You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: README.md
+20-3
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
# Raven
2
-
A theme manager for linux, currently focusing on i3. Supports multiple different configuration files, and can reload an entire theme on a dime. Fast, easy to use and portable.
2
+
A theme manager for linux, currently focusing on i3. Supports multiple different configuration files, and is fast and portable.
3
3
4
4
## Installation
5
5
All you technically require is [cargo](https://github.com/rust-lang/cargo) to be installed.
@@ -21,6 +21,12 @@ The following packages are required for their relevant options:
info : print info about the theme being currently edited
37
46
menu : show theme menu
38
47
```
39
48
## Configuration
@@ -43,17 +52,25 @@ window_manager: |[window manager in use. Currently only i3 is supported.]|
43
52
monitor : |number of monitors available, to tell how many polybars to dupe.|
44
53
```
45
54
46
-
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. Available options are:
55
+
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:
47
56
48
57
+ poly(Polybar)
49
58
+ termite(Termite config)
50
59
+ wm(window manager config)
51
60
+ wall(Wallpaper)
52
61
+ xres(Xresources)
53
62
+ xres\_m(Xresources, to be merged)
63
+
+ ranger(rc.conf)
64
+
+ lemonbar(A shell script that should spawn your lemonbar)
65
+
+ ncmpcpp(ncmpcpp connfig file)
54
66
55
67
If you place an i3 config named base\_i3 in ~/.config/raven, the contents of wm 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.
56
-
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.
68
+
69
+
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.
57
70
58
71
### Polybar bar names
59
72
Up to two polybars will be started, depending on how many monitors you have configured. The bars should be named, in order: `main` and `other`
73
+
74
+
### Cycle themes
75
+
76
+
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 inbetween each cycle into that file in order to use it.
0 commit comments