Cloud drive and downloads
Log in to your own Tianyi Cloud, Baidu Netdisk, Quark Drive or home NAS, pick games in "Cloud drive" to download to your handheld, and follow their progress on the "Downloads" page.
Tea is the Premium Clean Fans edition: the app holds no game resources or share links at all. The only things you can download are files in your own cloud drive or NAS. Once you log in, "Cloud drive" is a file browser for your drive: pick a game, choose a console, and Tea downloads it, extracts it and puts it in that console's ROM folder, ready to play from the library.
#Two kinds of drive: sync drive and library drive
In Settings → General, drives come in two groups, each with its own job:
| Group | Used for | How many |
|---|---|---|
| Sync drive | Keeps sync data: play time, beaten records, saves and more; see Sync | One |
| Library drive | Browse and download your own files in "Cloud drive" | Tianyi, Baidu, Quark and home NAS are all fine, one tab each |
Both groups can use the same drive, or different ones, for example Tianyi Cloud for sync and your home NAS for games. Once a drive is logged in for one group, its card in the other group shows the account and a Use button: tap it to use the drive straight away, with no second QR scan.
#Logging in to a drive
#Tianyi Cloud, Baidu Netdisk, Quark Drive
- Open Settings → General → Library drive.
- Tap Log in on the drive's card.
- Scan the QR code on screen with that drive's phone app (天翼云盘 for Tianyi Cloud, 百度网盘 for Baidu Netdisk, 夸克 for Quark Drive) and confirm the login on your phone.
- When the card shows your account (partly hidden), you're logged in.
If the QR code expires, tap New QR code. If you haven't logged in yet, tapping Choose a drive to log in on the "Cloud drive" page starts the same flow.
To remove a drive, tap Log out on its card. If it is also your sync drive, the account stays logged in and sync carries on; it just no longer shows in "Cloud drive". Otherwise its unfinished downloads will fail; games already downloaded are not affected.
#Home NAS
Tea connects to a NAS at home over SMB file sharing (Synology, UGREEN, QNAP, or a computer with file sharing turned on).
- Make sure SMB file sharing is on for the NAS and that your handheld and the NAS are on the same Wi-Fi.
- In Settings → General → Library drive, tap Connect on the "Home NAS" card.
- Tea looks for NAS devices on your network ("Looking for a NAS on your network…"); choose yours under "Pick your NAS:". If it isn't found, tap Type an address and enter its IP address or host name (such as
192.168.1.20). - Fill in User name and Password, then tap Connect. Leave the user name empty to connect as a guest; if the NAS doesn't allow guests, Tea asks you for an account.
- If you are connecting it as your sync drive, also pick a shared folder in Sync into; sync data goes inside it.
Your password is stored encrypted on the device and never uploaded. If a NAS that Tea found on its own changes IP address (say, the router hands out a new one), Tea finds it again by name. When you connect again, the address and user name are already filled in; you only re-enter the password.
Note The NAS only works on your home network. When you're out and can't reach it, the NAS in "Cloud drive" won't open and NAS downloads fail; once you're home, tap Retry on the "Downloads" page.
#Browsing "Cloud drive"
Open Cloud drive from the side menu (☰), just below "Library". In portrait it's in the bottom navigation bar.
With several library drives logged in, drive tabs run along the top in a fixed order, Tianyi → Baidu → Quark → NAS; switch with LB / RB. Each tab remembers its own open folder and selected files.
A fixed row at the top shows the drive icon, the current path, Refresh and Download.
#Controller
| Button | Action |
|---|---|
| A | Open a folder, or select / deselect a file |
| B | Go up one folder (closes search first if it's open) |
| X | Select every file shown |
| Y | Search this folder |
| Start | Switch between list and grid |
| LB / RB | Switch drive |
| ↑ on the first row | With files selected, moves to the Download button at the top; ↓ goes back to the file list |
Touch works too.
#List and grid
- List: like the library's list, each row shows a thumbnail, a console tag, the file name, download status and size.
- Grid: game files get a cover matched by file name, and the console is worked out from the file extension or the folder name (for example, a file in a
gbafolder). Covers follow the library's tile shape. Folders and other files show icons.
#Search
Press Y to search. Every word you type must match; case, spaces and punctuation are ignored. Search only filters the current folder; it clears when you move to another folder.
#The "Freedeck Sync" folder
If this drive is also your sync drive, its top folder holds a greyed-out Freedeck Sync (marked "Sync data"). That is sync data: it can't be opened or downloaded. Please don't delete or move it in your drive.
#Downloading games
- In "Cloud drive", select the files you want (A one at a time, X for all).
- Tap Download at the top (it shows how many are selected).
- Under Download to, choose where they go:
- Other folder: the first choice. Files are saved as they are in the folder you pick: not extracted, not added to the library. Handy for BIOS, firmware, patches and other files that aren't games. Tea remembers the last folder you picked. Files with the same name are replaced.
- PC: into the PC games folder.
- A console (sorted by name): into that console's ROM folder. Custom tabs you've made (such as
roms/mame) are listed under their console.
- Once the download starts, a message pops up; tap View downloads to go straight to the "Downloads" page.
Each file counts as one game; a set of split archives (such as .7z.001, .002… or .part1.rar, .part2.rar…) counts as one. File rows show their status live: Queued, Downloading, Paused, Failed, Installing, Downloaded. Tap ✕ on a downloading file to cancel it.
Tip Consoles marked "No folder set" under "Download to" are greyed out and can't be chosen. First set the Default ROM folder or that console's own folder in Settings → Emulator games.
#Where games go
The location comes from the folders in Settings → PC games and Settings → Emulator games:
| Download to | Goes into |
|---|---|
| PC | PC / Pool games folder, one folder per game |
| A console with its own folder (ROM folder per console) | That console's folder |
| A console without its own folder | The console folder named the ES-DE way (such as gba, psx) inside the Default ROM folder |
| A custom tab | That tab's folder |
| Other folder | The folder you picked, files as they are |
While installing, Tea tidies things up so emulators and the library both recognise them:
- Cartridge games in
.zip(GBA, NES, Mega Drive, N64 and so on) aren't extracted; they go straight into the console folder, and emulators read them directly. - Disc images (
.iso,.chd,.cso) and Switch.xci/.nspfiles need no extracting and are moved straight into the console folder. - When an archive holds a single game file (PSP, PS2, NDS, 3DS, Wii, GameCube, N64, Mega Drive), it is extracted, named after the game and put straight into the console folder; readme files and pictures are cleaned up.
- Disc games that use
.cue(PS1 and others) and PS3 games stay in their own folders. For PS1 games with only.ccd/.img/.sub, Tea adds a.cueitself so every PS1 core can start them. - Downloaded archives are deleted once extracted, so they don't take up space twice.
#Extraction
Tea extracts .zip, .7z, .rar (RAR5 included) and their split volumes. It tells the format from the file's contents, not its extension, so an archive with the wrong extension still opens.
Note An incomplete archive shows "the archive data is corrupt"; remove the files on the "Downloads" page and download again.
#Storage and folder access
Tea's downloads are kept in downloads inside the Freedeck folder (by default Freedeck in internal storage) while they run, then moved to where they belong.
There are two ways to set a folder, and either works:
- System picker (tap Use system picker): Android's own folder picker, no extra permission needed. But from Android 11 on, it won't let you pick the
Downloadfolder or the root of storage. - Tea's own folder browser (tap Choose folder): picks any folder, but first tap Grant access in Settings → General to turn on "All files access".
Tip Granting "All files access" is recommended: you can pick folders more freely, and big files and split RAR archives install more smoothly.
#Download speed and drive limits
Tea splits big files (over 8 MB) into several connections that download at once; after a pause or a dropped connection, each one picks up where it stopped. How many connections you get depends on your drive account:
| Drive | Free account | Member |
|---|---|---|
| Tianyi Cloud | 16 per file | 16 |
| Baidu Netdisk | 1 | SVIP: 8 |
| Quark Drive | 1 | Member: 8 |
| Home NAS | 4 | — |
Free Baidu Netdisk and Quark Drive accounts only allow one connection; that is the drive's own rule, and Tea doesn't get around it. After you become a member, there's no need to log in again: the next download that starts uses more connections.
Up to 2 files download at a time; the rest wait in line and start on their own as earlier ones finish.
#The "Downloads" page
Open Downloads from the side menu to manage all your drive downloads in one place. The number of running downloads shows as a badge on the menu.
A summary row runs along the top: N downloads · a done · b failed · c in progress (queued, downloading, paused and extracting all count as in progress).
| Action | What it does |
|---|---|
| Pause all / Resume all | Pause or resume every download |
| Clear finished | Clear the finished entries (game files stay) |
| Pause / Resume | Pause or resume one download |
| Retry | Start a failed download again, keeping what was already downloaded |
| b failed | Show only failed downloads; tap "b failed · show all" to see everything again |
| Retry failed | Retry every failed download at once |
| Remove record | Delete only the download entry; downloaded files stay |
| Remove files | Delete the download entry and its files (the files are listed first for you to confirm) |
When a download has several files (split archives, for example), tap "N files" to see each file's progress, and Hide files to fold it up again.
#When extraction fails
If extraction goes wrong after a download, the card shows "Extraction failed" and the reason (tap the message to dismiss it). Tap Retry: Tea extracts again from the files it already has, with no new download. If the archive is corrupt, see Extraction above.
#Expired login
When a drive's login expires, downloads in progress fail. Log in to that drive again in Settings → General, then go back to the "Downloads" page and tap Retry or Retry failed.
#Steam Deck
The Steam Deck version has the same "Cloud drive" and "Downloads" pages and works much the same way; buttons and folder settings differ a little. See Steam Deck.
