Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Listen to music on the go! Streeme is an open source, html5 based personal music server http://www.streeme.com
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
Take your MP3 or Ogg based music library anywhere with a modern web browser! Streeme offers a secure, private and legal way to serve your personal music collection online without purchasing expensive apps or hardware. Using the powerful Symfony php framework and MySQL 5, this app is a snap to install and run for yourself. Please download it, hack on it and make it better for everyone! LICENSE ------- See the license file LICENSE.TXT INSTALLATION ------------ See the installation file INSTALL.TXT CARE AND FEEDING OF YOUR STREEME -------------------------------- See the manual file in the Wiki - it's bound to change a lot In case the wiki is unavailable, here's a short guide Loading your media library --- this can be done from the commandline in the project dir You will need to fill out your app.yml with watched folders or an itunes path (note: on windows, the symfony command is php symfony instead of ./symfony) cd path/to/streeme ./symfony scan-media --type=itunes OR ./symfony scan-media --type=filesystem Getting art for your music can be done in the following ways from ID3 tags ./symfony scan-art --source=meta from Amazon's PAS system for amazon associates ./symfony scan-art --source=amazon from folders that the mp3s live in ./symfony scan-art --source=folders keep in mind that support for other music and list formats is an ongoing battle this doc may be horribly out of date already :) You should run these scripts every so often so Streeme stays up to date. Creating a user --- you should create a user for each device you'll use with streeme to do that it's back to the commandline ./symfony guard:create-user username password Logging in --- When you log in, you'll be presented with a few options -Mobile player -Desktop player -Logout The mobile player is optimized for a touch screen interface and the desktop player is optimized for features and bigger screen sizes. both players offer options for transcoding / modifying bitrate in their settings - please install FFMPEG if you would like to use these features for low bandwidth connections or changing formats. How to use the player --- If you've done everything right, you should see your content properly scanned and ready to use. the mobile player is navigated by tapping on albums, artists, songs, playlists, genres etc. HTML5 is very much in its infancy, so not all mobile players have the prescribed controls. The buttons beside the album art skip tracks and tapping the album art will pause and play. when the || symbol appears, the playback is paused. Press it again to resume playback. Playlists created in the desktop app can be used in the mobile app. The desktop player has different actions for single and double clicks. a double click on the song table will begin playing alternatively, you can press the single play button to the left of the song name. The RND button will shuffle the songs and the forward and previous buttons will skip tracks. Searches in either interface will return search results including all text columns of the table. Building playlists --- The desktop player has the ability to form playlists. the little + symbols next to your music items will add the songs, albums and artists to your selected playlist. To select a playlist click the folder icon in the top right, select add playlist and click it once to select it. It will turn a faint blue when active. You will now be able to add songs to the playlist. You can easily change the active playlist by single clikcing on any playlist in the list. To play back the playlist, you can click the play symbol or double click the playlist list entry. Tested Browsers ( December 2010 ) --- Chrome Browser 7.0.517.44 ( Full ) Mozilla Firefox 3.6 ( Partial - no mp3 codec must use ogg transcoding ) Safari 5.x series ( Full ) IE9 Beta ( Partial - no integrated controls ) iOS Mobile Safari ( 4.2 Full ) WebOS ( Palm Pre 1.4 Partial) No integrated controls - only specific MP3 formats allowed - audio tag does not send cookies, so it may be a security risk - no ogg support Android ( API V8 - ver 2.2.1 None ) Credits --- Thanks to Ryan Cumming for designing the model and scanner logic for streampod (previous project name) and streeme! Copyright Notice --- The artwork included with this package is copyright Richard Hoar (The Author) it may be reproduced for non-commercial purposes without asking permission from the Author or paying copyright royalty.