Where to Download Dunst, Read the Documentation, or Report Bugs

Updated

The official site, dunst-project.org, is the starting point for all three tasks. Its top navigation has five entries: Home, Showcase, Download, Documentation, and Changelog. Use Download to get Dunst, Documentation to read the manual, and the GitHub issue tracker (linked from the site) to report bugs or request features. Before filing a report, the site asks you to check the FAQ and documentation first.

Finding what you need on the site

Task Where to go Notes
Get Dunst Download in the top navigation The site does not list packages or versions on the home page, so treat the Download page as the authoritative entry point
Read the manual Documentation in the top navigation Covers configuration, rules, shortcuts, and other features described on the home page
See what changed Changelog in the top navigation Use this to check whether an issue was already fixed in a newer release
See it in action Showcase in the top navigation Examples of customized setups
Report a bug or request a feature GitHub issue tracker The site directs all bug reports and feature requests here
Check before reporting FAQ and documentation The site explicitly asks you to consult these first

Reporting a bug or requesting a feature

The site states that bug reports and feature requests should go through the issue tracker on GitHub. Two steps come before that:

  1. Check the FAQ and documentation. Many configuration questions (fonts, colors, timeouts, shortcuts, rules) are answered there, and the site names these as the resources to consult before reporting.
  2. Check the Changelog. If you are on an older release, the behavior you are seeing may already be addressed.

When you do file a report, the site does not publish a required template, so include what a maintainer would need to reproduce the problem: your Dunst version, your window system (X11 or Wayland), the relevant configuration, and the steps that trigger the issue.

What the project is, in one line

Dunst is a lightweight replacement for the notification daemons bundled with most desktop environments. It is toolkit-independent, runs natively on both X11 and Wayland, and targets window-manager-centric Unix-like setups (Linux distributions, BSDs, and similar). Its feature set—customizable fonts, icons, timeouts and colors, hot reloading, pattern-based rules, notification history and replay, multiple pause levels, keyboard and mouse controls, multi-monitor placement, a dmenu-based context menu, and script hooks—is documented under Documentation, so that page is the place to go once you have installed it.

Practical sequence

For a first-time user, the efficient path is: Download → Documentation (install and configure) → Changelog (confirm you are on a current release) → GitHub issue tracker only if a problem persists after checking the FAQ and docs.