How to run UltraStar Deluxe with Wine

• I assume that you have some basic knowledge about Linux, but don't worry, I'm not expecting too much.
• Your PC might need more CPU power to run UltraStar Deluxe than it does under windows. Wine is a kind of translator, translating, the Windows API to Linux calls.
• As UltraStar Deluxe makes use of OpenGL for those nice animations, you need 3d-acceleration under Linux. Otherwise USDX runs very slowly. NVIDIA and ATI both provide binary drivers for their most recent graphic cards under Linux (x86 and x86_64). Please read the manuals of your distro. They should explain how to install those drivers.

First of all, you need a recent version of wine. “Wine is an Open Source implementation of the Windows API on top of X, OpenGL, and Unix.” http://www.winehq.org. The version I used is 0.9.46. Virtually all decent distro's should have wine in their tree. e.g. under Gentoo the command is:

emerge wine

Wine nowadays comes with a nice little configuration program “winecfg” which circumvents nasty editing of config files. If you have just installed wine now, you possibly need to setup your audio driver, as shown in the image.

Unfortunately, the current version of US dx (1.0) which can be downloaded from [url]sourceforge.org[/url] cannot be used with wine directly. There is a minor bug in the initialization process, which has been already corrected in the SVN version. This bug does not pose a problem under windows, but under wine, the program won't start. You download and compile the UltraStar Deluxe Version from the SVN, or wait until a new version is out. I am not sure whether I may upload the patched “exe”-File here. I will have to ask the maintainers first.

As of Version 1.0.1 UltraStar Deluxe runs almost flawlessly with Wine, some bug fixes we're done in 1.0.1a - and we hope we can present you a native working USDX with the upcoming 1.1 version. Download the latest version: http://www.ultrastardeluxe.org/usdx-download/

UltraStar Deluxe uses several Dynamic Link Libraries (DLLs) under Windows. Wine can usually use these libraries, too. However, problems occur with older versions of the SDL.dll. The version of the SDL.dll that comes with the current package is incompatible with Wine and does not work. You need to download the most recent version of this file from http://www.libsdl.org/. The version I used can be found at http://www.libsdl.org/release/SDL-1.2.12-win32.zip. Extract the SDL.dll file directly to your “UltraStar Deluxe” folder.

Is this still correct (as for Version 1.0.1a)? I do remember that we've updated it, but I just want to make sure..

Right now, you should be able to launch UltraStar Deluxe. Really, that's all you have to do. The bash command for launching it is:

cd "Your-USDX-Folder"
wine UltraStar.exe

After a while, Wine should start like it is shown in the screenshot. Or in fullscreen mode depending on your config.ini settings.

I really don't know why, but Wine seems to have problems with some of the fonts that are included in UltraStar Deluxe. Those fonts are selected in the Theme files of the Program. When I tested the program, Font Style 1 and Font Style 3 could not be displayed. I also experienced some minor texture problems at the bars. The font problem can be solved easily by replacing all “Font = 1” with “Font = 0” in your favorite theme file (“UltraStar-DX-Folder/Themes/XXX.ini”).

If you experience problems (crashes of USDX mostly which you don't have with other sound cards under linux) you might want to try the following. It might also happen with other sound cards under Linux. But don't worry, there is a solution:

You can tweak wine by using the wine “regedit” and disabling the automatic detection of sound cards and specify them yourself. See http://wiki.winehq.org/UsefulRegistryKeys how this is done. You may also need to create an ”.asoundrc” file in you home directory and use alsa plugins (esp. dsnoop) and converters to create a UltraStar compatible device. (See for example at http://alsa.opensrc.org/.asoundrc for more information about the .asoundrc file).

In “regedit” you just need to add the described “Alsa Driver” key (it usually does not exist) and specify you cards or better the virtual pcm devices you created by adding a number of “DevicePCMn” = “my_vitual_device_n” strings, where “my_virtual_device” is the name of the device you have created in the ”.asoundrc” file, n is the number of the virtual device you would like to assign (from 1 to DeviceCount).

I copied this tutorial from our forum, written by Linnex who helped via contributing code and this fine tutorial. As it was written when 1.0 was fresh and new, there might be less flaws now - or something else (Version number of Wine++?) - anyways this was a rough and fast copy+paste, for the same text in our board check the following link: http://forum.ultrastardeluxe.org/viewtopic.php?f=22&t=52