Troubleshooting guide - Corne2Plum3/fnf2osumania GitHub Wiki

Troubleshooting guide

1.1.4 update

The program doesn't works? Here's how to fix known issues.

The program immediately close after a CMD/Terminal/Black Window show up.

That means the programes crashes before being able to display the GUI (or the message error). There are several reasons that the program crashes:

  • config.json: be sure that config.json is in the same folder than main.exe pr main.py. However, if it exists at the right place, maybe the file is corrupted. In both situation, download a clean version of the file here and add it to the same directory than main.exe or main.py.
  • missing file: a needed file is missing. You should redownload the program in this situation, and don't forget to never delete any file.

Python source code specific issues.

  • Are you running 'main.py'?: Be sure that you are running main.py and not a other file.
  • Missing Python library: at least 1 library needed isn't installed on your computer. The list of needed libraries are on the README.md.

Some elements are cut off the window

If like in the picture above the text goes out of the window, it's because the font Barlow Condensed used in the program, isn't installed on your computer. You need to install it to avoid this bug.

Note than since 1.1.4 you can resize the window if needed.

FileNotFoundError: [WinError 2] The system cannot find the file specified while importing audio 1

If you have an error like this issue (issue #6), with eventually other line numbers, check if you input files that exists, or ot's because you don't have FFMPEG installed on your computer, which he's needed by the program. Just install it (YouTube tutorial)

Black empty windows apperars then disseaperars during the export... (.exe only)

This is not a bug. Just don't close them else the program crashes. They closes themselves.

An error occurs while creating the .osu files.

They're several ways to get an error here, and probably the issue may be from the FNF chart. In all situations, post an issue here with the .json files you used (you may need to put the files into a .zip), so we can fix it for your charts and improve the program.

Something else...

Open an issue here, so we can help you.