playtime

Personal retro games library + EmulatorJS + Netplay.

Features:

• Multiple users with disk usage quota
• Keyboard and gamepad controls
• Save states
• Netplay - up to 4 players

Platforms supported:

• 3DO
• Arcade
• Atari 2600
• Atari 5200
• Atari 7800
• Atari Jaguar
• Atari Lynx
• Bandai WonderSwan (Color)
• ColecoVision
• Commodore 128
• Commodore 64
• Commodore Amiga
• Commodore PET
• Commodore Plus/4
• Commodore VIC-20
• MAME 2003
• NEC PC-FX
• NEC TurboGrafx-16 / SuperGrafx / PC Engine
• Nintendo 64
• Nintendo DS
• Nintendo Famicom / NES
• Nintendo Game Boy (Color)
• Nintendo Game Boy Advance
• Nintendo Super Famicom / SNES
• Nintendo Virtual Boy
• SNK Neo Geo Pocket (Color)
• Sega CD
• Sega Game Gear
• Sega Master System
• Sega Mega Drive / Genesis
• Sega Saturn
• Sinclair ZX Spectrum
• Sony PlayStation
• Sony PlayStation Portable

Quick installation with script

Prerequisites:

• A server with public IP address (for example, basic droplet on DO) running Ubuntu 22.04
• A domain with A record with IP address of the server

For example domain is playtime.example.com and IP is 10.10.10.10.

Ensure A record is correct:

dig +short playtime.example.com
#should output correct IP address

On the server, execute:

mkdir playtime && cd playtime
wget "https://github.com/n-at/playtime/raw/master/docker/quick-install.sh"
chmod +x quick-install.sh
./quick-install.sh "10.10.10.10" "playtime.example.com"

This script will:

1. Install docker (if it is not installed)
2. Run coturn, a TURN/STUN/ICE server
3. Get SSL certificate from Let's Encrypt
4. Build and run playtime

admin password will be in playtime/data/admin.password file.

Building

Go 1.24+ and npm 7+ required.

./install.sh
go build -a -o app

Configuration

Commandline arguments available:

$ ./app -help
Usage of ./app:
  -db-path string
        db path (default "data/bolt.db")
  -debug-emulator
        debug emulator (extended browser console output)
  -debug-netplay
        debug netplay (extended browser console output)
  -debug-templates
        debug page templates (do not cache)
  -listen string
        address and port to listen (default ":3000")
  -turn-server-password string
        TURN/STUN/ICE server password (if required)
  -turn-server-url string
        TURN/STUN/ICE server host, required for netplay (example: turn:turn.example.com)
  -turn-server-user string
        TURN/STUN/ICE server user name (if required)
  -uploads-path string
        uploads path (default "uploads")
  -verbose
        show debug output

docker

Build an image:

docker image build -t playtime:latest .

Available image environment variables:

• PLAYTIME_TURN_URL
• PLAYTIME_TURN_USER
• PLAYTIME_TURN_PASSWORD
• PLAYTIME_DEBUG_EMULATOR
• PLAYTIME_DEBUG_TEMPLATES
• PLAYTIME_DEBUG_NETPLAY
• PLAYTIME_VERBOSE

Exposed volumes:

• /app/data - database directory
• /app/uploads - uploads directory

Exposed default port 3000.

Netplay

TURN server is required for netplay. It can be obtained from:

• This list
• Open Relay
• Hosted, for example coturn

For a particular game netplay needs to be enabled in game settings.

Uses

• labstack/echo - MIT
• flosch/pongo2 - MIT
• sirupsen/logrus - MIT
• timshannon/bolthold - MIT
• google/uuid - BSD-3-Clause
• twbs/bootstrap - MIT
• twbs/icons - MIT
• sumimakito/Awesome-qr.js - Apache-2.0
• lekoala/bootstrap5-tags - MIT
• @fontsource/comfortaa - OFL-1.1
• @fontsource/raleway - OFL-1.1
• EmulatorJS - GPL-3.0 (not included)
• BIOS files from respective vendors (not included)