Please download and install the corresponding platform-specific Yass package.
After starting the Yass application, you will have to specify the physical location of your karaoke songs, covers, and playlists. Commonly used quick settings are available.
Example paths for user "Saruta" and Ultrastar Deluxe:
Windows: Mac OSX: Linux Ubuntu: | C:\Program Files\Ultrastar Deluxe\Songs /Users/Saruta/Library/Application Support/UltraStarDeluxe/Resources /home/.ultrastardx/songs |
The song library will then scan these folders (and subfolders) for karaoke data and cache them to speed up subsequent program start-ups. Cashes must be refreshed manually to synchronize to external changes.
Yass preferences, cache files, cover thumbnails, and songlists are stored in a ".yass" folder in your home directory (Java system property "user.home"). You can remove that folder to reset all customizations and clear all cached data.
Example .yass location for user "Saruta":
Windows XP: Windows Vista: Mac OSX: Linux Ubuntu: | C:\Documents and Settings\Saruta\.yass C:\Users\Saruta\.yass /Users/Saruta/.yass /home/Saruta/.yass |
Yass requires Java 1.5 or later. The Windows-specific Yass package will automatically check and download the Java runtime environment. Non-windows users will have to install Java manually.
Your songs should follow these requirements:
Karaoke data can be encoded in ANSI or UTF-8; however note that currently only Ultrastar (not Deluxe, see tools) can read UTF-8.
Audio/Video rendering relies on Omnividea Fobs (Ffmpeg OBjectS) JMF bindings. Platform-specific libraries are bundled with the Yass download package. Windows XP and Vista (32-bit and 64-bit) are reported to work well; I have no feedback from Linux Ubuntu or Mac OSX users yet (please contact me if you have positive/negative feedback for these systems).