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

Configuration

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