Release notes
What's new in every version of Tea, newest first. Also in the app: Settings → General → Release notes.
#1.8.4
[A note from the author] Tea for the Steam Deck brought in a lot of feedback. Thank you all! In the age of AI, what sets an app apart isn't who builds the flashiest thing or the most features. It's the many small touches that come from real players using it, and the bug fixes for all the odd cases. Seen that way, Tea and Coffee aren't purely vibe-coded, are they?
This time every platform gets a button layout you can switch freely (RetroArch, and on the Steam Deck the standalone emulators Eden, Azahar, melonDS, mGBA, Cemu and Ryujinx too): playing a Nintendo game, use the layout with A on the right, no digging through RetroArch's settings. Tea's cloud drive page can now download to any folder, handy for your own firmware and BIOS.
The Decky Coffee page got lots of polish: each game shows which cloud drives it's on, so you can pick the version that suits your drive membership.
1.8.4 · Your buttons, your layout Tea Premium Clean Fans edition
#🎮 Button layout: Nintendo or Xbox, one tap
- Games for Nintendo consoles (FC, SFC, GB, GBA, NDS…) get a button layout next to the emulator on the game page: Default layout, Nintendo layout or Xbox layout, one tap to switch.
- It takes effect at the next Play: the button printed A on your controller is A in the game. Each core remembers its own.
- Back to Default layout and RetroArch's own settings come back exactly as they were.
#📥 Downloads at a glance
- The Downloads page opens with a summary: how many in total, done, failed and in progress.
- Tap "failed" to see only those, and Retry failed to start them all again.
#📁 Cloud drive: download to any folder
- Download to now starts with Other folder: a BIOS, a patch or anything that isn't a game downloads as it is into the folder you pick, not unpacked and not added to the library; the folder is remembered.
#🗂️ The library knows more
- Compressed 3DS games (.cxi, .3dsx, .zcci, .zcxi, .z3dsx) are listed now; a folder of them used to show nothing at all.
- PS Vita packs tagged [DLC] in their name are listed as games and start.
- A game's Simplified and Traditional Chinese translations keep their own files: deleting one used to delete the other's files too.
#🖼️ Covers and labels
- Arcade cabinet pictures that went blank after an update are back, with no need to scrape each one again.
- Label search under Label / cover shows libretro's previews again.
- The cartridge picker lays its looks out in even rows of up to five (GBA 3+3, GB 4+3, MD 4+4).
#✨ AI features
- Look it up for a translated game now searches by the name the scrape found (a fan translation's title is often hard to find).
- Verify afdian tries again by itself once the network is back, instead of staying on "soon".
- While the bilibili QR code is up, the two sponsor QR codes below it are hidden, so the wrong one isn't scanned.
- Sign out frees this device's place right away, so verifying on another device just works.
#🩹 Small fixes
- The save sync setup hint no longer pops up each time a game page opens: it's a line under the emulator, and Got it hides it for good.
- Utility: Vita3K+ no longer shows Update after its latest version is installed.
- The RetroArch core note on the game page now reads "if not downloaded yet", so a core you already have can be ignored; RetroArch G brings its own cores and gets no note.
- In mainland China, emulator downloads and update checks skip two mirrors that no longer work, so there's less waiting.
#🕹️ Steam Deck edition
- Everything above comes to the Steam Deck, and the button layout also covers the standalone emulators Eden, Azahar, melonDS, mGBA, Cemu and Ryujinx, plus cores such as bsnes-hd beta, Mesen-S and DeSmuME.
- RetroArch plays well without EmuDeck:
- Bezels show properly: RetroArch used to open in a window, which put bezel and game out of place (PS1 most of all); it now always starts full screen.
- A controller with no hotkeys gets them: hold Select and press Start to quit, R1 / L1 to save / load a state, X for RetroArch's menu.
- On 2D consoles like FC, SFC, GBA and MD, the left stick works as the D-pad too.
- GBA in-game saves are kept with run-ahead on.
- Before a PS2 game starts, PCSX2's controller port 1 is put on Steam's controller, so buttons no longer need mapping by hand.
- Switch games with an older EmuDeck can pick the Eden that Utility installed.
- In-app updates are faster in mainland China: two dead mirrors are gone.
- Restarting Steam during the install no longer brings up a "Konsole wants to share your screen" window.
#☕ Coffee Steam Deck plugin
- 天翼云盘 downloads are much faster: each file over 16 connections at once instead of one; 百度网盘 SVIP and 夸克 members get 8. After a pause or a dropped network, every connection picks up where it stopped.
- Games not downloaded yet show which drive they come from right on the list (天翼 / 百度 / 夸克…), greyed out when you're not logged in; the game's details mark those 未登录.
- Bookmarks: bookmark a game from its details for the amber badge on its cover, a Bookmark tab of its own, and bookmarked games first in the list.
- The search row stays at the top and ↑ takes you back up; X hides downloaded games, Start switches grid and list, RT opens Jump to, all shown in Steam's footer.
#1.8.3
1.8.3 · How many per row? You decide Tea Premium Clean Fans edition
#🔢 Grid columns: as many as you like
- The library grid now goes by columns: 2 to 6, stepped with − and +, and the covers grow or shrink to fill each row exactly.
- Every tab keeps its own: six little squares for GBA, three big covers for PS2. Long-press the library's background and set it in Customise.
- Want it for every tab at once? Settings → Interface → Grid columns sets the default; tabs you set yourself keep theirs.
- UI scale no longer moves your covers: a bigger UI means bigger buttons and text, and the grid keeps your columns. No more losing a column and getting giant covers out of nowhere.
- It starts on Auto, exactly as before: leave it and nothing changes.
- Step to 2 or 6 and the focus hops to the other button, so the controller never gets thrown back to the top.
#🎮 LT + B: Customise in one press
- In the library, hold LT and press B to open Customise: theme colours, background, tile shape, scale and grid columns in one panel, no long press needed.
- It's in the hint bar while LT is held, and in the battery popup's Secret combos.
#🎬 Videos inside the preview
- With Game preview on, a game's video plays right in the preview panel, filling the cover's spot; the games and collections beside it no longer dim.
#🩹 Small fixes
- Picking a console like FC on the All page always opens its own tab; if a custom tab of the same console (say FCHD) had been moved before it, you used to land there instead.
- The Customise panel drops its title to make room for Grid columns.
#🎮 Steam Deck edition
- Grid columns, LT + B for Customise, videos inside the preview and the All page opening the right tab all come to the Steam Deck.
- When the installer asks "Close Steam now?", Enter now means yes: Steam has to close for Tea's shortcut to be added, and Enter used to skip it, leaving no shortcut.
#1.8.2
1.8.2 · afdian sponsors get AI, and the library gets a preview Tea Premium Clean Fans edition
#⚡ afdian sponsors, thank you for waiting
- Settings → AI → Verify afdian is open: enter your 8-character activation code and every AI feature unlocks on the spot.
- The author sends your code as a message on afdian; open the afdian app and it's there. New sponsors get theirs automatically after paying.
- No message? The same field takes the number of any of your orders to the author (copy it from your orders on afdian).
- Enter it once and it's remembered: next month's check is a single tap. Up to 3 devices per account.
- 🎁 A small thank-you: afdian verification arrived weeks after bilibili's, so everyone who sponsored on or before 19 November gets 7 extra days of AI features.
#🖼️ Game preview: see what you're pointing at
- A preview panel now sits beside the library's grid and list: box art or cartridge, name, play time and About, for whichever game is selected.
- Select a collection and its games fan out, carousel style.
- Switch it in Settings → Interface → Game preview. It starts off on small-screen handhelds so the grid keeps its room, and each device remembers its own choice.
#🚀 Press Play, play
- Games with Save sync used to wait several seconds on every start to check the drive. Now Play starts the game at once: your saves are already brought down in the background when you open the game page.
#☁️ Labels that survive a change of device
- Fixed: when several devices synced scrape results, one with label scraping turned off could replace labels another had already found. Both devices' finds are now kept together.
- Arcade cabinet pictures (snap, title screen, marquee, logo) are now kept and synced to your other devices, instead of downloaded again on each.
#🩹 Small fixes
- The All page names consoles in full (PlayStation 2), easy to spot; tabs keep the short names.
- The light that sweeps across a tab while box art is scraped is fainter and slower, easier on the eyes during a long scrape.
- The AI list now includes the one-tap launch command for custom launch.
- On phones with a punch-hole camera, landscape no longer leaves an empty white strip on the camera side: the app fills the whole screen.
#🎮 Steam Deck edition
- Verify afdian is open here too: activation code or order number, one field.
- The Game preview panel arrives as well, switched in Settings → Interface.
- Games with Save sync start the moment you press Play.
- The label and arcade cabinet sync fixes and the full console names on the All page come along.
#1.8.1
1.8.1 · PS Vita games on the shelf, a look for every tab Tea Premium Clean Fans edition
#🎮 PS Vita games show up on their own
- Games you installed in Vita3K now appear in your library by themselves. No copying them around again.
- ES-DE's
.psvitaand Daijishō's.dptfiles work too: drop one into the PS Vita ROM folder and it's a game you can Play. - A game moved into Vita3K on its first start leaves a
.psvitabeside it, so other frontends can start it too.
#🎨 Every tab its own tile shape
- Long-press the library's background to open Customise: the new Tile shape setting changes only the tab you're on. Square for GB / GBA, rectangle for the rest, each looking its best.
- Customise itself is redone: titles lined up with their buttons, choices on the right, slimmer sliders, and everything on one screen, no scrolling.
#📱 Full screen, for real
- Phones with a punch-hole camera no longer leave a black bar in landscape: the background reaches the camera's edge.
- Handhelds with on-screen or gesture navigation (like the Odin 3) lose the black strip along the bottom too.
#🕹️ Better with a controller
- Select is always the menu: press it on any screen to open the side menu. A collection's Edit / Dissolve moved to holding A.
- With the menu open, the focus stays in it, never pulled back by a tab you just switched to.
#⚡ A smoother game page
- The little arrow at the bottom of the game page now rises three times and stops, instead of redrawing the whole page forever. On slower handhelds the page feels much snappier.
#🩹 Small fixes
- Fixed: closing a search box while the keyboard was still up could crash the app.
- Fixed: picking an empty Freedeck folder during the first setup could crash it.
- RetroArch downloads in mainland China that said "The file size doesn't match": an outdated copy on the fast route is no longer used, and the right build comes down instead.
#🎮 Steam Deck edition
- PS Vita: ES-DE's
.psvitagames are finally listed and start; games installed in Vita3K show up in the library on their own; a game folder is moved into Vita3K on its first start. - Installing RetroArch and other emulators from Utility in mainland China now goes through SJTU's Flathub mirror, no longer stuck on "Installing"; the install also shows how much has come down and how fast.
- Only one Freedeck Go at a time: no more two copies open at once, fighting over frames.
- The new Customise panel, per-tab tile shapes, Select as the menu button and the smoother game page all come to the Steam Deck too.
#1.8.0
1.8.0 · Fast downloads in China, any core you like Tea Premium Clean Fans edition
#🚀 Downloads in China, in a flash
- Installing emulators in Utility from mainland China? No more waiting: the ones that wouldn't open or crawled along now come through a fast route at home.
- RetroArch and PPSSPP too. What took over twenty minutes is done in a blink.
- If the fast route ever stumbles, Freedeck switches back to the usual link on its own, and the install still goes through.
#🧩 Other cores, your pick
- In the emulator picker, RetroArch and RetroArch G now have one more row: Other cores….
- Open it for every core this console can use, with search. Pick one and it's remembered, so the game starts in it next time.
#🎬 A proper welcome back
- Quit a game and the black screen opens like a camera iris from the slot, the launch animation played in reverse.
#✨ A tidier emulator picker
- Every row the same height, notes never cut off, a smaller title, and a tighter ⋯ menu.
#🩹 Small fixes
- Switch cheats: turn them all off in Freedeck and they're really off in Eden too. No more switching them off or uninstalling them inside Eden.
#🕹️ Steam Deck edition
- Quitting a game opens the screen with the same iris.
- The emulator picker and ⋯ menu get the same tidy new look.
#1.7.9
1.7.9 · PS2 and Switch cheats Tea Premium Clean Fans edition
#🎮 PS2 cheats are here
- Playing PS2 games in ARMSX2 or NetherSX2? The game page now has a Cheats button too!
- Over ten thousand community cheat files, matched to your exact disc; a game's several code lists merge into one, no repeats.
- Names all in English? ✦ Translate still turns them into Chinese in a second.
- Tick and play: turn on Cheats (PNACH) in ARMSX2's in-game menu, or Enable Cheats in NetherSX2's settings.
- ARMSX2: set its data directory to a custom folder in its settings. NetherSX2: tap Allow in the cheats window the first time.
#🎯 Switch cheats (Eden)
- Eden (Nightly too) gets a Cheats button! A cheat database updated daily, with 60 FPS and graphics codes.
- Freedeck reads your exact version straight from the game file (update included) and picks the right codes; codes for another version never kick in.
- On as the game starts, nothing to set in Eden. Tap Allow in the cheats window once and choose Eden.
- A few large games (like Octopath Traveler II) show one tip: in Eden, the game's Properties → CPU backend: Dynarmic. That's all.
- Lemon has cheats built in: use them right in Lemon.
#🕹️ Steam Deck edition
- PCSX2 cheats: tick them on the game page and they're on when the game starts (Freedeck turns on PCSX2's Enable Cheats for you).
- Eden cheats: your game's version is recognized automatically too; tick and play.
#🩹 Small fixes
- Cloud sync: freshly scraped covers and game info no longer get replaced by older results from your drive.
#1.7.8
1.7.8 · NDS cheats + more PC games Tea Premium Clean Fans edition
#🎮 NDS cheats are here
- Playing DS games in melonDS, WatermelonDS or DraStic? The game page now has a Cheats button too!
- Codes are found by the game's name, picking the ones for your copy's region first (a Japanese game gets Japanese codes).
- Nothing found? Try ✦ Find cheats. Names all in English? ✦ Translate turns them into Chinese in a second.
- DraStic: the codes you tick switch on as the game starts (turn on Enable cheats in DraStic's menu → Options).
- melonDS / WatermelonDS: Freedeck puts the codes you tick into
Download/melonDS-cheats.xml. Import it once in melonDS's Settings → Cheats → Import cheats, then tick them in the game menu.
#🖥️ PC games join the library
- GameHub Lite's PC games show up right in the library with their icons; Play opens them (grant its folder once on GameHub Lite's card in Utility).
- GameNative's custom games, plus the Steam / Epic / GOG / Amazon games it exports, are listed too, one tap to Play.
#🏷️ Your own stickers, in bulk
- Drop pictures into
Freedeck/artwork/stickers/<console>/<ROM file name>.pngand your cartridges and discs wear them. - For example
Roms/gba/Pokemon Emerald.gba→stickers/gba/Pokemon Emerald.png; jpg and webp work too. - A custom sticker picked on the game page still comes first.
#🕹️ Steam Deck edition
- melonDS gets cheats too: tick them on the game page and they're on when the game starts, nothing to import (Freedeck turns on melonDS's Enable cheats for you).
- No more doubled top screen on DS: melonDS and RetroArch's melonDS DS both start with a large top screen and the bottom one small on its right.
- A tidier emulator picker: only popular, actively maintained emulators and cores are listed; outdated, duplicate and icon-less ones are tucked away.
#🩹 Small fixes
- Multi-disc games: discs listed by an .m3u in the ROM folder no longer show up as games of their own.
- FinalBurn Neo Plus no longer stays on a black screen in the official RetroArch.
- On wide screens the game page's cartridge or disc stays in one place instead of moving up and down.
- Custom launch's command box is cleaner: the long list of tags is gone.
#1.7.7
[A note from the author] Right after 1.7.6 went out, some players saw the library crash. This release fixes exactly that. Thanks to everyone who sent in their crash logs so quickly. Have fun!
1.7.7 · Crash fix Tea Premium Clean Fans edition
#🩹 No more library crashes
- With lots of games on the device (900+), the same game could show up twice for a moment while the library refreshed, and the library crashed. Now every game shows exactly once, refresh or not.
- Everything new in 1.7.6 stays: Custom launch, ✦ Generate, PSV / NS libraries without stray updates and DLC… update with confidence.
#1.7.6
[A note from the author] This release brings something wild: Custom launch. Any app on your device can now start your games, so every emulator Tea / Coffee doesn't support yet can still start your games with a custom command. Don't know how to write a launch command? Tap ✦ Generate and the AI writes it for you. And one more big one: Freedeck Go lands on the Steam Deck, and your saves travel through your cloud drive — save on the Deck, carry on on your Android handheld. Have fun!
1.7.6 · Custom launch Tea Premium Clean Fans edition
#🚀 The wild one: Custom launch
The emulator picker has a new last row, + Custom launch: any app on your device can start your games, not just the emulators Freedeck knows.
- ✦ Generate: the AI looks at what the app can take, then writes its launch command for you. On the brand-new Linkboy it got a GBA game running first try.
- Try: give it a go, then answer "Did the game start?" when you're back. Yes saves it; if it didn't start, tap Generate again and the AI tries another way.
- Open app only: for apps that won't take a game from outside, Play just opens the app and you pick the game there.
- Emulators Freedeck already supports can be customised too: want PPSSPP or Eden started another way? Write it its own command under Custom launch (RetroArch excepted: Freedeck looks after its cores, save sync and floating button).
- Daijishou and ES-DE fans can paste their launch arguments as they are.
- Commands are saved per app and console, and travel to your other handhelds with sync: set it up once.
- And yes, you can now open a GBA game with bilibili: the AI has it search for gameplay videos of the game 😂 (a browser works too, and finds you a guide).
#🎉 Steam Deck launch
- Same version, same look as on Android: the library, cartridge and disc labels, the launch animation, themes and backgrounds, played with the Deck's controls in Gaming Mode; touch works too.
- With EmuDeck, your ROM folder and emulators are found by themselves; a RetroArch core you don't have says "(installs when picked)": pick it and it downloads.
- L4 + R4 quick menu: press it in a game and the floating button's buttons slide in on the right: Hide, Save, Save+quit, RA menu, Quit. While it's open, nothing leaks into the game.
- Save sync across devices: the Deck and your Android handhelds share one Sync drive; the newest save comes down before a game starts and goes up when you quit. Save states stay with each side (the emulators are different builds that can't load each other's); in-game saves cross over as usual.
- Utility, Download Hub, Cheats (RetroArch, PPSSPP, Azahar, Dolphin) and the AI features are all there; Eden's controls are mapped to the Deck's buttons on its first start.
- Install: in Desktop Mode, download freedeck-go-tea-1.7.6-linux-x64.zip, run
cd ~/Downloads && unzip -o freedeck-go-tea-*-linux-x64.zip && bash freedeck-go/install.shin Konsole, then start Tea from your library's Non-Steam section in Gaming Mode. From then on, Settings → Check for updates does it in one go.
#🕹️ New arcade core: FinalBurn Neo Plus
Arcade games get one more core to pick: FinalBurn Neo Plus, a Chinese-enhanced FBNeo with combo buttons, IPS patches and .ini cheats. Saves, cheats and save sync are shared with FinalBurn Neo.
- It isn't an official RetroArch core, so RetroArch's core downloader doesn't have it: when you pick it, the game page reminds you in yellow to install it yourself first.
- If your RetroArch G comes with it, just pick it.
#🎮 Smoother controls
- Y toggles search: press Y again and the search box closes, keyboard and all. No more mashing Back.
- Hold LT + ↑↓ to page: big library? Jump a whole screen at a time in grid and list.
- Start on a game's page no longer opens Settings by accident.
- Hints show in full: long messages are no longer cut off after two lines.
#☁️ Steadier save sync
- PS2 saves shared across the family: NetherSX2, ARMSX2 and PCSX2 on the Steam Deck read and write the same, newest save. Save on one, carry on on another.
- ARMSX2: the game page tells you which memory card to create (named by the game's serial, like SLUS-21065.ps2) so its saves can sync.
- Taking another device's save no longer gets overwritten by older progress still waiting to upload here.
#🗂️ A tidier library
- No more update, patch and DLC clutter on PSV and NS: updates, patches and DLC sitting on their own in the ROM folder are no longer listed as games (judged by file name on NS; on PSV the game's info is read too), so only playable games show. The files stay put and the emulator still uses them.
#💅 Polish
- Shaders apply reliably: with a shader on, CPU video filters left behind by other tools are switched off, so scanlines no longer come out too fine to see.
- Bezels stay on screen: overlay scale and offsets left behind by other tools are reset, so the bezel shows whole, with no black gaps between it and the picture.
- A Game Boy screen look turns off Gambatte's built-in colorization, for truer colors.
#1.7.5
[A note from the author] This release is a save sync milestone: what started with RetroArch now covers every RetroArch core plus 20-plus standalone emulators across 12 consoles, so you can pick up on another handheld right where you left off. Utility is redesigned too: emulators grouped by console, their status at a glance, and BIOS, cheats and save sync each in their own part of the card. Have fun!
1.7.5 · Save sync for everyone Tea Premium Clean Fans edition
#☁️ Milestone: save sync across the emulators you play
Save on one handheld, carry on on another. Emulators whose saves sync:
Multi-system: RetroArch, RetroArch G (every core: in-game saves and quick saves)
GBA: My Boy! 🆕
NDS: melonDS, WatermelonDS, DraStic
3DS: AzaharPlus, Citra-MMJ, the 天马 pack's Citra
N64: M64Plus FZ / Pro 🆕
GameCube / Wii: Dolphin 🆕, Dolphin MMJR2-VBI
Wii U: Cemu 🆕 (and RetroArch's Cemu core)
Switch: Eden, Eden Nightly, Lemon and Eden forks
PS1: DuckStation 🆕
PS2: ARMSX2, NetherSX2 🆕
PSP: PPSSPP
PS Vita: Vita3K 🆕, Vita3K+ 🆕
Dreamcast: Flycast (current builds, per-game memory card) 🆕
The first time, the emulator's card says what's left to do: tap Allow once, or follow the tip to set its save folder in the emulator (M64Plus on external storage, ARMSX2 on a custom folder).
DuckStation and NetherSX2 keep their saves in a protected system folder: Android 13 and older usually let you allow it; newer Android may not.
The resume save PS2 writes when you quit a game syncs too.
Safer: only the game you played syncs, never another game's saves mixed in.
#🎮 A fresh Utility
- On the left, emulators grouped by console, each with its version and status: Installed (green), Update (blue), Not installed (grey). On the right, every emulator's card; pick one and the cards scroll to it.
- Each card has BIOS, Cheats and Save sync parts, one line each saying where things stand, with the buttons lined up on the right.
- Save sync walks you through it: Allow → log in to your sync drive → Save sync is ready.
- Pack emulators you installed yourself (My Boy!, RetroArch G, Yaba Sanshiro 2, M64Plus FZ Pro, STORM SWITCH, Lime3DS, the 天马 pack's Citra) show up in the list too.
- On narrow handhelds such as the Pocket DMG, a card's icon and buttons share one row, so the text has room.
#🕹️ Smarter arcade cabinets
- More vertical arcade games are recognised (Dogyuun, Battle Bakraid…) and get the green portrait cabinet.
- Customise under a game's cabinet lets you pick the landscape or portrait cabinet yourself, remembered per game and synced through your drive.
#🎮 Steam Deck version: very, very soon
- Freedeck for Steam Deck is on its way and lands very, very soon! Same drive, same saves: carry on between your handheld and your Steam Deck.
#🔧 Smaller improvements
The quick menu is now called the Floating button, in the notification and the Quick Settings tile too.
The round buttons on a game's page show their focus ring flush on their edge, with no gap.
Cloud drive: Download to can pick a custom tab's folder (roms/mame, say).
Lime3DS, if you installed it, can start your 3DS games.
PS1 games in CloneCD format (.ccd + .img + .sub) get a .cue after extraction, so every PS1 core starts them.
Fixed: the old Flycast some packs bundle didn't start games from Freedeck.
Fixed: resetting a shader look could delete a shader preset you wrote yourself.
Fixed: scrolling through the emulator list could crash.
In mainland China, downloads try the mirrors that work right now first.
#1.7.4
[A note from the author] This release is for PC and Switch players: PC games in DroidDeck now start from Freedeck in one go, Switch gets Lemon, an emulator with cheats built in, and Eden and Lemon saves now sync through your drive. Game page videos can also wait until you tap play. Vertical arcade games also get a fresh green cabinet. Have fun!
1.7.4 · PC and Switch Tea Premium Clean Fans edition
#🖥️ Play straight into DroidDeck
- Pick DroidDeck for a PC game and Play opens the game itself, no hunting for it inside DroidDeck.
- Any game folder you've added in DroidDeck starts this way: tap Allow once on DroidDeck's card in Utility (or on the game's page).
- Sync DroidDeck's game files to a folder (its Frontend files option; any name, best inside your ROM folder) and its Steam, Epic and GOG games show up in the PC tab too; one you already have is merged, never listed twice.
#🍋 A new Switch emulator: Lemon
- Download Lemon in Utility: built on Eden, with cheats built in (download and toggle them in the game), plus savestates and gamepad hotkeys.
- Eden is still recommended; for cheats, switch the game's Emulator to Lemon.
#☁️ Switch save sync
- Eden and Lemon saves now sync through your drive: tap Allow save access once on the emulator's card in Utility.
- The two share saves: play in Eden on one device and carry on in Lemon on another, or switch emulators on the same device.
- NSP and XCI files with no game ID in their name are recognised too.
#🕹️ A new cabinet for vertical arcade games
- Vertical arcade games such as 1943 Mark II now have their own green cabinet, with gameplay filling the portrait CRT. Find it in the carousel, game page and launch animation.
#🔧 Smaller improvements
- Some PSP CSO files couldn't be read before; they now are, so their cheats and XMB previews work.
- With the game page video turned off, a video button sits top right on the game's page (when it has a video): it plays only when you tap it.
- Fixed: on Android 11 and older, a big library showed a "last run failed" report at every start, and its box art couldn't be matched again.
#1.7.3
[A note from the author] This release upgrades the service behind the AI features from end to end: game descriptions, Find art and Rename are several times faster, and connecting works better on patchy networks. And arcade fans get what they asked for, an emulator per folder: give every game in your MAME folder the MAME core in one go, while your FBNeo games stay as they are. Have fun!
1.7.3 · Faster AI Tea Premium Clean Fans edition
#✨ Faster, steadier AI
- About: a new game's description is ready in about 5 seconds, where it often took 20 or more. It also sticks more closely to the known facts and what the search finds.
- Find art, the Chinese / English names in Rename, and Find cheats and Translate in Cheats: most answers in 1–3 seconds.
- Steadier connection: the AI service runs on a new route, so home networks that couldn't reach it before mostly work now.
- Supporters who already verified don't need to verify again; just update and go.
#🕹️ An emulator per tab
- Open a game in a custom tab (say MAME, or FC hack), pick an emulator and press Apply to this tab: every game in that tab starts with it, and the games in the main tab (Arcade and so on) stay as they are.
- No more setting a core on dozens of MAME games one by one. An emulator you picked for a single game still comes first.
#🏷️ Game names that feel like yours
- In Settings → Emulator games, "Use file names as game names" is now Use local game names: when on, a game takes its name from ES-DE's game list (gamelist.xml) first, then from its file.
- Arcade games keep their Chinese names with it on: kov2 stays 三国战纪2 instead of turning back into a short code.
#🌈 Smaller improvements
- On the All page, Start switches only between Grid and Carousel, never to a list that seemed to do nothing.
- The emulator picker shows Install in Utility only when none of the listed emulators is installed, and its buttons share one row when they fit, stacking with Done at the bottom only when they don't.
#1.7.2
[A note from the author] This release is mostly for arcade players: over twenty thousand MAME games now have Chinese names, ES-DE's arcade folders can become tabs of their own, and the latest RetroArch G can now run current MAME. I also tidied up a few details: the AI buttons are easier to find, the carousel runs smoother on the Gradient background, and portrait phones can always reach Settings. Have fun!
1.7.2 · Arcade update Tea Premium Clean Fans edition
#🕹️ Arcade: 21,000+ games named
- MAME arcade games you copy in yourself no longer show up as "galaga" or "outrun": over 21,000 of them now have Chinese names (thanks to a player who shared their ES-DE Chinese game list). kov2 shows as 三国战纪2 again.
- Keep arcade games in ES-DE's mame or arcade folders? An Arcade tab for each appears once it holds its first game, so there's no need to move everything into fbneo.
#🎮 Current MAME on RetroArch G
- Recent RetroArch G builds ship current MAME as MAME (Arcade), and it's now in the arcade emulator list too. Tested and it boots fine.
- Cores are listed in recommended order: FinalBurn Neo, MAME 2003-Plus, MAME (Arcade), MAME, MAME 2003, MAME4droid.
#✨ AI buttons easier to find
- Haven't turned on the AI yet? Its buttons now show in place, dimmed: game descriptions, the Chinese / English names in Rename, Find art, and Translate and Find cheats in Cheats. Tap one and it tells you where to turn it on.
- A supporter check that times out now says "Verification timed out; try again in a moment", and a dropped connection says so, instead of always saying the AI is slow.
#🌈 Smaller improvements
- With the Gradient background, the carousel no longer stutters while cartridges float.
- The GBA console art is a new classic yellow model, with its logo and buttons drawn correctly.
- On narrow phones in portrait, the bottom bar scrolls sideways when its buttons don't fit, so Settings is never pushed off screen.
- The game page's note saying where your BIOS goes can now be dismissed for good with the Got it at its end (the emulator's card in Utility still shows it).
#1.7.1
[A note from the author] Lots of feedback came in after the AI landed in 1.7.0, so this release polishes it: Find art finds the right picture more often, game descriptions show up right away, and when the network acts up you're told what's going on. Arcade fans get two new cores to choose from, and melonDS players who keep their saves apart from their games can finally do just that. Have fun, and tell me any time something's off!
1.7.1 · Sharper, faster AI Tea Premium Clean Fans edition
#✨ AI that works better
- Find art finds the right art: the AI gives the game's official English title exactly as published (the "&" in "Dragon Quest I & II HD-2D Remake" included), then tries each name against the art libraries and picks the one that actually finds labels and box art. Games it missed before, like Dragon Quest I & II HD-2D and The House of the Dead 2: Remake, now turn up.
- Faster answers: well-known games no longer need a web search every time, so most answers take well under half a minute, and even slow ones come back within a minute and a half instead of spinning forever.
- Network problems in plain words: when the AI service can't be reached you'll see "Can't reach the AI service; check your connection (or try another network)", and "The AI took too long; try again in a moment" when it's slow, instead of a wall of technical English.
#📖 Game descriptions open instantly
- Open a game page and its About card is there straight away; genre, year and publisher fill in after.
#🕹️ Arcade: two new cores
- Arcade games can now start in RetroArch's MAME (current MAME) and MAME 2003 cores, in both RetroArch and RetroArch G (when your RetroArch G build includes them). ROM packs made for current MAME play straight away with the MAME core.
#💾 melonDS saves wherever you like
- Turned off "save next to ROM" in melonDS or WatermelonDS and picked your own save folder? Pick the same folder under Save folder on its card in Utility, and save sync follows it there, so your games and saves can live apart.
- WatermelonDS's .srm saves sync too.
#1.7.0
[A note from the author] Built-in AI is here! This release puts it all through Tea: it looks up a game and writes you a short piece on its history, gameplay and fun facts, turns English cheats into Chinese with one tap, hunts down cheat files you couldn't find, finds label and box art in one tap, and fills in a game's official Chinese and English names. The AI features are for subscribers: a monthly plan on Bilibili or afdian turns them on (afdian folks, hang on a little: I'm waiting for afdian to give me access), with no token limits. And arcade fans: MAME4droid is now in Utility, with its arcade BIOS set up for you. Have fun, and tell me any time something's off!
1.7.0 · The AI arrives Tea Premium Clean Fans edition
#✨ AI is here (for subscribers)
- Look it up: tap ✨ on a game page and the AI combines the scraped info with a web search into a short piece in three parts: History, Gameplay, Fun facts. With the app in English, it writes in English. Stories are kept on your device, and Show original switches back any time. Games that had no description now get a card too.
- Translate cheats: English cheat names turn into Chinese in one tap.
- Find cheats: when a game shows no cheats (a renamed fan translation, say), tap Find cheats and the AI finds the right cheat file.
- Find art for labels and box art: in Customise, tap Find art. The AI fills in the game's English scrape name, the pictures appear, and one tap puts yours on.
- Official names in Rename: tap Chinese, English or Both at the top right of the rename dialog and the official name fills in.
- Verify under Settings → AI to turn it on. Bilibili charging can be verified now; afdian verification is coming soon.
#🕹️ Arcade: MAME4droid
- MAME4droid joins Utility: current MAME on Android, free and open source, with the widest arcade support, for games FinalBurn Neo can't run.
- The arcade BIOS (neogeo, pgm, qsound and more) downloads by itself. Pick that folder the first time MAME4droid opens, and the card tells you exactly which one.
- Choose MAME4droid in an arcade game's emulator list to start it there.
#🎠 A fresher All tab
- All now has a carousel view too, with the consoles turning past one by one.
- Global collections always come first in All, in the grid and the carousel.
- Consoles whose tab a global collection hides no longer show in All either.
#💾 Little touches
- Real sizes: downloaded and local games show the space they actually take.
- PS Vita: Pack as zip: with Vita3K's storage in its default place, the game page offers Pack as zip, a package Vita3K installs directly, so no more zipping it again yourself.
- Collection carousels no longer flicker or reshuffle their covers, and a global collection no longer covers the console beside it.
- A cleaner 3DS console render.
#1.6.8
[A note from the author] Some of you told me PCE-CD and Game Gear games wouldn't load, so both consoles are here now, and Game Gear even gets its own cartridge shells. They look good enough to make you want to play. Cloud drive can finally hold several drives at once, so you can hop between 百度, 夸克 and your NAS without logging out and back in. Save sync has a few new members too: Dolphin, melonDS, ARMSX2 and Wii U now follow you from one device to the next. If anything gives you trouble or there's something you'd like, let me know any time.
1.6.8 · Game Gear and PC Engine CD arrive, browse all your drives at once Tea Premium Clean Fans edition
#🕹️ Two new consoles: Game Gear and PC Engine CD
- Game Gear: drop games into a
gamegearfolder and play, in RetroArch's Genesis Plus GX or Gearsystem. Every game is a cartridge wearing its original label, in a Black or Clear black shell. Switch it any time under Customise. - PC Engine CD: drop games into a
pcenginecdfolder (a 天马 pack'sPCE-CDworks too) and play in Beetle PCE. The System Card BIOS it needs downloads by itself, so games start straight away, and multi-disc games get a playlist. - Save sync, cheats, box art and Chinese names, and bezels are all there, with brand-new console art on the console tiles. The PC Engine tile is now the classic white console too.
#☁️ Cloud drive: all your drives at once
- Cloud drive has moved into the side menu, right after Library, alongside Downloads and Utility.
- Settings → General → Library drive always shows all four, 天翼, 百度, 夸克 and your home NAS, so log in to as many as you like.
- Each drive is a tab. LB / RB switch between them, and each one remembers its folder and the files you've picked.
#💾 More saves sync
- Dolphin MMJR: GameCube saves, Wii saves and quick saves now sync.
- melonDS / WatermelonDS: the save sitting beside the game syncs by itself.
- ARMSX2: each game's own memory card and quick saves sync, and ARMSX2 is now the recommended PS2 emulator. If something needs setting up, a tip pops up before the game starts.
- Wii U: games start directly now, NUS dumps included in Cemu. RetroArch's Cemu core is a new option, with its saves synced by itself. Wii U games get box art too.
- PS Vita: the system firmware downloads by itself for both Vita3K and RetroArch's Vita3K core, and the core's saves sync by themselves.
#🎮 A fresher game page
- Play, Quick menu and ⋯ sit in one row, all the same height. Bookmark and Beaten have moved into ⋯.
- Games with disc art no longer push the title down: every game's title sits in the same spot.
- While saves sync, the related items in ⋯ show a spinning icon instead of stretching the menu.
- The controller's highlight now sits neatly inside every button.
#✨ Little touches
- Know where you are: move along the carousel and the 35 games count at the top left becomes 2 / 35. Collections count as the games inside them.
- Your tab order: press RT for Jump to, then long-press and drag the tabs into the order you like. It stays that way.
- Smooth D-pad scrolling: holding the D-pad no longer stutters, even with UI sounds on.
- A quieter Quick menu button: two seconds into a game it fades to almost invisible, out of your way.
- Your games keep your names: your own local games show their file names instead of being mistaken for another game.
- Sharper scraping: label stickers only come from games of the right console, and changing a Scrape name now updates the game video too.
- On small screens (1:1 handhelds, say) the global collection editor's buttons no longer fall off the screen.
#☕ Coffee
1.6.8 · Game Gear and PC Engine CD arrive Coffee
The two new consoles, Wii U games starting directly with box art, PS Vita firmware downloading by itself, the fresher game page, drag-to-reorder tabs and smooth D-pad scrolling all come to Coffee too. game titles are tidier as well, with their version shown on its own line.
#1.6.7
[A note from the author] Global collections, as promised last time, are here! Collections used to hold games from a single console. Now one collection can hold PS2, GBA, arcade… all your favourites: "Every Mario", "Must-beat classics", "Weekend games with friends", sorted however you like. In the carousel a collection becomes a slowly spinning ring of covers, so go give it a spin. If there's anything you'd change, let me know. I'm taking the next couple of days off, so there probably won't be an update. Have a great weekend!
1.6.7 · Global collections, every console in one place Tea Premium Clean Fans edition
#🌐 Global collections are here (Beta)
- Collections across consoles: tap New global collection at the top of All, then pick games from any console. Each global collection gets a tab of its own, right after All.
- Easy picking: the editor lists every console down the left, LB / RB to step between them, each showing how many of its games you've picked. Pick all / Pick none does a whole console at once, and consoles you've already picked from come first. All of it works with the controller.
- A tidier tab bar: once every game of a console is in the collection, Hide this tab clears it from the tab bar. Copy a new game for that console onto the device and its tab comes back by itself.
- Global collections only: switch it on in the sort menu (or press LT + X) and the tab bar keeps just All and your global collections, with each collection a big tile in All.
- A spinning ring of covers: in the carousel a global collection is a shelf of staggered covers. As it reaches the middle they fan out into a slowly turning ring of up to 20, each one growing as it comes round to the front.
- Ungroup keeps your games: Ungroup a collection you no longer want and only its tab goes; its games and files stay.
- Press RT for Jump to: global collections are listed at the top, one press away.
#🕒 Recently played
Once you've played something, Recently played appears right after All: every game you've played, the latest first, ready to pick up where you left off.
#🎮 Hold LT for the secret combos
Hold LT and the button hints at the bottom switch to the LT combos (LT + A for Quick launch, LT + X for Global collections only), and switch back when you let go. No more memorising.
#✨ Little touches
- The release notes window is roomier, with the version tabs right beside the title.
- Picking a background picture or a custom label now always opens the system's own picture picker.
- Bookmark and beaten marks in the list are bigger and easier to spot.
#☕ Coffee
1.6.7 · Global collections, every console in one place Coffee
Everything new in Tea above comes to Coffee too: global collections, Recently played and the LT combo hints, every bit of it.
#1.6.6
[A note from the author] This release is almost entirely about smoothness. Some of you told me that on entry-level handhelds like the KPA the grid and list stuttered as they scrolled, and holding the D-pad felt jerky. So I hooked one up to my computer and went through it frame by frame. The biggest culprit turned out to be the background: it was redrawn from scratch on every single frame, keeping the CPU and GPU busy with it alone. Now it's painted once and simply glides along, looking exactly the same at a fraction of the cost; scrolling and finding covers at startup got the same treatment. The less powerful your device, the more you should feel it. If anything still stutters, let me know. And a sneak peek: global collections are on the way, so one collection can hold games from different consoles. Stay tuned!
1.6.6 · Smoother, and made for your handheld Tea Premium Clean Fans edition
#🚀 Silky smooth
- Smoother scrolling: the grid and list glide noticeably better, most of all on small handhelds like the Pocket DMG. The Gradient background still drifts gently, at almost no cost.
- No more stutter holding the D-pad: the selection moves freely across the screen, and once it reaches the top or bottom row the list follows along, one row per press, nice and even.
- Device covers right away: games whose only cover is on your device (ES-DE or Pegasus pack art) used to take almost a minute to show after starting the app. Now they're there the moment it opens.
#🗂️ Collections, polished (Beta)
- In the carousel a collection is a tidy little grid that opens out the instant it reaches the middle, just as discs and cartridges grow there, instead of waiting for the row to stop first.
- Editing a collection lists its games first, so you see what's in it at a glance.
- Switching tabs and back no longer makes the game beside a collection wobble.
- Multi-disc game folders (like
莎木2or生化危机 代号维罗妮卡) no longer turn into collections by mistake: one folder, one game.
#🕹️ No more dark arcade cabinets
When an arcade game's online pictures haven't arrived yet, or fail to load, the cabinet now uses the game pack's own marquee, logo and gameplay shot: the marquee glows and the CRT shows the game.
#🎮 STORM SWITCH joins in
Got STORM SWITCH (the Eden "Storm" build) installed? Pick it as the emulator for your Switch games; it starts them just like Eden.
#💾 See how much space a game takes
- The game page's Storage card now shows This game uses: the real size on your device, every disc and the whole folder included.
- The list view drops its size column, which was always empty, for a cleaner look.
#📱 Small screens, sorted
- On small screens like the Pocket DMG and Pocket Micro, the battery is back in the top-right corner, and Bookmark moves to the left, right beside Search.
- No more long file name under a game's title on its page, and no more cryptic version codes in the carousel's game info.
#☕ Coffee
1.6.6 · Smoother, and made for your handheld Coffee
Everything new in Tea above comes to Coffee too. Plus, catalog games no longer show version dates like v20201226 in the carousel's game info, for a cleaner look.
#1.6.5
[A note from the author] This release's headline is collections. One of you sorted a whole "Hot-Blooded" series into one folder, only to find just one game in it would open, and that convinced me to build collections properly: a folder becomes a collection on its own, and you can also put any games you like together, each with its own look in the grid, the list and the carousel. Collections are in beta: the grouping and saving underneath are solid, and the look and controls will keep improving with your feedback. Tell me what you think.
1.6.5 · Collections are here, and the cover is your call Tea Premium Clean Fans edition
#🗂️ Collections: one folder, a whole series (Beta)
Collections are in beta: the grouping and saving underneath are solid, while the look and the controls are still being fine-tuned. Tell me what you think in the comments.
- Automatic collections: a folder holding several games (like
fc/热血系列/) now shows as one collection, and every game inside opens on its own, instead of just one of them. - Make your own: tap New collection next to the game count, tick games or a whole folder (games you add to that folder later join automatically), give it a name, done.
- Easy on the eye, easy to find: in the grid it's a little mosaic of covers; in the carousel, a row of small cartridges or discs that spreads into a neat grid when selected; in the list, a Collection badge. Collections always come first.
- Change your mind any time: long-press a collection, or press Select, to Edit or Ungroup it. Ungrouped games show on their own again; no files are deleted.
- Shared by Tea and Coffee: both editions on one device see the same collections (not synced between devices yet).
Multi-disc games, and folders with a BIOS or a patch archive beside the game, still count as one game and are never split.
#🖼️ The cover is your call
Custom cover on a game page (Label / cover for cartridge and disc games) now opens a full-screen page; LB / RB switch between Label and Cover:
- Search covers online: ScreenScraper, libretro, and Steam store art for PC games.
- Or pick an Image on device, preview it first, and tap Use when you're happy.
- Your cover shows everywhere: grid, list, carousel and game page. Changed your mind? Reset cover.
#💿 Multi-disc games, any disc you like
- More disc names recognised: games whose files are named
CD1/CD2,盘2,碟2or第2张are now one game with a disc choice. - Pick a disc at Play: for a multi-disc game in RetroArch (with the Quick menu on), Play asks which disc: Continue where you left off loads your quick save as before; Disc 2 starts straight on the second disc.
- Swap disc in game: the Quick menu has a new Swap disc button that lists every disc; tap the one you want. Only swap when the game asks for it, otherwise the game will freeze. The Quick menu's buttons all fit now, so Quit is never pushed out of reach.
#🌏 Every region's BIOS, all at once
When a BIOS is needed, PS1, Saturn and Mega CD now get the Japanese, US and European BIOS in one go, so Japanese games and fan translations no longer fail to start on the wrong region. NetherSX2 / ARMSX2 also get the Japanese and European PS2 BIOS; import them in their BIOS settings.
#☁️ More control over your saves
- The game page's ⋯ menu has a new Upload local saves: confirm, and this device's saves go up as the newest. The drive's previous copy can still be picked in Save history.
- Save history is now a neat table: time, device and emulator version at a glance, the newest marked Newest, and Pick to switch back.
#🐞 Fixes and small things
- GBA games in RetroArch with Run-Ahead (input-lag reduction) turned on didn't write their saves; they now run in a safer mode and save normally.
- Opening a game page now always selects Play (or Download for a game you don't have yet), so A gets you going.
- Using the touchscreen tucks the bottom button hints away; press any controller button and they're back. The hint bar also has a subtle outline, so it reads over busy backgrounds.
#☕ Coffee
1.6.5 · Collections are here, and the cover is your call Coffee
Everything new in Tea above comes to Coffee as well, except the save-sync features (Upload local saves and Save history). Plus:
#☕ Just for Coffee
- Custom cover can also go straight back to the catalog cover.
- The login reminder next to the game count is shorter ("Log in to a drive for more games"), with New collection right before it, easy to spot.
#1.6.4
[A note from the author] Nearly everything in this release came from your comments. Some of you said Play on a PC game still meant hunting for it again in another app; one friend's DS games wouldn't open in Tea but ran fine from 天马; another worried that hard-won progress was being overwritten by the cloud. I read every one of them, fixed what could be fixed, and made a few things better along the way: box art, for one, now downloads once and stays on your device, so a new tile shape, UI scale or game page never makes you wait for it again. Thank you for taking the time to tell me where it rubs. This app is something we're shaping together.
1.6.4 · PC games, one tap away Tea Premium Clean Fans edition
#🎮 Straight into PC games: GameNative & GameHub Lite
Play used to only open GameNative or GameHub Lite, and you had to find the game all over again in there. Now Tea takes you straight into the game:
- GameNative: add the game's folder in GameNative once, and from then on Play in Tea starts the game, whether GameNative is open or not.
- GameHub Lite: tap Allow once on a game page and Use this folder on the page that opens. Tea then recognises every game you've added in GameHub Lite, and any you add later, and Play goes straight in. Rather not grant access? Copy the Local Game ID on the game's page in GameHub Lite and come back to Tea: same result.
For a game not added in either app yet, the game page tells you what to do next.
#🕒 Save history, always at hand
The game page's ⋯ menu now has Save history, the same window as tapping "Saves synced": see which device and when each save came from, and switch back to an earlier one in a tap. It opens even for a game not synced on this device yet, so you can bring over your progress from another handheld. While a sync is running it's greyed out for a moment, then ready again.
#🖼️ Box art downloads once, kept for good
Box art is kept on your device after its first download. Switch the tile shape, change the UI scale or open a game page, and Tea uses that copy instead of downloading again, even offline. The game page's background now appears together with the page, no more blank second or two.
The first few times you browse after updating, a few covers may still download once more; after that, they're there for good.
#💡 A tip: close RetroArch properly to keep in-game saves
In RetroArch, saves made inside the game (save points, save crystals and the like) first live only in RetroArch's memory, and are written to the save file when you close the game properly. If you swipe RetroArch away in recent apps, that progress is gone before it's written, and next time the game is back at your previous save, as if the cloud had overwritten it.
Quit with Close Content in RetroArch's menu, or Quit in Tea's quick menu, then come back to Tea and your saves sync safely. Quick saves (save states) aren't affected: they're written to a file the moment you make them.
#🔧 Fixes
- Some older DraStic builds said "无法打开游戏" (couldn't open the game) when Tea started an NDS game; they now start. If a newer DraStic hasn't been given the game's folder yet, the game page tells you which folder to add in DraStic.
- With a tab's own background set, opening a game page flashed the global background for a moment; it now stays put.
- Some 3DS, NDS, PS1, PS2, MD and FC covers were stretched out of shape in the grid; they now keep their real proportions and fill the tile.
#1.6.3
[A note from the author] This release is about care. Handhelds come in every size, and so do our eyes: some of you squint for buttons on a 3.5" screen, some watch a lonely cartridge in the middle of an 11" tablet, and some hold the screen at arm's length to read it. Now the size of the interface and the cartridges is yours to set, wherever it's most comfortable for you. And the background per console I promised last time is here too. Play easy, see clearly.
1.6.3 · Easy on the eyes Tea Premium Clean Fans edition
#🔍 UI scale & cartridge size
Settings → Interface → Scale has two 10-step sliders:
- UI scale (80% – 125%): buttons, text and cards grow or shrink together. Tired eyes or a small screen? Go bigger. A big screen? Go smaller and fit more in. It stops growing where the screen runs out of room: the toolbar tucks some buttons away and the grid drops a column, so nothing ever gets crammed.
- Cartridge size (64% – 145%): make the carousel's middle cartridge, disc or UMD as big as you like. It never runs into the toolbar or the game's name, and always keeps its distance from the games beside it.
Step them with left / right on your controller. They're saved on this device only and never synced.
#🖼️ A background for every tab
Every library tab can have its own background: a neon sunset for PS2, a gaming desk for PC, your favourite handheld poster for GBA. Switch tabs and the background follows. Tabs without their own keep the global one.
#🎛️ Long-press Customise, all in one place
Long-press an empty spot in the library and the new Customise panel puts everything together, no more digging:
- Theme colours: switch between Light and Dark in one tap; Customise opens the full themes page.
- Background texture: Dots / PS shapes / Gradient.
- Background picture: Everywhere or This tab; tap the chosen one again to pick another picture.
- Scale: the UI scale and cartridge size sliders. While you move cartridge size the panel turns see-through, so you watch the middle cartridge grow and shrink.
#🔧 Fixes
- After flipping through several games with LB / RB on a game page, B jumped the carousel back to the game you first opened; it now stays on the last one you looked at.
- .cdi games you copied into the Dreamcast folder didn't show up; they're now listed and launch, and .gdi games no longer show ".gdi" in their names.
- The light at the top of the gradient background jumped at the end of each loop; it now flows smoothly all the way.
#1.6.2
[A note from the author] This release is about making Tea feel like yours: backgrounds and wallpapers can be any picture you like, a long press away. Along the way come WatermelonDS and the 16:10 tablet bezels you asked for. A background per console is coming next; keep the requests coming.
1.6.2 · A fresh backdrop Tea Premium Clean Fans edition
#🎨 Backgrounds your way
Settings → Interface → Background has four choices:
- Dots: the familiar classic.
- PS shapes: faint △ ○ × □ across the screen; you know which controller.
- Gradient: made from your current colours, with a big wave drifting slowly left to right; light and dark each get their own.
- Image: any picture on your device as the whole app's background. For now one picture covers every screen; a background per console is on the way.
Long-press an empty spot in the library and a Customise menu pops up: jump straight to Theme colours or Background, no digging through Settings. The top toolbar now fades into the background too.
#🖼️ Game page wallpapers
The ⋯ next to Play on the game page now has Change wallpaper: pick a picture for this game, or set one for every game of that console (all your GBA games, say). It's centred and cropped to fill the page, and a game's own picture wins over its console's.
To keep the buttons tidy, Scrape again, Change wallpaper and Delete game now live in the ⋯ menu; Bookmark and Beaten stay where they were.
#🍉 New emulator: WatermelonDS
Utility adds WatermelonDS, a supercharged melonDS:
- RetroAchievements, and achievements unlocked offline are submitted once you're back online.
- Vulkan rendering and RetroArch shader presets.
- External displays: play on the big screen, keep touch on the handheld.
- Installs alongside melonDS and starts games straight from the game page; the DS BIOS is set up just like melonDS's.
#🖥️ Bezels made for 16:10
Utility → Bezels adds a full set drawn for 16:10 screens (Lenovo Legion Y700 and other tablets): nearly 30 frames for GB, GBA, NES, SNES, Mega Drive, PS1, N64, Dreamcast, arcade and more, listed first on 16:10 devices.
#📜 Release notes, easier to read
The release notes window is bigger and has tabs for the 3 versions before this one. When an update is found, the latest notes are saved on your device, so they open instantly, even on a slow network.
#🔧 Fixes
- After editing a custom theme, long-pressing the background no longer failed to open the themes page.
- On a few devices the system cut an update off mid-install ("Session destroyed"); Tea now carries on in the system installer.
#1.6.1
[A note from the author] Half of 1.6.1 comes from your feedback: the RetroArch your handheld came with and the one on your phone finally share saves, and saves after Save+quit are safer. The other half is about less fuss: missing BIOS files fetch themselves, scraping can be paused or turned off, and swiping the carousel feels a lot better.
1.6.1 · Shared saves, BIOS sorted Tea Premium Clean Fans edition
#💾 Two RetroArch builds, one set of in-game saves (Beta)
The RetroArch built into your handheld (RetroArch G) and the official RetroArch from Utility used to keep separate saves. Now in-game saves (battery saves) sync between them: finish on the handheld, carry on on your phone.
- Use the same core on both (mGBA for GBA on both, for example).
- Save states still stay with each build: different RetroArch versions can't read each other's.
- If both already had their own save, you pick the one to keep, and the other isn't lost (it's kept as
.freedeck-bak).
#💡 Why are save states so hard to sync?
An in-game save is just a small battery save in a simple format, which is why it can be shared between the two RetroArch builds. A save state is different: it's a full snapshot of the whole console at one instant, with its CPU, memory and graphics all in it. If any of these don't match, loading fails or drops you back at the boot screen:
- Emulator version: RetroArch and its cores can change the save-state format with any update, and newer RetroArch compresses save states in a way older builds can't read.
- BIOS: a save state is often taken while the game is waiting inside the BIOS, and it won't load under a different BIOS (exactly what happened with GBA before this version).
- Game file and settings: a different ROM version or different core options can make the snapshot mismatch too.
That's why this can only really be done by a frontend. A plain folder-sync tool copies files as they are, with no idea which game they belong to, which emulator and core made them, or when a game starts and ends. Tea is the one starting your games: before a game starts it brings the newest save down, puts the same BIOS in place, converts a newer RetroArch's save states into a format your build can read, and makes the newest one the state that loads; the moment the game ends, it sends that save up.
#🛡️ Safer saves
- The save at the moment your game ends is the one that goes up: even on a slow network, with the upload not started yet, nothing that touches the file afterwards can push it out.
- Save+quit or Quit in the Quick menu now starts syncing straight away, without waiting to get back to Tea, and the Quick menu closes with the game.
- Choosing Use the other device's in a save conflict now syncs at once, instead of sitting on "Waiting to sync saves".
#🧩 BIOS sorted for you
Open a game's page or press Play, and any missing BIOS downloads by itself, from mainland China too:
- RetroArch: PS1 (SwanStation, Beetle PSX), Mega CD, 3DO, PC Engine CD, Lynx, Famicom Disk System, plus the BIOS the GBA, PS1 (PCSX ReARMed), DS and Dreamcast cores use.
- GBA save states now load on your other device: before, a device with a BIOS and one without meant loading a state took you back to the boot screen. Now every device uses the same BIOS.
- DuckStation, NetherSX2, ARMSX2, melonDS: Tea can't put files into these emulators' BIOS folders, so the BIOS downloads to Freedeck/bios. Utility and the game page tell you where it is and how to import it in the emulator (just once).
#🏷️ Scraping, your way
- Pause 1 hour: a new button next to the scraping progress gives your network or battery a break. Scraping resumes by itself an hour later, or tap Resume any time.
- Settings → Emulator games → Scrape labels: turn it off and no more labels are scraped; cartridges and discs show the box art instead. Labels you already have stay, and box art is still scraped.
#👆 Smoother carousel swiping
A light swipe now goes to the next game instead of springing back, and a hard flick no longer skips two. When it stops, the cartridge eases into place, which you'll notice most on big tablets.
#1.6.0
[A note from the author] 1.5.9 sent your RetroArch saves along with you; 1.6.0 brings the standalone emulators too. PPSSPP, 3DS and DraStic now carry on between the Pocket FIT and the Pocket DMG. There's also Save history, so a save you overwrote by accident can come back. Save sync is still Beta, so keep the feedback coming!
1.6.0 · Standalone emulators join save sync Tea Premium Clean Fans edition
#💾 Save sync: standalone emulators (Beta)
Not just RetroArch: these standalone emulators' saves now travel with your cloud drive too:
- PPSSPP: in-game saves + save state slot 1. CHD and similar games are recognised after you've played them once.
- Azahar / Citra MMJ (3DS): in-game saves + save state slot 00.
- DraStic (NDS): in-game saves + every save state slot.
Same as before: finish on one device, quit the emulator properly, wait a moment back in Tea for the saves to go up, then pick up the other.
DraStic tip: newer DraStic asks for a folder the first time it opens. Pick Internal storage › DraStic and Tea finds it on its own (and if you pick another folder, Tea finds that too).
#🕰️ Save history
On the game page, Saves synced is now underlined. Tap it to open Save history: the last 3 syncs, with the device, the time and the emulator version.
Pick one to put it in place of this device's saves. The ones it replaces are kept as .freedeck-bak, and after your next game it goes up as the newest.
#🎮 A fresh game page
- The cartridge flies in: open a game from the carousel and its cartridge flies from the carousel to its spot on the page while the background and buttons fade in. Back sends it flying home.
- Buttons rearranged: first row Play, Bookmark, Beaten, Find cover again, Delete; second row emulator, Cheats, Quick menu. The "⋯" menu is gone: everything is one press away.
- Cheats: the number turned on shows as a small badge on the corner (9+ past nine).
- A small arrow at the bottom of the page reminds you there's more game info below.
#🖼️ Tile shape
Settings → Interface → Tile shape: Default (wide), Square or Rectangle (game box). Console box art is no longer cut into a strip, and square and box tiles fit a few more games per row.
#✨ Also new
- Long-press an empty spot in the library to jump straight to the theme settings.
- Sleep no longer counts as play time: turn the screen off mid-game and the sleep isn't added.
- Faster sync: saves go up first, and 百度 SVIP uploads several files at once.
#⚠️ Beta notes
- Always quit the emulator properly. If you leave with Home and it keeps running in the background, it won't read newer saves.
- Use the same game file on both devices where you can.
- Save history starts with this version: earlier syncs aren't in it.
- Devices still on 1.5.9 keep syncing, but don't see Save history.
#1.5.9
[A note from the author] Save sync is here! It's the big one Tea has been building toward for several releases: play halfway through on the Pocket FIT, pick up the Pocket DMG and carry on. To get there we tried GBA, FC, Dreamcast and Saturn saves and save states, game by game, on two handhelds. It arrives as a Beta for now. Tell us how it goes!
1.5.9 · Your saves follow you Tea Premium Clean Fans edition
#💾 Headliner: save sync (Beta)
Save on one handheld, keep playing on another. In-game saves and save states travel with your cloud drive.
Turning it on: in Settings, under Sync drive, switch Sync on. Play time, beaten games and saves share that one switch, so there's nothing else to set up.
How it works:
- Play as usual, quit properly: use Save+quit in the Quick menu, or RetroArch's own quit. When you're back in Tea, that session's saves go up automatically.
- Carry on on another device: Tea starts fetching newer saves as soon as you open the game's page, and checks once more when you press Play. The game page shows Syncing saves…, then Saves synced · N min ago.
- Changed on both? An amber line appears on the game page. Tap it and pick Keep this device's or Use the other device's. The other copy isn't deleted: it's kept on this device as
.freedeck-bak.
What syncs:
- In-game saves (
.srmand friends), plus the auto save state and slot 0. - Saves are kept by emulator → core → game: RetroArch and RetroArch G each keep their own, and switching cores never overwrites anything.
- Dreamcast: each game gets its own memory card, instead of every save crammed onto one.
- PSP (PPSSPP core): the game's save folders on the memory stick sync too.
- Saturn: the cartridge setting is set to Auto Detect everywhere, so save states from another device load.
- Save states from a newer RetroArch, which older RetroArch can't read, are converted automatically when they come down.
- Files up to 64 MB each, so Dreamcast and PSP save states fit.
#⚠️ Beta notes (current limits)
- RetroArch and RetroArch G only. Standalone emulators (PPSSPP, DuckStation, NetherSX2 and others) don't sync yet.
- Always quit properly: leaving with Home or swiping RetroArch away saves nothing. The Quick menu's Quit keeps only the in-game save; to keep a save state, use Save+quit.
- It has to be "the same game" on both devices: ideally the same file with the same name. Games whose files are just numbers (like
004.chd) aren't recognised. The easy fix is to copy the same file across. - Only the auto save state and slot 0 sync. Other slots stay on the device.
- Save states work best with the same RetroArch and core on both devices. If the versions are far apart, a save state may not load; in-game saves are the safest.
- Saves go up when you're back in Tea. Finish on one device, return to Tea for a moment, then pick up the other.
#🔜 What's next
- Save sync for standalone emulators, starting with PPSSPP.
- More real-device testing: PSP, conflicts, RetroArch G.
- Matching the same game even when the names differ.
#⏯️ Load the quick save at start
Settings → Emulator games → "Save on exit, resume next time" is now "Load the quick save at start": turn it on and a game starts from its newest save state, including the one Save+quit wrote. Whether RetroArch saves automatically when you quit is now up to RetroArch's own Auto Save State.
#✨ Also new
- Saturn BIOS downloads itself: before a Saturn game starts, any missing BIOS is fetched for you. No more black screens.
- PPSSPP core fonts download themselves: no more missing text in PSP games.
- A smarter Quick menu mug: it only appears when RetroArch can answer it, and stays away on builds or cores that can't.
- RetroArch G fixed: games with a bezel no longer play sound with no picture in RetroArch G.
- Library sort is remembered: your chosen sort is still there next time you open Tea (this device only, never synced).
- Settings no longer sync between devices: theme, button layout and the rest stay on each handheld; sync is just for game records and saves.
#1.5.8
[A note from the author] Save sync is getting closer! Before saves can sync, everyone's saves have to work the same way: when you leave a game properly, RetroArch writes everything down. This release's floating button and Save on exit pave the way. And 中登95's 16:9 reflective frames are here for Pocket FIT and every other 16:9 handheld — enjoy!
1.5.8 · Save in one tap, leave in style Tea Premium Clean Fans edition
#☕ Headliner: a floating button in your games
A little half-transparent mug now sits in the bottom right corner of RetroArch games. Tap it for the Quick menu:
- Swap bezels and shaders while you play: shaders change instantly; a new bezel reloads the game and keeps your place.
- Save: a save state in one tap.
- Save+quit: save, then quit RetroArch properly and land back in Tea.
- RA menu: RetroArch's own menu.
- Quit: leave without saving.
- Drag the mug anywhere; it snaps to the nearer edge. Long press to hide it until your next game.
Turning it on: flip the Quick menu switch next to the emulator picker on a game's page (or add the Quick menu tile to your Quick Settings), then allow Tea to display over other apps when asked.
It needs RetroArch's universal nightly: the Quick menu talks to RetroArch through its command interface, which only the nightly builds have — the 1.22.2 release doesn't yet. Utility's RetroArch is now that build.
#💾 Save on exit, pick up where you left off
Settings → Emulator games → Save on exit, resume next time: turn it on and RetroArch saves whenever you quit properly; start the same game again and you're right back where you were. Together with Save+quit, every exit saves cleanly — the groundwork for save sync to come.
Tip: leaving with Home, or starting another game straight from Tea, doesn't give RetroArch time to save. To keep your progress, use Save+quit or RetroArch's own quit.
#🔁 After switching to RetroArch's universal nightly
If you had RetroArch's release or Play build, Utility's RetroArch card will ask you to switch:
- In Utility, uninstall the old one, then install the universal nightly.
- Open RetroArch once and allow it access to all files.
- Download your cores again inside RetroArch: Load Core → Download a Core.
- Back in Tea, start games as usual. Your saves and save states are still in the same RetroArch folder, and the bezels and shaders you set up are picked up again automatically when a game starts.
#🪞 中登95's 16:9 reflective frames
中登95's KPA-style shaders come to 16:9 screens! The console's own artwork wraps the sides, and a reflective frame around the picture catches the game's glow, like a real console screen.
- 12 console groups: FC, SFC, MD (with Mega-CD and 32X), PC Engine, PS1, Dreamcast, arcade (CPS, Neo Geo), GBA, GBC, GB, NGP/NGPC and WonderSwan.
- Pick 16:9 reflective · 中登95 in Utility → Shaders or the in-game Quick menu. It brings its own bezel, so you don't need to add one (needs Vulkan).
- Made for the Switch's 720p and laid out again for 1080p, so it's crisp on the Pocket FIT.
- Plus 42 more 16:9 bezels: three Famicoms, SFC, MD / Genesis, PlayStation, 10 GBC colours, 19 GBA DGQ colours, and real-hardware and clear GBAs.
- In the Quick menu, the shaders made for your screen's shape come first.
#🛠️ KPA (3:2) and 4:3 shaders, fixed
- Edge to edge: KPA's GBC, GG, NGPC and VB art no longer leaves black bars.
- The reflective frame tucks under the shell, like a screen set into the console instead of a picture frame.
- Even LCD grids, and GBC no longer shrinks to a small box on the Pocket Micro 2.
- On Adreno devices (such as the Pocket ACE), framed looks that used to fail and leave a stretched picture now show properly.
#✨ Also new
- Eden Nightly (Switch) joins Utility, side by side with the release build.
- Game page video gets its own switch.
- Covers load faster when you change tabs, and scrolling is smoother.
- The focused game in the carousel is a little bigger, and at launch the cartridge, disc or UMD comes up closer before it goes in.
#1.5.7
[A note from the author] Save sync is a big job — thanks for your patience. This release brings custom colour themes, and I've bought the licence for 中国色's colours so you can enjoy them freely. It also fixes lots of scraping bugs and adds support for several emulators you asked for. Thank you for all your feedback!
1.5.7 · Make it your colours! Tea Premium Clean Fans edition
#🎨 Headliner: colour themes
All of Tea can wear new colours now! Go to Settings → Interface → Theme → Colours and tap the light or dark colour button to open the colour page.
- Analogue picks: 12 traditional Chinese colours — Milk, Almond, Butter, Daisy, Tangerine, Crane, Pond, Peach, Rose, Fawn, Violet and Azure — each with a light and a dark version. Every button shows its four colours as sloped stripes, so you can see the look at a glance.
- One tap to switch: the screen closes in and opens back up with Tea in its new colours. Switching between the Light and Dark tabs switches the app's mode too.
- Classic: the familiar Sepia and Charcoal are still here.
- Custom: tap the empty button, give it a name (吾 to start with), and pick a colour each for the page, cards, text and accent. On the right are all 751 traditional Chinese colours of 《色谱》, sorted by hue, each with 11 shades from light to dark. Every pick repaints the whole app straight away; save when you love it. Long press or press X to tweak it later.
- Colour data from 中国色 zhongguose.com, under its commercial licence.
#🔴 A red dot for updates
When a new Tea is out, a small red dot lights up on the ☰ menu button and on Settings, so you never miss an update.
#🎬 Better game videos
- No more stutter: previews used to freeze and then jump ahead; now they play smoothly, and changing the volume no longer stops them.
- PSP videos play: some handhelds couldn't decode the clips inside PSP games; they now play another way. ScreenScraper's sharper videos come first, the ISO's own clip last.
- Chinese file names find their video: games that are already scraped look up their video by ID instead of by English name.
- Translated cartridges get labels too: a fan translation finds its label and video from the original cartridge.
#🕹️ 天马 pack emulators, ready to play
Emulators bundled with 天马 packs now launch your games directly:
- Citra (天马包): 3DS
- Yaba Sanshiro 2: Saturn
- M64Plus FZ Pro: N64
#🏛️ No more black arcade screens
Arcade games not scraped yet now fill their cabinet with the 天马 pack's screenshot, a still from its video and its logo, so the screen and the marquee light up.
#🔋 Easier on the battery while you play
Once a game starts, Tea pauses scraping in the background and leaves all the power to the emulator; it picks up again when you come back.
#🎯 Little fixes
- Opening Custom label no longer freezes while a scrape is running.
#1.5.6
1.5.6 · Dreamcore retro reflections, and your cartridges come alive! Tea Premium Clean Fans edition
#✨ Headliner: 中登95's Dreamcore Retro Reflective Bezels & Shaders
A huge thank-you to 中登95: his whole 梦核复古反射遮罩滤镜 pack now ships built in!
- 39 looks for 18 consoles: made-to-measure for 3:2 screens like the KPA, 4:3 screens (flat or curved) and 16:9 screens, picked to fit your handheld.
- Reflective screen frames: a retro frame with real reflections around the picture, meeting the bezel art perfectly.
- Perfectly even LCD grids: the grid adapts to your screen's resolution, so every pixel cell is the same size — no more uneven stripes.
- FC / SFC get CRT scanlines for that old-TV glow.
- Pick them in Utility, each with a preview. Looks that draw their own frame and bezels make way for each other automatically, so they never stack.
#🎮 Cartridges come alive
The focused cartridge, disc or UMD in the carousel now floats and gently turns — and catches the light from the top left: the highlight slides in from that corner as it turns towards the light and slips back out as it turns away. Not your thing? Switch it off in Settings → Interface → 3D cartridge animation.
#🏠 Your home NAS joins in
- Library and sync both work with a home NAS (SMB file sharing): it finds the NAS on your Wi-Fi, and once you're logged in you browse and download straight from it.
- Pick the Sync drive and Library drive separately: sync to 天翼云盘 and browse your NAS, for example. A drive you're already logged in to is reused with one tap — no second login.
#🗂️ A nicer Library to browse
- List or grid, your call (Start switches), with box art right on the grid tiles.
- The path and Download selected stay pinned on top, and Y searches the folder.
- Box art for Chinese file names too: ~29,000 built-in Chinese–English game names help find the right cover.
#📖 Game descriptions in Chinese
Got a Pegasus pack (天马包)? Its Chinese description now shows on top, with the English one after it. The About card moved to the top of the game page, so it's the first thing you see.
#🕹️ More emulator choices
- New: Dolphin MMJR2-VBI (GameCube / Wii), one tap to install from Utility, with cheats.
- My Boy! (GBA) support: if it's installed, just pick it in the emulator picker.
- RetroArch G (the RetroArch bundled with Pegasus packs) is listed on its own, with only the cores it ships — and its own gold icon.
- A clearer emulator picker: grouped by emulator with one core per row; emulators you haven't installed fold into a single line, so it's no longer long and cramped.
#🎯 Small things, smoother play
- Switching tabs brings you back to the game you had selected — and if that game was deleted, you land right where it was.
- Open Utility with Select from the carousel, change a setting, come back: you're still on the same game.
- Cartridge labels show the cover or the game's name while their label art downloads — no more blank labels.
- GermanTacos bezels are now built in, so their previews no longer spin forever.
- Picking folders is more reliable — no more "Can't use this folder".
#☕ Coffee gets it too
Everything above comes to Coffee as well, except the home NAS and the separate drive picks.
#1.5.5
1.5.5 · Every game has a story, and Settings got a glow-up! Tea Premium Clean Fans edition
#📖 Game info
Open the page of any game on your handheld and its About section now tells you its genre, release year, publisher and developer, plus a short description. It's fetched once and kept, so it opens instantly next time.
#🗂️ A smarter All tab
- Hack collections get their console tile: FC folder empty but all your games in an "FC hacks" custom tab? All still shows the FC tile, counts the custom folder's games too, and opens the tab that has them.
- Android games on the wall: with Android games on, All gets an Android handheld tile right after PC — tap it to jump to the Android tab.
#🔤 Name sort follows the names you see
Name A→Z now sorts by the name on each card: your renames and the Chinese names from Pegasus packs included. Collections with English file names shown under Chinese names (like FC-HD) finally sort properly.
#🚀 Scraping never stalls
- One slow network moment could pause cover and label downloads for hours, so it looked stuck. Now only that one game waits — the rest keep going.
- After updating from 1.5.4, labels come straight back from the old image cache instead of downloading all over again.
#⚙️ A fresh Settings page
- New Interface tab: Theme, UI sounds, A to Play, Android games and Game videos all live here now, so General stays tidy.
- One card per setting: every option has its own card — the explanation on the left, its switch or buttons on the right.
- Clearer cloud drive login: 天翼云盘, 百度网盘 and 夸克网盘 side by side — tap the one you use. Once logged in, only that drive shows: the Sync switch on top, Sync now and Log out on the right, and Log out asks before it does.
- One drive at a time: sync keeps its data on the drive you're logged in to, so switching drives often will cause sync problems — best to stick with one.
#☕ Coffee gets it too
Everything above comes to Coffee as well (except the cloud drive login). Plus, with its big catalog, All's console tiles now show up in about a second — no more staring at "0 platforms" for 10+ seconds.
#1.5.4
1.5.4 · One cloud drive, every handheld in sync! Tea Premium Clean Fans edition
#☁️ Cloud sync: pick up where you left off on any handheld
Log in to 天翼云盘, 百度网盘 or 夸克网盘 and Tea quietly keeps your game profile in your own cloud drive, shared by all your handhelds:
- Play time and completions: hours played and games beaten show up on every device, along with play time from your other handhelds.
- Covers and labels: box art and cartridge labels scraped on one handheld are ready on the next — no scraping twice.
- Your setup: Bookmarks, renames, custom labels (images included), cartridge looks, cheat picks and preferences all come along.
- Always in view: the little cloud in the menu shows sync status — tap it to sync now — and a cloud mark on each game tells you it's synced.
Tea syncs when it opens, when you come back to it, and after you play. It only uses your own drive space — still Premium Clean.
#🖼️ Full-screen artwork
Tap the cartridge or cover on a game's page to see its label and the whole box art full screen: pinch to zoom, drag to look closer, LB / RB to switch between label and cover.
#🎬 Game pages come alive
Games with a video now play it behind their page as soon as you open it (muted, once through), then settle back on the cover.
#🎨 Smarter "Prefer frontend artwork"
- Turned on, grid and list views show the pictures already on your device first: ES-DE's or a Pegasus pack's, and images beside the ROM.
- Cartridge and disc views aren't affected: labels still prefer the most accurate label scan. Some games (like Fire Emblem on 3DS) used to lose their right label with the switch on — fixed.
#⚠️ Tea and Coffee both installed? Please read
Both editions share one record of covers and labels. Until now, Coffee left running in the background couldn't see covers you'd just scraped in Tea, and wrote its own old ones over your changes. One player picked covers by hand, closed and reopened Tea, and found them all turned back into Coffee's.
This update fixes it:
- Each app reads the other's latest changes when you come back to it, so they no longer overwrite each other.
- With both installed, Tea looks after artwork: Coffee shows the shared covers, and scraping, custom labels and cartridge looks happen in Tea.
Please:
- Update both Tea and Coffee to 1.5.4. An older Coffee can still overwrite Tea's changes.
- While you use Tea, close Coffee completely: swipe it away in recent apps, so it isn't left running in the background.
- Covers that were already overwritten can't be brought back — scrape them again in Tea once you've updated, and they'll stay put.
#🎮 Smoother with a controller
- B on any tab goes back to All; B on All opens the menu.
- Downloaded games no longer wear a green ✓, so covers stay clean.
#✨ A little polish
- More PS Vita games just work: older Mai dumps without a mai_moe folder (like Akiba's Trip 2) now install into Vita3K, and updates and DLC are never mistaken for the game itself.
- Bookmarks are never lost to a change made in the other edition.
- Cartridge labels are saved as small images right after scraping, ready even offline.
- The Download Hub shows a loading row while a folder opens, and the "Freedeck Sync" folder in your drive is shown but never opened or downloaded.
#1.5.3
1.5.3 · Your cloud drive is now your game library! Tea Premium Clean Fans edition
#☁️ Download Hub: straight from your own cloud drive
Got a pile of games in your own cloud drive? No more downloading to a computer and copying across. Log in to 天翼云盘, 百度网盘 or 夸克网盘 and the Download Hub becomes a browser for your own files:
- Browse folders: A opens a folder or picks a file, B goes up, X picks everything, Y refreshes.
- Grab several at once: pick your games, press Start (or tap Download), choose a console, and they land in its ROM folder. Archives are unpacked, and split volumes become one game.
- It guesses the console: pick .gba files and the picker is already on GBA; consoles are listed A–Z with their folders.
- Progress at a glance: every file shows its progress, ✕ cancels, and View downloads in the start message jumps to Downloads.
Not logged in yet? Tap Choose a drive to log in right in the Download Hub, pick a drive and scan the code. Only your own files, no shared links — still Premium Clean.
#📥 Downloads is back
Downloads returns to the menu: pause, resume and clear your drive downloads in one place, each labelled with its drive.
#🔑 Cloud drive in Settings
Settings → General has a new cloud-drive card: one drive at a time, and logging in to another logs the first out. It says what it's for — downloading your own games, with play time / completion sync and game-save sync coming soon!
#🎮 Smoother with a controller
- Focus never gets lost: the menu opens on the page you're on; closing it, switching tabs, or opening Settings or Utility lands on the first control, ready for the D-pad.
- Swipes keep up: after a touch swipe in the carousel, focus and the video preview follow the game in the middle.
- Cleaner long press: a quick A no longer flashes the hold ripple, and opening details by holding gives a gentle rumble.
#✨ A little polish
- The app calls itself just Tea or Coffee — download notifications too.
- A download whose server can't be reached retries twice, picking up where it left off.
#1.5.2
1.5.2 · Cheats are here! Coffee / Tea Premium Clean Fans edition
#🪄 Give old favourites a new twist
Infinite lives, extra time, or smoother graphics? Choose a supported emulator or core on the game page, then tap Cheats beside it to explore the codes available for your game.
- Toggle and save: changes save immediately and apply the next time you press Play. The game page shows how many codes are enabled.
- Find your codes: match online databases, search, choose file variants or import compatible files. Saved codes work offline, and Coffee and Tea share your choices.
- Spot supported cores: the emulator picker labels cores with cheat support; selecting one reveals the Cheats button.
#🎮 Beyond RetroArch
PPSSPP (PSP), Azahar (3DS) and Dolphin (GameCube / Wii) join in! Choose the emulator’s data folder once, then pick and apply codes from the game page.
- Easier folder setup: choose Azahar’s or PPSSPP’s parent folder to find User / PSP automatically. For Dolphin, use “Dolphin Emulator” in the system folder picker’s sidebar. Utility cards show the destination and offer folder setup and reset.
- More code sources: an extra frame-rate and graphics collection for 3DS, plus a backup GC / Wii archive. Wii WBFS identification is supported, with three included codes for Japanese Ikaruga too.
#🕹️ Supported RetroArch consoles and cores
- FC / NES: FCEUmm, Nestopia UE, Mesen; SFC / SNES: Snes9x, Snes9x 2010.
- GB / GBC: Gambatte, Gearboy, mGBA; GBA: mGBA, VBA-M.
- Mega Drive / Mega-CD: Genesis Plus GX, PicoDrive; Saturn: YabaSanshiro, Beetle Saturn.
- PS1: PCSX ReARMed, Beetle PSX HW; N64: Mupen64Plus-Next; NDS: melonDS DS.
- Neo Geo / CPS arcade: FinalBurn Neo.
- PC Engine: Beetle PCE Fast; WonderSwan / Color: Beetle WonderSwan (RAM codes only, with limited database coverage and compatible-file import).
Code availability varies by game. Match your region and update; translations and hacks may be incompatible. To restore previous files and settings, reset cheats from the emulator’s card in Utility.
#🌏 Coming next: AI translation
English code descriptions hard to follow? AI translation of cheat descriptions into Chinese is coming in a future update!
#🎬 Pause to preview
Focus a library game to start a background preview after the idle delay (1 second by default), or show buffering while it loads. Sound is off by default, with gentle fades. Tabs, controls and hints stay visible; the selected game remains opaque while other games become translucent. Existing ES-DE / Pegasus clips come first; PSP can also play its embedded XMB menu animation without unpacking the whole game. If neither is available, ScreenScraper waits for artwork scraping to finish before matching an online clip. “Buffering video...” appears at the top right while it loads; online clips use a temporary cache. TV, arcade and PC clips have subtly dimmed CRT scanlines; handhelds keep their original picture. Settings → General → Game videos offers on/off, 1s/2s/3s delays, looping (on by default), and Sound (off by default). Any button or touch fades back to browsing. Video availability varies by game.
#👆 Play your way
Prefer one tap to Play? Enable A to Play in Settings → General: A / tap plays, LT + A opens details. Turn it off to reverse them. Long press always opens details, with a timed ripple while video previews pause. The battery popup keeps its control hints in sync.
#✨ A little polish
Quicker video previews: carousel movement no longer restarts the idle delay, local clips are found during it, and online lookup shows buffering feedback.
A louder opening sound for the R2 tab picker.
Console counts in All now match their tabs, counting multi-disc games once.
Smaller GameCube discs; PSP and PC Engine media turn half a circle as they lift, then insert downwards.
A better-balanced gamepad mug launcher icon, and a clearer classic mug in the dark-mode icon picker.
Fixed “Cannot automatically move…” errors when Utility updates apps on an SD card formatted as internal storage.
#1.5.1
FreeDeck Go 1.5.1 · Premium Clean Fans edition
#🎮 Another way to play 3DS
- Citra-MMJ joins Utility and the setup wizard. Install it, then try it from a 3DS game's emulator picker. Some games may run better on lower-end devices; updates are infrequent and compatibility varies by game. AzaharPlus remains recommended.
.ciagames open the emulator so you can install them there first, then play from its game list.
#🕹️ PGM arcade, with less setup
- Open an IGS PGM game page, such as Knights of Valour or Oriental Legend, or press Play, and the missing
pgm.zipBIOS is fetched automatically beside the game.
#✨ Smoother refreshes
- PS Vita games such as Muramasa now find their game folder inside extra archive folders and launch correctly.
- Tea: Deleting a game now returns you to the library, without leaving a Download button on its page.
- Fixed library pull-to-refresh getting interrupted mid-gesture, and refresh messages disappearing too quickly.
- Controller combos in the battery popup are clearer in Dark mode and match the button hints below.
#1.5.0
#🌙 A darker look for late-night play
- Try the new Dark theme in Settings → General → Theme: matte greys, warm orange accents, and the familiar dotted background.
- Pick Default, Dark, or Follow system. Change it manually and a black iris closes on your chosen button, then opens onto the new look.
- Settings buttons, options, and switches now have clear controller-focus outlines that follow each control's edge.
#🕹️ Slide it in, hear it clearly
- Press Play and cartridges and discs slide into the screen's edge like a slot: cartridges pause before pushing home, Switch / PS Vita / DS / 3DS cards press in and spring back, and discs and UMDs start spinning at the slot.
- Removed the overlapping Play-button click so the growing, cartridge-insertion, and disc-spin sounds come through clearly.
#📱 More Android games in view
- The app drawer now shows the two editions as Coffee and Tea, easy to tell apart.
- The Android game picker is more compact, with extra columns on wider screens. See more apps at once and select or deselect them with ease.
- Tap the battery at the library's top right for controller shortcuts and a fast-scroll tip: grab the slider on the right of the grid or list and drag.
#🎨 Console tiles and credits
- Library console tiles now pair translucent backgrounds with hardware pictures, without the cover mosaics.
- Settings → About now brings together artwork, bezel, shader, and community credits, with copyright details for the original cartridge and console artwork.
#1.4.9
#🏎️ Fast scroll: thousands of games, one drag away
- The library's grid and list now have a scrollbar on the right: grab it and fly through thousands of games in a second.
- While you drag, a bubble tells you where you are: the first letter when sorted by name (pinyin initials for Chinese titles), the size when sorted by size, the date in Recently played — so you can stop right on the game you want.
#🕹️ Click it in
- Press Play and your cartridge or disc no longer flies off the screen — it slides into the screen's edge like a real slot: cartridges stop halfway then push home, Switch / PS Vita / DS / 3DS cards press in and spring back with a click, and discs and UMDs start spinning only as they reach the slot, sinking in slowly as they spin.
- Each kind of media has its own sound, and Mega-CD and 3DO games now show as discs.
#🏷️ Use file names as game names
- New in Settings → Emulator games: "Use file names as game names" shows emulator games on the device by their ROM file names, just as you named them.
- Display only — scraping and search work as before, and any name you set yourself still wins.
#🎨 Easier label picking
- The custom label page has a bigger preview and a result list only as wide as it needs; on narrow screens the search box sits under the preview.
- Fixed FC / 小霸王 cartridges sometimes wearing a sideways NES label: with no Japanese label, they now use the box art.
#🖥️ Also
- PC games now recommend GameNative first on the game page, matching the setup wizard.
#1.4.8
#🐴 Pegasus packs, ready to play
- FreeDeck now reads Pegasus (天马) game packs: numbered ROMs (
001.chd,ikaruga.zip) show their real names — Castlevania: Symphony of the Night, Ikaruga… - The pack's own covers are used straight away, so thousands of games light up at once.
- Collection folders like
FC hack,MD hackandFBNEO ACT Vbecome custom tabs automatically, named after the folder — delete any you don't want. - "Prefer ES-DE artwork" is now "Prefer frontend artwork (ES-DE / Pegasus)" and uses both.
- The community Pegasus pack's whole bezel set is built in: GBA SP, 22 GBA and 22 GBC colour frames, retro TV frames for FC, SFC, PS1, Saturn, DC, N64, PCE and more, Game Gear, NGPC, WonderSwan and Pokémon mini shells, plus arcade, NAOMI and vertical-game frames and a whole 3:2 set for small screens like the Pocket Micro 2 — each offered on screens that suit it; plus a Remake DMG frame and two vertical frames, on any device.
#✏️ Name it your way
- Tap ✎ next to a game's title to rename it, then re-scrape by the new name in one go.
- Custom labels now have a scrape name with live search across ScreenScraper labels and libretro covers — pick one and use it.
- New "Recently played" sort puts what you just played first.
#🛠️ Smoother and steadier
- Fixed RetroArch sometimes opening to a black screen: it now restarts cleanly when you switch games (Android 13 and below).
- Bezels no longer land in the top-left corner on older bundled RetroArch builds (1.19 and earlier).
- New in Utility: Vita3K+ (an experimental PS Vita fork), and install conflicts now name the app in the way and how to remove it.
- New handheld? Copy the Freedeck folder over with your ROMs — even when the new SD card has another name, ROM folders, custom tabs and covers line up again by themselves, no setup or re-scraping.
- PS1 now recommends RetroArch's PCSX ReARMed core: smooth on low-end handhelds and no BIOS needed (prefer DuckStation? pick it once on the game page).
- Fixed a rare out-of-memory crash with very big libraries.
- Downloaded covers no longer show up in your gallery.
- The first scan of a big ROM folder no longer maxes out the CPU, and when the scraping server is busy the library says so, with the time it'll try again, instead of looking stuck.
- The setup screen no longer pushes its buttons off screen when it finds lots of consoles; PCE, MD-CD and NAOMI folders are recognised.
- More reliable updates: resuming and mirror downloads fixed.
- On small landscape handhelds the toolbar keeps the Bookmark button.
- Thanks now has 爱发电 (afdian) too — one more way to support the author ❤️
#1.4.7
#⏱️ See how long you've played
- New play time: games started from FreeDeck are timed automatically, and tiles, lists and game pages show "Played 3h 12m".
- Beat it? Tap ⋯ → Mark beaten on the game's page for a golden trophy 🏆.
- Beaten games move to the end of the list, leaving the front for the ones still to finish (turn off "Beaten last" in the sort menu).
#🎮 Set up a whole console at once
- In the emulator picker, tap Apply to all to use the same emulator and core for every game on that console.
- Sensor cartridges (Boktai, WarioWare: Twisted!…) now show and recommend mGBA, with cores that can't read the sensor greyed out.
#💅 Looks and feel
- The carousel fills square handhelds (RG Cube, RG Rotate) better, with its neighbours drawn closer.
- The classic thump-and-latch cartridge sound is back.
- Utility's emulator titles name their consoles in brackets.
- 32-bit Android handhelds can now install RetroArch in one tap.
- Frontend packs' image folders are no longer listed as games — their covers are used instead.
- When Play needs folder access, it tells you which folder to add in the emulator.
#1.4.6
#📱 Android games join the shelf!
The library has a new Android tab: turn on Android games in Settings → General, and the native games on your device sit right beside your emulator games.
- Press Start (or tap Add / remove at the end) to slide up the app drawer, tick the games you want (as many as you like), and tap again to take one off.
- A to play, Y to search.
#🔊 Feel it with your ears
- Brand-new UI sounds: taps, Back, D-pad moves, LB/RB tab flips and the RT tabs popup each have their own.
- Not your thing? Settings → General → UI sounds turns them off.
#🏷️ Custom labels
- On a game's page, tap the cartridge (or Customise below it) and pick Custom label to use any picture on your device as its label.
- Changed your mind? Reset label puts it back.
#💅 Looks and feel
- WonderSwan and Lynx get cartridges of their own: the clear blue-green shell and the matte black card, game label on top.
- Discs sit evenly in their rims.
- Front-facing console art for CPS1–3 and Naomi.
- Smoother updates in mainland China: faster mirrors first, slow ones skipped, and a clear reason for each one that fails.
- Thanks now opens the author's bilibili page.
#1.4.4
#🕹️ The arcade is open!
Your arcade games (Neo Geo, CPS1–3, FBNeo, Naomi) now live in a red bartop cabinet: the game's marquee glows in the top panel, and real gameplay plays on the CRT — scanlines, curved glass, vignette and all.
- In the carousel the cabinet stays right in the middle. Flick left or right and the marquee fades over while the screen "changes channel" with a burst of static — like strolling past the machines in an arcade.
- Hit Play: a scan line rolls down the screen, the signal flickers out and back, a coin clinks in — and you're playing!
#✨ More to play with
- LB / RB to flip games: jump to the previous / next game right from its page, no trip back to the list.
- Console tiles on All: tap one to jump straight to that console's tab; with Bookmark on, only consoles with bookmarked games show.
- Utility welcomes Cemu (Wii U) and DroidDeck (PC).
#💅 Looks and feel
- Fresh console tiles: translucent cards with bigger hardware art, and new pictures for GB, GBC, Switch, N64, MD, Saturn and Mega-CD.
- Upgraded disc and UMD looks.
- A crisper sound as a cartridge goes in.
- The screen now follows your system's auto-rotate.
- Tighter buttons on the game page, so Delete fits even on 720dp screens.
- A tidier button hint bar: LB on the left, RB on the right, centred.
- More games find their covers: a Chinese DC collection, the Wii WiiWare/VC set and the NDS official set.
#1.4.2
#Fixes
- Discs and UMDs with no ScreenScraper label and no ES-DE art no longer show blank (such as The Incredible Hulk: Ultimate Destruction on PS2): they wear the game's cover again.
#1.4.1
#New
- Release notes: the Version card in Settings → General has a Release notes button, so you can see what a new version changes before updating.
- Prefer ES-DE artwork (Settings → Emulator Games): when on, the library shows the covers ES-DE has already scraped first. ES-DE art on SD cards and in a custom ES-DE media folder is found too, and ROMs named by a code (such as
PS2CH105.iso) find their ES-DE art by the game's name. - New disc and UMD look: drawn on new real-world base images, with rounder discs and even rims.
- Label fallback: while ScreenScraper's cartridge/disc label hasn't arrived or can't be found, ES-DE art or art already on the device stands in, so discs no longer show blank.
#Improvements
- Faster box art scraping: three games at a time, and with your own ScreenScraper login, as many parallel requests as your account allows.
- Labels that failed because of the network or the daily quota are retried later on their own, without scraping the cover again.
#Fixes
- Fixed severe stutter and "app isn't responding" on some devices (such as the AYANEO Pocket ACE) while box art was being scraped.
#Anonymous analytics
- New "game launched" event: records the game's name, console, emulator and RetroArch core. No account is attached, and no file or path is recorded.
#1.4.0
#Important
- Two editions: Coffee (Freedeck Go, every feature) and Tea (FreeDeck Tea, the Premium Clean Fans edition — 纯净版 — with no game downloads). They're separate apps that can be installed side by side, and they share settings, bookmarks, cartridge looks and scraped art through the
/storage/emulated/0/Freedeckfolder. - New signing key: Coffee users upgrading from 1.3.0 need to uninstall the old version first (app data is cleared; games in your download folders are kept).
- Tea checks for and installs its own updates in Settings → General → Version.
- Anonymous analytics (Mixpanel) added: only the first install and the number of ScreenScraper requests are recorded, with device model, Android version, screen resolution and app version. No Tianyi, Baidu or ScreenScraper account and no game information is ever attached.
#New
- PS3: 掌机助手 installs the ARMSX3 emulator (needs your own PS3 firmware), and PS3 is in the setup wizard. PS3 games get box art by the game ID inside the ISO, and 139 PS3 catalog games that had no cover now have one.
- 3DS: AzaharPlus replaces Azahar (it runs some games Azahar can't).
.ciagames must be installed in AzaharPlus first; the game page explains how. - PS Vita: supports Vita3K 0.2.1 (the main repo's continuous build). A game is moved into Vita3K's storage folder the first time it's started, so set Vita3K's storage location to internal storage or the SD card first. Builds from the old Vita3K repo are flagged, with a reminder to back up saves before uninstalling.
- Bookmarks first: bookmarked games always list first, then downloaded ones; the Downloaded-only and Bookmarks filters can be on together.
- ScreenScraper login (Settings → Emulator Games): use your own account's quota, with no wait between lookups.
- Box art scraping: when libretro has no cover, ScreenScraper's box art is used. Tabs still fetching art shimmer instead of showing a spinner.
- Cartridges: new Neo Geo Pocket cartridge (black, orange, grey); the PC Engine HuCard is now a real photo; HuCards and PSP UMDs slide out upward in the launch animation. On a game page, press Right from the button row to select the cartridge, then A to change its look.
- Tidier installs: after extracting a PSP, PS2, NDS, 3DS, Wii, GameCube, N64 or MD game, its game file goes straight into the console's ROM folder, named after the game, as emulators and ES-DE expect.
- Hidden controls: the library's battery popup lists the hidden combos (hold LT + A to start a downloaded game straight from the library).
- Orientation: the screen flips with the device between both landscape orientations (e.g. a tablet held upside down in a stretch controller).
- Tea: choose between three app icons in Settings → General; X toggles the Bookmarks filter.
- Thank the author: now an Afdian link and card, shown in Tea too.
#Improvements
- Faster library tab switching: with no login, or with the Downloaded-only / Bookmarks filter on, only the relevant games are read, and every tab is read ahead.
- Coffee's built-in ScreenScraper account allowance raised to 1,000 requests a day.
#Fixes
- A removed download no longer comes back and keeps downloading.
- A failed extraction now deletes the partial files it wrote; a damaged RAR is reported as damaged instead of as a wrong password.
- Share access codes are no longer tried as archive passwords.
- Game folders holding only empty files no longer count as downloaded.
- Some downloaded games missing their ✓ now show it (
.cci3DS games, games matching a file of the same name). - Fixed WonderSwan / WonderSwan Color box art matching.
- Fixed "share link is empty" for every game after installing Coffee over Tea.
- The update check no longer offers an older version as an update.
- The scrape queue no longer re-queues finished or unscrapeable games (which kept their tabs looking busy).
