molneya / CollectionGenerator

A program to generate and manage osu! collections.
GNU General Public License v3.0
7 stars 1 forks source link

Collection Generator

A program to generate and manage osu! collections.

Setup

For Windows, download and run the latest version from releases.

Otherwise, clone and run the code using:

git clone https://github.com/molneya/CollectionGenerator
cd CollectionGenerator
python main.py

First Run

When running for the first time, you'll need to edit your configuration to specify your osu! directory and osu!api credentials. Do so by selecting Config in the menu, then pressing the Save and Reload button to save your desired changes. You can use the program without doing this, but functionality will be limited.

Usage

Loading and Saving Collections

You can load collections in either .db or .osdb format by selecting File > Open > File. A shortcut for opening your osu! collection directly exists by selecting File > Open > osu! Collection. Alternatively, you can drag and drop your collections into the program.

You can also save collections in a similar manner by selecting File > Save. Right-clicking a collection in the list and selecting Save saves the collection on its own.

Read more about the difference in osu! collection formats here.

Generating Collections

The Generate menu dropdown has many selections to generate collections with certain specifications:

Editing Collections

Right-click a collection in the collection list to see possible collection operations:

Selecting and right-clicking multiple collections in the collection list shows yet more possible operations:

Double-clicking a collection's name allows you to rename it.

Editing Beatmaps

After opening the beatmap viewer, right-clicking a beatmap in the beatmap list shows these operations:

You can view/hide additional columns in the window by selecting the View menu dropdown, and selecting your columns.