Tea 中文

Artwork and scraping

Where box art and labels come from, ScreenScraper accounts and quotas, cartridge looks, custom labels and box art, arcade cabinets, the launch animation and game videos.

Tea automatically finds box art, cartridge labels, descriptions and videos for the games on your device; this is called "scraping". Most of the time you don't have to do anything. This page explains how it works and how to swap in pictures you like better.

Automatic scraping

Where box art comes from

Once a game is in a ROM folder, Tea tries these in turn:

  1. By file: reads the ROM's checksum or the disc's serial number and looks it up exactly in libretro's game database. This finds the most matches.
  2. By name: translations and hacks have different checksums, so Tea matches the game's English name instead. Chinese names are first turned into the original English name.
  3. ScreenScraper: when the first two find nothing, Tea uses the box art ScreenScraper returns.
  4. Pictures on the device: when nothing else is found, Tea uses pictures already on the device: ES-DE's media folder, a Pegasus pack's images, an image with the same name next to the ROM, a cover / folder image in the game folder, or the game's own icon (PSP, PS Vita, PS3).

Only games on the device are scraped.

Scraping progress

Scraping again

Box art and labels are saved on the device once seen, so they show offline afterwards too.

Labels and ScreenScraper

Cartridges, discs and UMDs

FC cartridge
FC cartridge

Games on the device show as the physical item in the carousel and on the game page, with the artwork printed on it:

Look Consoles
Cartridge FC / NES, SFC / SNES, MD, GB, GBC, GBA, N64, NDS, 3DS, Switch, Game Gear, NGP, WonderSwan, Lynx; HuCard for PC Engine
Disc PS1, PS2, PS3, Saturn, DC, Wii, Wii U, Mega-CD, 3DO; mini disc for GameCube
UMD PSP
Arcade cabinet NEOGEO, CPS1 / 2 / 3, FBNeo arcade, Naomi (see below)

Cartridge labels and disc faces use ScreenScraper's scans of the real thing first; without a scan, the box art is cropped and applied instead.

Scrape labels switch

If you'd rather not use ScreenScraper's scans, turn off Settings → Emulator games → Scrape labels. With it off, no new labels are scraped and games without a label show their box art in the cartridge and disc views; labels already scraped are kept, and box art is scraped as usual.

ScreenScraper account

Labels, descriptions and some videos come from ScreenScraper (screenscraper.fr). It works without logging in (using the built-in account). Log in to your own account in Settings → Emulator games → ScreenScraper account and:

To log in:

  1. No account yet? Tap Sign up to register on the ScreenScraper website.
  2. Tap Log in and fill in your User name and Password.
  3. Once logged in, it shows "Logged in:" and your masked account; Log out logs out at any time.

The card shows "Used today: X / Y" below.

Note When the day's quota runs out, a message on screen says the quota is used up and scraping carries on tomorrow. Games that didn't get a label today get one automatically the first time you open Tea the next day.

Prefer frontend artwork

