Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/andrew-ld/smart-tv-telegram
stream movies from telegram to smart tv
https://github.com/andrew-ld/smart-tv-telegram
telegram-bot video
Last synced: 6 days ago
JSON representation
stream movies from telegram to smart tv
- Host: GitHub
- URL: https://github.com/andrew-ld/smart-tv-telegram
- Owner: andrew-ld
- License: agpl-3.0
- Created: 2019-11-01T20:13:49.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-07-27T17:20:26.000Z (4 months ago)
- Last Synced: 2024-10-02T00:39:08.857Z (about 1 month ago)
- Topics: telegram-bot, video
- Language: Python
- Homepage:
- Size: 160 KB
- Stars: 179
- Watchers: 16
- Forks: 54
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# smart-tv-telegram [](https://pypi.org/project/smart-tv-telegram/) [](https://github.com/andrew-ld/smart-tv-telegram/blob/master/LICENSE) [Docker](https://hub.docker.com/r/andrewhyphenld/smart-tv-telegram)
A Telegram Bot to stream content on your smart TV (also Chromecast, FireTV and other UPnP device)
### Demonstration video
[](https://player.vimeo.com/video/452289383)
## 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](https://developers.google.com/cast/docs/media#video_codecs)
Note: Most LG TVs with WebOS have an incorrect UPnP implementation
## How-to setup (Release from pypi)
Make sure you have an updated version of python, only the latest version will be supported
- Install smart-tv-telegram from pip
- Download config.ini.example as config.ini
- Edit config.ini
- Start from python entrypoint
```bash
python3 -m pip install --upgrade smart-tv-telegram
curl https://raw.githubusercontent.com/andrew-ld/smart-tv-telegram/master/config.ini.example -o config.ini
nano config.ini
smart_tv_telegram -c config.ini -v 1
```
## How-to setup (Manual build)
Make sure you have an updated version of python, only the latest version will be supported
- Download the repository
- Build wheel package
- Install package
- Copy config.ini.example to config.ini
- Edit config.ini
- Start from python entrypoint
```bash
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 image
- Start Docker container
```bash
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](https://kodi.wiki/view/Settings/Services/UPnP_DLNA) (you should enable remote control)
##
**Q:** How do I get a token?
**A:** From [@BotFather](https://telegram.me/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](https://telegram.me/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