LibreELEC
LibreELEC is a beta platform: launching and readers work, but install and startup are manual.
Zaparoo Core on LibreELEC provides Kodi integration for movies, TV shows, and music. Also works on CoreELEC and other Kodi-based systems.
Install
Download Zaparoo Core for LibreELEC from the Downloads page, unzip it and copy the zaparoo file to /storage.
Enable SSH in LibreELEC settings (Services > SSH Server). Default credentials: root / libreelec.
cd /storage
./zaparoo -service start
Once Core is running, write your first token from the Zaparoo App or the built-in web UI at http://<libreelec-ip>:7497/app/.
Kodi API Setup
Enable Kodi remote control for Zaparoo to work:
- Open Settings > Services
- Change view setting to at least "Standard"
- Open the Control page
- Enable "Allow remote control via HTTP"
- Set a blank password
- Enable "Allow remote control from applications on this system"
Adding to Startup
Add to /storage/.config/autostart.sh:
/storage/zaparoo -service start
Uninstall
- Stop the service:
/storage/zaparoo -service stop - Remove the line you added to
/storage/.config/autostart.sh. - Delete
/storage/zaparoo, and/storage/.local/share/zaparooif you also want to remove your configuration and data.
File paths
| Item | Path |
|---|---|
| Config file | /storage/.config/zaparoo/config.toml |
| Data directory | /storage/.local/share/zaparoo |
| Log file | /storage/.local/share/zaparoo/logs/core.log |
| Mappings directory | /storage/.local/share/zaparoo/mappings |
The config file can be accessed through the SMB share in the Configfiles folder.
Client security
Encryption is off by default on LibreELEC, so the Zaparoo App and browsers connect without pairing. To require pairing with a PIN, set encryption = true in config.toml; Core then shows the PIN under Settings > Clients > Pair in the terminal UI or with ./zaparoo -pair.
Readers
Each reader's page has setup steps and troubleshooting. See readers to compare them, or the setup guide to pick one for your setup.
Launchers
LibreELEC uses Kodi as its primary launcher. Kodi media is played through the Kodi JSON-RPC API. Plex and Jellyfin launchers play on a TV or other player. See Media Servers.
Local Files
These launchers play files directly from disk in /storage/:
| System ID | Folders | Extensions |
|---|---|---|
Video | videos, tvshows | .avi, .mp4, .mkv, .iso, .bdmv, .ifo, .mpeg, .mpg, .mov, .wmv, .flv, .webm, .m4v, .3gp, .ts, .m2ts, .mts, .m3u, .m3u8 |
MusicTrack | music | .mp3, .flac, .ogg, .m4a, .wav, .wma, .aac, .opus |
Library Media
These launchers play media from Kodi's indexed library. They query Kodi's database during media indexing rather than scanning the filesystem.
| System ID | Description |
|---|---|
Movie | Movies from Kodi library |
TVEpisode | Individual TV episodes |
TVShow | Entire TV show (plays every episode from the first) |
MusicTrack | Songs from Kodi music library |
MusicAlbum | Albums from Kodi music library |
MusicArtist | Artists from Kodi music library (plays all songs) |
Shell scripts
Custom shell scripts (.sh files) can be launched directly. Scripts must be added to the allow_file list in config.toml.
[launchers]
allow_file = [
"^/storage/.*\\.sh$"
]
Restart Zaparoo after modifying the config for changes to take effect.