URL Parameters

TinyEmulator supports URL query parameters to control game launch behavior.

Basic Parameters

Parameter	Type	Description	Example
core	string	Emulator core name	?core=nes
rom	string	ROM file path or URL	?rom=roms/game.nes
autostart	boolean	Auto-start the game	?autostart=1
lang	string	UI language	?lang=zh
fullscreen	boolean	Start in fullscreen	?fullscreen=1

Supported Cores

Core	Platform	Example
nes	Nintendo Entertainment System	?core=nes
snes	Super Nintendo	?core=snes
gba	Game Boy Advance	?core=gba
genesis	Sega Genesis / Mega Drive	?core=genesis
arcade	Arcade (FBNeo)	?core=arcade
ps1	PlayStation 1	?core=ps1
n64	Nintendo 64	?core=n64

Netplay Parameters

For multiplayer sessions:

Parameter	Type	Description
session	string	Netplay session ID
room	string	Room ID to join
tunnel	string	WebSocket tunnel URL
create	boolean	Create a new room
single	boolean	Single player mode (no netplay)

Example: Create a room

https://play.tinyemulator.com?core=nes&rom=game.nes&create=1

Example: Join a room

https://play.tinyemulator.com?session=abc123&room=42&tunnel=wss://tunnel.example.com

Share Links

When self-hosting the backend, you can generate short share links via the REST API:

# Create a short link
curl -X POST https://your-domain.com/api/v1/short \
  -H "Content-Type: application/json" \
  -d '{"url": "https://play.your-domain.com?core=nes&rom=game.nes"}'

# Response
{"code": "abc123"}

Short link format: https://your-domain.com/s/<code>

Language Support

Code	Language
en	English
zh	Chinese (Simplified)

https://play.tinyemulator.com?lang=zh