Raven

A theme manager for linux, currently focusing on i3. Supports multiple different configuration files, and is fast and portable. Upstream now hosted at sr.ht. You can find ravenlib there as well, if you're looking to add to or build off of the core features.

Example

ThemeHub

Raven supports installing themes from and publishing themes to ThemeHub, or your own instance of ravenserver. I encourage everyone to share their themes and rices there!

Wiki

There's a wiki here, which provides more in-depth information on raven and the surrounding projects.

Getting Started

If you just want to get going, you can install raven from crates.io with

cargo install raventhemer

If you don't want to install cargo, you can download a binary built from the latest git commit here.

Installation

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

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

• New option suggestions are very welcome!

You can also download a(possibly outdated prebuilt binary from here, or a binary built from the latest git commit at my website.

Usage

raven help for a list of available commands:

``` raven nicohman nicohman@demenses.net A theme manager and switcher for desktop linux

USAGE: raven

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 ```

Configuration

The section on configuring raven has been moved to the wiki. Go check it to learn how to configure raven!