{"id":13610504,"url":"https://github.com/nicohman/raven","last_synced_at":"2025-04-11T03:24:33.894Z","repository":{"id":32778764,"uuid":"111742370","full_name":"nicohman/raven","owner":"nicohman","description":"Rust-based themer for linux, specializing in i3. Rice at a moment's notice!","archived":false,"fork":false,"pushed_at":"2023-06-21T22:10:59.000Z","size":347,"stargazers_count":49,"open_issues_count":9,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-25T01:28:07.156Z","etag":null,"topics":["polybar","raven","rust","termite","theme","unixporn"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nicohman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null},"funding":{"github":"nicohman"}},"created_at":"2017-11-22T23:30:59.000Z","updated_at":"2024-08-11T21:12:26.000Z","dependencies_parsed_at":"2024-03-30T15:46:01.343Z","dependency_job_id":null,"html_url":"https://github.com/nicohman/raven","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicohman%2Fraven","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicohman%2Fraven/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicohman%2Fraven/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nicohman%2Fraven/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nicohman","download_url":"https://codeload.github.com/nicohman/raven/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248334634,"owners_count":21086433,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["polybar","raven","rust","termite","theme","unixporn"],"created_at":"2024-08-01T19:01:45.344Z","updated_at":"2025-04-11T03:24:33.868Z","avatar_url":"https://github.com/nicohman.png","language":"Rust","funding_links":["https://github.com/sponsors/nicohman"],"categories":["Rust"],"sub_categories":[],"readme":"# Raven [![](https://img.shields.io/crates/v/raventhemer.svg?style=flat-square)](https://crates.io/crates/raventhemer) [![builds.sr.ht status](https://builds.sr.ht/~nicohman/raven.svg)](https://builds.sr.ht/~nicohman/raven?)\n\nA theme manager for linux, currently focusing on i3. Supports multiple different configuration files, and is fast and portable. Upstream now hosted at [sr.ht](https://git.sr.ht/~nicohman/raven). You can find [ravenlib](https://git.sr.ht/~nicohman/ravenlib) there as well, if you're looking to add to or build off of the core features.\n\n### Example\n\n![A gif showing raven working](https://thumbs.gfycat.com/MenacingHandsomeCobra-size_restricted.gif)\n\n## ThemeHub\n\nRaven supports installing themes from and publishing themes to [ThemeHub](https://demenses.net), or your own instance of [ravenserver](https://git.sr.ht/~nicohman/ravenserver). I encourage everyone to share their themes and rices there!\n\n## Wiki\n\nThere's a wiki [here](https://man.sr.ht/~nicohman/raven), which provides more in-depth information on raven and the surrounding projects.\n\n## Getting Started\n\nIf you just want to get going, you can install raven from [crates.io](https://crates.io/crates/raventhemer) with\n\n`cargo install raventhemer`\n\nIf you don't want to install cargo, you can download a binary built from the latest git commit [here](https://demenses,net/downloads).\n\n## Installation\n\nAll you technically require is [cargo](https://github.com/rust-lang/cargo) to be installed.\nYou can install from [crates.io](https://crates.io/crates/raventhemer) by running `cargo install raventhemer`, or by building manually:\n\nRun:\n\n`git clone https://git.sr.ht/~nicohman/raven \u0026\u0026 cd raven`\n\n`cargo install --path . --force`\n\nThe following packages are required for their relevant options:\n\n+ [Polybar](https://github.com/jaagr/polybar): `poly`\n\n+ [i3](https://github.com/i3/i3): `i3`\n\n+ [Pywal](https://github.com/dylanaraps/pywal) : `pywal`\n\n+ [Feh](https://github.com/derf/feh): `wall`\n\n+ [Ncmpcpp](https://github.com/arybczak/ncmpcpp) : `ncmpcpp`\n\n+ [Termite](https://github.com/thestinger/termite/): `termite`\n\n+ [Bspwm](https://github.com/baskerville/bspwm) : `bspwm`\n\n+ [Rofi](https://github.com/DaveDavenport/rofi) is used in the default config and is recommended. You can also add a custom rofi theme with the `rofi` option.\n\n+ [Ranger](https://github.com/ranger/ranger) : `ranger`\n\n+ [Lemonbar](https://github.com/LemonBoy/bar) : `lemonbar`\n\n+ [Openbox](https://github.com/danakj/openbox) : `openbox`\n\n+ [Dunst](https://github.com/dunst-project/dunst) : `dunst`\n\n+ [Sublime Text 3](https://www.sublimetext.com/) : `st_tmtheme`, `st_scs` and `st_subltheme`\n\n+ [VSCode](https://github.com/Microsoft/vscode) : `vscode`\n\n* New option suggestions are very welcome!\n\nYou can also download a(possibly outdated prebuilt binary from [here](https://github.com/nicohman/raven/releases), or a binary built from the latest git commit at [my website](https://demenses.net/downloads).\n\n## Usage\n\n`raven help` for a list of available commands:\n\n```\nraven\nnicohman \u003cnicohman@demenses.net\u003e\nA theme manager and switcher for desktop linux\n\nUSAGE:\n    raven \u003cSUBCOMMAND\u003e\n\nFLAGS:\n    -h, --help       Prints help information\n    -V, --version    Prints version information\n\nSUBCOMMANDS:\n    add        Add option to current theme\n    cycle      Control cycle daemon\n    delete     Delete a theme\n    edit       Edit theme\n    help       Prints this message or the help of the given subcommand(s)\n    info       Print info about the theme being currently edited\n    install    Install a theme from ThemeHub repo\n    load       Load a complete theme\n    manage     Manage online themes\n    menu       Show theme menu\n    modify     Open the currently edited themes's option in $EDITOR\n    new        Create a new theme\n    refresh    Load last loaded theme\n    rm         Remove an option from edited theme\n```\n\n## Configuration\n\nThe section on configuring raven has been moved to the [wiki](https://man.sr.ht/~nicohman/raven). Go check it to learn how to configure raven!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicohman%2Fraven","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnicohman%2Fraven","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnicohman%2Fraven/lists"}