Raven is a rust-based theme manager for linux desktops. It works by defining multiple different 'options', like a polybar configuration, or a wallpaper, and then loads them into sequence when asked to. Even if you're not using a full-on DE, and instead opting for the more minimal WM like i3 or bspwm, you can still get a coherent theme that affects pretty much everything you do. There's a complete list of options available in the README of raven.
Raven has a few different moving parts.
Ravenserver is an online server that people can upload themes to using the command-line tool and later download them. The main instance is hosted here, so go check it out! More themes are always appreciated.
Raven is the command-line tool that you use to manage and load the themes, but it is just an interface to
Ravenlib, which handles all of the heavy-lifting with themes
Graven is an alpha-stage GUI version of raven, which I am very open to feedback on.
All you technically require is cargo to be installed.
You can install from crates.io by running cargo install raventhemer
, or by building manually:
Run:
git clone https://git.sr.ht/~nicohman/raven && cd raven
cargo install --path . --force
You can also download a binary built from the latest git commit at my website.
The following packages are required for their relevant options:
Polybar: poly
i3: i3
Pywal : pywal
Feh: wall
Ncmpcpp : ncmpcpp
Termite: termite
Bspwm : bspwm
Rofi is used in the default config and is recommended. You can also add a custom rofi theme with the rofi
option.
Ranger : ranger
Lemonbar : lemonbar
Openbox : openbox
Dunst : dunst
Sublime Text 3 : st_tmtheme
, st_scs
and st_subltheme
VSCode : vscode
raven help
for a list of available commands:
raven
nicohman <nicohman@demenses.net>
A theme manager and switcher for desktop linux
USAGE:
raven <SUBCOMMAND>
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
SUBCOMMANDS:
add Add option to current theme
cycle Control cycle daemon
delete Delete a theme
edit Edit theme
help Prints this message or the help of the given subcommand(s)
info Print info about the theme being currently edited
install Install a theme from ThemeHub repo
load Load a complete theme
manage Manage online themes
menu Show theme menu
modify Open the currently edited themes's option in $EDITOR
new Create a new theme
refresh Load last loaded theme
rm Remove an option from edited theme
A main config file is placed in ~/.config/raven/config.json, which has the following options:
polybar: Array of strings, which decideds what bars are run with polybar. The size of the array should be the same as your monitor number
monitors : The number of monitors currently in use
menu_command: A command that, when raven menu is run, will be piped a list of theme names through STDIN and expects a theme name from STDOUT
last: The last theme raven loaded
editing: The theme you are currently editing
host: The URL of the ravenserver host to use. By default, [https://demenses.net](https://demenses.net)
To configure a theme, start off by creating it with raven new [theme]
. You'll automatically start editing that theme. Run raven add [option] [file]
to add a specific option. This will copy the indicated file to raven's registry, and run/reload/copy it when the edited theme is loaded or refreshed. Run raven rm [option]
to remove an option from a theme. Available options are:
base_ files allow splitting the config from the cosmetics on the options with [base_] For example if you place an i3 config named base_i3 in ~/.config/raven, the contents of i3 for a theme will be appended to it instead of being run on their own. This allows you to have a central config for keyboard shortcuts, and have cosmetics only be stored in the theme.
The lemonbar option should be a shell script that runs lemonbar(s). They will automatically be killed just like polybars when the theme is changed or reloaded.
As many polybars as you have monitors will be started. The names of the bars themselves should be configured in config.json
. The default is ["main", "other"]. If you're sharing your themes with others, it is recommended that you leave the polybar monitor name blank, so that it automatically adapts to other monitor names.
With the cycle command you can control a daemon that will automatically cycle through all of your configured themes. You need to edit ~/.config/raven/time
and place the number of seconds there should be between each cycle into that file in order to use it.
Plain text containing sublt/<filename>.<extension>
(which you must create on your theme folder) or the name of an already installed theme (e.g DA.sublime-theme
)
Extensions: st_tmtheme (.tmTheme
), st_scs (.sublime-color-scheme
) and st_subltheme (.sublime-theme
)
Ravenserver has specific API docs available here, if you want to develop your own client for it or something similar.
Docs.rs has documentation for ravenlib, which is useful for either your own projects or contributing.
I'm very happen to take issues and pull requests. Please submit patches to the mailing list, and bug reports to the issue tracker. I will still accept either one on github, however.
commit e48bb3a456eb674f958fa602a00aa2e2aba7c3db Author: nicohman <None> Date: 2019-06-30T00:15:53+00:00 Update ravenserver docs for ravenserver-rs