Linux Desktop Integration for Quake

  • click to auto-install a mod, play, resume from last save, etc.
  • for Ubuntu Linux and Ubuntu variants

New custom Quake singleplayer releases appear pretty frequently on places like func_msgboard and the Quake Mapping Discord server. It would be nice to have a low-friction way to swim in this river of content — especially since many of the releases are collections of small maps, any time spent fiddling with files or in the Quake console seems like too much useless overhead.

I've customized my singleplayer Quake setup on Linux to tackle that idea. The goal is to use desktop integration to quickly handle common stuff I do with Quake singleplayer releases: install, start play, resume play from savegame, hop between maps in a mapjam/speedmap pack, and uninstall. The files and scripts to do this are collected in a GitHub repo. I currently use a variant of Ubuntu called elementary OS, so this customization should work on Ubuntu, elementary OS, or other Ubuntu variants.


• Source


Automatically install and launch a downloaded zip of a Quake mod or maps

Double-click shortcut to launch a gamedir and resume at most recent savegame

Optional Chrome browser integration


• Auto install+play of downloaded archives

Right-click on an archive (zip or rar or many other kinds) and select "Open with Quake". The archive's files will be installed into a gamedir in your Quake directory and organized so that the content is ready to play. Optionally a ".quake" shortcut (described below) will be created in a directory of your choice. Finally the gamedir will be automatically be launched in the process described below.

• Launching Quake to play a gamedir

Right-click on a gamedir in your Quake directory and select "Open with Quake".

  • Common capitalization errors that break Linux play will be fixed.
  • If there are savegames, the gamedir will be activated in Quake and its most recent savegame loaded.
  • If no savegames, the gamedir will be activated in Quake and its start map (or only map) will be loaded.

• Optional ".quake" shortcuts for launching gamedirs

Double-click on a ".quake" file to launch the related gamedir as above. E.g. double-clicking "zendar1d.quake" would have the same effect as right-clicking the "zendar1d" gamedir and choosing "Open with Quake".

• Launching Quake to play a specific bsp

Double-click on a bsp file (in some maps directory within a gamedir). The gamedir will be activated in Quake as above, with the difference that the selected bsp will be what is loaded as opposed to some startmap or savegame.

• Optional "mapjam helper"

For a smoother trip through a mapjam or speedmap pack: an in-game keybind to load the next map that you haven't played yet.

• Uninstalling a gamedir

(This is only helpful if you use ".quake" shortcuts.) Right-click on a gamedir and choose to open it with "Quake mod cleanup". The gamedir and any ".quake" shortcut to it will be deleted. Similarly you can do this on a ".quake" shortcut, to delete both the shortcut and the gamedir it points to.

• Optional Chrome browser integration

Right-click on a download link in a webpage and select "Open with Quake"; same features as described above for archive files.


If you want to give this a whirl, you'll need to download the files from the GitHub repo, either by git-cloning them or just downloading a zip.

The instructions are in a top-level readme and three sub-readmes; since they are in markdown format it's probably nicest to work through them online. The main readme starts out with some of the material on this page, but then it covers some important caveats to be aware of before getting into the installation instructions.