How to Build OpenITG in Ubuntu from Source

This guide assumes you have downloaded the latest copy of the OpenITG source code from here: https://github.com/openitg/openitg You can optionally take the latest build from here: http://openitg.gr-p.com/ - However, this build hasn't been updated since 2013 and features quite a few bugs. So let's build from source using this guide.

NOTE: This guide has been written and tested using: Ubuntu 17.04 Zesty Zapus / 13 April 2017

1. Enable "Community-maintained free and open-source software (universe)".

a) Via the GUI here: Search > Software & Updates.

or

b) via Terminal here:
sudo add-apt-repository universe
sudo apt-get update


2. Open Terminal and execute the following...
sudo apt-get install libasound2-dev libpulse-dev libmad0-dev libtheora-dev libvorbis-dev libpng-dev libjpeg-dev libglu1-mesa-dev libgl1-mesa-dev xorg-dev libxrandr-dev libbz2-dev libglew1.5-dev glew-utils libglew-dev libglewmx-dev libgtk2.0-dev yasm automake liblua5.1-0-dev libusb-dev libavcodec-dev libavformat-dev libswscale-dev libresample1-dev libcrypto++-dev libsdl1.2-dev libavutil-dev libjpeg62-dev

NOTE: The old Beta2 build does not require these libraries: libavutil-dev libpng12-dev libjpeg62-dev


3. Install libpng12-dev. libpng12-dev is not available in the universe repository, so you have to add a new repository

a) Add the following line to: /etc/apt/sources.list
deb http://security.ubuntu.com/ubuntu trusty-security main

b) Now install libpng12-dev
sudo apt-get install libpng12-dev


4. Open Terminal and execute the following to build the source...
./build-home.sh


5. Open Terminal and execute the following to package it into a nice releasable form...
./generate-home-release.sh


6. A zip file (release) will now have been generated in the main directory called "home-tmp.zip". Well done!


NOTE: If you are trying to run OpenITG and it states that shared files/libs are missing, then chances are a lib was missing when it was compiled. Please check ALL required libraries were present on your system at compile time.

Need pads? and have PIUIO: https://github.com/djpohly/piuio

Credits: s34n and TeamBBC

HOW TO: PIUIO with Stepmania 5 or OpenITG in Linux and Windows

Please follow this guide to install PIUIO before continuing...

Once you have installed the drivers for PIUIO on your system, you will need the software to be able to interact with your PIU drivers.


In Windows

1. Download and install IO2Key here:
https://mega.nz/#!INFUDBqa!Br-zZexEgOaVCDNqUzPQmoVi3jg0X5X4ZNSKxm-P1GQ
Video Help: https://www.youtube.com/watch?v=xo5m9dlNFfY

IO2Key maps the inputs from PIUIO to standard keyboard keys. You can then easily map the keyboard keys in Stepmania or OpenITG.



Linux - Stepmania 5

1. Open the following file:

Preferences.ini
(Located in the users home directory. NOTE: Stepmania needs to be ran for the first time for these files to appear!)

TIP: Make sure Static.ini does NOT contain this line as it'll override the setting if so. Alternatively, you can place the following in static.ini to override this. Your choice!

2. Find the line that begins with: "InputDrivers=". Modify this line so that the value is empty (auto-probe).

I.e.
"InputDrivers=XXXXXXX" should now read:
"InputDrivers=". (No spaces and case sensitive)


3. Still within this file, find the line that begins with: "LightsDriver=" Modify this line so that it begins with PIUIO_Leds after the equal sign.

I.e.
"LightsDriver=" should now read:
"LightsDriver=PIUIO_Leds". (No spaces and case sensitive)


This tells Stepmania that we want to use PIUIO to manage the lights for the arcade cabinet.


Linux - OpenITG

As OpenITG supports PIUIO out of the box, the complete setup is rather simple...

1. Open the following file:


Stepmania.ini (Located in the Data folder)

TIP: Make sure Static.ini does NOT contain this line as it'll override the setting if so. Alternatively, you can place the following in static.ini to override this. Your choice!

2. Find the line that begins with: "InputDrivers=". Modify this line so that it includes PIUIO.

I.e.
"InputDrivers=x11" should now read:
"InputDrivers=x11,PIUIO". (No spaces and case sensitive)

This tells OpenITG that we want to add PIUIO as an optional input driver IN ADDITION to x11 (A standard linux keyboard) 

3. Still within this file, find the line that begins with: "LightsDriver=" Modify this line so that it begins with PIUIO after the equal sign.

I.e.
"LightsDriver=" should now read:
"LightsDriver=PIUIO". (No spaces and case sensitive)

This tells OpenITG that we want to use PIUIO to manage the lights for the arcade cabinet.



BONUS ANNOYANCE: Disable Floor Panels from Selecting Songs in the Song Menu Screen

1. Open the following file depending on your engine:
OpenITG - Stepmania.ini (Located in the Data folder)
Stepmania 5 - Preferences.ini (Located in AppData for the current user)

TIP: Make sure Static.ini does NOT contain this line as it'll override the setting if so. Alternatively, you can place the following in static.ini to override this. Your choice!

2. Find the line that begins with: "OnlyDedicatedMenuButtons="

Modify this line so that it reads: "OnlyDedicatedMenuButtons=1"