https://github.com/j03-dev/system-theme.hx
system-theme.hx is a theme switcher plugin for Helix
https://github.com/j03-dev/system-theme.hx
Last synced: 5 months ago
JSON representation
system-theme.hx is a theme switcher plugin for Helix
- Host: GitHub
- URL: https://github.com/j03-dev/system-theme.hx
- Owner: j03-dev
- License: mit
- Created: 2026-01-13T15:07:43.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-01-16T11:12:22.000Z (5 months ago)
- Last Synced: 2026-01-17T06:44:28.978Z (5 months ago)
- Language: Scheme
- Size: 43.9 KB
- Stars: 8
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# system-theme.hx
system-theme.hx is a theme switcher plugin for [Helix](https://github.com/helix-editor/helix/) that automatically adapts to your system's appearance (dark/light mode).
## Usage
Add the following to `init.scm` in your Helix config directory:
```scheme
(require "system-theme-hx/system-theme.scm")
(auto-theme "tokyonight_moon" "github_light")
```
This plugin provides the `auto-theme` function that automatically switches between dark and light themes based on system preference.
### Examples
```scheme
;; Gruvbox variants
(auto-theme "gruvbox_dark_hard" "gruvbox_light_hard")
;; Catppuccin variants
(auto-theme "catppuccin_mocha" "catppuccin_latte")
```
## Installation
Follow the instructions [here](https://github.com/mattwparas/helix/blob/steel-event-system/STEEL.md) to install Helix on the plugin branch.
Then, install the plugin with one of the installation methods below.
### Using Forge
Forge is the Steel package manager, and will have been installed in the previous step. Run the following:
```sh
forge pkg install --git https://github.com/j03-dev/system-theme.hx.git
```
### Building from source
1. Clone and `cd` into this repo and run `cargo steel-lib`
1. Add `(require "/system-theme.hx/system-theme.scm")` to `init.scm` in your Helix config (where `` is the absolute path of the folder containing the system-theme.hx repo)