Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
A social web app for browsing and listening to a music library using only a standards-compliant browser
Ruby CSS JavaScript
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
app
config
db
doc
lib
log
public
script
test
vendor
views
.gitignore
.rvmrc
Gemfile
Gemfile.lock
README.md
config.ru
rakefile

README.md

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.

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

Rename config/mongoid.yml.sample to toastunes.yml, and add your Mongo configuration.

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

add users

Add an initial admin user:

rake toastunes:create:admin[you@example.com,somepassword]

To add users, send them to /users/sign_up, then log in as an admin to approve their account at /users.

load an iTunes library

To load your iTunes library, run the following rake task, providing a path to your iTunes folder, and an optional name for the library (when managing multiple libraries).

rake toastunes:read:itunes['/path/to/iTunes',itunes]

Then extract/process album art, artists, genres:

rake toastunes:process:albums

load a directory

Make sure your library directory structure is like the following:

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

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

cd toastunes
ln -s /volumes/yourlibrary public/music/yourlibrary

Parse your library

rake toastunes:read:artists[yourlibrary]

Utilities

replace old genres with new ones via a lookup file

rake toastunes:process:replace_genres[/path/to/lookup.tab]

delete genres that have no albums

rake toastunes:genres:cleanup

Deploy

precompile assets prior to a production release (public/assets currently ignored in .gitignore)

rake assets:precompile

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

Something went wrong with that request. Please try again.