Home Assistant Add-ons: Snappier Server

This repository contains two add-ons:

• Snappier Server (stable) - Runtime v1.5.0
• Snappier Server Beta (beta) - Runtime v1.5.0ab

Self-hosted, lightweight Snappierer Server for Home Assistant.

About

This repository provides Snappier Server as a Home Assistant add-on, allowing it to run continuously in the background without any complex setup.

The Snappier IPTV App is required to interact with the server and manage recordings, downloads, and schedules.

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. Snappier Server takes care of these requests in the background. Once a recording or download begins, Snappier IPTV itself can be closed — the server continues independently.

Features

This add-on supports the full feature set of Snappier Server, including:

• 🎬 Live TV Recording: Record live streams and schedule future recordings
• 📺 TV Series Management: Automatic episode downloading and organization
• 🎞️ Movie Downloads: Download movies on demand
• 🔄 Catch-up Recording: Record previously aired content
• 🎛️ FFmpeg Integration: High-quality video processing and transcoding
• 🌐 Web Interface: Easy-to-use web-based management interface
• 🔗 Home Assistant Integration: Seamless integration with your Home Assistant setup
• 📡 EPG Support: Electronic Program Guide with configurable refresh intervals

Installation

1. Add this repository to your Home Assistant add-on store:

   • Go to Supervisor > Add-on Store > ⋮ > Repositories
   • Add the repository URL: https://github.com/toellbe/ssha

2. Choose one add-on and click Install:

   • "Snappier Server" (stable)
   • "Snappier Server Beta" (beta)

3. Configure the add-on (see Configuration section below)

4. Start the add-on

Configuration

Basic Configuration

use_curl_to_download: true
download_speed_limit_mbs: 0
enable_remux: true
enable_epg: false
epg_url: ""
epg_refresh_interval: 24
recordings_folder: "/share/snappier/recordings"
movies_folder: "/share/snappier/movies"
series_folder: "/share/snappier/series"
pvr_folder: "/share/snappier/pvr"
api_token: ""
timezone: "Europe/Berlin"
ssl_cert: "/ssl/fullchain.pem"
ssl_key: "/ssl/privkey.pem"

Advanced Configuration Options

Option	Description	Default
use_curl_to_download	Use curl instead of FFmpeg for downloads	true
download_speed_limit_mbs	Download speed limit in MB/s (0 = unlimited)	0
enable_remux	Enable video remuxing	true
enable_epg	Enable EPG (Electronic Program Guide) functionality	false
epg_url	EPG (Electronic Program Guide) URL (optional)	""
epg_refresh_interval	EPG refresh interval in hours (1-168)	24
recordings_folder	Path for recordings	/share/snappier/recordings
movies_folder	Path for movies	/share/snappier/movies
series_folder	Path for TV series	/share/snappier/series
pvr_folder	Path for PVR recordings	/share/snappier/pvr
api_token	Auto-filled generated API token (managed by add-on)	""
timezone	Timezone for scheduling	Europe/Berlin
ssl_cert	SSL certificate path (optional)	/ssl/fullchain.pem
ssl_key	SSL private key path (optional)	/ssl/privkey.pem

HTTPS / SSL

• HTTPS is enabled only when both configured files exist:
  • ssl_cert
  • ssl_key
• If one of the fields is empty or a file is missing, the add-on runs on HTTP.
• Default prefilled paths match Home Assistant SSL mapping:
  • /ssl/fullchain.pem
  • /ssl/privkey.pem

Usage

Accessing the Web Interface

Once the add-on is running, you can access the Snappier Server web interface at:

• External Access: http://[HOME_ASSISTANT_IP]:7429
• Home Assistant: Use the "Open Web UI" button in the add-on interface

Port Configuration

The add-on uses fixed internal ports for better reliability:

• Snappier Server: Internal port 8000 → External port 7429

External port mappings are handled automatically by Home Assistant.

Storage

The add-on stores recordings and downloads in the /share/snappier/ directory:

• Recordings: /share/snappier/recordings/
• Movies: /share/snappier/movies/
• TV Series: /share/snappier/series/
• PVR: /share/snappier/pvr/

These directories are accessible from other Home Assistant add-ons.

Troubleshooting

Add-on Won't Start

1. Check the add-on logs for error messages
2. Ensure your configuration is valid
3. Verify that the specified ports are not in use
4. Check that the storage directories exist and are writable

Web Interface Not Accessible

1. Ensure the add-on is running
2. Check that port 7429 is not blocked by your firewall
3. Verify the add-on configuration

Storage Issues

1. Ensure the /share/ directory has sufficient space
2. Check write permissions to storage directories
3. Verify the configured storage paths exist

Technical Details

Architecture

• Base Image: Debian Linux for glibc compatibility
• Snappier Server (stable): CLI binaries v1.3.4 from https://snappierserver.app/files/
• Snappier Server Beta: CLI binaries v1.5.0ab from https://snappierserver.app/betaFiles/
• Video Processing: FFmpeg integration
• Multi-Architecture: Support for amd64, aarch64

Build Information

• Stable and beta channels use separate CLI binary feeds (not Docker wrapper)
• Simplified single-service architecture
• Fixed port mapping for stability
• Persistent storage integration

Support

If you encounter a bug, have a feature request, or need help, feel free to open an issue on GitHub. Feedback and contributions are always welcome!

Version History

See snappier-server/CHANGELOG.md for all version changes. See snappier-server-beta/CHANGELOG.md for beta channel changes.

License

This project is licensed under the MIT License. See LICENSE for details.

Credits

• Snappier Server by Sarah Bainbridge
• Snappier IPTV by Sarah Bainbridge
• Home Assistant add-on adaptation and integration
• Community feedback and contributions

---

Repository Structure

ssha/
├── README.md                          # This file
├── repository.json                    # Repository configuration
├── snappier-server/                   # Stable channel add-on
│   ├── config.yaml                    # Add-on configuration
│   ├── Dockerfile                     # Container build instructions
│   ├── README.md                      # Stable add-on documentation
│   ├── CHANGELOG.md                   # Stable version history
│   ├── LICENSE                        # MIT License
│   └── rootfs/                        # Container filesystem
│       ├── etc/
│       └── opt/
└── snappier-server-beta/              # Beta channel add-on
    ├── config.yaml                    # Add-on configuration
    ├── Dockerfile                     # Container build instructions
    ├── README.md                      # Beta add-on documentation
    ├── CHANGELOG.md                   # Beta version history
    ├── LICENSE                        # MIT License
    └── rootfs/                        # Container filesystem
        ├── etc/
        └── opt/

---