This is my first plugin for RadioDJ and also happens to be my first project written in C#.Net.
The idea came about after replying to a
post by PHAZE FM. He needed to clear a category and then import all files from a directory into that category. Unfortunately, RadioDJ does not have this functionality. That is until I decided to create a plugin which can do exactly that.
Folder Loader plugin adds two event actions for use in scheduled events:
- Clear Subcategory – deletes songs from a subcategory specified by category and subcategory name or ID as argument. It will delete song records from database, so it’s up to users to decide if it suits their needs.
- Load Files From Folder – imports all supported file formats from a directory, placing them in a subcategory, assigning genre and track type specified by name or ID as arguments.
Example action for importing tracks from "C:\News\" into main category "News", subcategory "Latest News", assign "News" genre and set type to "News":
PluginAction|Folder Loader|Load Files From Folder|C:\News\;cat=News&subcat=Latest News&genre=News&type=News
NOTE: cat and
genre parameters are optional.
Since version 2.0.1.0:If
genre is set to
AutoGenre, plugin will try to read genre from ID3 tags. This may slow down import process.
Cue point data can be imported from file ID3 tags (if saved previously) using
ID3cue=yes.
Do not add the ID3cue parameter, since plugin checks for its presence, not its value. Reading cue data from ID3 tags also slows down the import process.
e.g. to import tracks with cue points and genres from ID3 tags, action would be:
PluginAction|Folder Loader|Load Files From Folder|C:\News\;cat=News&subcat=Latest News&type=News&genre=AutoGenre&ID3cue=yes
There is just one option in plugin settings –
Recurse subfolders. If enabled, plugin will scan for files in all subdirectories of specified directory.
I've tested the plugin as much as I could, but there could be some bugs. Test it on your secondary system to see if it fits your requirements.
You should back up your database because
Clear Subcategory action will delete songs from database. Although the plugin checks if specified subcategory exists before deleting songs and does nothing if the subcategory can't be found by name or ID.
Usual disclaimer: Folder Loader plugin is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
[Download link no longer available]
PLEASE READ CHANGELOG BEFORE USING NEW VERSION (2.0.0.1 and up)!FAQQ: Does it import duplicates if tracks are already in database?
A: No. It checks if track already exists using same functions RadioDJ is using to do that.
Q: Does it delete files from disk?
A: No.
Q: Does it give milk?
A: Maybe. If you ask politely.

Current version:
2.0.1.0Last updated:
2015-04-26 06:17 GMTChangelog:
2.0.1.0- Enhancement: Optionally read CUE data from file ID3/meta tags (enabled using parameter ID3cue=yes)
- Enhancement: Optionally read genre from file ID3/meta tags (enabled using parameter genre=AutoGenre)
- Enhancement: Plugin will create the specified genre if it doesn't exist (unless genre is set to AutoGenre)
2.0.0.2- Now compatible with RadioDJ 1.7.7 and 1.7.8
For previous RadioDJ versions: [Download link no longer available]
2.0.0.1- Completely reworked how arguments are specified
- OPTIONALLY Main category can be specified using cat=Category Name. (Make sure that category exists or no tracks will be imported)
- Subcategory can be specified using subcat=Subcategory Name. (Make sure that subcategory exists or no tracks will be imported)
- OPTIONALLY Genre can be specified using genre=Genre Name.
- Track type can be specified using type=Music. (It must be one of types supported by RadioDJ or it will be set to Music)
Categories, subcategories and genres will not be created by the plugin, so they must exists or it will not work. I'm planning to add it if enough users request that feature.
Time spent on latest version: 6 hours1.0.0.1- Importing runs in a separate thread to avoid blocking main interface
- Added checking for incorrect or empty arguments
Kudos to Marius for testing and advice.
1.0.0.2- More checks for empty or incorrect arguments
- Checks if folder path exists and logs error to events log if path can't be found
1.0.0.0First working version created in about 4 hours.
Runs on main thread and blocks RadioDJ interface during folder import.