Skip to main content
Version: 1.6

Dux Calendar

DankCalendar Installation

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.

Flatpak​

DankCalendar is available on Flathub as com.danklinux.dankcalendar. The Flatpak bundles its runtime dependencies, so you do not need a separate Quickshell install on the host.

flatpak install flathub com.danklinux.dankcalendar
flatpak run com.danklinux.dankcalendar
note

Notifications and credentials use XDG desktop portals. To sync DankMaterialShell theme colors from the host, grant read access to the cache:

flatpak override --user \
  --filesystem=xdg-cache/DankMaterialShell:ro \
  com.danklinux.dankcalendar

Local ICS calendar directories also need an explicit filesystem grant (or the equivalent in Flatseal).

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

Install DankCalendar from our R2-backed XBPS repository or build it from source.

echo "repository=https://void.danklinux.com/danklinux/current" | sudo tee /etc/xbps.d/danklinux.conf
sudo xbps-install -Su
sudo xbps-install -S dankcalendar
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 (the Quickshell UI is embedded in the binary)
  • Desktop entry, icon, shell completions, and dcal.service under /usr/lib/systemd/user/

From Source​

The Quickshell UI is embedded into the dcal binary at build time, and part of it lives in the dank-qml-common submodule — clone with --recurse-submodules (or run git submodule update --init in an existing clone):

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

This installs:

  • dcal binary to /usr/local/bin (UI embedded)
  • 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