Giter VIP home page Giter VIP logo

ultrastarorganizer's Introduction

Ultrastar Organizer

Cleanup and organize your Ultrastar Deluxe library with this simple command line tool.

Table of Contents

  1. Make sure Java 17 is installed (Eclipse Temurin).
  2. Download the latest version of this program here.
  3. 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
Reformat before usage example Reformat after usage example

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
Automatch before usage example Automatch after usage example

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

Songlist 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

Download

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.

diff

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>

ultrastarorganizer's People

Contributors

jorisguffens avatar

Stargazers

Barry avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.