Official Project Website: https://usdx.eu/

UltraStar Deluxe (USDX) is a free and open source karaoke game. It allows up to six players to sing along with music using microphones in order to score points, depending on the pitch of the voice and the rhythm of singing. UltraStar Deluxe is a fork of the original UltraStar (developed by corvus5). Many features have been added like party mode, theme support and support for more audio and video formats. The improved stability and code quality of USDX enabled ports to Linux and Mac OS X.

Currently, the following installation channels are offered:

• installer (or portable version) for the latest release
• flatpak from flathub
• Arch Linux AUR

• To set additional song directories change your config.ini like this:

  [Directories]
  SongDir1=C:\Users\My\Music\MyUSDXSongs
  SongDir2=F:\EvenMoreUSDXSongs
  SongDir...=... (some more directories)

• To enable joypad support change config.ini Joypad=Off to Joypad=On
• To enable 2 or 3 player each on 2 screens, disable the full screen mode, extend your desktop horizontally and set the resolution to fill one screen. Then, in the config.ini set Screens=2 and restart the game.
• The primary folder for songs on OS X is $HOME/Music/UltraStar Deluxe, which is created when UltraStar Deluxe is run for the first time.
• On OS X, by default the config.ini file is created in $HOME/Library/Application Support/UltraStarDeluxe when UltraStar Deluxe is run for the first time.
• When running in borderless fullscreen mode, the monitor it runs on can be configured by setting Graphics.PositionX/Y to an offset in pixels.
• If installed via the flatpak package, the primary song folder is ~/.var/app/eu.usdx.UltraStarDeluxe/.ultrastardx/songs/ and the config.ini is located in ~/.var/app/eu.usdx.UltraStarDeluxe/.ultrastardx/ by default. To configure additional song directories, they first need to be made accessible to the flatpak app using the command: flatpak override eu.usdx.UltraStarDeluxe --filesystem=/your/new/songfolder - Afterwards, the directory can be added to the config.ini file as usual.

The wiki contains more information on:

• Command-line parameters
• Controls
• Customization

There are two main ways to compile the game:

1. Lazarus IDE
2. ./autogen.sh && ./configure [--enable-debug] && make

The executable will be game/ultrastardx[.exe].

For extended information, dependencies, OS-specific notes and configure flags, see COMPILING.md.

• -NoLog : Do not create any .log files

• -Joypad : Start with joypad support

• -Language <ID> : Load language [ID] on startup. Example: -Language german

• -Songpath <PATH> : Same as config Songpath. Example: -SongPath "C:\Ultrastar Songs"

• -ConfigFile <FILE> : Load configuration file [File] instead of config.ini. The path to the file has to exist. Example: -ConfigFile config.SongCreation.ini

• -ScoreFile <FILE> : Use [File] instead of Ultrastar.db The path to the file has to exist. Example: -ScoreFile HouseParty.db

• -FullScreen : Start the game in full screen mode

• -Depth {16|32} : Force depth to 16 or 32. Example: -Depth 16

• -Resolution <ID|RESOLUTION> : Force resolution. Either by ID (matching an entry of the possible resolution list) or custom resolution (with the format of WIDTHxHEIGHT). Example: -Resolution 800x600

• -Screens {1|2} : Force 1 or 2 screens. Example: -Screens 2

Some Examples:

Start with a resolution of 1024x768, a depth of 32 bit and in full screen mode: ultrastar.exe -Resolution 1024x768 -Depth 32 -Fullscreen

Start without logging and with polish language ultrastar.exe -NoLog -Language polish

Start with a customs configuration file and score database: ultrastar.exe -ConfigFile "C:\Ultrastar\Configs\PartyConfig.ini" -ScoreFile "C:\Ultrastar\Scores\PartyScores.db"

Freepascal 3.0.0 or newer is required to compile UltraStar Deluxe. If you had some older version of fpc installed before, make sure to remove everything of it correctly before trying to install freepascal (otherwise compiling will fail with various weird error messages). Also, using the 3.0-development branch with current fixes is suggested. If you want to help the project by coding patches, we suggest you to use the Lazarus 1.6 or newer integrated development environment. For linking and running the game, the following libraries are also required:

• SDL2, SDL2_image
• ffmpeg 2.8 or older
• sqlite
• bass
• some fonts like ttf-dejavu and ttf-freefont
• portaudio
• lua 5.1 or 5.2 or 5.3
• opencv if you want webcam support
• projectM if you want audio visualisation support

1. Start Lazarus.
2. Choose Project → Open Project … in the menu bar. A file-dialog box will show.
3. Change to the src subdirectory of your USDX working copy (e.g. ultrastardx/src).

• If you are running Windows, open the ultrastardx-win.lpi project-file (Preferably use the win32 verison of lazarus, as the included libraries are 32 bit).
• On Unix-like systems use the ultrastardx-unix.lpi file.

4. Now you can compile USDX by choosing the menu entry Run → Build or pressing Ctrl+F9.
5. If you want to compile and/or start USDX directly choose Run → Run or press F9.

1. make sure all required libraries are installed

• for current debian / ubuntu: sudo apt-get update && sudo apt-get install git automake make gcc fpc libsdl2-image-dev libavformat-dev libswscale-dev libsqlite3-dev libfreetype6-dev portaudio19-dev libportmidi-dev liblua5.3-dev libopencv-highgui-dev
• if you want to build --with-libprojectM, you also need sudo apt-get install g++ libprojectm-dev
• for arch linux there is an aur package called ultrastardx-git

2. git clone https://github.com/fscs/USDX.git
3. cd USDX
4. ./autogen.sh
5. ./configure (or use autoconf)
6. make -j4
7. Play the game,
   • install the game and start it
     • sudo checkinstall, make sure that package name is usdx
     • ultrastardx
   • or start it directly ./game/ultrastardx

• USDX is built using Homebrew and official FreePascal build (using its compiler FPC)
• To install Homebrew, follow instructions from brew.sh
• You can get the FPC build from freepascal.org or
  • brew install fpc
• Make sure the XCode command line tools are installed.
  • xcode-select --install
• Needed brew libraries can be installed using (ffmpeg up to 3.3 is supported):
  • brew install sdl2 sdl2_image automake portaudio binutils sqlite freetype lua libtiff pkg-config ffmpeg@2.8
• Clone repo
  • git clone https://github.com/UltraStar-Deluxe/USDX
• Generate configure file and more
  • ./autogen.sh
• Make sure that you have your build setup right
  • ./configure
• Now build the UltraStar application
  • make macosx-standalone-app
• Run by clicking UltraStarDeluxe in your build folder or
  • open UltraStarDeluxe.app

Feel free to fork this project, modify it to your hearts content and maybe also do pull requests to this repository for additional features, improvements or clean-ups.