MPD-Web-Remote

MPD-Web-Remote copied to clipboard

+==============================================================================+ | Remote WebApp | | Version 1.0 | | An MPD media interface intended for iOS Devices | | Thomas Preston | +==============================================================================+

Copyright (C) 2011  Thomas Preston

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

================================================================================ About:

For this to work you will need:

• MPD (obviously)
• a webserver with PHP installed
• a webkit compatible web browser (Mobile/Safari, Google Chrome)

Then just put the remote directory somewhere on your server. I have it at /srv/http/remote but you can put it wherever you like.

Browse to it on your phone and then go to the bookmarks icon and press 'Add to Home Screen'. The idea is for the web application to look and feel like a native app. You can change the colour of the icon by replacing the apple-touch-icon.png with one of the other icons in appleTouchIcons or by creating your own.

If you have any suggestions or bugs then please contact me at: [email protected]

HUGE thanks to:

• iWebKit for the style sheets; without which I this would't have looked half as pretty! http://snippetspace.com/projects/iwebkit/

• Whoever made mpd.class.php.

• MPD Protocol reference for my help with my custom commands. http://www.musicpd.org/doc/protocol/index.html

• Ellen Speakman for providing the touch icons. x

• Radioactivity for the speaker icon. http://radioactivity.deviantart.com/art/Speaker-Icon-110884165

Thank you. :-)

================================================================================ Change Log:

27/02/11 - First Release

================================================================================ Explanation (in case you want to make some changes):

Files:

• apple-touch-icon.png - WebApp icon for iOS's springboard

• startup.png - An placeholder while the webpage loads on an iPhone

• NOTE: You will have to bookmark the webapp to your homescreen to see these.

• index.php - main remote interface

• playqueue.html - displays the playqueue

• addtrack.html - Add tracks root; shows all songs, playlists and search

• showSongs.php - second level for adding tracks; shows the actual tracks

• appleTouchIcons - contains some extra icons
• css - style sheets
• javascript - all of the client side code
• mpd - all of the server side code

• mpd.class.php - interfaces with the MPD server
• mpdconfig.php - handy config file
• mpdcontrol.php - my front end for controlling MPD (uses mpd.class.php)
• mpdquery.php - my front end for querying MPD (uses mpd.class.php)
• globalFunctions.php - some global functions. NEAT. UNT. TIDY.

• images - um... well... images...

Simple explanation: The client side javascript deals with most user input and then, using ajax, passes commands to the mpd files stored on the server. They all return some text values which are formatted by the javascript and then passed to the page.