Tea 中文

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:

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.

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.

See Cloud drive and downloads.

File access and the Freedeck folder

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:

  1. Tap a swatch to open the colours page (LB / RB switch between light and dark).
  2. Choose a preset colour set and press A to use it.
  3. 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.
  4. 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

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

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".

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

AI

Lists every AI feature, and is where you verify as a supporter to unlock them:

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.

Drive logins, AI verification and download records are kept only in Tea on this device, not in the Freedeck folder.

Moving the Freedeck folder

  1. Go to Settings → General → Freedeck folder and tap Choose folder.
  2. In the folder browser, pick an empty folder.
  3. 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.

To update:

  1. 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.
  2. Tap Update (you can also tap Update right in the release notes window).
  3. The first time you update, if it says "Permission needed", tap Open settings, allow Tea to install apps, then come back.
  4. 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.