Settings and updates
What each Settings tab and option does, plus the Freedeck folder, app updates and error reports.
Press Select to open the menu and choose Settings. On the game page, the downloads page and other pages you can also press Start to open Settings directly (in the library Start switches the layout, and in Utility it opens the setup wizard). Settings has six tabs, switched with LB / RB: General, Interface, PC games, Emulator games, AI, About. Every change takes effect right away; there's nothing to save.
#General
#Language
Switch between 中文 and English; the whole interface changes language at once.
#App icon
Choose the style of Tea's icon on your home screen. Some home screens take a moment to show the new icon, and a shortcut you placed on the home screen may disappear; just add it again.
#Button layout
Pick by the letters printed on your controller:
- Xbox: A is the bottom button.
- Nintendo: A is the right button (Nintendo controllers, Japanese layout).
If your handheld's own "swap A/B" setting is already on, the right button is already A; choose Xbox.
#Sync drive
Syncs play time, beaten records, and RetroArch in-game saves and quick saves between devices. Choose one of Tianyi Cloud (天翼云盘), Baidu Netdisk (百度网盘), Quark Drive (夸克网盘) or Home NAS.
- Before you choose, four cards are shown; tap Log in (Connect for the NAS). A drive already logged in as a library drive shows Use, no second login needed.
- Once chosen, it shows the account, sync status (such as "Synced · 5 min ago"), Sync now and Log out; the Sync switch at the top right pauses sync.
Note: Sync data lives in the sync drive, and switching sync drives often makes sync go wrong. Once you pick one, try not to change it.
See Sync.
#Library drive
Browse and download games from your own cloud drive or home NAS on the Cloud drive page. You can log in to several; each drive is a tab on the Cloud drive page, and it can include the sync drive.
- All four cards are always shown. Added drives show the account and Log out; a drive logged in as the sync drive shows Use; the rest show Log in / Connect.
- When you log out of a library drive that is also the sync drive, the login is kept for sync; the confirmation says so.
See Cloud drive and downloads.
#File access and the Freedeck folder
- File access: shows whether all files access has been granted. If not, tap Grant access. Reading ROMs and choosing folders such as Download need it.
- Freedeck folder: settings, scraped data and images shared by Coffee and Tea, by default the
Freedeckfolder in internal storage. Tap Choose folder to move it.
#Version and updates
At the very bottom of the General tab is Tea's own version card: the installed version, the latest version, and the Release notes and Check for updates / Update buttons. See "Checking for updates" below.
#Interface
| Option | What it does |
|---|---|
| Theme | Default (light), Dark or Follow system |
| Colours | Pick a colour set each for light and dark; tap a swatch to open the colours page |
| Background | Page background: Dots, PS shapes, Gradient or Image (any picture on the device; once chosen, tap Change image to swap it) |
| UI sounds | Sounds for tapping buttons, going back and opening the menu. The game start sound isn't affected |
| Tile shape | Cover shape in the library grid and the Cloud drive grid: Default (wide), Square, Rectangle (game box) |
| Grid columns | Games per row in the library grid: Auto, or set it with − / + |
| Scale | UI scale: size of buttons, text and cards; Cartridge size: size of cartridges and discs in the carousel view |
| A Quick launch game | On: A / a tap starts the game, LT + A shows details. Off: A / a tap shows details, LT + A starts it. A long press always opens details |
| Android games | Shows an "Android" tab in the library; choose which of the device's apps to show as games |
| Game preview | Shows the selected game's cartridge, description and play time to the left of the grid and list. Remembered per device; off by default on small-screen handhelds |
| 3D cartridge animation | In the carousel view, the selected cartridge, disc or UMD slowly floats and turns |
| Game videos | Plays a video once a game is selected; see below |
Tip: Tile shape and grid columns can also be set per tab: long-press the background in the library. The settings here are the default for every tab.
#Theme and colours
Theme decides between light and dark. The Colours row has two swatches, "Light" and "Dark", the colour sets used in each mode:
- Tap a swatch to open the colours page (LB / RB switch between light and dark).
- Choose a preset colour set and press A to use it.
- To make your own, choose New: give it a name and pick a colour each for page, cards, text and accent. On the right are all the traditional Chinese colours and their shades, and the interface changes colour as you go. When you're happy, tap Save.
- For a colour set you made, select it and long-press or press X to open Edit, where you can change it or Delete it.
#Scale
- UI scale: makes buttons, text and cards bigger or smaller. When the screen can't fit any more, it stops on its own and says "This screen goes up to xx%."
- Cartridge size: changes only the cartridge, disc or UMD in the middle of the carousel view. The panel turns see-through while you drag, so you can see the result directly.
#Game videos
| Option | What it does |
|---|---|
| Game videos | Plays a background video once a game is selected (in the preview panel when game preview is on) |
| Game page video | Plays videos on the game page too |
| Delay | Waits 1s / 2s / 3s after a game is selected before playing |
| Loop | Plays again when it ends |
| Sound | Whether videos have sound |
| Save streamed videos | Saves videos played online into ES-DE's media folder, so next time they play from the device, and ES-DE can use them too |
#PC games
- PC / Pool games folder: PC games go here, one folder per game.
- GameNative covers: after a PC game is installed, Steam covers (
coverv.jpg/coverh.jpg) are written into its game folder, and they show once the game is added to GameNative. For games installed earlier, tap Add covers to installed games to fill them all in at once.
#Emulator games
#ScreenScraper account
Covers, labels, descriptions and videos are mostly scraped from ScreenScraper. Without logging in, a built-in account is used; log in with your own account and scraping counts against your account, usually with more speed and more requests per day. The card shows "Used today: x / y".
- No account: tap Sign up.
- Have an account: tap Log in and enter your user name and password.
- To leave: tap Log out to go back to the built-in account.
#Scraping options
| Option | What it does |
|---|---|
| Scrape labels | Labels on the physical views such as cartridges and discs. Turned off, no new labels are scraped, and games without a label show their cover in those views; existing labels stay, and covers are scraped as usual |
| Prefer frontend artwork (ES-DE / Pegasus) | The grid and list prefer artwork already on the device: from ES-DE or a Pegasus game pack, and images beside the ROM. Cartridge and disc views aren't affected |
| Use local game names | Shows local game names first: the name in a Pegasus or ES-DE game list, then the arcade Chinese name, then the ROM file name. Games you renamed keep your name. Only what's shown changes; scraping and search still use the game's original name |
| Load the quick save at start | When a RetroArch game starts, loads the auto quick save so you carry on where you left off (including one synced from another device) |
Tip: Whether a quick save is written when you quit a game is set in RetroArch: Settings → Saving → Auto Save State.
#ROM folders
- Default ROM folder: for consoles without their own folder, games go in "Default ROM folder/console name/game name". When you switch to another default ROM folder, the console folders already in it are recognised, and missing ones are created.
- ROM folder per console: one card per console. Tap Choose folder to give it its own folder, or Reset to go back to its folder inside the default ROM folder.
- Add custom tab: shows another folder for the same console (a hack collection, for example) as its own tab in the library. Fill in Tab name, choose the Console and the folder, then Save; later, Edit or Delete it on its card.
#AI
Lists every AI feature, and is where you verify as a supporter to unlock them:
- Verify bilibili 充电: log in by scanning with the B站 (bilibili) app to confirm your 充电 (charging support) status.
- Verify afdian: enter the 8-character activation code the author sent you in a private message, or the order number of any order you placed with the author on 爱发电 (afdian).
Once verified, it shows "Verified · source · until date". Verification lasts a month; when it runs out, just verify again (afdian verification fills in the activation code or order number you used last time). Sign out stops this device from using AI features. Below are QR codes for supporting the author.
See AI features.
#About
Tea's instructions and disclaimer, plus the sources of and thanks for bezels, shaders, colour sets, arcade game names, covers and other resources.
#Freedeck folder
The Freedeck folder (by default /storage/emulated/0/Freedeck) holds what you can take with you: bookmarks, renames, scraped data, covers and labels, cartridge looks, and preferences such as language, look and button layout.
- Shared with Coffee: if both editions pick the same folder, they share this data.
- Restored after reinstalling: after you reinstall Tea and grant all files access, a Freedeck folder in the default location is found again on its own. If you use another location, choose it again during first-time setup or in Settings → General → Freedeck folder.
- New device: copy the Freedeck folder along with your ROMs to the new device, and covers, custom tabs and ROM folders all line up, no scraping again.
Drive logins, AI verification and download records are kept only in Tea on this device, not in the Freedeck folder.
#Moving the Freedeck folder
- Go to Settings → General → Freedeck folder and tap Choose folder.
- In the folder browser, pick an empty folder.
- Tea copies the old folder's contents across (except the image cache, which is rebuilt).
If you pick a folder that already holds Freedeck data (copied from another device, for example), Tea reads and uses the data in it.
#Checking for updates
Tea updates inside the app; there's no need to download an APK by hand.
- Automatic check: Tea checks for a new version when it starts, and when you come back to it more than two hours after the last check. When there's a new version, a small red dot appears on the ☰ button and on Settings, and goes away after you update.
- Check by hand: in Settings → General, tap Check for updates on the version card at the bottom.
To update:
- Tap Release notes on the version card to see what's new. The top right of the notes window switches to earlier versions; with a controller, use left and right on the D-pad.
- Tap Update (you can also tap Update right in the release notes window).
- The first time you update, if it says "Permission needed", tap Open settings, allow Tea to install apps, then come back.
- When the download finishes, install it as the system prompts. The update installs over the current version, and your games, settings and logins all stay.
Note: If you have both Coffee and Tea installed, update them together, so an older version doesn't overwrite the shared images and records.
For updating the Steam Deck version, see Steam Deck version.
#Error reports
If Tea closes unexpectedly, the next time you open it a "Something went wrong last time" window pops up with the error report. Tap Copy or Share to send the report to the author and help fix the problem; tap Close and this report won't show again.
#Differences on the Steam Deck
The Steam Deck version's Settings has no PC games tab, and none of the App icon, Button layout (handled by Steam Input), Android games, Load the quick save at start and file access options; its profile folder is also in a different place. See Steam Deck version.