With Settings → Emulator games → Prefer frontend artwork (ES-DE / Pegasus) on, grid and list show pictures already on the device first: ES-DE's or a Pegasus pack's (ES-DE's when there are both), and pictures next to the ROM. The cartridge and disc views aren't affected: labels still come from ScreenScraper first, and use these pictures only when there's none.

Tea looks for ES-DE's ES-DE/downloaded_media folder on internal storage and SD cards, including any custom media location you set in ES-DE.

Cartridge looks

GBA cartridges in different looks
GBA cartridges in different looks

Some consoles' cartridges come in several looks. On the game page, tap Customise below the cartridge:

  1. Pick a look and the cartridge changes right away (on the game page, in the carousel and in the launch animation).
  2. To use this look for all of this console's games, tap Apply to all.
  3. Tap Done to close.
Console Looks
FC / NES NES (US), Famicom (Japan), Subor
SFC / SNES SNES (US), Super Famicom (Japan)
MD Genesis black / grey / beige / blue, Mega Drive black / grey / beige / clear blue
GB Grey, black, red, blue, yellow, green, white
GBC Clear smoke, clear gold, clear silver, clear crystal blue, atomic purple, plus all the GB colours
GBA Indigo, dark grey, black, red, blue, green
NDS Black, ivory
NGP Black, orange, grey
Game Gear Black, clear black

The default look for FC / SFC and NES / SNES depends on the game's version: Japanese releases and Chinese translations use the Famicom / Super Famicom cartridge with the Japanese label; US and European releases use the NES / SNES cartridge.

Custom labels and box art

You can give every game pictures you choose yourself. Depending on the game, the button below the picture on the game page says Customise (cartridges with several looks: tap Label / cover in the pop-up), Label / cover (other cartridges, discs, UMDs) or Custom cover (other games).

It opens a full-screen page with two tabs, Label and Cover:

Button Action
LB / RB Switch tabs
Y Jump to the search box
B or ✕ Close

Label tab

Custom label: searching for labels
Custom label: searching for labels

  1. Scrape name is filled in with the English name Tea recognized; you can change it to another name (type at least 3 letters).
  2. Two groups of results are listed below: Label scans · ScreenScraper (scans of the real thing, with today's remaining requests shown beside it) and Box art · libretro (uses no requests).
  3. Select a result and the cartridge or disc on the left previews it; tap Use.

Cover tab

  1. The left side shows the current box art and where it came from (custom cover / picked by hand / found automatically).
  2. Type an English name in the search box to list box art from ScreenScraper and libretro; PC games also get Steam store art.
  3. Select one and tap Use, or tap Image on device. Once set, you can tap Reset cover.

A custom cover beats every other box art, in the grid, list, carousel and on the game page.

Tip Don't know the game's English name? Find art looks up the game's official name and searches with it for you. It's an AI feature; see AI features.

Custom labels and custom covers travel to your other devices with Drive sync.

Adding labels in bulk

To give many games new labels at once, drop image files straight into this folder:

Freedeck/artwork/stickers/<主机>/<ROM 文件名>.png

For example, Roms/gba/Pokemon Emerald.gba matches Freedeck/artwork/stickers/gba/Pokemon Emerald.png; jpg, jpeg and webp work too. <主机> (console) is Tea's own console code, which isn't always the same as the ROM folder name: for example gba, psp, nds; FC is fc (not nes), PS1 is ps1 (not psx). Games in a custom tab use the code of the console the tab belongs to. <ROM 文件名> is the ROM file name.

The order is: a label picked by hand on the game page → a label in this folder → ScreenScraper's scan → pictures on the device. This folder isn't synced through your drive; copy it to each device yourself.

Arcade cabinets

Arcade cabinet
Arcade cabinet

Arcade games (NEOGEO, CPS1 / 2 / 3, FBNeo, Naomi) show as a small arcade cabinet in the carousel, on the game page and in the launch animation: the light box at the top carries the game's marquee, and the screen shows the game.

Large view

On the game page, press A or tap the cartridge, disc, UMD, box art or arcade cabinet to open a full-screen view:

Launch animation

When you tap Play on the game page, the cartridge, disc or UMD flies to the middle of the screen and then slides into the bottom of the screen as if going into the console: a cartridge clicks into its slot, a disc starts spinning, an arcade cabinet's screen flashes a scan line and takes a coin, and finally the picture closes in an iris into the game. When you quit the game and return to Tea, the iris opens again from the slot.

The focused cartridge in the carousel slowly floats and turns; you can turn this off in Settings → Interface → 3D cartridge animation. The launch animation's sounds aren't affected by the "UI sounds" switch. More about launching in Playing games.

Game videos

Rest on a game in the library for a moment and its video plays in the background (in the preview panel when game preview is on). Press any button or touch the screen and the video stops at once.

Where videos come from

  1. Videos in ES-DE's media folder.
  2. Videos that come with a Pegasus pack.
  3. ScreenScraper's online videos (only for games on the device, looked up once box art scraping is done).
  4. The XMB background animation on a PSP game's disc (as the last resort).

Settings

In Settings → Interface → Game videos:

Option What it does
Game videos Main switch: play background videos when a game is focused
Game page video Play once (muted) when the game page opens. With it off, games with a video show a video button in the game page's top-right corner; tap it to play
Delay Wait 1 / 2 / 3 seconds after selecting a game before playing
Loop Play again when it ends
Sound Muted by default
Save streamed videos Save videos played online into ES-DE's media folder (ES-DE/downloaded_media/<主机>/videos/, <主机> being the console) so they play locally next time, and ES-DE can use them too

Tip After you change a game's scrape name, online videos Tea saved for it earlier are deleted and looked up again, so you don't keep seeing a video of the wrong game. ES-DE's or a pack's own videos are never deleted.

Steam Deck edition

Scraping, labels, custom covers, arcade cabinets, the launch animation and game videos work the same in the Steam Deck edition as on Android. See Steam Deck.