Skip to content

Commit 8100cba

Browse files
committed
updated README
1 parent e3cc41e commit 8100cba

File tree

1 file changed

+100
-29
lines changed

1 file changed

+100
-29
lines changed

README.md

Lines changed: 100 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Doom Runner
22

3-
Doom Runner is yet another launcher of ZDoom and derivatives with graphical user interface. It is written in C++ and Qt, and it is designed around the idea of presets for various multi-file modifications (Brutal Doom with mutators, Project Brutality with UDV, Complex Doom Clusterfuck, ...) to allow one-click switching between them and minimize any repetitive work.
3+
Doom Runner is yet another launcher of common Doom source ports (like GZDoom, Zandronum, PrBoom, ...) with graphical user interface. It is written in C++ and Qt, and it is designed around the idea of presets for various multi-file modifications (Brutal Doom with mutators, Project Brutality with UDV, Complex Doom Clusterfuck, ...) to allow one-click switching between them and minimize any repetitive work.
44

55
First you perform an initial setup, setting up the paths and adding all your Doom engines and IWADs.\
66
![](Screenshots/1-InitialSetup.png "Initial setup")
@@ -17,12 +17,41 @@ You can even configure gameplay flags and compatibility flags, with tooltips fro
1717
If you extract a .wad file together with an equally named .txt file (for example AV.wad and AV.txt), you can display its content by doubleclicking the wad in the map pack list.\
1818
![](Screenshots/5-MapPackDesc.png "Map pack description")
1919

20-
The map list and IWAD list are automatically updated from selected directory, so everytime you download a new WAD, you don't need to manually add it to the launcher. The mod list supports drag&drop from directory window and internal drag&drop for reordering the files.
20+
And now the launcher even has a dark theme!
21+
![](Screenshots/6-DarkTheme.png "Dark theme")
2122

23+
### Features
2224

23-
## Project's state
25+
* Unlimited number of named presets switchable with a single-click
26+
* Lists of IWADs and Map packs are automatically synchronized with the content of a selected directory
27+
* Drag&Drop for easy adding of files or re-ordering them
28+
* Ability to quickly tick or untick any files to load without the need to remove and re-add them
29+
* Ability to start a multiplayer game on LAN
30+
* Ability to directly start selected map, load selected save or record/replay a demo
31+
* DM flags and Compatibility flags calculator with tooltips from official ZDoom wiki
32+
* Ability to automatically put save files, demo files or screenshots in a directory named after the selected preset
33+
* Ability to filter the saved presets using a search phrase or regular expression
34+
* Choice between light and dark theme that can follow system preferences
35+
36+
### Advantages over other launchers
37+
38+
* Compatible with most commonly used source ports:
39+
ZDoom, GZDoom, Skultag, Zandronum, PrBoom, Eternity, Chocolate Doom, Crispy Doom, ...
40+
... and support for more can be easily added if requested
41+
* Runs on Windows and Linux (installable via Flatpak or AUR)
42+
* Does not require any special runtime like .NET or JRE
43+
44+
### Disadvantages over other launchers
45+
46+
* Does not have any browser or downloader of known mods.
47+
You must find the mods, download them, and add them to the launcher by yourself.
48+
* Cannot show public multiplayer servers.
49+
You can join a server only by entering its hostname of IP address.
50+
51+
### Project's state
52+
53+
The development is near the end. I don't plan to add any big new features, only bug-fixes of reported issues and small usability improvements.
2454

25-
The development is at its end. There are not going to be any new major features, only bug-fixes of reported issues and small refinements.
2655

2756

