Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/max2play/webinterface

Browser Administration for Linux-Based Audio/Video-Player like ODROID or Raspberry Pi
https://github.com/max2play/webinterface

Last synced: 5 days ago
JSON representation

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

Awesome Lists containing this project

README 

        
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...