A cross-distribution Linux weather app with a native frontend per desktop. Reads the host theme on COSMIC and KDE Plasma. Pre-release beta.
Find a file
jcrenshaw 55d310fd8e Merge branch 'cosmic-only/remove-de-self-theming' into 'main'
refactor: remove KDE/GNOME self-theming, refocus on COSMIC-only

See merge request vintagetechie/atmos!24
2026-06-30 12:37:30 -04:00
.gitlab/issue_templates docs: tester guide, issue template, and beta status for v0.2.0-beta 2026-06-25 14:23:12 -04:00
.planning docs(planning): abandon Phase 17, record COSMIC-only pivot 2026-06-30 11:59:54 -04:00
crates refactor: remove KDE/GNOME self-theming, refocus on COSMIC-only 2026-06-30 11:52:34 -04:00
docs release: bump to 1.1.1-alpha — About dialog, app-id namespace, core groundwork 2026-06-14 15:36:25 -04:00
packaging/flatpak rename: app id com.vintagetechie.Atmos -> dev.jcrenshaw.Atmos 2026-06-14 11:36:33 -04:00
res release: prep v0.2.0-beta 2026-06-25 14:28:23 -04:00
scripts ci: test coverage + tag-triggered Flatpak release 2026-06-13 16:56:50 -04:00
.gitignore docs(planning): abandon Phase 17, record COSMIC-only pivot 2026-06-30 11:59:54 -04:00
.gitlab-ci.yml refactor: rename frontend crate atmos-cosmic -> atmos 2026-06-24 09:01:59 -04:00
cargo-sources.json release: bump to 0.1.0-beta, renumber to the 0.x beta scheme 2026-06-21 14:31:47 -04:00
Cargo.lock refactor: remove KDE/GNOME self-theming, refocus on COSMIC-only 2026-06-30 11:52:34 -04:00
Cargo.toml release: prep v0.2.0-beta 2026-06-25 14:28:23 -04:00
CHANGELOG.md release: bump to 0.1.0-beta, renumber to the 0.x beta scheme 2026-06-21 14:31:47 -04:00
deny.toml refactor: rename frontend crate atmos-cosmic -> atmos 2026-06-24 09:01:59 -04:00
dev.jcrenshaw.Atmos.json release: prep v0.2.0-beta 2026-06-25 14:28:23 -04:00
LICENSE-APACHE chore: add MIT and Apache-2.0 license files 2026-06-12 14:15:04 -04:00
LICENSE-MIT chore: add MIT and Apache-2.0 license files 2026-06-12 14:15:04 -04:00
package-lock.json docs(phase-11): replan with cross-AI review; switch reviewer to gemini 2026-06-23 21:36:09 -04:00
package.json docs(phase-11): replan with cross-AI review; switch reviewer to gemini 2026-06-23 21:36:09 -04:00
README.md docs: tester guide, issue template, and beta status for v0.2.0-beta 2026-06-25 14:23:12 -04:00
rust-toolchain.toml chore(01-01): scaffold Cargo workspace + three crate manifests + committed Cargo.lock 2026-06-11 23:27:17 -04:00
TESTER.md release: prep v0.2.0-beta 2026-06-25 14:28:23 -04:00

Atmos

A cross-distribution Linux weather app with a native, per-desktop frontend.

Atmos shows current conditions, hourly and 7-day forecasts, and severe-weather alerts. It detects your location automatically (or lets you search for a city) and keeps the reading fresh in the background. The COSMIC™ desktop frontend is the first and currently the only face; the data core is toolkit-neutral so other desktop frontends can be added without touching it.

Status: pre-release v0.2.0-beta ("Self-Theming"). Atmos now reads the host desktop theme and matches it (COSMIC and KDE Plasma). Packaged for the author's self-hosted Flatpak remote while it stabilizes. See TESTER.md if you want to help test.

Features

  • Current conditions with feels-like, humidity, wind, pressure, and visibility
  • Hourly and 7-day forecasts
  • Severe-weather alerts with a header badge and a dedicated Alerts page
  • Automatic location detection (IP-based) and city search
  • Imperial/metric units and a configurable refresh interval
  • Background refresh that survives sleep/resume and network blips without blanking

Install (Flatpak)

Atmos runs on the freedesktop runtime, which lives on Flathub. Most COSMIC systems already have Flathub; some clean installs don't, so add it first, then add the jcrenshaw.dev remote (where everything I ship lives) and install:

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak remote-add --if-not-exists jcrenshaw https://dl.jcrenshaw.dev/jcrenshaw.flatpakrepo
flatpak install jcrenshaw dev.jcrenshaw.Atmos
flatpak run dev.jcrenshaw.Atmos

If you skip Flathub the install stops with requires the runtime org.freedesktop.Platform/x86_64/25.08 which was not found — that's the runtime missing, not the app. Add Flathub and run the install again.

The jcrenshaw remote is GPG-signed.

Build from source

Requires a Rust toolchain and the COSMIC/libcosmic build dependencies.

cargo build --release -p atmos
./target/release/atmos

Architecture

Atmos is a Cargo workspace:

  • atmos-core — toolkit-neutral data, settings, scheduling, and view-models. Carries no UI-toolkit dependency (enforced by a firewall test).
  • atmos — the COSMIC (libcosmic) frontend. The only crate allowed to touch a UI toolkit.
  • atmos-harness — test/support harness for the core.

Support

If Atmos is useful to you, you can support development at ko-fi.com/vintagetechie. Issues and feature requests go to the issue tracker.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option. (The COSMIC frontend binary links the GPL-3.0 libcosmic toolkit; the Atmos source itself remains MIT/Apache-2.0.)