### Install via AUR Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/README.md Install prebuilt binary or build from latest git using yay. ```bash # Prebuilt binary yay -S dux-calendar-bin # Build from latest git yay -S dux-calendar-git ``` -------------------------------- ### Install via Flatpak Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/README.md Install and run the calendar from Flathub. ```bash flatpak install flathub dev.duxlabs.calendar flatpak run dev.duxlabs.calendar ``` -------------------------------- ### Install systemd user service Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/README.md Installs and enables a user service that starts the daemon at login and restarts on failure. ```bash make install-systemd systemctl --user enable --now dcal ``` -------------------------------- ### Build from source Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/README.md Clone with submodules and install. Requires the dux-qml-common submodule; build fails without it. ```bash git clone --recurse-submodules https://github.com/duxlabs-dev/dux-calendar.git cd dux-calendar sudo make install ``` -------------------------------- ### Run the installed Flatpak application Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/distro/flatpak/README.md Launches the installed Dux Calendar Flatpak application. ```bash flatpak run com.danklinux.dankcalendar ``` -------------------------------- ### Build and install Flatpak from repository root Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/distro/flatpak/README.md Builds the Flatpak using org.flatpak.Builder with --force-clean, --user, --install, and a local repo. Uses mirror-screenshots-url and compose-url-policy=full. ```bash flatpak run org.flatpak.Builder \ --force-clean --user --install --repo=repo \ --mirror-screenshots-url=https://dl.flathub.org/media \ --compose-url-policy=full \ builddir distro/flatpak/com.danklinux.dankcalendar.yml ``` -------------------------------- ### Development Setup and Make Commands Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/README.md Initialize submodules after clone and use make targets: `make run` builds and runs against in-repo quickshell config, `make test` runs Go test suite, `make fmt` formats Go code, `make update-common` bumps dux-qml-common submodule and nix flake input together. ```bash git submodule update --init # once after clone (or clone with --recurse-submodules) make run # build and run against the in-repo quickshell config make test # run the Go test suite make fmt # format Go code make update-common # bump the dux-qml-common submodule + nix flake input together ``` -------------------------------- ### Install pre-commit hooks with prek Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/CONTRIBUTING.md Installs pre-commit hooks after installing prek. Hooks run gofmt -s, go vet, go mod tidy, and the Go test suite for core/ changes, plus generic whitespace/YAML checks. ```bash prek install ``` -------------------------------- ### VSCode QML settings for Fedora Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/CONTRIBUTING.md Configure the QML extension for Fedora. Paths may vary by distribution; this example uses /usr/bin/qmlls and /usr/bin/qmake6. ```json { "[qml]": { "editor.defaultFormatter": "qt-project.qmlls", "editor.formatOnSave": true }, "qt-qml.doNotAskForQmllsDownload": true, "qt-qml.qmlls.customExePath": "/usr/bin/qmlls", "qt-core.additionalQtPaths": [ { "name": "Qt-6.x-Fedora-linux-g++", "path": "/usr/bin/qmake6" } ] } ``` -------------------------------- ### VSCode QML settings for Arch Linux Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/CONTRIBUTING.md Configure the QML extension for Arch Linux. Paths may vary by distribution; this example uses /usr/lib/qt6/bin/qmlls and /usr/bin/qmake. ```json { "[qml]": { "editor.defaultFormatter": "qt-project.qmlls", "editor.formatOnSave": true }, "qt-qml.doNotAskForQmllsDownload": true, "qt-qml.qmlls.customExePath": "/usr/lib/qt6/bin/qmlls", "qt-core.additionalQtPaths": [ { "name": "Qt-6.x-linux-g++", "path": "/usr/bin/qmake" } ] } ``` -------------------------------- ### dcal account and sync commands Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/README.md Manage accounts and sync from the command line. Use `dcal account add` to connect local, CalDAV/iCloud, Google, or Microsoft accounts; `dcal account setup` for custom OAuth clients; and `dcal sync` to force a sync. ```bash dcal account list # list connected accounts dcal account add local ~/cal # add a local calendar directory dcal account add caldav # add a CalDAV / iCloud account dcal account add google # sign in with Google (opens your browser) dcal account add microsoft # sign in with Microsoft (opens your browser) dcal account setup google # optional: use your own Google OAuth client dcal account setup microsoft # optional: use your own Microsoft app registration dcal account remove # remove an account dcal sync [account-id] # force a sync dcal reminders # list upcoming reminders ``` -------------------------------- ### I18n.tr usage example in QML Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/CONTRIBUTING.md Wrap user-facing strings in I18n.tr with context. This example shows a greeting on the calendar header. ```qml import qs.Common Text { text: I18n.tr("Hello World", " Hello world greeting shown on the calendar header") } ``` -------------------------------- ### Generate .qmlls.ini with dcal qs tooling Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/CONTRIBUTING.md Creates quickshell/.qmlls.ini so qmlls can resolve qs.* and Quickshell imports. Does not start the app; the file is a symlink into /run/user/, so run again after reboot. ```bash dcal qs tooling -p quickshell ``` -------------------------------- ### Mockery expecter API usage Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/CONTRIBUTING.md Generated mocks use the expecter API. Example shows creating a mock provider and setting an expectation for ListCalendars. ```go provider := mocks.NewMockProvider(t) provider.EXPECT().ListCalendars(mock.Anything).Return(cals, nil) ``` -------------------------------- ### Uninstall Flatpak with data deletion Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/distro/flatpak/README.md Removes the application and its data stored under ~/.var/app/com.danklinux.dankcalendar/. Note that this is separate from a native make install. ```bash flatpak uninstall --delete-data com.danklinux.dankcalendar ``` -------------------------------- ### Example translated export JSON structure Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/quickshell/translations/README.md poexports/.json files are nested context -> term -> translation objects. Common/I18n.qml picks the file matching the system locale (full tag first, then language code) and falls back to built-in English strings. ```json { "sidebar button to create a new event": { "Create event": "Termin erstellen" } } ``` -------------------------------- ### Copy Matugen template to configuration directories Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/README.md Creates the required directories and copies the included Matugen template into the user's Matugen templates folder. Adjust paths if using a custom XDG_CONFIG_HOME. ```bash mkdir -p ~/.config/matugen/templates ~/.config/dankcal cp assets/matugen/dankcalendar.json.template ~/.config/matugen/templates/dankcalendar.json.template ``` -------------------------------- ### dcal CLI commands for launching and managing the app Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/README.md Use these commands to launch, show, toggle, run, restart, or kill the application. Closing the window only hides it; the daemon and tray icon keep running. Reopen from the tray icon, desktop entry, or `dcal show`, and quit via tray menu or `dcal kill`. ```bash dcal # launch, or show/focus the window if already running dcal show # same as above dcal show --view day # open (or focus) directly on a view: month|week|day|agenda dcal toggle # toggle window visibility dcal run # run in the foreground (logs to the terminal) dcal run -d # run as a background daemon dcal restart # restart the running shell dcal kill # stop everything ``` -------------------------------- ### Repository structure tree Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/README.md Monorepo layout showing the QML interface, Go backend, shared submodule, assets, and Makefile. ```text dankcalendar/ ├── quickshell/ # QML-based calendar interface │ ├── Modules/ # UI components (calendar views, sidebar, tray) │ ├── Modals/ # Settings, account, event, and search dialogs │ ├── Services/ # IPC bridge and shell-side state │ ├── Widgets/ # Calendar-specific Dank UI controls │ ├── Common/ # Shared resources, themes, and i18n │ ├── DCommon/ # → symlink into the dux-qml-common submodule │ └── translations/ # POEditor-managed string catalogs ├── dux-qml-common/ # Shared DMS widget library (git submodule) ├── core/ # Go backend, daemon, and CLI │ ├── cmd/dcal/ # dcal CLI and daemon entrypoint │ ├── internal/ # Providers, sync engine, reminders, IPC, OAuth │ ├── api/ # HUMA + chi HTTP API │ ├── ent/ # Ent ORM schema and generated code │ └── repo/ # Repository-pattern data access ├── assets/ # Icons, desktop entry, systemd unit └── Makefile # Build, install, and dev targets ``` -------------------------------- ### Generate Matugen colors from wallpaper Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/README.md Runs Matugen with an image to generate the theme file. No reload hook is needed; Dux Calendar reloads the file when it changes. ```bash matugen image /path/to/wallpaper.png ``` -------------------------------- ### Add Matugen template entry to config.toml Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/README.md Registers the template in Matugen's configuration so it generates the theme file at the specified output path. Adjust paths if using a custom XDG_CONFIG_HOME. ```toml [templates.dankcalendar] input_path = "~/.config/matugen/templates/dankcalendar.json.template" output_path = "~/.config/dankcal/matugen-theme.json" ``` -------------------------------- ### dcal commands for opening and importing .ics files Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/README.md Open an `.ics` file (e.g., a meeting invitation) to preview and import it. The desktop entry registers `dcal` as a `text/calendar` handler, so opening the attachment from your mail client does the same. ```bash dcal open invite.ics # preview in the import dialog dcal events import invite.ics --calendar # import from the terminal dcal events rsvp accept # reply to an imported invitation ``` -------------------------------- ### Lint Flatpak repository Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/distro/flatpak/README.md Runs flatpak-builder-lint on the repo directory to check for issues. ```bash flatpak run --command=flatpak-builder-lint org.flatpak.Builder \ repo repo ``` -------------------------------- ### Lint Flatpak manifest Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/distro/flatpak/README.md Runs flatpak-builder-lint on the manifest file to check for issues. ```bash flatpak run --command=flatpak-builder-lint org.flatpak.Builder \ manifest distro/flatpak/com.danklinux.dankcalendar.yml ``` -------------------------------- ### Clone repository with submodules Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/CONTRIBUTING.md Clones the repository including the vendored dux-qml-common submodule. Use the second command in an existing clone to initialize submodules. ```bash git clone --recurse-submodules https://github.com/duxlabs-dev/dux-calendar.git # or, in an existing clone: git submodule update --init ``` -------------------------------- ### Run with hot reload from core/ Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/CONTRIBUTING.md Enables hot reload to pick up QML changes without restarting the app. Run from the core/ directory. ```bash # from core/ DCAL_ENABLE_HOTRELOAD=1 go run ./cmd/dcal run -c ../quickshell ``` -------------------------------- ### IPC Commands for dcal Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/README.md Scriptable IPC surface for keybinds and automation. Use `dcal ipc ui.toggle` to toggle UI, `ui.show` to show with optional view parameter (month|week|day|agenda), `ui.openEvent` with uid, `events.list` with date range, `accounts.list`, `reminders.upcoming`, and `system.autostart`. ```bash dcal ipc ui.toggle dcal ipc ui.show dcal ipc ui.show view=day # open on a specific view: month|week|day|agenda dcal ipc ui.openEvent uid= # open a specific event's details window dcal ipc events.list from=2026-06-01 to=2026-06-30 dcal ipc accounts.list dcal ipc reminders.upcoming dcal ipc system.autostart ``` -------------------------------- ### dcal open command with multiple file and URL formats Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/docs/calendar-file-import.md Opens .ics or .vcs files from the command line. Accepts multiple paths, file:// URLs with percent-encoding, and webcals:// URLs. The desktop entry advertises text/calendar, text/x-vcalendar, application/ics, webcal, and webcals, and accepts multiple URLs with %U. ```sh dcal open invitation.ics appointment.vcs dcal open 'file:///home/me/Team%20meeting.ics' dcal open webcals://example.com/calendar.ics ``` -------------------------------- ### Generate mocks with mockery Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/CONTRIBUTING.md Run from the core/ directory or via the root Makefile. Generates mocks into internal/mocks from .mockery.yml. Never write mocks by hand. ```bash make mocks ``` -------------------------------- ### Set POEditor credentials for Dux Calendar Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/quickshell/translations/README.md Set your own credentials with distinct env var names so the two projects don't clash. This repo has its own POEditor project, separate from Dux Shell. ```sh export DCAL_POEDITOR_API_TOKEN=... # POEditor account API token export DCAL_POEDITOR_PROJECT_ID=... # this project's numeric id ``` -------------------------------- ### Grant read-only access to Dux Shell theme cache Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/distro/flatpak/README.md Enables theme sync by allowing read-only access to the host cache directory xdg-cache/dms. Run with --user for the current user. ```bash flatpak override --user --filesystem=xdg-cache/dms:ro com.danklinux.dankcalendar ``` -------------------------------- ### Wrap user-facing string with I18n.tr in QML Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/quickshell/translations/README.md Wrap user-facing strings at the call site. The second argument is a short translator context describing where the string appears; identical terms in different roles need distinct contexts. Placeholders use %1/%2 with .arg(), and month/day names come from SettingsData, not translations. ```qml text: I18n.tr("Create event", "sidebar button to create a new event") ``` -------------------------------- ### Rebuild cached modules and tools Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/distro/flatpak/README.md Rebuilds cached modules and tools by adding --disable-cache to the builder command. Use when cached modules need to be refreshed. ```bash flatpak run org.flatpak.Builder \ --force-clean --disable-cache --user --install --repo=repo \ --mirror-screenshots-url=https://dl.flathub.org/media \ --compose-url-policy=full \ builddir distro/flatpak/com.danklinux.dankcalendar.yml ``` -------------------------------- ### Regenerate translation template with make i18n-extract Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/CONTRIBUTING.md Run from the repo root after adding or changing strings. Extraction skips strings inside quickshell/DCommon/ which are owned by dux-qml-common. ```bash make i18n-extract ``` -------------------------------- ### Run i18n test, sync, and check commands Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/quickshell/translations/README.md i18n-test extracts and validates without network. i18n-sync uploads en.json terms, downloads translations, and stages changes. i18n-check fails if local i18n is out of sync (for CI / pre-commit). ```sh make i18n-test # extract + validate, no network make i18n-sync # upload en.json terms, download translations, stage changes make i18n-check # fail if local i18n is out of sync (for CI / pre-commit) ``` -------------------------------- ### Grant access to local ICS calendar directory Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/distro/flatpak/README.md Allows the sandbox to read local calendar directories and custom theme files. Replace ~/calendars with the actual path; equivalent to a Flatseal permission. ```bash flatpak override --user --filesystem=~/calendars com.danklinux.dankcalendar ``` -------------------------------- ### Extract translations with make i18n-extract Source: https://github.com/duxlabs-dev/dux-calendar/blob/master/quickshell/translations/README.md Regenerates en.json (POEditor source upload) and template.json (empty template for translators). Run after adding or changing strings. make i18n-local does the same but prints which terms were added/removed. ```sh make i18n-extract # or: python3 extract_translations.py ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.