Snappier Server

• PORT — Listening port (default: 8000)
• HOST — Bind address (default: 0.0.0.0)
• ENABLE_REMUX — Convert .ts to .mkv after recording (default: false)
• RECORDINGS_FOLDER — Live TV recording output path (default: ~/SnappierServer/Recordings)
• MOVIES_FOLDER — Movie download output path (default: ~/SnappierServer/Movies)
• SERIES_FOLDER — TV series download output path (default: ~/SnappierServer/TVSeries)
• PVR_FOLDER — PVR data path (default: ~/SnappierServer/PVR)
• HLS_FOLDER — HLS transcoding temp directory (default: ~/SnappierServer/hls)
• EPG_FOLDER — EPG cache data path (default: ~/SnappierServer/epg)
• LOGS_FOLDER — Log file directory (default: ~/SnappierServer/logs/)
• DOWNLOAD_SPEED_LIMIT_MBS — Max curl download speed in MB/s (default: 0 = unlimited)
• MAX_CURL_RETRIES — Max retry attempts for curl downloads (default: 5)
• USE_CURL_TO_DOWNLOAD — Force curl for all downloads instead of FFmpeg (default: false)
• ENABLE_EPG — Enable EPG support (default: false)
• EPG_URL — Single EPG XML URL (deprecated — use EPG_URLS instead). If both are set, EPG_URLS takes precedence
• EPG_URLS — Multiple EPG sources as JSON array (takes precedence over EPG_URL)
• EPG_REFRESH_INTERVAL — Refresh interval in hours (default: 24)
• LOG_ROTATE_DAYS — Log rotation interval in days (default: 3)
• LOG_ROTATE_SIZE_MB — Max log file size before rotation in MB (default: 10)
• KEEP_ALIVE_TIMEOUT — HTTP keep-alive timeout in ms (default: 65000)
• HEADERS_TIMEOUT — HTTP headers timeout in ms (default: 66000)
• HLS_USE_HW — Enable hardware acceleration for HLS transcoding (default: false). Uses platform-specific encoders: VideoToolbox on macOS, VAAPI/NVENC on Linux
• HLS_VIDEO_ENCODER — Override the video encoder for HLS (e.g. h264_videotoolbox, h264_vaapi, h264_nvenc). If unset, uses libx264 or the hardware encoder when HLS_USE_HW is enabled

Setting Variables

# macOS / Linux
export PORT=9000
export ENABLE_REMUX=true
export ENABLE_EPG=true
export EPG_URL="http://example.com/epg.xml"
./snappier-server-cli

# Windows (PowerShell)
$env:PORT = "9000"
$env:ENABLE_REMUX = "true"
.\snappier-server-cli.exe

# Windows (cmd)
set PORT=9000
set ENABLE_REMUX=true
snappier-server-cli.exe

To persist, add to ~/.bashrc, ~/.zshrc, or the systemd service file.

All arguments override environment variables. Run --help for the full list.

./snappier-server-cli --help

Server

--port 8080                          # Override listening port
--host 127.0.0.1                     # Bind address (default: 0.0.0.0)
--enable-remux                       # Convert .ts to .mkv after recording
--speed-limit 50                     # Download speed limit in MB/s

Config & Data Paths

--config /etc/snappier/config.json   # Custom config file (default: ~/SnappierServer/config.json)
--pvr-folder /mnt/data/pvr
--epg-folder /mnt/data/epg
--logs-folder /var/log/snappier
--recordings ~/Recordings
--movies ~/Movies
--series ~/TVShows

Logging

--log-rotate-days 7    # Rotate every N days (default: 3)
--log-rotate-size 20M  # Rotate at N MB (default: 10)

EPG

# Single source
--enable-epg --epg-url "http://example.com/epg.xml" --epg-interval 12

# Multiple sources (JSON)
--enable-epg --epg-urls '[
  {"url":"http://primary.com/epg.xml","name":"Primary","priority":1,"enabled":true},
  {"url":"http://backup.com/epg.xml","name":"Backup","priority":2,"enabled":true}
]'

Full Example

