To install, unzip/untar the release to its own directory, and then add that directory to the list of directories in your PATH environment variable.

OR, optionally, if you use Windows: Use the provided Windows Installer, which will do that stuff automatically!

What is Doomy?

Doomy is a minimalist, preset-based Doom Engine frontend launcher. So minimal, in fact, that it can be run from command-line instead of its normal GUI process!

Doomy makes a locally-stored database of Engines, IWADs, and PWADs to be grouped together into launchable presets. It can run practially every engine you can throw at it, including running the original executables using your favorite flavor of DOSBox!

Doomy can also store screenshots, demos, and saved games per preset so that you can also keep those nice and organized, without interfering with your other loaded presets.

What does it look like?

Doomy looks like this:

How does Doomy store its data?

Doomy uses SQLite to store its data. The SQLite DB schema that it uses is available in the documentation, or just open up doomy.db using a SQLite database browser. This way, if you feel so inclined, you can write a different frontend for it using the same data. Hopefully it's not too cryptic.

The preset data is stored in the preset folder in Doomy's config folder, each preset corresponding to a preset's hash. If you enter in the same preset (and not clean up the folder), the exact same config will line up with that preset.

As for WADs and IWADs and Engines, that's for you to decide - Doomy makes no assumptions about how you organize your Doom collection, though it works best on an organized hierarchy of folders.

How do I run the GUI on Linux/macOS?

Assuming Doomy is on your PATH, just type doomy --gui at the terminal. I need to make this a little bit better, somehow. Also, just running the JAR as-is will bring up the GUI version.