Tellio

Tellio is a self-hosted Stremio live TV addon that reads either:

• an M3U playlist plus an XMLTV EPG source
• an Xtream Codes server URL with username and password

It creates one Stremio catalog per playlist group, lists channels with their logos as thumbnails, and updates now/next programme descriptions every 5 minutes.

Features

• Per-user configuration through a hosted /configure page
• Dynamic Stremio catalogs generated from M3U groups or Xtream categories
• Meta pages showing:
  • Currently Playing TV Show
  • Start Time - End Time
  • Next Up TV Show
  • Start Time - End Time
• Programme artwork used as fanart when available in XMLTV, with channel logo fallback
• Direct stream playback using the source URL, not VPS proxying
• Startup sync on first configured request, then automatic refresh every 5 minutes for active configs

Requirements

• Node.js 20+
• A VPS or other host reachable by Stremio

Run Locally

cd /home/jon/AI\ Projects/Tellio
npm start

The addon will listen on http://0.0.0.0:7000 by default.

Optional environment variables:

• PORT=7000
• HOST=0.0.0.0
• TELLIO_USER_AGENT=Tellio/0.1

Run With Docker Compose

From the project directory:

cd /home/jon/AI\ Projects/Tellio
docker compose up -d --build

Then check:

docker compose ps
docker compose logs -f

Stop it with:

docker compose down

Configure In Stremio

1. Start the server on your VPS.
2. Open http://YOUR_VPS:7000/configure
3. Enter either:
   • M3U URL and XMLTV URL
   • Xtream server URL, username, and password
4. Click Generate Install URL
5. Open the generated stremio://.../manifest.json link

Each user gets a unique encoded addon URL containing only their chosen source settings.

Supported Input Notes

• M3U and XMLTV can be remote URLs or local filesystem paths on the VPS.
• Gzipped XMLTV files such as .xml.gz are supported.
• Xtream endpoints are auto-derived as:
  • player_api.php?...&action=get_live_streams
  • xmltv.php?...

Deploy On A VPS

You can deploy either with Docker Compose or systemd. Docker Compose is the simplest route on a VPS.

Docker Compose

1. Copy the project to your VPS.
2. Change into the app directory.
3. Start it:

cd /opt/tellio
docker compose up -d --build

4. Verify it:

docker compose ps
curl http://127.0.0.1:7000/health

5. Open:

http://YOUR_VPS_IP_OR_DOMAIN:7000/configure

If you are using a reverse proxy such as Nginx, use your public HTTPS URL instead.

systemd

1. Copy the project to your VPS.
2. Create /etc/systemd/system/tellio.service

[Unit]
Description=Tellio Stremio Addon
After=network.target

[Service]
Type=simple
WorkingDirectory=/opt/tellio
ExecStart=/usr/bin/node /opt/tellio/server.js
Restart=always
RestartSec=5
Environment=PORT=7000
Environment=HOST=0.0.0.0

[Install]
WantedBy=multi-user.target

3. Enable and start it:

sudo systemctl daemon-reload
sudo systemctl enable --now tellio
sudo systemctl status tellio

If you expose it over HTTPS behind Nginx, use the public HTTPS URL for the configure page so the generated install link points to the correct host.

Route Summary

• /configure renders the config page
• /manifest.json returns the base configurable manifest
• /:configToken/manifest.json returns the configured manifest
• /:configToken/catalog/tv/:catalogId.json
• /:configToken/catalog/tv/:catalogId/:extraArgs.json
• /:configToken/meta/tv/:channelId.json
• /:configToken/stream/tv/:channelId.json

Current Limitations

• EPG channel matching uses tvg-id, Xtream epg_channel_id, and channel name fallbacks.
• Channel data is cached in memory only, so a restart clears active session caches until the next request.
• Some providers use unusual Xtream stream formats or incomplete XMLTV image metadata, which may need provider-specific tweaks later.