Skip to main content
Version: 1.6
██████╗  ██████╗ █████╗ ██╗     
██╔══██╗██╔════╝██╔══██╗██║     
██║  ██║██║     ███████║██║     
██║  ██║██║     ██╔══██║██║     
██████╔╝╚██████╗██║  ██║███████╗
╚═════╝  ╚═════╝╚═╝  ╚═╝╚══════╝

DankCalendar Installation

DankCalendar installs a single dcal binary, the Quickshell UI config, and a desktop entry.

Requirements​

  • Quickshell (qs) — quickshell-git or quickshell from the DankLinux repository
  • Qt 6 declarative, including Qt.labs.platform for the tray icon
  • Go 1.25+ (build from source only; the packaged binary is pure Go with no CGO)

Installation Methods​

Choose the installation method that best fits your system.

Distribution Packages​

Arch & Derivatives​

paru -S dankcalendar-bin

Fedora & CentOS​

sudo dnf copr enable avengemedia/danklinux
sudo dnf install dankcalendar-git

Debian & Ubuntu​

Debian​

Packages are published on OBS for Debian 13 (Trixie), Debian Testing, and Debian Sid.

Select your release:

curl -fsSL https://download.opensuse.org/repositories/home:AvengeMedia:danklinux/Debian_13/Release.key | \
  sudo gpg --dearmor -o /etc/apt/keyrings/danklinux.gpg
echo "deb [signed-by=/etc/apt/keyrings/danklinux.gpg] https://download.opensuse.org/repositories/home:/AvengeMedia:/danklinux/Debian_13/ /" | \
  sudo tee /etc/apt/sources.list.d/danklinux.list
sudo apt update
sudo apt install dankcalendar-git

Ubuntu​

Ubuntu 26.04 LTS+ (Resolute Raccoon) is supported via Launchpad PPA.

sudo add-apt-repository ppa:avengemedia/danklinux
sudo apt update
sudo apt install dankcalendar-git

openSUSE & Derivatives​

DankCalendar is available through the Open Build Service (OBS) for OpenSUSE Tumbleweed, Leap 16/16.1, and Slowroll.

Select your distribution:

sudo zypper addrepo https://download.opensuse.org/repositories/home:AvengeMedia:danklinux/openSUSE_Tumbleweed/home:AvengeMedia:danklinux.repo
sudo zypper refresh
sudo zypper install dankcalendar-git

Void Linux​

note

Void packages are pending submission to the official void-packages repository. Until they are merged upstream, you can install them from our self-hosted custom XBPS repositories or build them from source.

echo "repository=https://avengemedia.github.io/DankLinux/current" | sudo tee /etc/xbps.d/danklinux.conf
sudo xbps-install -Su
sudo xbps-install -S dankcalendar-git
note

On the first sync, xbps-install will output our signing key fingerprint and ask you to type y to trust and import it. Verify that the key matches our official signing fingerprint.

Distribution packages install:

  • dcal to /usr/bin/dcal
  • Quickshell UI to /usr/share/quickshell/dankcal
  • Desktop entry, icon, shell completions, and dcal.service under /usr/lib/systemd/user/

From Source​

git clone https://github.com/AvengeMedia/dankcalendar
cd dankcalendar
sudo make install

This installs:

  • dcal binary to /usr/local/bin
  • Quickshell config to /usr/local/share/quickshell/dankcal
  • Desktop entry + icon

Override the prefix with PREFIX=/usr sudo make install.

Running at Login​

DankCalendar runs as a background daemon, and the window is just a view onto it. To keep it running across logins, choose one of:

systemd user service​

The distribution package and make install-systemd both provide a user unit. After installing from a distribution package or building from source:

systemctl --user enable --now dcal

When building from source without the systemd install target:

make install-systemd
systemctl --user enable --now dcal

Start at login (XDG autostart)​

Toggle Start at login from Settings → General. This manages an XDG autostart entry that launches dcal run -d --hidden, so the daemon starts hidden and waits in the tray.

Verification​

# Check version
dcal version

# Launch the calendar window
dcal

Next Steps​

  • Accounts - Connect your calendars
  • Usage - Learn the CLI commands