danser

danser-go

danser-go is a CLI visualisation tool for osu!standard maps. This fork is an edited version with Iteki's PP system in mind.

Run arguments

• -artist="NOMA" or -a="NOMA"
• -title="Brain Power" or -t="Brain Power"
• -difficulty="Overdrive" or -d="Overdrive"
• -creator="Skystar" or -c="Skystar"
• -md5=hash - overrides all map selection arguments and attempts to find .osu file matching the specified MD5 hash
• -id=433005 - overrides all map selection arguments and attempts to find .osu file with matching BeatmapID (not BeatmapSetID!)
• -cursors=2 - number of cursors used in mirror collage
• -tag=2 - number of cursors in TAG mode
• -speed=1.5 - music speed. Value of 1.5 is equal to osu!'s DoubleTime mod
• -pitch=1.5 - music pitch. Value of 1.5 is equal to osu!'s Nightcore pitch. To recreate osu!'s Nightcore mod, use with speed 1.5
• -settings=name - settings filename - for example settings-name.json instead of settings.json
• -debug - shows additional info when running Danser, overrides Graphics.DrawFPS setting
• -play - play through the map in osu!standard mode
• -skip - skips map's intro like in osu!
• -start=20.5 - start the map at a given time (in seconds)
• -end=30.5 - end the map at the given time (in seconds)
• -knockout - knockout mode
• -record - Records danser's output to a video file. Needs a globally accessible ffmpeg installation.
• -out=abcd - overrides -record flag, records to a given filename instead of auto-generating it. Extension of the file is set in settings. When the -ss flag is used, this sets the output filename as well.
• -replay="path_to_replay.osr" or -r="path_to_replay.osr" - plays a given replay file. Be sure to replace \ with \\ or /. Overrides all map selection arguments
• -mods=HDHR - displays the map with given mods. Overrides -speed and -pitch arguments if DT/NC/HT/DC mods are given
• -skin - overrides Skin.CurrentSkin in settings
• -cs, -ar, -od, -hp - overrides maps' difficulty settings (values outside of osu!'s normal limits accepted)
• -nodbcheck - skips updating the database with new, changed or deleted maps
• -ss=20.5 - creates a screenshot at the given time in .png format
• -quickstart - skips intro (-skip flag), sets LeadInTime and LeadInHold to 0.

Since danser 0.4.0b artist, creator, difficulty names and titles don't have to exactly match the .osu file.

Examples which should give the same result:

<executable> -d="Overdrive" -tag=2 //Assuming that there is only ONE map with "Overdrive" as its difficulty name

<executable> -t="Brain Power" -d="Overdrive" -tag=2

<executable> -t "Brain Power" -d Overdrive -tag 2

<executable> -t="ain pow" -difficulty="rdrive" -tag=2

<executable> -md5=59f3708114c73b2334ad18f31ef49046 -tag=2

Settings and knockout usage are detailed in the wiki.

Building the project

You need to clone it or download as a .zip (and unpack it to desired directory)

Prerequisites

• 64-bit go (1.16 at least)
• gcc (Linux/Unix), mingw-w64 or WinLibs (Windows, TDM-GCC won't work)
• OpenGL library (shipped with drivers)
• xorg-dev (Linux)

Building and running the project

First, enter the cloned/downloaded repository.

When you're running it for the first time or if you made any changes type:

go build

This will automatically download and build needed dependencies.

Afterwards type:

./danser-go <arguments>

Credits

osu! was created by osu! team (@ppy) and osu! community.

Default skin was created by Haskorion: Redd Glass HD

Uses Exo2 font under SIL Open Font License

Uses Ubuntu font under Ubuntu Font License