./snappier-server-cli \
  --config /path/to/config.json \
  --port 8080 \
  --enable-epg \
  --epg-url "http://provider.com/epg.xml" \
  --epg-interval 24 \
  --enable-remux \
  --recordings ~/Recordings \
  --movies ~/Movies \
  --series ~/TVShows \
  --logs-folder /var/log/snappier \
  --log-rotate-days 7 \
  --log-rotate-size 20M \
  --epg-folder /mnt/data/epg \
  --pvr-folder /mnt/data/pvr

http://YOUR-SERVER-IP:8000/dashboard

Features

• System Overview: CPU, memory, disk usage
• Active Jobs: Real-time progress for downloads and recordings, with cancellation
• Scheduled Recordings: View and manage upcoming jobs
• Recording History: Browse completed recordings
• TV Guide (EPG Grid): Interactive programme listings, channel browsing, recording scheduling, live playback
• Settings: EPG sources, PVR rules, download paths, remuxing

TV Guide Setup

1. Dashboard → Settings → EPG Sources → add/edit a source
2. Check "Use for TV Guide (Xtream Codes)" — credentials auto-detected from Xtream URLs
3. Save. The server fetches channel and category data.
4. Click TV Guide in the sidebar to open the interactive grid.

EPG (Electronic Programme Guide) provides programme listings for scheduling recordings and browsing the TV guide. Your IPTV provider supplies the EPG URL — look for "XMLTV URL", "EPG URL", or "TV Guide URL" in your provider's welcome email, customer portal, or app setup instructions. If you can't find it, contact your provider.

EPG URL Format

If your provider uses Xtream Codes (a common IPTV management system), construct the EPG URL from your provider's server details (not your Snappier Server):

http://your-provider-server:port/xmltv.php?username=USERNAME&password=PASSWORD

GUI Setup

1. Tray icon → Preferences → EPG section
2. Enable EPG, paste your URL, name the source, set priority (1 = highest)
3. Set refresh interval (24h recommended), Save

CLI Setup

# Single source
./snappier-server-cli --enable-epg \
  --epg-url "http://iptv.example.com:8080/xmltv.php?username=user&password=pass"

# Multiple sources
./snappier-server-cli --enable-epg --epg-urls '[
  {"url":"http://primary.com/epg.xml","name":"Primary","priority":1,"enabled":true},
  {"url":"http://backup.com/epg.xml","name":"Backup","priority":2,"enabled":true}
]'

Verify

curl -H "X-API-Token: YOUR_TOKEN" http://localhost:8000/epg/status     # Source info & update times
curl -H "X-API-Token: YOUR_TOKEN" http://localhost:8000/epg/channels   # Detected channels
curl -H "X-API-Token: YOUR_TOKEN" -X POST http://localhost:8000/epg/refresh  # Force refresh

Troubleshooting

• No data: Verify URL returns XML in a browser. Check EPG is enabled. Wait for initial download.
• Stale data: POST /epg/refresh or reduce refresh interval.
• URL not working: Verify credentials. Try standard Xtream format. Contact your provider.

PVR (Personal Video Recorder) creates rules that automatically schedule recordings when matching programmes appear in your EPG data. Like a DVR — set it once and the server records every matching episode.

Requirements

• EPG must be enabled and working
• Server should be running 24/7 for automatic scheduling

Rule Types

• Series: Records all future matching episodes continuously. Best for TV series and daily shows.
• One-time: Records only the next match, then auto-disables. Best for special events or one-off recordings.

How to Create Rules

• Snappier IPTV app: Long-press any programme in the EPG grid for recording options. Manage rules in the Server section.
• Web Dashboard: Open Settings → PVR Rules to create and manage rules.

How It Works

The server scans EPG data for matching programmes after each EPG refresh, on startup (2-second delay), or when you trigger a manual scan. Matched programmes are automatically scheduled for recording. You can exclude specific episodes you don't want.

Data Storage

PVR data is stored in the PVR_FOLDER (default: ~/SnappierServer/PVR/):

