A responsive clock application for COSMIC desktops and Linux phones, built with libcosmic.
Alarms are evaluated while Clock is running. They are not yet backed by a system service, so closing the application also stops alarm delivery.
just run
just demojust demo opens the deterministic world-clock page used as the basis for preview automation.
Requirements: Rust 1.98+, just, pkg-config, Wayland and XKB development libraries.
just check
just build-release
sudo just installThe Flatpak needs Wayland, fallback X11, DRI, PulseAudio-compatible playback, desktop notifications, read-only COSMIC configuration, and COSMIC settings-daemon access. It does not require network, location, or sensor permissions.
The repository retains the blueprint's Flatpak, Alpine APK, cross-compilation, metadata generation, deterministic preview, CI, and release workflows. Run just generate after dependency or translation changes to refresh localized metadata and Flatpak Cargo sources.
Dependabot checks Cargo dependencies and GitHub Actions daily at 06:00 UTC. libcosmic updates remain individual PRs; other Cargo minor and patch updates are grouped, while major updates stay separate. Cargo updates increase manifest requirements as well as the lockfile. Rust toolchain and Python build dependencies are checked weekly on Mondays. Updates still require review and passing CI.
rust-toolchain.toml is the compiler-version source for CI and the musl build images. Cargo.toml keeps the minimum supported Rust version separately. requirements-build.txt supplies the Python dependencies for both local Flatpak source generation and CI; the local recipe uses an isolated uv environment or a virtualenv rather than arbitrary preinstalled modules.
Container-base updates, the coherent cross CLI/image set, rustup and generator checksum pins, and Flatpak runtime/BaseApp compatibility remain reviewed maintenance tasks. Like Camera, the preview container uses fedora:44 and current distro packages, extracting the COSMIC theme from the repository's current cosmic-settings RPM. CI caches the built image by Containerfile hash. Run just generate-previews to regenerate screenshots and review visual changes after rebuilding: package versions are not locked, so a fresh build can change their appearance.
Licensed under GPL-3.0-only. Contributions intentionally submitted for inclusion are licensed under the same terms. Source files should carry SPDX-License-Identifier: GPL-3.0-only.
