Simple yet powerful Web Media Player

This HTML5-based Media Player will allow you to stream your multimedia collection in a local network, or over the web. It supports the most popular web media formats, such as

• mp3
• ogg
• ogv
• webm
• mp4 (audio/video)
• flv

It also supports subtitles, file searching via media title or file name, media cover selection and much more.

It's written in C++ (C++11, to be precise), using Wt, Twitter Bootstrap, MediaElement.js and Video.js

• gcc 4.7 or above
• Wt 3.3.0 or above
• Boost
• GraphicsMagick++ (ImageMagick++ should work too, but I found it much less reliable)
• FFmpeg binary, libavformat/libavcodec/libavutil
• FFmpeg Thumbnailer
• Qt4 (Optional, to add a system tray icon when your server is running)

Also make sure to have a recent gcc version supporting C++11.

At least one of

• Sqlite3
• PostgreSQL

Mysql/MariaDB will probably be supported soon.

First, make sure to have all dependencies installed (if you are compiling from source code, you need the headers packages too).

Then, clone the repository and update the submodules.

$ git clone https://github.com/rockman81/Pandorica.git
$ cd Pandorica/
$ git submodule init
$ git submodule update

Configure and build Pandorica

$ mkdir build
$ cd build
$ cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=/usr
$ make
$ sudo make install

Then, just run the 'Pandorica' command. When used with no arguments, Pandorica will run on localhost:8080, and store your media database in $HOME/.config/Pandorica/Pandorica.sqlite

Pandorica is already mostly mobile ready. You just need to set

<progressive-bootstrap>true</progressive-bootstrap>

in your wt_config.xml file.

Use the --help option for the most common options, and the --help-full option to see all command line options (including Wt default ones). Lookup the official Wt Reference Page for a detailed overview.

Pandorica also uses some extra configuration properties. You can set them in the "properties" section of your wt_config.xml file (usually located in /etc/wt, you can use a different one with the "-c" option).

If you want to publish your Pandorica box over the internet it is highly reccomended to run it inside an existing web server installation (like apache, lighttpd, nginx) Follow these steps:

• Configure your webserver to forward requests to Pandorica. You can achieve this by configuring mod_proxy in your webserver.
• Configure some alias paths in your webserver. For instance, you will need the Wt resources folder (/usr/share/Wt/resources/) and Pandorica static resources (/usr/share/Pandorica/static/). Wt resources should be aliased as "/resources" on your webserver (you can configure it in your wt_config.xml file). You can choose Pandorica static resources path, and tell Pandorica this path with the --static-deploy-path argument.
• Optionally, but reccomended, configure a PostgreSQL connection (see below)
• Also optional, select a different http port in Pandorica if the default (8080) is busy with the --http-port argument After completing these steps, you can run Pandorica in managed mode: $ Pandorica --server-mode managed --static-deploy-path /pandorica-static Or, if you configured your webserver mod_proxy to deploy Pandorica as a subdirectory: $ Pandorica --server-mode managed --static-deploy-path /pandorica-static --deploy-path /Pandorica

Example property entry:

<property name="psql-connection">application_name=streamingapp host=localhost port=5432 dbname=streaming_app_database user=streamingapp_pg_username password=streamingapp_pg_password</property>

If psql-connection property is set, Pandorica will not use the Sqlite3 connector.

Email verification (strongly suggested if you are deploying your Pandorica box on the internet):

<property name="email-verification-mandatory">true</property>

Email addresses:

<!-- Streaming App settings -->
<property name="auth-mail-sender-name">Streaming App</property>
<property name="auth-mail-sender-address">admin@localhost</property>
<!-- put a REAL address here, you will have to receive warnings here! -->
<property name="admin-mail-name">StreamingApp Admin</message>
<property name="admin-mail-address">admin@localhost</message>

Remember to install a local SMTP server to relay emails, particularly if you set email-verification-mandatory true. If you don't, your users will not be able to login!

You can also enable OAuth authentication: Google and Facebook providers are supported

• quit-password: if you define this property, you can quit or restart the application by calling either:

    http://pandorica_url/graceful-quit?pwd=<your-password> (waits for existing sessions to shutdown)
    http://pandorica_url/force-quit?pwd=<your-password>
    http://pandorica_url/graceful-restart?pwd=<your-password> (waits for existing sessions to shutdown) 
    http://pandorica_url/force-restart?pwd=<your-password>
  

• icons: Humano2 icon theme
• Web framework: Wt
• CSS framework: Twitter Bootstrap