Snappier Server

Latest version: v1.0.3

Install & Run Guide

This page covers how to download, install, and run Snappier Server in both GUI (Electron) and CLI‐only modes on Windows, macOS, and Linux, for both x86_64 and ARM64 architectures.

What is Snappier Server?

Snappier Server is a lightweight yet powerful service designed to run seamlessly on your machine 24/7 ideally - otherwise you may miss recordings. Built exclusively for the Snappier IPTV App, it acts as the brain behind all your media recording and downloading needs.

With the Snappier IPTV App, users can effortlessly schedule live TV recordings, save CatchupTV, and download movies or entire TV series from their IPTV provider. Movies can also be scheduled to download at a specific future date and time. Snappier Server takes care of these requests in the background—quietly, efficiently, and reliably.

Note: Each active recording or download uses one connection to your IPTV service. If your subscription only allows a single connection, you won’t be able to watch live TV or start another recording at the same time. However, once a recording has started, you can begin watching it from the server even while it’s still in progress—this does not use up a connection

By default, all your media is saved to the Current Working Directory (CWD) + snappierServer/ folder, but you're free to specify a custom location for folders to organize your recordings and downloads your way. The downloaded content is fully compatible with the Snappier IPTV app and can also be played in any media player that supports the formats.

Note: Live TV and CatchupTV recordings are saved in the .ts (MPEG Transport Stream) format. While widely compatible, this format may not work with certain players—such as Infuse. However, if you enable remuxing the .ts file will be converted to .mkv format making it more compatible.

Once a recording or download begins through the Snappier IPTV App, Snappier itself can be closed. Snappier Server continues the task independently, ensuring everything completes smoothly—even while you're away.

Need help? Join our friendly community on Discord! You’ll find the invite link directly in the Snappier IPTV app.

Notice: Snappier Server is currently a beta feature of the Snappier IPTV App. While it's designed to work for most users, it may not be compatible with all systems or network setups. Installation is the responsibility of the user, and while we may not be able to assist with every individual setup, we’ll always try our best to help in the Discord server if possible. We welcome feedback as we continue to improve it.

1. GUI App (Tray)

The GUI App provides a system‐tray icon and Preferences window. Pick the right package for your OS and CPU:

⚠️ If you’re installing on a computer with a graphical user interface (GUI) — such as Windows, macOS, or Linux — the GUI app is recommended. For headless systems (without a GUI), please use the CLI-only binary provided in Section 2 below.

# Debian/Ubuntu:
sudo apt update && sudo apt install ffmpeg

# Fedora/RHEL:
sudo dnf install ffmpeg

# Arch Linux:
sudo pacman -S ffmpeg
  

2. CLI-Only Binary

🔧 This CLI‐Only Binary is designed for headless/server environments without any GUI.

The CLI package is a single native executable (no GUI), suitable for servers or Docker. It listens on port 8000 by default.

Download

• Windows x64: Download
• Windows ARM64: Download
• macOS x64: Download
• macOS ARM64: Download
• Linux x64: Download
• Linux ARM64: Download

Prerequisite: FFmpeg

Ensure FFmpeg is installed for full recording, remuxing, and optional movie/series downloading support:

# Debian/Ubuntu:
sudo apt update && sudo apt install ffmpeg

# Fedora/RHEL:
sudo dnf install ffmpeg

# Arch Linux:
sudo pacman -S ffmpeg

Note: If you're running the CLI version in a desktop environment and want notifications, install and activate a Linux notification daemon such as dunst or xfce4-notifyd:

• Ubuntu/Debian:
  sudo apt install dunst
  or
  sudo apt install xfce4-notifyd
• Fedora:
  sudo dnf install dunst
  or
  sudo dnf install xfce4-notifyd
• Arch Linux:
  sudo pacman -S dunst
  or
  sudo pacman -S xfce4-notifyd

After installation, ensure the daemon is started or enabled in your session (e.g., by adding dunst & to your autostart script).

Installation & Run

1. Place the binary in a directory on your PATH, or run it directly:

chmod +x snappier-server-cli-‹platform›-‹arch›
./snappier-server-cli-‹platform›-‹arch›

2. To change the default listening port (8000), set the PORT environment variable before launching the server.
   See the section below titled How to Set Environment Variables for step-by-step instructions.
3. All API endpoints (schedules, recordings, movies, series) are available at:

   http://localhost:8000

4. Connect the App: In the Snappier IPTV app, go to Settings → Snappier Server and enter the IP address and port number of the machine running Snappier Server (e.g., 192.168.1.100 and 8000). Do not include http:// or https://

Environment Variables

You can configure the server by setting the following environment variables before launch:

• PORT
  Set the port the server listens on (default is 8000).
• ENABLE_REMUX
  Set to true to convert .ts files to .mkv format automatically.
• RECORDINGS_FOLDER
  Path to store live TV recordings.
• MOVIES_FOLDER
  Path to store downloaded movies.
• SERIES_FOLDER
  Path to store downloaded TV series.
• DOWNLOAD_SPEED_LIMIT_MBS
  Set max download speed for curl-based downloads (in MB/s). Use 0 to disable limit.
• USE_CURL_TO_DOWNLOAD
  Set to true to force using Curl for all downloads (movies/series) instead of FFmpeg.

How to Set Environment Variables

Before launching Snappier Server, set the appropriate environment variables in your shell or startup script. Here’s how to do it on each platform:

Windows (Command Prompt)

set PORT=9000
set ENABLE_REMUX=true
snappier-server-cli.exe

Windows (PowerShell)

$env:PORT = "9000"
$env:ENABLE_REMUX = "true"
.\snappier-server-cli.exe

macOS / Linux (Bash/Zsh)

export PORT=9000
export ENABLE_REMUX=true
./snappier-server-cli

To make variables permanent on macOS/Linux, add them to your shell’s startup file, like ~/.bashrc or ~/.zshrc.

3. Common Notes

• Configuration: GUI mode stores prefs in config.json under your user‐data folder (%APPDATA% on Windows, ~/Library/Application Support/… on macOS, ~/.config/… on Linux).
• FFmpeg: The macOS and Windows builds bundle FFmpeg, so you don’t need to install it separately on those platforms. On Linux, you must install FFmpeg manually.
• Docker: Use the CLI binary in a Docker image for headless deployments.
• Finding Your IP Address: To connect the Snappier IPTV app to the server, you'll need the local IP address of the machine running Snappier Server:
  • Windows: Open Command Prompt and run ipconfig. Look for the "IPv4 Address" under your active network adapter.
  • macOS: Open Terminal and run ipconfig getifaddr en0 (or en1 depending on your network). Alternatively, go to System Settings → Network → select your network → look for “IP address”.
  • Linux: Open Terminal and run hostname -I or ip a. Look for your active interface’s IP address (e.g., eth0 or wlan0).
• Network Access: Make sure any firewalls or routers allow traffic on the selected port if you want to access the server from another device.
• VPN Configuration: If using a VPN, ensure that both Snappier and the Snappier Server are on the same LAN/subnet to communicate properly.

© 2025 SnappierServer — Source & Updates