Tea 中文

Utility

Install and update emulators in Utility, sort out install conflicts, set up RetroArch bezels and shaders, or configure it all at once with the setup wizard.

Open Utility

Go to Utility from the menu on the left. There are three tabs at the top:

The last button in the tab bar is Setup wizard, the recommended place to start on a new device (see the end of this page).

Install and update emulators

Emulator list

Utility: Emulators
Utility: Emulators

On the left is a directory grouped by console (multi-platform, NDS, 3DS, N64, NGC / Wii, Wii U, Switch, PS1–PS3, PSP, PS Vita, DC / NAOMI, Arcade, N-Gage, PC). Each entry shows its version and status:

Status Meaning
Installed (green) Installed and up to date
Update (blue) A new version is available
Not installed (grey) Not installed yet
Installing (yellow) Downloading or installing

A version showing Checking… means the latest version is being looked up; for Couldn't check, tap the hint on the card to try again.

On the right are cards for every emulator. Whatever you select on the left, the right side scrolls to its card.

Install, update, open

  1. On the emulator's card, tap Install.
  2. The first time, Android asks you to allow Tea to "install unknown apps": tap Open settings, turn the switch on in the system page, then come back.
  3. When the download finishes, confirm the install as Android asks.

Installed emulators have Open on their card, and Update when a new version is out. Leaving Utility mid-download doesn't stop it.

Tip: emulators from firmware packs that you installed yourself (My Boy!, RetroArch G, Yaba Sanshiro 2, M64Plus FZ Pro, STORM SWITCH, Lime3DS, Citra from the 天马包 (Pegasus pack)) are listed too and can start games, but can't be downloaded or updated here.

Rows on the card

An installed emulator's card may have these rows at the bottom, each with a line about its current state and a button on the right:

Some cards have a row of their own, such as Vita3K's Vita3K's storage folder, or Allow for GameHub Lite and DroidDeck.

About RetroArch

Utility installs the universal RetroArch (nightly): the floating button, choosing a disc at start and other features need it, and the stable 1.22.2 doesn't support them. The package has no cores; after installing, go to Load Core → Download a Core in RetroArch.

If you previously installed the stable RetroArch or the Play Store version, the card suggests switching to the universal version:

  1. If your saves are in the RetroArch folder under Android/media/, copy them out first; uninstalling deletes them too.
  2. Tap Uninstall it on the card, then install the universal version.
  3. In the new RetroArch, download your cores again (Load Core → Download a Core) and set up your hotkeys again.
  4. Go back to Tea and start games as usual. The bezels and shaders you set up before are reconnected automatically when a game starts.

If your RetroArch shows garbled Chinese text (a build missing Chinese fonts), the card tells you too: install the official version above first, then uninstall the old one.

Emulators worth knowing

Emulator Notes
Vita3K+ Experimental community fork of Vita3K: runs more games but may be unstable, aimed mainly at Snapdragon. Can be installed alongside Vita3K; set both to the same storage folder
Vita3K The old version (0.2.0) is signed differently and can't be updated in place: back up your saves, uninstall the old version, install the new one, then reinstall the firmware
Citra-MMJ Performance fork of Citra that may run better on low-end devices; updated infrequently. AzaharPlus is still recommended for 3DS
Lemon Switch emulator based on Eden with built-in cheats; Eden is still recommended for Switch
Eden Nightly Eden's nightly build; can be installed alongside the stable version, with separate keys, firmware and saves
Dolphin MMJR2-VBI Performance fork of Dolphin that runs some games better on low- and mid-range devices; can be installed alongside the official Dolphin
WatermelonDS Enhanced fork of melonDS: achievements, Vulkan, shader presets, external displays; can be installed alongside melonDS
MAME4droid The latest MAME, for arcade games FinalBurn Neo can't run; needs full (non-merged) ROMs for the matching MAME version
ARMSX3 PS3 emulator at an early stage; needs a powerful device and your own PS3 firmware
Cemu Wii U; needs a powerful device and Android 11 or later
DroidDeck PC; Snapdragon only (Adreno 730 or newer), downloads about 3 GB of runtime on first launch

Install conflicts

When an install fails with a conflict, the card tells you which app is in the way and what to do:

The text in brackets at the end of the card is the system's original error; just send a screenshot when asking for help.

Bezels

Bezels are frame images around the game picture, set per console, for RetroArch.

Before you start

Set one up

  1. Go to Utility → Bezels. Consoles already set up come first, the rest are sorted by popularity.
  2. Tap a console and pick a bezel under Choose a console bezel; each has a preview.
  3. The confirm window lists the settings that will change (the original values are recorded, so you can reset at any time). Turn on Integer scaling if you like: the game is enlarged by whole-number steps so shader grids and scanlines look even, and the bezel shrinks to wrap the picture (the picture may get smaller).
  4. Tap Apply. It takes effect when the game is reloaded.

To undo it, tap Reset next to the console: the bezel image is deleted and RetroArch's related settings go back to how they were before the bezel was set.

Good to know

Shaders

Shaders change the look of the picture; they're also set per console, for RetroArch.

Set one up

  1. Go to Utility → Shaders and tap a console.
  2. Pick a shader and tap Apply. The confirm window also offers Integer scaling.
  3. To undo it, tap Reset.

Available shaders

Shader Effect
LCD / CRT (recommended) LCD grid for handhelds, CRT scanlines for home consoles and arcade
Light A light effect that's easy on performance
Clean pixels Sharp pixels, no grid
Phosphor Dot / Phosphor Line By 脑浆油条. Phosphor dots for handhelds, phosphor lines for home consoles and arcade
Brickboy DMG and others GB-only original Game Boy screen effects (needs Vulkan)
中登95 series Complete looks with reflective frames and pictures of the real console: 3:2, 4:3 flat / curved, 16:9 reflective frame and more, shown only on screens of the matching shape

Setup wizard

On a new device, the setup wizard is the recommended way to set up emulators, bezels and shaders in one go:

  1. Tap Setup wizard at the end of Utility's tab bar.
  2. Consoles: tick the consoles you want to play (Tea recognises consoles already in your ROM folder).
  3. Emulators: each console lists its emulators with the recommended one first; install directly.
  4. Bezels: pick a bezel for each console that uses RetroArch, or None.
  5. Shaders: pick a shader for each console; LCD / CRT is recommended.
  6. Done: shows the result for each console.

The bezel and shader steps appear only if the consoles you picked use RetroArch; if RetroArch isn't ready yet they're skipped automatically, and you can set them up later in Utility. You can tap Close at any time, or Start over at the end.

Tip: the first time you use RetroArch, remember to download the cores you need inside it (Load Core → Download a Core).

Updating Tea itself

Tea's Check for updates is under Settings → General. When a new version is available, a small red dot lights up on the ☰ menu button and on Settings. See Settings.