viranch/tv repository overview

⁠docker-tv

Entertainment automation for home (RaspberryPi) and VPS in a docker image

⁠What does the image contain?

• Transmission⁠ server for downloading media from torrents.
• Jackett⁠ as the torrent search aggregator backend.
• Dashboard web page (http://your-ip/) that shows:
  • Torrent search bar, with direct "Download" button in search results.
  • The Transmission web interface
  • Web view of the downloads directory (hosted by Apache⁠, styled by Apaxy⁠).
• Automatic download of new episodes as and when they're aired, using personalized feed from showRSS⁠.
• Push notifications of finished downloads via PushBullet⁠.

⁠What does it look like?

⁠Search for torrents

⁠Select from search results

⁠Torrent downloads

⁠Push notification of download complete

⁠How to use?

• Get a VPS or a RaspberryPi⁠ and install any Linux OS (preferably, with a good docker support; choose one of Ubuntu & ArchLinux if in doubt).

• Install docker⁠ on it.

• Run the container:

docker run -d --name tv -v $PWD/data:/data -p 80:80 viranch/tv

• [OPTIONAL] To use episode download automation, create an account on showRSS⁠ and add your favourite shows. Get the link to the RSS feed from "My Feed" tab, it should be of the form: http://showrss.info/user/XXXXXXX.rss. Pass this link as RSS_FEED environment variable:

docker run -d --name tv -v $PWD/data:/data -p 80:80 -e RSS_FEED=http://showrss.info/user/XXXXXXX.rss viranch/tv

• [OPTIONAL] For getting push notifications of download complete on your phone, there are various options:
  • Install the one of the Transmission Andoird apps (Remote Transmission⁠ or Transmission Remote⁠) and configure the remote server, then enable download finished notifications in app settings.
  • If you have an iPhone, the other alternate is PushBullet⁠. The image has in-built support for PushBullet, just declare your API token as PB_TOKEN environment variable.

docker run -d --name tv -v $PWD/data:/data -p 80:80 -e RSS_FEED=http://showrss.info/user/XXXXXXX.rss -e PB_TOKEN=XXXXX viranch/tv

• [OPTIONAL] To protect your container, you can also set a username & password for basic authentication, using the AUTH_USER & AUTH_PASS environment variables:

docker run [...] -e AUTH_USER=bob -e AUTH_PASS=myprecious [...] viranch/tv

• Navigate to http://your-ip/. You can change the port with the -p switch, eg: -p 8000:80.