Feature List
Easy Setup
...whether you choose docker or vanilla, local or remote.
Media Management
Easy drag-and-drop to upload your media to streama!
Live Sync Watching
Watch with your loved ones remotely, with sync for play/pause and scrubbing.
Beautiful Video Player
With an episode and season browser.
Multi-User Capable
Create accounts for anyone you like and grant them specific privileges.
Continue Watching
The system remembers where you left off last time!
Related Movies & Shows
The system detects similar movies and shows for you to add.
Open Source
Use, change and distribute the code as much as you want!
File Browser
Access your current Files with the built-in file browser
Video Conversion
Coming soon...
Media crawler
Coming soon...
Chromecast support
Coming soon...
Newsletter
Subscribe to new feature announcements and hot releases!
Easy Setup
Step 1 - Java
If you don't have it already, go ahead and download a copy of JDK8 (Oracle) and install JDK as usual, make sure to let JDK add new variables to your system.
Step 2 - Download the executable & config
- Download the most recent .war file in the releases page.
wget https://github.com/dularion/streama/releases/download/v1.0.11/streama-1.0.11.war -O streama.war - Make executable for user:
sudo chmod u+x streama.war - download the sample_application.yml
as application.yml and place it in the same directory as the war file.
wget https://raw.githubusercontent.com/dularion/streama/master/docs/sample_application.yml -O application.yml
Step 3 - Run the application
- open your command line tool
- on a unix-system (Ubuntu, Mac, etc), run
./streama.war - on Windows (untested), run
streama.war - This command will run the application in an embedded server against a local database http://localhost:8080
Step 4 - Login
the first thing you will see when opening the URL is a login screen. Use username admin and
password admin to log in. Enjoy
For further information and FAQ, see the Up and Running with v1 Wiki
Step 1 - Java
Ubuntu15: sudo apt-get install openjdk-8-jdk
Ubuntu14: see the instructions
Step 2 - Download the executable
- Download the most recent .war
file in the releases page.
wget https://github.com/dularion/streama/releases/download/v1.0.11/streama-1.0.11.war -O streama.war - Make executable for user:
sudo chmod u+x streama.war - download the sample_application.yml
as application.yml and place it in the same directory as the war file.
wget https://raw.githubusercontent.com/dularion/streama/master/docs/sample_application.yml -O application.yml
Step 3 - Run the application
./streama.war
the first thing you will see when opening the URL is a login screen. Use username admin and
password admin to log in. Enjoy
Tipps
- use systemctrl to run the war as a service in the background. see instructions here
- customize the database to be mysql with your own secure username and password. see instructions here
For further information, FAQs and other tricks, see the Up and Running with v1 Wiki
Build Docker-Image from Source (optional)
Dependencies: git, oraclejdk7
git clone git@github.com:dularion/streama.git cd streama make
Run Docker Image
Dependencies: docker, MySQL
docker run -d --name=“streama” -p 8080:8080 -p 4000:4000 -v /data:/data -e “MYSQL_HOST=mysqlhost” -e “MYSQL_PORT=3306” -e “MYSQL_DB=streama” -e “MYSQL_USER=streama” -e “MYSQL_PASSWORD=streama” whatever/streama
Parameters
- -d run as daemon
- MYSQL_HOST default: mysql
- MYSQL_PORT default: 3306
- MYSQL_DB default: streama
- MYSQL_USER default: streama
- MYSQL_PASSWORD default: streama
- whatever/streama That is the name of the docker image, both on docker-hub and if you build it from source
Run Docker Image & Linked MySQL-Container
Dependencies: docker
docker run --rm -it --name="streama" -p 8055:8080 -p 4000:4000 --link mysql:mysql -e “MYSQL_HOST=mysqlhost” -e “MYSQL_port=3306” -e “MYSQL_DB=streama” -e “MYSQL_USER=streama” -e “MYSQL_PASSWORD=streama” whatever/streama
Media Upload
The Admin-Panel
One of the most important things to me was to make managing shows, movies, and episodes as easy and fun as possible. For this I made heavy use of the API from theMovieDatabase.org, which auto-fills the episodes, shows and movies with useful information and great images. This eases the user's role in adding content.
For example, creating a new TV-show and the episodes for the first season looks something like this:
Uploading video-files for each episode is as easy as drag-and-drop!

Live Sync Watching
Video Player
The Player
The Streama-Player is (heavily) inspired by Netflix, so you get all the good stuff from there. For Shows, there is a "next episode" button and a handy episode/season browser. There are also the basics: volume-control, play/pause, and fullscreen. Later down the road I will add a feature to add subtitles and switch between video-files (for instance for different quality uploads). The player is HTML5-based and has only really been tested in Chrome so far.
The Episode Browser
I am especially proud of the Episode-Browser, which aims to function just like on Netflix. By default, the current video-file's season is selected. The user gets an overview of which other episodes there are in the season, how many seasons there are, and, as an added feature, the user sees all the added episodes, even if no video-files are added to them (thus greyed out).
Multi-User Capable
Users can be invited and managed in the admin-panel. By default, they have no role, meaning they can only view videos. As admins, they can manage the server settings and invite other users. As content-managers, they can create and upload content. Thus, users with both roles, have full.
Once a user is invited and has access to the application, they can edit their Profile. Here, they can set a full name, change their password and even set some favorite genres. At present these the genres are not used for anything, but this can pave the way for automatic playlists such as "recommended to you".
Continue Watching
If you are watching a show with many episodes, or stop a movie somewhere in the middle, it is really useful to be able to come back at a later point and find links to the show/movie that you lead you directly where you left off! Streama periodically saves your viewing status while you watch any type of content, and it is smart enough to differentiate between a single movie and a show containing multiple episode (where it only always saves the latest entry)
Related Movies & Shows
Sometimes you add a movie to streama because you anticipate that you will feel like watching it soon. In such a case, it can be useful if you also get some suggestions regarding similar movies that you also might want to add. Streama makes this especially easy for you, as you can simply click on a suggested movie to create it, and then you can add your video file to it at a later point if you wish.
Open Source
This project is completely open source for anyone who wishes to use, share or contribute to it. It is published under the MIT License. You can find a link to the license here.
File Browser
Access existing Files on your harddrive by setting the directory in the settings and then browsing to the files when editing a movie or a show.
Copyright Notification
Streama does not permit copyright infringing activities and infringement of intellectual property rights on its demo-website, and will remove all Content if properly notified that such content infringes on another's intellectual property rights. Streama reserves the right also to block a specific IP-address from accessing the demo-website, if they are determined to be a repeat infringer.
If you believe that your work has been copied in a way that constitutes copyright infringement, please provide Streama with the written information specified below:
- physical or electronic signature of the person authorized to act on behalf of the owner of the copyright interest that is allegedly infringed;
- description of all of the copyrighted works that you claim has been infringed upon;
- description of where the material that you claim is infringing is located on the Streama demo-website, including, a URL of the specific location of the infringing material;
- Information sufficient to allow us to contact you including, at a minimum, your address, telephone number, and e-mail address;
- statement by you that you have a good-faith belief that the disputed use is not authorized by the copyright owner, its agent, or the law; and
- statement by you, made under penalty of perjury, that the above information in your notice is accurate and that you are the copyright owner or authorized to act on the copyright owner’s behalf.
To submit a Copyright Notification, please write an email to this address.