2857
## Download
@@ -34,40 +63,89 @@ Pre-compiled executables for different operating systems can be found on [releas
3463
For Windows I only provide statically linked executable, because installing the Qt DLLs required to run this program is too much work and it's easier to have everything bundled together.
3564

3665

66+
3767
## How to install and run
3868

69+
3970
### Windows
4071

41-
Because of the static linking, everything is present in the executable. You just need to extract the executable into some directory and it is good to run.
72+
The `DoomRunner.exe` bundles everything inside itself. Just extract it into some directory and it is good to go. Putting it to `Program Files` is also supported.
4273

4374
#### Scoop
4475

45-
`doomrunner` is available in the games bucket:
76+
For users of [Scoop](https://scoop.sh/), thanks to [sitiom](https://github.com/sitiom) it is now available in the games bucket:
4677
```
4778
scoop bucket add games
4879
scoop install doomrunner
4980
```
5081

82+
5183
### Linux
5284

53-
On Linux, i wasn't able to make a static build yet. Therefore you need to install the following shared libraries to make the app run.
85+
On Linux you have few options.
86+
87+
#### Install manually
5488

55-
* libqt5core
56-
* libqt5gui
57-
* libqt5widgets
58-
* libqt5network
89+
Extract the executable in where you usually put them, commonly `/usr/bin` or `/opt/DoomRunner`.
5990

60-
On Ubuntu use
91+
Then you need to install the following shared libraries to make the app run.
92+
93+
* `libqt5core`
94+
* `libqt5gui`
95+
* `libqt5widgets`
96+
* `libqt5network`
97+
98+
Please note that in different distributions the libraries might have slightly different names, for example in Ubuntu 22 LTS they are called `libqt5core5a`, `libqt5gui5`, ...
99+
100+
Use your distribution package manager to find and install those
101+
102+
* Ubuntu: `sudo apt install libname`
103+
* Arch: `pacman -S libname`
104+
* ...
105+
* or use some graphical package manager like for example Muon
106+
107+
The executable was built in Kubuntu 22.04 LTS so there is a chance that it will not find the libraries in other distributions. In that case you will need to build it yourself.
108+
109+
#### Install via Flatpak
110+
111+
Thanks to [Massi aka Ergosum](https://github.com/mbugni), Doom Runner can now be installed via [Flatpak](https://flatpak.org/) from this package TODO: link, using the following commands:
61112
```
62-
sudo apt install libname
113+
TODO
63114
```
64-
or some graphical package manager like Muon.
65115

66-
The binaries were built on Kubuntu 22.04 LTS so it is possible that they will not find the libraries on other distributions. In that case you will need to build it yourself.
116+
#### Install from AUR
67117

68-
#### Arch Linux
118+
Thanks to [PopeRigby](https://github.com/poperigby), Arch Linux users can now leverage [AUR](https://wiki.archlinux.org/title/Arch_User_Repository) to install Doom Runner via package manager from this [package](https://aur.archlinux.org/packages/doomrunner) using the following commmands:
119+
```
120+
TODO
121+
```
122+
123+
#### Install on NixOS
124+
125+
Thanks to [Keenan Weaver](https://github.com/keenanweaver), NixOS users can now install Doom Runner [package](https://search.nixos.org/packages?channel=unstable&show=doomrunner&from=0&size=50&sort=relevance&type=packages&query=doomrunner) using the following instructions.
126+
127+
##### via the package manager
128+
```
129+
nix-env -iA nixpkgs.doomrunner
130+
```
131+
132+
##### via the configuration file
133+
134+
1. Add one of the following to your configuration.nix
135+
```
136+
environment.systemPackages = with pkgs; [
137+
doomrunner
138+
];
139+
```
140+
or
141+
```
142+
users.users.yourUserName.packages = with pkgs; [
143+
doomrunner
144+
];
145+
```
146+
147+
2. Rebuild the system with `nixos-rebuild`
69148

70-
Thanks to PopeRigby, Arch Linux users can now install DoomRunner via package manager from repository https://aur.archlinux.org/packages/doomrunner
71149

72150

73151
## How to build
@@ -83,7 +161,7 @@ I'm going to show you exact steps for building in Windows using Msys2 and in Ubu
83161

84162
#### Using Msys2
85163

86-
For instructions how to install Msys2 check www.msys2.org
164+
For instructions how to install Msys2 check [www.msys2.org](https://www.msys2.org)
87165

88166
Use Msys2-MinGW-64 terminal to enter the following commands.
89167

@@ -126,33 +204,25 @@ cd build-static
126204
C:/msys64/mingw64/qt5-static/bin/qmake ../DoomRunner.pro -spec win32-g++ "CONFIG+=release"
127205
mingw32-make
128206
```
129-
130-
131-
#### Using plain old MinGW
132-
133-
Not supported yet.
134-
You have to download the Qt sources and compile Qt by yourself. I cannot give you an advice here, because i tried it several times, but never got passed certain compilation errors. Alternativelly you can try to google and download pre-build Qt, but it has to be compiled by the SAME VERSION of compiler that you have installed, otherwise it might not link with your application.
135-
136207

137208
#### Using Visual Studio
138209

139210
Not supported yet.
140211
You have to download the Qt sources and compile Qt by yourself. I cannot give you an advice here, because i don't use Visual Studio at all. Alternativelly you can try to google and download pre-build Qt, but it has to be compiled by the SAME VERSION of compiler that you have installed, otherwise it might not link with your application.
141212

142213

143-
144214
### Linux (Ubuntu and derivatives)
145215

146216
##### 1. Install g++ compiler
147217
```
148218
sudo apt install g++
149219
```
150-
220+
151221
##### 2. Install Qt
152222
```
153223
sudo apt install qtbase5-dev qt5-qmake
154224
```
155-
225+
156226
##### 3. Build the project
157227
```
158228
cd <DoomRunner directory>
@@ -163,6 +233,7 @@ make
163233
```
164234

165235

236+
166237
## Reporting issues and requesting features
167238

168-
If you encouter a bug or just want the launcher to work differently, you can either create an issue here on github or reach me on email [email protected] or on Discord as Youda#0008.
239+
If you encouter a bug or just want the launcher to work differently, you can either create an issue here on github or reach me on email [email protected] or on Discord as Youda008.

0 commit comments

Comments
 (0)