BG Live TV — Stremio Addon

What you get

Features

📺

65+ Live Channels

Full Bulgarian TV lineup — news, sports, entertainment, kids, and more.

⚡

HLS Streams

High-quality .m3u8 streams fetched fresh on every play request.

📱

All Devices

Works on PC, Android TV, Fire TV Stick, and any Stremio client.

🔓

No Account

No registration, no subscription. Self-hosted on your own server.

🐳

Docker Ready

One command to spin up with Docker Compose. Zero config needed.

🖼️

Channel Logos

All channel logos downloaded locally — no external image dependencies.

Setup

Installation

The recommended way. Requires Docker Compose.

1. Clone the repository

bash

git clone https://github.com/hjelev/bgtv-stremio.git
cd bgtv-stremio

2. Start the addon

bash

docker compose up -d --build

The addon starts at http://localhost:7000

Useful commands

bash

docker compose logs -f      # follow logs
docker compose down         # stop and remove the container
docker compose pull         # pull latest image

Requires Docker.

1. Build the image

bash

git clone https://github.com/hjelev/bgtv-stremio.git
cd bgtv-stremio
docker build -t stremio-bgtv .

2. Run the container

bash

docker run -d \
  --name stremio-bgtv \
  -p 7000:7000 \
  --restart unless-stopped \
  stremio-bgtv

The addon starts at http://localhost:7000

Stop / remove

bash

docker stop stremio-bgtv
docker rm stremio-bgtv

Requires Node.js v18+ (use nvm if needed).

1. Clone and install dependencies

bash

git clone https://github.com/hjelev/bgtv-stremio.git
cd bgtv-stremio
npm install

2. Download channel logos

bash

npm run download-images

Downloads all 65 channel logos to public/images/tvlogo/

3. Start the server

bash

npm start

The addon starts at http://localhost:7000

Add to Stremio

Installing the Addon

Manifest URL

http://localhost:7000/manifest.json

Replace localhost with your server's local IP to install from another device on the same network (e.g. http://192.168.1.x:7000/manifest.json).

1

Open Stremio

Launch the Stremio app on any of your devices — PC, Android TV, Fire TV Stick, etc.

2

Go to Addons

Click the puzzle-piece icon or navigate to Addons → Community Addons → Install from URL.

3

Paste the manifest URL

Enter http://localhost:7000/manifest.json (or your server's IP) and click Install.

4

Watch live TV

Go to the TV section in Stremio — your Bulgarian live channels will appear under the BG Live TV catalog.

Under the hood

How it works

1

Catalog

The addon scrapes the channel list from the source site with cheerio and serves it as a Stremio TV catalog — complete with channel names and logos. Results are cached for 1 hour.

2

Stream extraction

When you pick a channel, the addon fetches that channel's page and extracts the embedded HLS stream URL from the JWPlayer file:"…" script via regex — in real time.

3

Playback

Stremio receives a fresh, time-limited .m3u8 URL and starts playback immediately — no buffering layers or intermediaries.

Technical details

Addon Manifest

Field	Value
ID	`org.custom.bgtv`
Name	BG Live TV
Version	`1.0.0`
Type	`tv`
Catalog ID	`bg_tv`
ID prefix	`bgtv_`
Resources	`catalog`, `meta`, `stream`
Default port	`7000`