Data sources
Watch folders / iTunes XML
On the data sources tab you configure where MyTunesRSS gets its data from, i.e. the tracks for the database. You can add iTunes XML files for importing contents of an iTunes library or watch folders. A watch folder is scanned recursively for supported audio and video files. You add a watch folder or an iTunes XML with the "add local" button. Double clicking an existing entry allows you to edit it.
On Linux system you cannot select watch folders like on Windows and Mac OS X systems with Java 5. When selecting a folder in the file chooser dialog and clicking the button you do not select the folder but navigate into it. On Windows and Mac OS X systems it works as expected, i.e. double clicking a folder navigates into it and the button selects it. As a workaround you have to navigate into the parent folder of the watch folder and then enter the watch folder name manually into the text field and then click the button to select it. The latest version of Java 6 fixes this problem.
Remote (YouTube) datasources
You can also add remote datasources. A remote datasource is specified through a URL which you can enter after clicking "add remote". Currently only YouTube is supported. You can enter any RSS/Atom feed URL from the YouTube website. Here are a few examples you could try.
http://gdata.youtube.com/feeds/api/videos?q=mytunesrss&orderby=relevance&v=2&start-index=1&max-results=50 http://gdata.youtube.com/feeds/api/videos?q=simpsons&orderby=relevance&v=2&start-index=1&max-results=50 http://gdata.youtube.com/feeds/api/videos?q=simpsons&orderby=relevance&v=2&start-index=51&max-results=50 http://gdata.youtube.com/feeds/base/standardfeeds/top_favorites?time=today&v=2 http://gdata.youtube.com/feeds/base/users/rathergoodstuff/uploads?v=2
The first one returns all videos which match the query "mytunesrss", i.e. the videos you would get on the YouTube site searching for "mytunesrss". The "start-index" and "max-results" parameters used on most of the examples tell YouTube which part of the complete result you want to get. The "max-results" parameter cannot be higher than 50. The second and third example both search for "simpsons", i.e. they return the same result but fetch different parts. The second one fetches results 1 to 50 and the third one fetches 51 to 100, so MyTunesRSS would fetch the first 100 matches. The fourth examples retrieves a standard feed: today's top favorites. The last sample fetches all videos uploaded by user "rathergoodstuff".
You can also have a look at the YouTube API documentation for detailed technical information on feed URLs.
Fallback names
The fallback names below the sources specify in what manner the watch folders are organized. You can put anything inside the text fields where [dir:0] is replaced by the name of the directory which contains the file, [dir:1] is replaced by the name of the directory which contains [dir:0] and so on. You can put any static text information into the fields as well. The example in the screenshot shows a common setup which means that the tracks are in a folder named like the album and the album folders are in folders named like the artist. This is how iTunes for example organizes files. This information is used only if the track itself does not contain any meta information in ID3 tags or MP4 ATOMs. So this is a fallback for getting album and artist names only.
iTunes path replacements
Sometimes you might have iTunes running on one computer and for some reason you might want to run MyTunesRSS on another computer with a copy of the iTunes Library XML file. In this case the paths in the XML file might be wrong. Consider you have iTunes running on some Mac and the paths in the iTunes XML all start with "/Volumes/Data/iTunes Music/". Now you copy the XML to the MyTunesRSS server which is running Windows for example. The data volume is mounted as "H:\", so the iTunes Music folder is "H:\iTunes Music" on this computer. The MyTunesRSS server won't find any of the files from the XML of course. So you have to tell MyTunesRSS to replace parts of the file paths with something else. These are the path replacements. You enter a search regular expression and a replacement. For the above example this would be the search expression "/Volumes/Data" and the replacement "H:", so each path "/Volumes/Data/iTunes Music/..." becomes "H:/iTunes Music/..." in MyTunesRSS. You need not care about slashes or backslashes since Java can use both on any system.
Upload folder
The upload folder is the base directory where uploaded files are places. You can optionally have MyTunesRSS create subfolders for each user during the upload. The upload folder is automatically also used as a watch folder, so you do not need the update folder to the watch folders if you want to have access to the uploaded files at once.