= Doom Launcher

https://ci.appveyor.com/project/hobomaster22/doomlauncher[image:https://ci.appveyor.com/api/projects/status/github/nstlaurent/doomlauncher?svg=true[Build status]]

image:https://api.codacy.com/project/badge/Grade/f77deda96cfb4b90a201d09cb0014009[link="https://app.codacy.com/manual/nstlaurent/DoomLauncher?utm_source=github.com&utm_medium=referral&utm_content=nstlaurent/DoomLauncher&utm_campaign=Badge_Grade_Settings"]

Doom Launcher is a Doom frontend for Windows PC. Instead of being a simple utility to launch your files, it serves as database for all your Doom engine games and mods. It can be compared to https://www.quaddicted.com/tools/quake_injector[Quake Injector], a popular tool for Quake.

image::https://i.imgur.com/TIg4kNK.png[IWads Tile View Showcase] Large tile view for IWads tab. IWADs such as Freedoom and Heretic can be played with Doom Launcher.

image::https://i.imgur.com/mYqC1QO.png[Custom Files Tile View Showcase] Large tile view for a custom tag named "Playing". Doom Launcher can play custom mapsets such as Eviternity, Back to Saturn X, Plutonia 2, and more!

== Features

• Direct download and metadata update from /idgames (through API).
• Add ZIP archives containing WAD/PK3/DEH/TXT files.
• Automatic scraping of title, author, release date and description from included text files.
• Automatically load files when selecting an IWAD or source port.
• Add comments and ratings for files.
• Import screenshots directly from a source port into the database.
• Maintain demos and saved games (DSG/ZDS supported).
• Set launch parameters and warp into any map in a file.
• Select specific files within a ZIP archive.
• Tag files with custom colored tags.
• Screen filters to simulate CRT monitors.
• Record play-statistics for each map completed in a play session. Supported source ports includes ZDoom, PrBoom+, CNDoom, Chocolate Doom, and Crispy Doom.
• Automatic daily database backups (SQLite database files).
• Create shortcuts to quickly launch files.

Many more features are documented in the Help file. Please read it if you have any concerns regarding certain features.

Doom Launcher is written by Hobomaster22 in C# and requires .NET 4.5. If you want to report bugs or suggest features, submit issues to the GitHub repository. To contribute to Doom Launcher, fork a copy of the repository and submit your changes via a pull request.

== Building Doom Launcher

Download a copy of the repository onto your Windows system and open up the solution file on Visual Studio. Visual Studio 2017 or later is recommended. You may create new unit tests to help verify that your changes work before submitting them.

Doom Launcher currently supports Windows 7 and later. Mac and Linux are unsupported.

In order to build the Setup module for Visual Studio 2022, you may need to separately install support for Installer projects: https://marketplace.visualstudio.com/items?itemName=VisualStudioClient.MicrosoftVisualStudio2022InstallerProjects

== Development Tools

SQLite Browser. Great tool for viewing and editing the DoomLauncher.sqlite database: https://sqlitebrowser.org/

SonarLint. A great code analysis extension for Visual Studio. Highly recommended and used for most of Doom Launcher's development: https://www.sonarlint.org/visualstudio/

== Doom Launcher Links

GitHub Repository: https://github.com/nstlaurent/DoomLauncher

Doomworld Thread: https://www.doomworld.com/vb/doom-general/69346-doom-launcher-doom-frontend-database/

Realm667: https://realm667.com/index.php/en/kunena/doom-launcher