OpenITG / NotITG FAQ

Are they similar to StepMania 5?

No, No, No, No and No!

Okay, they are all based on Stepmania, they are all rhythm games, they have the same gameplay, but ITG and SM5 runs differently! On ITG, scripts are based on XML files, while SM5 uses Lua files. ITG uses Lua 5.0, while SM5 uses Lua 5.1. Those terms may be unknown to you, but they mean that any modded simfile from SM5 won't work in ITG, and any theme or noteskin from ITG won't work in SM5 (or vice-versa)!

So please, don't try a SM5 thing on ITG, or an ITG thing on SM5. It's just a waste of time. Of course, standard simfiles runs pretty well on both, since they read both .sm files!

Okay, I want to install OpenITG/NotITG now!

Huh?

You need to know a few important things before trying to install OpenITG or NotITG :

• Don't install ITG in the Program Files folder! Yes, we know that it's the default location, but that's dumb. Program Files is a folder which requires elevated privileges to write inside it. It means that you have to launch ITG as an administrator in order to play it, which is not recommended at all. You can install it anywhere else if you want to. For example, you can have a C:\Games, a folder on your Desktop, on an external drive... Everything that isn't Program Files is good!
• If it's crashing, it's not broken! If you have any issue while launching the game, just continue to read this page! You will easily and quickly fix any occuring issue.
• Again, This is not SM5. Don't try any SM5 theme or noteskin! There also are themes for ITG, like Simply Love, or GrooveNights.
• Before asking any help, make sure you read the totality of this page! It most likely have a solution for your problems.

If you understood these things, you can now install ITG!

Troubleshooting

A problem? An unexpected crash? Can't run the game? Here is a list of the most common errors!

The game crashes on boot with a video card error.

You have an error like this :

There was an error while initializing your video card.

   PLEASE DO NOT FILE THIS ERROR AS A BUG!

Video Driver: (Your graphic card here)

Initializing OpenGL...
SetVideoMode failed: Couldn't set screen mode
Initializing Direct3D...
SetVideoMode failed: CreateDevice failed: ''

Unfortunately, your graphic card can't handle ITG on fullscreen. You need to enable Windowed mode :

1. Open the file at (The location where you installed ITG)/Data/Static.ini
2. Go to the bottom to find "Windowed=0", set it to "Windowed=1".
3. Save the file, close it, and restart the game!

The game crashes randomly with a "Access Violation" error.

Make sure that the game is located outside of Program Files. If it happens while launching a specific simfile, contact the file's author.

If your game isn't in Program Files, feel free to ask the UKSRT Discord for help! Many people will help you!

When launching a simfile, I'm having a white screen.

Go into (The location where you installed ITG)/Data/Static.ini and add "VideoRenderers=opengl" at the end. Save, and restart. D3D is causing issues with some effects.

My game is crashing when going to "Graphic Options".

You are using the default/home theme, and you are having this error :

parse error in ScreenGraphicOptionsBasic::Line8

The default theme shipped with OpenITG is unfortunately broken. You must fix it. But don't worry, it's really easy!

1. Open the file at (The location where you installed ITG)/Themes/home/metrics.ini
2. Near the bottom, under the section "[ScreenGraphicOptionsBasic]", there is a line called "LineNames=1,2,3,4,5,6,7,8". Replace it by "LineNames=1,2,3,4,5,6,7". (Just remove the ",8").
3. Save the file, close it, and restart the game!

How can I install Songs?

Open the archive (zip, rar, ...), and follow these simple steps:

• If the song archive does contain a readme.txt, READ IT.
• If the archive does contain a "Songs" folder, and/or "Courses", and/or "NoteSkins", just drag all the folders in the root of your ITG installation.
• If the archive just does contain a single folder, and inside it, some files (.png, .sm, .ogg, other folders, ...), you have to drag that folder into a group in your Songs folder (The location where you installed ITG)/Songs). For example, if you're downloading NEXT STAGE, a file made by Daikyi, you could create a "Daikyi" folder inside your Songs, and inside it, drag the NEXT STAGE folder. You should have the Songs Folder, a group (here, "Daikyi"), a song (here, "NEXT STAGE"), and inside it, the files.

After any of those methods, you have to restart your game.

A song isn't appearing!

• Make sure that the song is located at the right place. It should look like (The root of your ITG installation)/Songs/(a group)/(the song)). If not, follow the "How can I install songs?" section.
• Try to open the .sm file with a text editor, and check if there is a "#SELECTABLE:YES;" line. If there is a "#SELECTABLE:NO;", replace the "NO" with "YES". If there is no "#SELECTABLE" line, just add it at the beginning.
• Did you restart your game after installing it? It's needed, so close your game and start it again.

If you still have issues, don't hesitate to ask in the UKSRT Discord!

How come "scalable" noteskin is highlighted in the NotITG v4 theme?

It's because you don't have that noteskin. Please download it and place it in OpenITG/NoteSkins/dance