Install
Where to download
Everything lives on the official site:
https://tml.tywmc.cn/#downloadThe page detects your platform; you can also switch platform, architecture and channel manually. Every file lists its SHA-256 so you can verify it.
Official builds vs self-compiled builds
Official builds carry the server address (notices, updates, beta). Packages you compile yourself ship without any server address and work offline only.
Windows
- Download
TYW Launcher.exe(stable, snapshot and beta are separate files). - Put it in a directory you can write to — not
C:\Program Files. - Run it. The first launch asks for a data directory.
.NET Framework 4.8 ships with Windows 10 1809 and later; nothing to install. Windows 7 is not supported.
Uninstalling: delete the exe and the PCL directory. The only leftover is HKCU\Software\PCLDebug (notice fingerprints).
Linux
Check your architecture first:
uname -m
# x86_64 → grab the linux-x64 package
# aarch64/arm64 → grab the linux-arm64 packageThe package is self-contained — no .NET runtime required — but it links against the usual desktop libraries (X11, fontconfig, OpenGL). What you install depends on the distribution.
Generic steps (any distribution)
mkdir -p ~/apps/tyw
tar -xzf TYWLauncher-linux-x64.tar.gz -C ~/apps/tyw # use TYWLauncher-linux-arm64.tar.gz on arm64
chmod +x ~/apps/tyw/TYWLauncher
~/apps/tyw/TYWLauncherAfter extracting you should see TYWLauncher, Assets/ and a pile of .dll files. The first run asks for a data directory (defaults to ~/PCL).
Uninstalling: delete ~/apps/tyw and the data directory.
Debian / Ubuntu / Linux Mint / Deepin
sudo apt update
sudo apt install -y libx11-6 libice6 libsm6 libfontconfig1 libgl1 libxi6 libxrandr2Ubuntu 20.04+ and Debian 11+ are fine. Anything older ships a glibc that is too old to start.
Fedora / RHEL / CentOS Stream / Rocky / AlmaLinux
sudo dnf install -y libX11 libICE libSM fontconfig mesa-libGL libXi libXrandrCentOS 7 and older are not supported (glibc too old).
Arch / Manjaro / EndeavourOS / CachyOS
sudo pacman -S --needed libx11 libice libsm fontconfig mesa libxi libxrandropenSUSE Tumbleweed / Leap
sudo zypper install -y libX11-6 libICE6 libSM6 fontconfig Mesa-libGL1 libXi6 libXrandr2Alpine and other musl distributions
There is no official musl build. Either try a glibc compatibility layer (gcompat) or build from source.
Wayland sessions
XWayland is used automatically and usually needs no setup. If your install is minimal and lacks it:
# Debian / Ubuntu
sudo apt install -y xwayland
# Fedora
sudo dnf install -y xorg-x11-server-Xwayland
# Arch
sudo pacman -S xorg-xwaylandHeadless servers (plain SSH)
The launcher is a GUI application and needs an X display; over a bare SSH session it will fail with "cannot open display". Use X11 forwarding (ssh -X) or VNC / remote desktop. It does not run headless.
Add a desktop entry (optional)
mkdir -p ~/.local/share/applications
cat > ~/.local/share/applications/tyw-launcher.desktop <<'EOF'
[Desktop Entry]
Type=Application
Name=TYW Launcher
Exec=/home/YOUR_NAME/apps/tyw/TYWLauncher
Terminal=false
Categories=Game;
EOFReplace Exec with your real path.
macOS
Download .dmg or .zip and move TYW Launcher.app to Applications.
# if the zip build refuses to open
xattr -cr "/Applications/TYW Launcher.app"- Apple Silicon:
arm64package (ad-hoc signed). - Intel:
x64package. - "Unverified developer" → right click → Open, or allow it in System Settings → Privacy & Security.
Android
Install the .apk (Android 8.0+). Grant storage access on first run; Android 11+ asks for MANAGE_EXTERNAL_STORAGE.
You do not need to install Java. The launcher downloads the matching Android JRE (8 / 17 / 21 / 25) for your architecture, with direct links and mirror fallback.
Beta channel
- Open the stable build → Settings → Other → Launcher → enable beta.
- Enter the beta key issued by the administrator (bound to your device code).
- Restart; the channel switches to beta.
Beta has no auto-update: each launch pulls the latest package from the server. No server, no start. Untick the box to return to stable (or snapshot).
Verify a download
Windows:
Get-FileHash .\TYW Launcher.exe -Algorithm SHA256Linux / macOS:
sha256sum TYWLauncher-linux-x64.tar.gz