Tea 中文

Steam Deck edition

Tea for the Steam Deck — installing, where files live, launching games, buttons, the in-game quick menu, updating and uninstalling, and how it differs from Android

Tea also comes in a Steam Deck edition (Freedeck Go). It has the same version number and interface as the Android edition: the library, cartridge and disc labels, the launch animation, theme backgrounds, Cloud drive, Utility, cheats, AI features and save sync are all there. Play straight from Game Mode with the controller, or swipe on the touchscreen.

Getting it

The Steam Deck edition is currently for supporters only; see the download page for how to get it.

Installing

Install it in Desktop Mode.

  1. Switch to Desktop Mode: press the Steam button → Power → Switch to Desktop.

  2. Put the downloaded archive (freedeck-go-tea-version-linux-x64.zip) in your Downloads folder.

  3. Open Konsole (application menu in the bottom-left corner → System → Konsole) and type:

    cd ~/Downloads && unzip -o freedeck-go-tea-*-linux-x64.zip && bash freedeck-go/install.sh
    

    Rather not type? In the Dolphin file manager, right-click the archive → Extract → Extract archive here, go into the freedeck-go folder, press F4 (or right-click an empty spot → Open Terminal Here), type bash install.sh and press Enter.

  4. When the installer asks "Close Steam now?", just press Enter: Steam's game list can't be changed while Steam is open, and Steam reopens automatically afterwards.

  5. Go back to Game Mode (Return to Gaming Mode on the desktop) and launch Tea from Non-Steam in your library.

The installer:

Note Run the installer in Desktop Mode. In Game Mode it can't close Steam, so it only installs the app; you'll need to run it again in Desktop Mode to get the Steam shortcut.

Leave Steam's controller and touchscreen settings at their defaults; there's nothing to change. Only one Tea runs at a time.

Manual install (if the one-step install doesn't work)

  1. In Dolphin in Desktop Mode, open your home folder (/home/deck). If there's no Applications folder, create one, then extract the archive into it so you get /home/deck/Applications/freedeck-go/. Don't name it FreedeckGo (that's the folder for settings and images).
  2. Open Steam on the desktop → Add a Game in the bottom-left corner → Add a Non-Steam Game → Browse…, set the file type to All Files, choose freedeck-go.sh in the freedeck-go folder → Add Selected Programs.
  3. For an icon: right-click it in your Steam library → Properties → click the icon and choose icon.png from the same folder. You can rename it to Tea.

If it won't start, right-click freedeck-go.sh → Properties → Permissions → tick Is executable.

First launch

Tea on the Steam Deck
Tea on the Steam Deck

The first time you launch it, Tea asks you to:

  1. Choose a language.
  2. Choose your ROM folder: with EmuDeck installed, it finds ~/Emulation/roms automatically; without it, tap Create ROM folder to create Emulation/roms and a subfolder for each console, then put games in the matching subfolder.
  3. Log in to ScreenScraper (optional, for scraping covers and info; see Covers and labels).

Install emulators in one tap from Utility, or use the Setup wizard to pick your consoles, install emulators and set up bezels and shaders all at once; see Utility.

Where files live

Location Contents
~/Applications/freedeck-go The app itself
~/FreedeckGo Settings, bookmarks, covers, labels and images you can share with the Android edition; cloud drive downloads also go to downloads here first by default
~/.local/share/freedeck-go This device's settings, cover cache, cloud drive logins and logs
~/Emulation/roms (the EmuDeck / ES-DE ROM folder) Games, in a subfolder per console (gba, psx, ps2…)

Cloud drive and downloads

In Settings → General → Library drive, log in to 天翼云盘 (China Telecom Cloud), 百度网盘 (Baidu Netdisk) or 夸克网盘 (Quark): a QR code appears on screen; scan it with your phone. Then browse your own cloud drive files under Cloud drive in the side menu, tap Download once you've picked, and choose which console to download to (or Other folder).

When a download finishes, the game is installed into that console's ROM folder automatically, and archives are extracted automatically. Nothing downloads while Tea is closed; it carries on next time you open it. See Cloud drive and downloads.

Launching games

Tap Play and Tea launches the game the same way ES-DE on this device would: the same emulator rules, looking for emulators in the same places.

Before launching, Tea takes care of a few things for you:

Play time is recorded as usual, including when you quit with Steam's "Exit game".

Buttons

Tea reads the controller through Steam Input; keep Steam's default controller settings.

Button Action
A / B Confirm / back
Select Open the side menu
LB / RB Switch tabs
Start Switch between grid / list / carousel
Y Search
LT + B Open "Customise" (theme, background, cover shape, grid columns)
Hold Select + Start for about 1 second in game Close the running emulator and go back to Tea
L4 + R4 in game Open the quick menu (see below)

The touchscreen works too: tap, swipe and long-press just like on a handheld.

RetroArch hotkeys: if RetroArch has no controller hotkeys set up yet (say, without EmuDeck, or freshly installed from Flathub), Tea sets up the same ones EmuDeck uses:

Button Action
Hold Select + Start Quit
Hold Select + R1 / L1 Quick save / quick load
Hold Select + X (or L3 + R3) Open the RetroArch menu
Hold Select + R2 Fast-forward
Hold Select + D-pad left / right Switch save slot

For games on 2D consoles like the NES, SNES, GBA and Mega Drive, the left stick works as a D-pad too. Existing RetroArch settings (EmuDeck's or your own) aren't changed.

In-game quick menu

While playing in Game Mode, press L4 + R4 and a quick menu slides in on the right of the screen (like the floating button on Android). While it's open, the game doesn't receive button presses.

Save sync

The Steam Deck and Android handhelds can share the same Sync drive: the latest saves are pulled before a game starts and uploaded after you quit. In-game saves work on both, so you can carry on on another device; quick saves stay on each device (the emulator versions differ, so they can't read each other's).

For setup, see Saves and cloud sync.

Updating

  1. Open Settings → General and tap Check for updates on the version card at the bottom.
  2. When there's a new version it shows "Latest" with the version number; tap Update to download (check Release notes first to see what's new).
  3. When it shows "… is ready: restart to finish", tap Restart to update. Tea closes, finishes updating and opens again.

Your settings and data are kept. If it shows "no Steam Deck build yet", the latest version doesn't have a Steam Deck update yet; check again later.

Uninstalling

In Konsole in Desktop Mode, run:

bash ~/Applications/freedeck-go/install.sh --uninstall

This removes the app, Tea from the application menu and the Steam shortcut, and keeps your settings and data (~/.local/share/freedeck-go and ~/FreedeckGo). To remove the settings and data too:

bash ~/Applications/freedeck-go/install.sh --uninstall --purge

If you installed it manually: remove Tea in Steam, then delete the freedeck-go folder.

How it differs from Android

Viewing art full size
Viewing art full size

Android Steam Deck
Launching games Tea's own emulator list ES-DE's emulator rules, with EmuDeck, Flatpak and AppImage support
In-game menu Floating button L4 + R4 quick menu
Custom launch (including AI Generate) Yes No
Android apps, PC game launchers (GameHub, GameNative, DroidDeck, etc.) Yes No
Home NAS Yes Not yet
Bezels Every bezel Utility offers Only bezels that fit the Deck's screen (16:10)
Save sync Between Android devices, both in-game saves and quick saves sync With Android, only in-game saves are shared; quick saves stay on each device
Updating Settings → General → Check for updates The same, then tap Restart to update to finish