Skip to content

TuxMC-sys/blissflixx-purple

 
 

Repository files navigation

Raspberry Pi + TV = <3

Use a Raspberry Pi to turn any screen into a smart streaming experience!

Watch movies, tv shows, documentaries and almost any video in the Internet, instantly.

Control everything from a web browser.

Built with awesome free software tools that respect your privacy and put you in control. No ads, no tracking.

Website: https://diegorodriguezv.github.io/blissflixx/

Features

BlissFlixx allows you to stream various types of video and audio content directly from the internet to your television. Supported media sources include:

  • Youtube
  • Vimeo
  • Facebook
  • Twitch
  • Catchup TV services such as BBC iPlayer
  • Full movies and documentaries on Youtube
  • Torrents (including magnet links)
  • Local media files
  • Video/Audio from hundreds of other websites

All media (including torrents) are streamed on demand and you do not need to wait for a download to complete.

BlissFlixx allows for easy discovery of media by installing channels which group related content by category and allow user defined searches. e.g Documentary channel, Youtube channel, BBC iPlayer channel etc. New channels are easily created.

Multilingual subtitles can automatically be added to Movies and TV shows.

The user may also create multiple playlists to organise their favourite content.

The media server can be controlled via a web interface from any computer, tablet or phone.

Screenshots

BlissFlixx Channels

Youtube Movies Channel

Documentary Channel

BBC iPlayer Channel

Video Controls

Prerequisites

  • Raspberry Pi (Not model A) with at least 8Gb SD card running Raspbian. You should also have about 2 Gb of free space on the card.
  • Broadband connection with enough speed to support video streaming. Ideally you should have a wired ethernet connection into your Pi as some WiFi adapters may have problems with streaming.
  • Television plugged into Raspberry Pi.
  • Computer, tablet or smartphone for controlling server.

Installation

IMPORTANT: BlissFlixx installation requires Raspberry PI OS 10 (Buster) 32 bits - desktop or lite

To install git clone this repository:

git clone https://github.com/TuxMC-sys/blissflixx-purple.git

Now enter the BlissFlixx folder and run the configure script which will install all the required external dependencies:

cd blissflixx-purple
sudo ./configure.sh

It will take about 1 hour for this script to complete so now might be a good time to wash the dishes or take the dog for a walk. Note that during the execution of the script various warnings will be reported but this is expected.

configure.sh options

The configure.sh script will install BlissFlixx dependencies and set up the python environment. But it can also perform other optional tasks which are invoked with the following arguments:

  • -boot

Install a system service script to run BlissFlixx when the system starts up. The command executed at boot is run.sh in case you want to modify it.

  • -blank

Install a system service script to blank the screen when the system starts up. It's particularly useful when using a 'lite' version without an X desktop as the screen is full of boot up messages. Blanking the screen allows the screen to enter in a power saving mode more easily. For installations with a desktop environment this can also be useful so the script configures the X screensaver to blank the screen after 10 seconds. The command executed at boot is blank_screen.sh in case you want to modify it.

  • -uninstall

Remove the system service scripts installed by BlissFlixx.

  • -only

Performs only the options invoked. Useful to configure BlissFlixx after initial installation.

For example sudo ./configure.sh -only -blank will just install the blank screen screen service, skipping over installation.

configure_py.sh

The configure_py.sh script will set up the python environment for BlissFlixx.

Running the server

Once the configuration script is complete you can start the server by running:

./blissflixx.py

Note that the first time you start the server it will first take a few moments to complete the installation.

Once you see the message "ENGINE Bus STARTED" the server will be up and running. Now open up a browser on your phone, tablet or PC and point it at:

http://ip-address-of-your-pi:6969

So for example if the IP address of the Raspberry Pi is 192.168.1.4. Then you need to point your browser to:

http://192.168.1.4:6969

If you want to run the server on the default port 80 then you will need start the server with the --port flag:

./blissflixx.py --port 80

Finally if you want the server to continue running even after you log out of your session (which is usaully the case) then specify the --daemon flag:

./blissflixx.py --port 80 --daemon

Fortunately there is a script to run the above command:

./start.sh

If you have netbios installed in your network, chances are you can access your raspberry pi using it's hostname:

If you have an Apple device (iPad, Mac etc) read this article for details on how to get this to work with Windows devices.

User guide

When you first connect your browser to the BlissFlixx server you should be presented with the following page showing your installed channels:

BlissFlixx Homepage

This page will allow you to browse all the channels that you have installed and enabled.

To remove any channels you are not interested in click on the settings cog icon on the top menu bar and then select the 'MANAGE CHANNELS' option.

Now select a channel such as Youtube Movies. You will then see a screen like the following:

Youtube Movies Channel

The default view is to list all the latest movies submitted to the channel. However you can also select the categories at the top of the page to view movies of the selected genre.

To play a movie simply click on the title link and the movie will start playing.

You can also search for specific movies from the search box.

All the other channels behave in a similar fashion with a list of categories and an optional search facility.

You can also add any media item to a playlist which is covered in the following section.

Playlists

You can organise your media by creating playlists:

BlissFlixx playlists

To create a playlist click on the 'NEW PLAYLIST' button and specify a title. You can then go and add a thumbnail and description for the playlist by clicking on the 'Edit Playlist' button.

When you are browsing your channels you will have an option to add items to your created playlists.

Play URL

If you want to play something that is not provided by any of your channels then you can use this page to play it. First select the play icon in the menu bar and then copy the URL of the page containing the video and paste it into the 'What to Play' box. You will then be able to play and/or add it to a playlist.

Note that you can also play torrents and magnet links by pasting the link as documented above.

Search

The search page allows you to search all of your channels simultaneously. Simply enter your query terms into the search box and you will be presented with the results grouped by channel.

Subtitles

Movies and TV shows will have an option saying 'Play With Subtitles'. Selecting this option will allow you to specify your preferred language as well as other metadata required to find the correct subtitles.

Settings

The settings page currently contains two options. The first - MANAGE CHANNELS - allows you to disable or enable any installed channels.

The second option - RESTART & UPDATE - will restart and also update the server to the latest release. If you come across any problems make sure you first update the server to the latest version to check if the issue has already been fixed.

Help

If you find a bug or want to ask a question please use the github issues page.

More information can be found at the wiki.

Supported media sites

BlissFlixx relies on yt-dlp for extracting media so a list of supported sites can be found on it's project site: https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md

Plugins

For information about what extra plugins are available please check the Plugin Development section of the wiki.

Credits

BlissFlixx relies on the following projects to do all the heavy lifting:

BlissFlixx used to rely on the following software projects:

About

Raspberry Pi + TV = Smart streaming experience.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 47.0%
  • JavaScript 31.0%
  • HTML 15.3%
  • CSS 3.9%
  • Shell 2.8%