A Telegram Bot to stream content on your smart TV
Project description
smart-tv-telegram Docker
A Telegram Bot to stream content on your smart TV (also Chromecast, FireTV and other UPnP device)
Demonstration video
Feature
- Streaming, the bot will not have to download the entire file before playing it on your device
- You can play anything if your device has the right codec
- You can stream on any device that supports UPnP (AVTransport)
- Chromecast, Vlc (telnet api) and Kodi (xbmc http api) support
- Streaming over HTTP
- Web interface that plays videos in your browser
Note: Chromecast (1st, 2nd and 3rd Gen.) only supports H.264 and VP8 video codecs
Note: Most LG TVs with WebOS have an incorrect UPnP implementation, throw it in the trash and buy a new TV
How-to setup
Make sure you have an updated version of python, only the latest version will be supported
(currently it also works on Python 3.6)
- Download the repository
- Install python dependencies from requirements.txt
- Copy config.ini.example to config.ini
- Edit config.ini
git clone https://github.com/andrew-ld/smart-tv-telegram
cd smart-tv-telegram
python3 -m pip install wheel
python3 setup.py sdist bdist_wheel
python3 -m pip install dist/*.whl
cp config.ini.example config.ini
nano config.ini
smart_tv_telegram -c config.ini -v 1
How-to setup (Docker)
- Copy config.ini.example to config.ini
- Edit config.ini
- Build Docker
- Start Docker
cp config.ini.example config.ini
nano config.ini
docker image build -t smart-tv-telegram:latest .
docker run --network host -v "$(pwd)/config.ini:/app/config.ini:ro" -d smart-tv-telegram:latest
Troubleshooting
Q: How do I use the web interface?
A: Set enabled
to 1
in web_ui
config block, and change the password
-
open http://
listen_ip
:listen_port
/static/index.html -
now if you send a video in the bot on telegram you can choose to play it in the browser
Q: My Firewall block upnp and broadcasting, how can use kodi without it
A: Set xbmc_enabled
to 1
and add your kodi device to xbmc_devices
list
Q: What is the format of xbmc_devices
A: A List of Python Dict with host
, port
, (and optional: username
and password
)
example: [{"host": "192.168.1.2", "port": 8080, "username": "pippo", "password": "pluto"}]
Q: How-To control vlc from this bot
A: set vlc_enabled
to 1
and add your vlc device to vlc_devices
list
Q: What is the format of vlc_devices
A: A List of Python Dict with host
, port
, (and optional: password
)
example: [{"host": "127.0.0.1", "port": 4212, "password": "123"}]
Q: How-To enable upnp on my device that use kodi
A: follow this guide (you should enable remote control)
Q: How do I get a token?
A: From @BotFather
Q: How do I set up admins?
A: You have to enter your user_id, there are many ways to get it, the easiest is to use @getuseridbot
Q: How do I get an app_id and app_hash?
A: https://core.telegram.org/api/obtaining_api_id#obtaining-api-id
Q: The video keeps freezing
A: Check the video bitrate, this bot supports maximum ~4.5Mb/s
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file smart_tv_telegram-1.3.7.dev0.tar.gz
.
File metadata
- Download URL: smart_tv_telegram-1.3.7.dev0.tar.gz
- Upload date:
- Size: 32.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | dbdb48af20c6ca460466c3fa14cab06b2f9af264888dcfa9954acf6a3d7159ac |
|
MD5 | 86df3bb04a5ed80c1a570386c79c4492 |
|
BLAKE2b-256 | 2401f0b8b1c71a51be68165a3b7c1fa8ac6c4735830f50442c2f06837b04f4dd |
File details
Details for the file smart_tv_telegram-1.3.7.dev0-py3-none-any.whl
.
File metadata
- Download URL: smart_tv_telegram-1.3.7.dev0-py3-none-any.whl
- Upload date:
- Size: 36.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 21b4d0d70ec57531351302dac7b3f54ab58fea0ce21909aa332d70924a6f7970 |
|
MD5 | 4bda1704d70de7cb812979e1f63860ce |
|
BLAKE2b-256 | 1697645dc48037511ba9f6f2dfcb7695666e57a2c46dba48a1e821509ef3bb71 |