refactor
This commit is contained in:
parent
876d79c480
commit
61a4a9bdcd
GPG key ID:
901B2ADDF27C2263
2 changed files with 141 additions and 2 deletions
|
|
@ -5,4 +5,52 @@ website: https://davatorium.github.io/rofi/
|
|||
repo: https://github.com/davatorium/rofi
|
||||
---
|
||||
# Rofi
|
||||
#wip
|
||||
Rofi is a window switcher, run dialog, ssh-launcher and dmenu replacement that started as a clone of simpleswitcher, written by Sean Pringle and later expanded by Dave Davenport.
|
||||
|
||||
## Configuration
|
||||
There are two methods of setting configuration options:
|
||||
- Local configuration. Normally, depending on XDG, in `~/.config/rofi/config.rasi`.
|
||||
- Command line options:
|
||||
|
||||
```shell
|
||||
rofi -combi-modi window,drun,ssh -theme solarized -font "hack 10" -show combi
|
||||
```
|
||||
|
||||
can be expressed in a configuration file like this:
|
||||
```
|
||||
configuration {
|
||||
modi: "window,drun,ssh,combi";
|
||||
font: "hack 10";
|
||||
combi-modi: "window,drun,ssh";
|
||||
}
|
||||
@theme "solarized"
|
||||
```
|
||||
|
||||
To get a full list of options for `config.rasi` file run `rofi -dump-config` or `rofi -h`. You can write the output of the command directly to your configuration file while running `rofi -dump-config > ~/.config/rofi/config.rasi`.
|
||||
|
||||
## Themes
|
||||
The easiest way to get started theming rofi is by modifying your existing theme.
|
||||
|
||||
Themes can be modified/tweaked by adding theming elements to the end of the
|
||||
config file. The default location of this file is `~/.config/rofi/config.rasi`, if the file does not exists, you can create it.
|
||||
|
||||
A basic config:
|
||||
```
|
||||
configuration {
|
||||
modes: [ combi ];
|
||||
combi-modes: [ window, drun, run ];
|
||||
}
|
||||
|
||||
@theme "gruvbox-light"
|
||||
|
||||
/* Insert theme modifications after this */
|
||||
```
|
||||
|
||||
For example if we want to change the `Type to filter` text in the entry box we append the following:
|
||||
```css
|
||||
entry {
|
||||
placeholder: "Type here";
|
||||
}
|
||||
```
|
||||
|
||||
In the above section, `entry` indicates the widget, `placeholder` is the property we want to modify and we set it to the string `"Type here"`.
|
||||
|
|
|
|||
|
|
@ -3,4 +3,95 @@ obj: application
|
|||
repo: https://github.com/Alexays/Waybar
|
||||
---
|
||||
# Waybar
|
||||
#wip
|
||||
Highly customizable Wayland bar for Sway, [hyprland](../desktops/hyprland.md) and Wlroots based compositors.
|
||||
|
||||
![Screenshot][Screenshot]
|
||||
|
||||
## Configuration
|
||||
The configuration uses the [JSON](../../files/JSON.md) file format and is named `config`.
|
||||
|
||||
Valid directories for this file are:
|
||||
- `~/.config/waybar/`
|
||||
- `~/waybar/`
|
||||
- `/etc/xdg/waybar/`
|
||||
|
||||
A good starting point is the [default config](https://github.com/Alexays/Waybar/blob/master/resources/config).
|
||||
|
||||
### Bar Config
|
||||
|
||||
| option | typeof | default | description |
|
||||
| ----------------------------------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `layer` | string | `bottom` | Decide if the bar is displayed in front (`top`) of the windows or behind (`bottom`) them. |
|
||||
| `output` | string | array | |
|
||||
| `position` | string | `top` | Bar position, can be `top`,`bottom`,`left`,`right`. |
|
||||
| `height` | integer | | Height to be used by the bar if possible, leave blank for a dynamic value. |
|
||||
| `width` | integer | | Width to be used by the bar if possible, leave blank for a dynamic value. |
|
||||
| `modules-left` | array | | Modules that will be displayed on the left. |
|
||||
| `modules-center` | array | | Modules that will be displayed in the center. |
|
||||
| `modules-right` | array | | Modules that will be displayed on the right. |
|
||||
| `margin` | string | | Margins value using the css format without units. |
|
||||
| `margin-<top\|left\|bottom\|right>` | integer | | Margins value without units. |
|
||||
| `spacing` | integer | `4` | Size of gaps in between of the different modules. |
|
||||
| `name` | string | | Optional name added as a CSS class, for styling multiple waybars. |
|
||||
| `mode` | string | | Selects one of the preconfigured display modes. This is an equivalent of the [`sway-bar(5)`](https://github.com/swaywm/sway/blob/master/sway/sway-bar.5.scd) `mode` command and supports the same values: `dock`, `hide`, `invisible`, `overlay`. <br>Note: `hide` and `invisible` modes may be not as useful without Sway IPC. |
|
||||
| `start_hidden` | bool | `false` | Option to start the bar hidden. |
|
||||
| `modifier-reset` | string | `press` | Defines the timing of modifier key to reset the bar visibility. To reset the visibility of the bar with the press of the modifier key use `press`. Use `release` to reset the visibility upon the release of the modifier key and only if no other action happened while the key was pressed. This prevents hiding the bar when the modifier is used to switch a workspace, change binding mode or start a keybinding. |
|
||||
| `exclusive` | bool | `true` | Option to request an exclusive zone from the compositor. Disable this to allow drawing application windows underneath or on top of the bar. <br>Disabled by default for `overlay` layer. |
|
||||
| `fixed-center` | bool | `true` | Prefer fixed center position for the `modules-center` block. The center block will stay in the middle of the bar whenever possible. It can still be pushed around if other blocks need more space. <br>When false, the center block is centered in the space between the left and right block. |
|
||||
| `passthrough` | bool | `false` | Option to pass any pointer events to the window under the bar. <br>Intended to be used with either `top` or `overlay` layers and without exclusive zone. <br>Enabled by default for `overlay` layer. |
|
||||
| `gtk-layer-shell` | bool | `true` | Option to disable the use of gtk-layer-shell for popups. Only functional if compiled with gtk-layer-shell support. |
|
||||
| `ipc` | bool | `false` | Option to subscribe to the Sway IPC bar configuration and visibility events and control waybar with `swaymsg bar` commands. <br>Requires `bar_id` value from sway configuration to be either passed with the `-b` commandline argument or specified with the `id` option. <br>See [#1244](https://github.com/Alexays/Waybar/pull/1244) for the documentation and configuration examples. |
|
||||
| `id` | string | | `bar_id` for the Sway IPC. Use this if you need to override the value passed with the `-b bar_id` commandline argument for the specific bar instance. |
|
||||
| `include` | array | | Paths to additional configuration files. <br>Each file can contain a single object with any of the bar configuration options. In case of duplicate options, the first defined value takes precedence, i.e. including file -> first included file -> etc. Nested includes are permitted, but make sure to avoid circular imports. <br>For a multi-bar config, the `include` directive affects only current bar configuration object. |
|
||||
|
||||
### Multiple instances of a module
|
||||
If you want to have a second instance of a module, you can suffix it by a '#' and a custom name.
|
||||
|
||||
For example if you want a second battery module, you can add `"battery#bat2"` to your modules.
|
||||
|
||||
To configure the newly added module, you then also add a module configuration with the same name.
|
||||
|
||||
This could then look something like this _(this is an incomplete example)_:
|
||||
```js
|
||||
"modules-right": ["battery", "battery#bat2"],
|
||||
"battery": {
|
||||
"bat": "BAT1"
|
||||
},
|
||||
"battery#bat2": {
|
||||
"bat": "BAT2"
|
||||
}
|
||||
```
|
||||
|
||||
To style in `styles.css` use :
|
||||
```css
|
||||
battery.bat2 {
|
||||
border-bottom: 2px solid #FFFFFF;
|
||||
}
|
||||
```
|
||||
|
||||
## Styling
|
||||
Styling is done using the CSS file format and with a file named `style.css`.
|
||||
|
||||
Valid directories for this file are:
|
||||
- `~/.config/waybar/`
|
||||
- `~/waybar/`
|
||||
- `/etc/xdg/waybar/`
|
||||
|
||||
A good starting point is the [default style](https://github.com/Alexays/Waybar/blob/master/resources/style.css).
|
||||
|
||||
## Modules
|
||||
- [Battery](https://github.com/Alexays/Waybar/wiki/Module:-Battery)
|
||||
- [Bluetooth](https://github.com/Alexays/Waybar/wiki/Module:-Bluetooth)
|
||||
- [Clock](https://github.com/Alexays/Waybar/wiki/Module:-Clock)
|
||||
- [CPU](https://github.com/Alexays/Waybar/wiki/Module:-CPU)
|
||||
- [Custom](https://github.com/Alexays/Waybar/wiki/Module:-Custom)
|
||||
- [Disk](https://github.com/Alexays/Waybar/wiki/Module:-Disk)
|
||||
- [Group](https://github.com/Alexays/Waybar/wiki/Module:-Group)
|
||||
- [Hyprland](https://github.com/Alexays/Waybar/wiki/Module:-Hyprland)
|
||||
- [Image](https://github.com/Alexays/Waybar/wiki/Module:-Image)
|
||||
- [Memory](https://github.com/Alexays/Waybar/wiki/Module:-Memory)
|
||||
- [Network](https://github.com/Alexays/Waybar/wiki/Module:-Network)
|
||||
- [Temperature](https://github.com/Alexays/Waybar/wiki/Module:-Temperature)
|
||||
- [Taskbar](https://github.com/Alexays/Waybar/wiki/Module:-Taskbar)
|
||||
|
||||
[Screenshot]: data:image/avif;base64,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
|
||||
Loading…
Reference in a new issue