• pvr_rules.json — Recording rules
• pvr_exclusions.json — Excluded episodes
• Recordings saved as .ts (or .mkv with remuxing enabled)

The server auto-detects SSL certificates on startup and switches to HTTPS. The port stays the same (default 8000) — only the protocol changes. No certs = standard HTTP.

Certificate Paths (checked in order)

1. ./certs/ (project directory, recommended for CLI)
2. User data directory:
   • Windows: %APPDATA%\snappierServer-electron\certs\
   • macOS: ~/Library/Application Support/snappierServer-electron/certs/
   • Linux: ~/.config/snappierServer-electron/certs/

Required: privkey.pem and fullchain.pem

Let's Encrypt

sudo certbot certonly --standalone -d yourdomain.com

mkdir -p ./certs
sudo cp /etc/letsencrypt/live/yourdomain.com/privkey.pem ./certs/
sudo cp /etc/letsencrypt/live/yourdomain.com/fullchain.pem ./certs/
sudo chown $USER:$USER ./certs/*.pem

Reverse Proxy (Caddy)

# Caddyfile
yourdomain.com {
    reverse_proxy localhost:8000
}

caddy run

Caddy handles certificates, renewal, and HTTP-to-HTTPS redirect automatically.

Self-Signed (dev only)

mkdir -p ./certs
openssl req -x509 -newkey rsa:4096 \
  -keyout ./certs/privkey.pem \
  -out ./certs/fullchain.pem \
  -days 365 -nodes -subj "/CN=localhost"

Verify

# Check server logs:
# HTTPS: "SSL certificates found in ./certs - starting HTTPS server"
# HTTP:  "No SSL certificates found - starting HTTP server"

Certificate Reload

Certificates are read on startup only. After updating or renewing certificates, restart the server for changes to take effect.

App Connection

Enable the HTTPS/SSL toggle in Snappier IPTV settings. For self-signed certs, visit https://SERVER-IP:8000 in mobile Safari/Chrome first to accept the certificate.

• Config location: Desktop app stores config in the OS user-data directory (%APPDATA% / ~/Library/Application Support/ / ~/.config/). CLI defaults to ~/SnappierServer/config.json.
• CLI binary: The CLI is a standalone executable with Node.js bundled in. No runtime dependencies — just download and run.
• FFmpeg: Bundled on macOS/Windows (desktop app). Install separately on Linux and for all CLI installs.
• Recording format: .ts (MPEG Transport Stream). Enable remuxing to convert to .mkv for better compatibility with media players like Plex and VLC.
• Default storage: ~/SnappierServer/ (recordings, movies, series, PVR data). Override with env vars or CLI args.
• Port conflicts: If port 8000 is already in use, the server will fail to start with an EADDRINUSE error. Change the port with PORT=9000 or --port 9000.
• Firewall: Allow traffic on the configured port for cross-device access.
• VPN: The server and client must be able to reach each other over the network (same LAN, or routable via VPN).

Updating

Replace the binary or app with the new version. Your configuration, API token, and recordings are stored separately in ~/SnappierServer/ (CLI) or your OS user-data directory (desktop app) and persist across updates.

Uninstalling

• Windows: Delete the extracted folder. Remove %APPDATA%\snappierServer-electron if you want to clear config.
• macOS: Drag the app from Applications to Trash. Remove ~/Library/Application Support/snappierServer-electron for config.
• Linux: Delete the AppImage or CLI binary. Remove ~/.config/snappierServer-electron (desktop) or ~/SnappierServer (CLI) for config and data.

Desktop App vs CLI

Both share the same recording/download engine. The desktop app adds a Preferences UI, system tray with start/stop controls, a log viewer window, folder browser dialogs, and automatic port hot-reload when config changes. The CLI reads config once at startup.

Find Your IP

# Windows
ipconfig                    # Look for "IPv4 Address"

# macOS
ipconfig getifaddr en0      # Or check System Settings > Network

# Linux
hostname -I                 # Or: ip a

• hls.js — JavaScript HLS client using Media Source Extensions. Apache License 2.0. See THIRD_PARTY_LICENSES.txt.