A simple program that generates album.json files for Warzone 2100's Music manager
The whole program is contained within the AJGen.c file. Since v0.3, the program uses platform-specific code, but it contains fallbacks to a mode with standard C libraries only. If you're not presented with the option to detect files automatically, and you have compiled the binaries yourself, the reason most likely is that the program does not detect your system properly or is not made to work with it.
A compiled Windows version is available in Releases.
The executable file must be located in the same folder as the album cover PNG file and the OGG/Vorbis music files. For more information on where to put the finished folder, see the Warzone 2100 GitHub page.
The program operates entirely in CLI mode.
If you encounter any issues, please report them at the repository.
The code could be greatly improved upon by adding additional integrity checks (for functions like scanf) and Unicode support (for Windows)
Preparation: Put all your .ogg files and a .png file you wish to use as an album cover in a single folder.
- When firing up the program, the user has to enter the corresponding info about the album
(incl. a valid filename for the cover). - Then, the user is prompted if they'd like to set numerous options to their default values: track volume, BPM, etc.
- If an album.json file is detected in the folder, the user is asked whether or not it should be overwritten. If not, the program quits.
- The program enters a loop, where it prompts for track filename and title (unless the program operates in auto-detection mode, in which case they're detected automatically), and, depending on chosen options, volume, BPM, and playback modes.
- After a track is added, the user is prompted if they want to continue. If yes, the cycle is repeated. If not, the program finalizes the file and quits.
In auto-detection mode step 5 happens automatically.
Track filenames of the kind "track#.ogg" (where # is a number) are known to cause conflicts with existing files in the game and should be avoided.
On Linux/UNIX and derivatives, the tracks will most likely appear in random order.
Compilation on Windows with Visual Studio requires tweaks to the code.
The 20-file cap on the file lists is artificially added and can be easily extended with a single change in the source code.