Unbewohnte
/
OBM
1
1
Fork 0
Code Issues Pull Requests Projects Releases 14 Wiki Activity
⬗ (Osu! Background Manager) A little utility to replace, retrieve or remove backgrounds for every beatmap in your osu! folder ⬖
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
38 Commits
1 Branch
16 Tags
276 KiB
 
 
Tree: 54bcd0c060
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '54bcd0c060'
${ noResults }
Unbewohnte 54bcd0c060
More clear explanation of "-beatmap" flag 		4 years ago
logger Added custom logger and made code a bit less messy 4 years ago
manager Added support for -beatmap flag 4 years ago
settings Add files via upload 4 years ago
util Added some new background creation fields 4 years ago
LICENSE Update LICENSE 4 years ago
OBM.go Added support for -beatmap flag 4 years ago
README.md More clear explanation of "-beatmap" flag 4 years ago
flags.go Added support for -beatmap flag 4 years ago
go.mod Added custom logger and made code a bit less messy 4 years ago
worker.go Added some new background creation fields 4 years ago

README.md

OBM (Osu!-Background-Manager)

This utility will help you with replacement and retrievement of Osu!`s beatmap backgrounds

Use at your own risk ! There is no way to return removed original backgrounds unless you delete all beatmaps and reimport newly downloaded versions of them again.

Installation

From source (You`ll need Go installed)

  1. git clone https://github.com/Unbewohnte/OBM.git or download and unzip the archive
  2. cd into the directory
  3. go build

From release

  1. go to the releases page
  2. choose your OS and download the archive
  3. cd to the location of the downloaded version
  4. unzip (7z x **archive_name**) - for 7z archives

Usage

To run - ./OBM in terminal (on Unix) || OBM in command line (on Windows)

First run

  1. The program will generate a settings.json file if it is not already in the directory when you run it
  2. Paste your Osu! filepath in the "pathToOsu" field
  3. Enable/Disable needed features, providing valid filepaths to them
  4. Additionally you can disable the "createBlackBackgoundImage" by replacing true with false or change the number of workers

After

  1. Start the utility again. If it has found the settings file - it will perform the magic according to provided rules

Flags (starting from version 1.3.4)

Right now there is one argument that you can specify before running the program - "beatmap". This flag will tell the program to do its work ONLY on beatmaps with specified name; others will be ignored

Examples

  1. ./OBM -beatmap="" - the same as just ./OBM. It will affect all of your beatmaps
  2. ./OBM -beatmap="Demetori" - this will search for beatmaps with names that contain "Demetori" and will work only with them
  3. ./OBM -beatmap=Demetori - the same as before, but without "" (look at 4 - 5 for nuances)
  4. ./OBM -beatmap=raise my sword - NOTE that this will make the program look only for word "raise", but not for the whole sequence
  5. ./OBM -beatmap="raise my sword" - this is the valid option for 4 (You need to use "" in case of a multi-word name)

The search is case-insensitive, so for example ./OBM -beatmap="Road of Resistance" and ./OBM -beatmap="ROAD of rEsIsTaNcE" will get you the same results

License

MIT License

If you have found this program useful, then consider to give this repository a ☆. It is not difficult for you, but means a lot for me