No description
  • JavaScript 93.6%
  • Zig 6.2%
  • CSS 0.1%
  • HTML 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-17 01:08:19 +01:00
extension fix: A background turning translucent after an apply is no longer left drawn opaque until the browser is refocused 2026-11-17 01:08:19 +01:00
.gitignore feat: Pages in the kosmos' colors and font through kosm's own browser extension 2026-11-12 20:51:50 +01:00
AGENTS.md feat: Pages in the kosmos' colors and font through kosm's own browser extension 2026-11-12 20:51:50 +01:00
App.zig feat: Colors and font are separate per-site toggles, so a site can keep one without the other 2026-11-14 01:07:51 +01:00
build.zig feat: Pages in the kosmos' colors and font through kosm's own browser extension 2026-11-12 20:51:50 +01:00
build.zig.zon feat: Pages in the kosmos' colors and font through kosm's own browser extension 2026-11-12 20:51:50 +01:00
README.md feat: Colors and font are separate per-site toggles, so a site can keep one without the other 2026-11-14 01:07:51 +01:00
root.zig feat: Pages in the kosmos' colors and font through kosm's own browser extension 2026-11-12 20:51:50 +01:00

kosm_firefox

Firefox-based browsers for kosm: every page darkened by Dark Reader's engine in the kosmos' colors and font, through kosm's own extension, and changed at once by every apply.

  • Kosm (extension/) styles pages: Dark Reader's engine in the values kosm wrote, and a toolbar button with a colors and a font switch for the current site and every site switched before. It can be signed for Mozilla's Firefox, but isn't yet.
  • Kosm Live (extension/live/) is Kosm plus an experiment API: it also sets the prefs other apps write for it in the running browser, and calls the window methods they name to recompute what the browser derives from those prefs. kosm_zen writes its prefs for it, so Zen's own UI (the kosm mod's colors, the accent) changes at once too, just as after a restart. Experiment APIs need a browser that runs unsigned extensions using them, such as Zen; Mozilla's Firefox won't load it.

Nothing of kosm runs while the browser is closed: the browser starts kosm relay while it runs, which sends the values file to the extension now and whenever an apply changes it.

What it writes

  • ~/.local/share/kosm/firefox/values.json: Dark Reader's theme.
  • ~/.local/share/kosm/firefox/relay: the script the browser starts, running kosm relay.
  • ~/.mozilla/native-messaging-hosts/kosm_firefox.json: tells Firefox and Zen where the relay is.
  • With live: Kosm Live in ~/.local/share/kosm/firefox/live/, and in every live profile a file extensions/kosm-live@ktisigonos installing it plus a // kosm:begin firefox block in user.js with the prefs it needs: unsigned extensions allowed (xpinstall.signatures.required), experiment APIs on (extensions.experiments.enabled), and extensions in the profile's own folder loading without a prompt (extensions.autoDisableScopes = 14). Anything able to write into your profile could already change its user.js, so these open nothing new to it.

After the first apply, restart the browser once; Kosm Live shows up in its add-ons. If you used Dark Reader or a Stylus font style, remove them.

Fields

Field Default
theme.mode null: dark; .dimmed dims light pages instead; from: .dark, or .dimmed for a light theme
theme.brightness, theme.contrast null: 100 (percent)
theme.grayscale, theme.sepia null: 0 (percent)
theme.text_stroke null: 0 (pixels, 0..1)
theme.dark_scheme_background_color null: Dark Reader's #181a1b; from: black
theme.dark_scheme_text_color null: #e8e6e3; from: white
theme.light_scheme_background_color null: #dcdad7; from: white
theme.light_scheme_text_color null: #181a1b; from: black
theme.scrollbar_color null: from the page; from: the theme's lightness.bright of the foreground
theme.selection_color null: from the page; from: the theme's state.selected of the background
theme.style_system_controls null: Dark Reader's choice
theme.font_family null: each page's fonts; families in fallback order
kosm_binary ~/.local/bin/kosm
directory ~/.local/share/kosm/firefox
native_hosts ~/.mozilla/native-messaging-hosts (LibreWolf: add ~/.librewolf/native-messaging-hosts)
live null: no Kosm Live; from: .{}
live.profiles ~/.zen/*
live.exclude none
format .{}: the JSON adapter's, then #rrggbb

An App{} writes nothing.

Dark Reader

extension/darkreader.js is the npm package darkreader 4.9.135 (MIT, extension/darkreader-LICENSE), unchanged. The engine has none of the Dark Reader extension's per-site fixes, so a few sites look worse than with the extension; switch their colors off with the toolbar button.