How to make Address links on doomlist.net work

To be able to join servers directly by clicking the links in the Address column on https://doomlist.net, your OS needs to be configured to associate the zan:// URL scheme with a launcher.

On Windows this can be done by using the official Zandronum installer bundle version 3.2 or later (available at https://zandronum.com/). The association is made by default during the installation process and no more setup is needed.

Linux users will have to follow this guide to achieve the same.

This guide uses Doomseeker as the launcher and assumes you already have it installed.

Guide for Linux:

Use your favorite text editor to create a file on the following path:

$HOME/.local/share/applications/doomseeker-link-handler.desktop

The contents of the file should be as follows (replace PATH_TO_DOOMSEEKER with the correct path to the doomseeker executable on your system):


[Desktop Entry]
Type=Application
Name=Doomseeker link handler
Exec=/PATH_TO_DOOMSEEKER/doomseeker --connect %u
StartupNotify=false
MimeType=x-scheme-handler/zan;

Finally run the following command:

xdg-mime default doomseeker-link-handler.desktop x-scheme-handler/zan

Now when you click a zan:// link, Doomseeker should connect you to the server.

Guide for Windows:

For Windows users the preferred setup method is using the official Zandronum installer bundle available at https://zandronum.com/. If you used the installer, you don't need any further setup. This legacy guide is only provided for reference.

It is necessary to edit the Windows registry to make a new URL scheme association. You can use the linked web tool or follow the manual instructions below.

Using Sean's web tool

https://firestick.games/zds

Just run the generated .reg file as administrator and you should be set.

Manual instructions

The following subtree has to be created in the registry:


HKEY_CLASSES_ROOT
     zan
         (Default) = "URL:zandronum"
         URL Protocol = ""
         shell
             open
                 command
                     (Default) = "PATH_TO_DOOMSEEKER\doomseeker.exe --connect %1"

To create this subtree automatically, you can use this .reg file

The last step is to replace the placeholder path with the actual path to your doomseeker.exe. Start the Windows registry editor (regedit.exe) as administrator and navigate to the following path in the registry:

Computer\HKEY_CLASSES_ROOT\zan\shell\open\command

Double click the (Default) entry to edit the value. Replace PATH_TO_DOOMSEEKER with the path to the doomseeker executable on your system.

The result should look like this (except the path will be different):

regedit

Once the path to doomseeker.exe in the registry is correctly set the zan:// links should start working immediately.