kasima / toastunes

A social web app for browsing and listening to a music library using only a standards-compliant browser

About

ToasTunes is a social web app for browsing and listening to a music library, adding comments and ratings, and adding album art and genre classifications. ToasTunes was written by @drtoast.

• Created using Ruby 1.9, Rails 3, jQuery, CSS3, HTML5
• MongoDB datastore via Mongoid
• HTML5 audio playback (no Flash required)
• Devise for secure user authentication
• HAML view templates
• ID3 tag parsing and album art extraction
• Album art retrieval using Amazon AWS API
• Bundler for dependency management

Setup

installation, Mac OSX:

rvm install 1.9.2
brew install mongodb
brew install ghostscript
brew install imagemagick
git clone git://github.com/drtoast/toastunes.git
cd toastunes
bundle

installation, BSD

todo

edit config files

edit config/toastunes.yml.sample, rename to toastunes.yml

edit config/mongoid.yml.sample, rename to toastunes.yml

To download album art via Amazon AWS, add your developer key id and secret key to config/toastunes.yml.

add users

ToasTunes is meant for private use, so public user registration is disabled. An admin can add a new user in the rails console:

rails c
User.create :email => '[email protected]', :password => '123456'

load an iTunes library

Create a symlink from your iTunes Music folder to public/music/itunes:

cd toastunes/music
ln -s ~/Music/iTunes/iTunes\ Music itunes

Edit the path to your iTunes library XML in config/toastunes.yml, then:

rake toastunes:read:itunes

Process album art, artists, genres

rake toastunes:process:albums

load a directory

Make sure your library directory structure is the following:

yourlibrary/Artist Name/Album Title/Song Title.mp3

Create a symlink from your music directory to public/music/yourlibrary:

cd toastunes
mkdir public/music
mkdir public/images/covers
mkdir public/images/thumbnails
ln -s /volumes/yourlibrary public/music/yourlibrary

Parse your library

rake toastunes:read:artists[yourlibrary]

Bugs

Currently only runs well in Google Chrome.

Can't read filenames with funky characters on Samba shares, e.g. "Miss Kitten & The Hacker/Two/09 Inutile Eternité.mp3"

Parsing of ID3 picture tags needs some work