Read this article if you need help Getting Started with groovyBox.
Frequently Asked Questions / Troubleshooting
Problem: How come no songs or artists are loading?
This can be caused by one of two problems:
Reason #1 : You are accessing a local copy of the page
Solution: For security purposes, groovyBox will not access your hard drive. You have to access groovyBox.html via HTTP in order for it to work. Check your browser location. It should have “http” somewhere in it. Or, if you’re using a browser that doesn’t show http, then it should NOT have “file” in it.
- Wrong: file:///C:/Users/jack/Dropbox/Public/groovyBox/groovyBox.html
- Right: http://dl.dropbox.com/u/1261672/groovyBox/groovyBox.html
Reason #2 : songs.xml does not exist or is not in the right location
Solution: Open the /guts folder to see if there is a file called songs.xml. If there isn’t one there, you need to run groovyBox.exe to generate it. You have the ability to change the directory where songs.xml is outputted, but don’t. The XML must be called songs.xml and must be located in groovyBox/guts. Later, I’ll implement a feature that lets you create multiple XML playlists.
Certain songs are showing up as blank lines
This is a quirk with the music file’s song information (e.g. the ID3 tag). Basically, some special characters will junk up the script. Also, if the song doesn’t have the proper information, there won’t be a title / artist / album to display. So, make sure that your songs all have complete information. You can edit this right within Windows Explorer by Right-clicking the file and choosing Properties > Details. Avoid having more than one artist or contributing artist, since the semicolon really throws a monkey wrench into the operation. That’s an issue we hope to fix, but for now, if it’s a group effort, call it “Various Artists” or “Jim and Jane and Johnny.”
Page elements or songs aren’t showing up
Make sure that all your files are synced to Dropbox and then try again. Look at the files in your Dropbox folder and see if they have the blue syncing badge or the green check mark badge. If it’s the former, just hold tight. Likewise, if you’ve made changes to songs.xml, that file will have to sync again. Look in the guts folder to see if songs.xml is syncing.
I can’t get the player to show up