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

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​

On Arch, use the AUR packages below. On Fedora, Debian, Ubuntu, and OpenSUSE, the DankLinux repository publishes dankcalendar-git, a rolling build from upstream master. A stable dankcalendar package may follow tagged releases later.

Arch Linux (AUR)​

# Prebuilt binary
yay -S dankcalendar-bin

# Build from latest git
yay -S dankcalendar-git

Fedora & CentOS (COPR)​

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

Debian (OBS)​

# Debian 13 (Trixie) — adjust the repo URL for Testing or Sid if needed
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
tip

See the DankLinux repository guide for Debian Testing, Sid, and other OBS repo URLs.

Ubuntu (PPA)​

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

OpenSUSE (OBS)​

# Tumbleweed — see the DankLinux guide for Leap / Slowroll repo URLs
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

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