Cleanup and organize your Ultrastar Deluxe library with this simple command line tool.
- Make sure Java 17 is installed (Eclipse Temurin).
- Download the latest version of this program here.
- Start with
java -jar UltrastarOrganizer-<version>.jar
This will rename all files and sub directories to a conform naming scheme. It will also search for missing audio, video, and image files inside the same directory if they are missing from the info file.
Before | After |
---|---|
This program will move each audio file in the root directory to the correct sub-directory, it will also run the reformat command for the matched sub-directories.
Before | After |
---|---|
This program generates a tracklist in an external file. Very useful if you want to print a list.
Option | Description |
---|---|
--type <value> |
Tracklist type, valid values are: - ODT OpenOffice Document- CSV Comma Separated Values |
OpenOffice Document Example
Minimize the size of your library by downscaling background and cover images.
Option | Description |
---|---|
--remove-backgrounds |
Clear up more space by removing background images. |
--max-cover-size <value> |
The max size of cover images. Empty = no shrinking |
--max-background-size <value> |
The max size of background images. Empty = no shrinking |
Search your library by text or some special options.
Option | Description |
---|---|
--query <value> |
Search for text in title & artist. |
--has-background |
Tracks with a background image |
--has-no-background> |
Tracks without a background image |
--has-cover |
Tracks with a cover image |
--has-no-cover |
Tracks without a cover image |
--has-video |
Tracks with a video |
--has-no-video |
Tracks without a video |
--multiple-versions |
Directories that contain multiple song files |
--duet |
Tracks that are duets |
You can use multiple options together, only results that apply to all options are returned.
You can see stats of your library with this simple command.
Example output
Directories: 1002
Total Tracks: 1016
Duets: 15
Disney songs: 26
Total size: 5.59GB
Average directory size: 5.72MB
You can download missing cover art files automatically with this command.
This will use the Spotify Web API, this only works with your own account (premium not required), you must also create a developer application here. The credentials of this application will be used to query the API.
Option | Description |
---|---|
--spotify <clientId>:<clientSecret> |
Use the spotify API with the given client id & secret. |
--market <countryCode> |
A 2-letter country code to search in. |
This command will compare your library against another library or tracklist.csv.
- To compare a tracklist:
diff <path/to/file>
- To compare another library:
diff <path/to/directory>