Browser Administration for Linux-Based Audio/Video-Player like ODROID or Raspberry Pi
PHP Shell JavaScript CSS HTML Python Other

README.md

Max2Play - Webinterface

Browser Administration for Linux-Based Audio/Video-Player like ODROID or Raspberry Pi.

More Information on http://www.max2play.com and http://shop.max2play.com

Find a live Demo of Max2Play Web interface at http://demo.max2play.com:81/.

FEATURES

  • browser interface for configuring WiFi, filesystem mountpoints, autostarts, display resolution, init-scripts, etc.
  • no need to ssh to your device any more
  • Plugin configuration to add new features and customize navigation
  • custom CSS and logo possible
  • easy to use even for non-programmers (configure mount-points, samba-shares, start/stop programs)
  • responsive layout - optimized for mobile devices
  • adds plug & play to existing audio/video-player releases
  • multilanguage support for basic settings and new plugins (german and english are already available with PO-files)

HOW TO INSTALL

  • install & configure apache webserver with php5 support: "apt-get install apache2 php5 php5-json"
  • Enable mod_rewrite for Apache "a2enmod rewrite"
  • Add "/etc/apache2/sites_enabled/max2play.conf" from repository "CONFIG_SYSTEM/apache2/" to point to the max2play directory and remove default from "/etc/apache2/sites_enabled/"
  • drop the files from the max2play-Folder of this repository to "var/www/max2play/"
  • reload webserver "/etc/init.d/apache2 reload"

HOW TO CONFIGURE

  • every task for the browserinterface needs little setup to work properly
  • the browser interface itsself uses script-files and configuration-files located in "/opt/max2play"
  • some file-permissions and sudoer-configs need to be set in order to get wifi and other things working in the max2play-interface
  • activate or deactivate Plugins on "Reboot / Reset"-Tab of webinterface

HOW TO UPDATE

  • On Basic-Settings in Webinterface click "check Max2play Update"
  • If a new version is available, the files in webserver-folder and /opt/max2play will be overwritten, just keeping wifi, samba and playername config-files

FILESTRUCTURE OF MAX2PLAY PROJECT

  • Webinterface is under /max2play
  • Config-Files for /etc/ under /CONFIG_SYSTEM
  • Config-Files for /home/USER under /CONFIG_USER
  • Packages with Scripts for /opt/ under /opt/

HOW TO CREATE NEW PLUGINS

  • copy an existing Plugin (e.g. a small one that exists): cp -r /var/www/max2play/application/plugins/squeezeplug /var/www/max2play/application/plugins/myplugin
  • change the Pluginname /var/www/max2play/application/plugins/myplugin/controller/Setup.php
  • there is always a backend- (folder "controller") and a frontend-file (folder "view"). Both have the same name and go together (see MVC-Schema).
  • if you want to call shell scripts best use the function $this->writeDynamicScript(array("SCRIPT GOES HERE"));
  • you can work with the return value of your script and pass it to the view
  • the view is used to place buttons and output data as well as take input data from forms
  • to activate your new plugin go to "Reset/Reboot" and mark your new Plugin -> save and reload page -> now your Plugin should be visible in the navigation

SCREENS OF CURRENT USAGE - THIS IS HOW IT LOOKS LIKE

This file is work in progress...