hyprwm/hyprland-wiki
1
0
Fork 0
mirror of https://github.com/hyprwm/hyprland-wiki.git synced 2024-11-22 20:55:59 +01:00
Code Issues Projects Releases Packages Wiki Activity

fixup! {Configurating, IPC}: Revert back old tab styling

Browse source
This commit is contained in:
Antonino Scordino 2022-10-20 21:50:41 +02:00
parent 66c82c8699
commit 7ded1ebc9e
No known key found for this signature in database
GPG key ID: F20FDE4C896FC2CB
4 changed files with 172 additions and 162 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

25
pages/Configuring/Master-Layout.md
View file

@ -17,23 +17,26 @@ However, you can resize the master window.
_category name `master`_ _category name `master`_
| name | description | type | default | | name | description | type | default |
| -------------------- | ------------------------------------------------------------------------------------ | ----- | ------- | |---|---|---|---|---|
| special_scale_factor | (0.0 - 1.0) the scale of the special workspace windows | float | 0.8 | | pseudotile | enable pseudotiling. Pseudotiled windows retain their floating size when tiled. | bool | false |
| new_is_master | whether a newly open window should replace the master or join the slaves. | bool | false | | col.group_border | inactive (out of focus) group border color | color | 0x66777700 |
| new_on_top | whether a newly open window should be on the top of the stack | bool | false | | col.group_border_active | active group border color | color | 0x66ffff00 |
| force_split | 0 -> split follows mouse, 1 -> always split to the left (new = left or top) 2 -> always split to the right (new = right or bottom) | int | 0 |
| preserve_split | if enabled, the split (side/top) will not change regardless of what happens to the container. | bool | false |
| special_scale_factor | 0 - 1 -> specifies the scale factor of windows on the special workspace | float | 0.8 |
| split_width_multiplier | specifies the auto-split width multiplier | float | 1.0 |
| no_gaps_when_only | whether to apply gaps when there is only one window on a workspace, aka. smart gaps. | bool | false | | no_gaps_when_only | whether to apply gaps when there is only one window on a workspace, aka. smart gaps. | bool | false |
| use_active_for_splits | whether to prefer the active window or the mouse position for splits | bool | true |
## Dispatchers ## Dispatchers
`layoutmsg` params: `layoutmsg` params:
| param | description | | dispatcher | description | params |
| -------------- | ----------------------------------------------------------------------- | |---|---|---|
| swapwithmaster | swaps the current window with master | | togglegroup | toggles the current window and its siblings (recursively) into a group | none |
| cyclenext | focuses the next window respecting the layout | | changegroupactive | switches to the next window in a group. | b - back, f - forward. |
| cycleprev | focuses the previous window respecting the layout | | togglesplit | toggles the split (top/side) of the current window | none |
| swapnext | swaps the focused window with the next window respecting the layout |
| swapprev | swaps the focused window with the previous window respecting the layout |
{{< hint type=info >}} {{< hint type=info >}}
example usage: example usage:

38
pages/Configuring/Variables.md
View file

@ -9,7 +9,7 @@ the layout pages and not here. (See the Sidebar for Dwindle and Master layouts)
## Variable types ## Variable types
| type | description | | type | description |
| ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |---|---|
| int | integer | | int | integer |
| bool | boolean, `true` or `false` (`yes` or `no`, `0` or `1`) - any numerical value that is not `0` or `1` will cause undefined behaviour. | | bool | boolean, `true` or `false` (`yes` or `no`, `0` or `1`) - any numerical value that is not `0` or `1` will cause undefined behaviour. |
| float | floating point number | | float | floating point number |
@ -43,7 +43,7 @@ SHIFT CAPS CTRL/CONTROL ALT MOD2 MOD3 SUPER/WIN/LOGO/MOD4 MOD5
### General ### General
| name | description | type | default | | name | description | type | default |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | ---------- | |---|---|---|---|---|
| sensitivity | mouse sensitivity (legacy, may cause bugs if not 1, prefer `input:sensitivity`) | float | 1.0 | | sensitivity | mouse sensitivity (legacy, may cause bugs if not 1, prefer `input:sensitivity`) | float | 1.0 |
| border_size | self-explanatory | int | 1 | | border_size | self-explanatory | int | 1 |
| no_border_on_floating | disable borders for floating windows | bool | false | | no_border_on_floating | disable borders for floating windows | bool | false |
@ -55,7 +55,7 @@ SHIFT CAPS CTRL/CONTROL ALT MOD2 MOD3 SUPER/WIN/LOGO/MOD4 MOD5
| damage_tracking | Makes the compositor redraw only the needed bits of the display. Saves on resources by not redrawing when not needed. Available modes: `none, monitor, full`. You don't need to know what different modes do, just always use `full`. | str | full | | damage_tracking | Makes the compositor redraw only the needed bits of the display. Saves on resources by not redrawing when not needed. Available modes: `none, monitor, full`. You don't need to know what different modes do, just always use `full`. | str | full |
| layout | which layout to use. (Available: `dwindle`, `master`) | str | dwindle | | layout | which layout to use. (Available: `dwindle`, `master`) | str | dwindle |
| no_cursor_warps | if true, will not warp the cursor in many cases (focusing, keybinds, etc) | bool | false | | no_cursor_warps | if true, will not warp the cursor in many cases (focusing, keybinds, etc) | bool | false |
| apply_sens_to_raw | if on, will also apply the sensitivity to raw mouse output (e.g. sensitivity in games) **NOTICE:** **_really_** not recommended. | bool | false | | apply_sens_to_raw | if on, will also apply the sensitivity to raw mouse output (e.g. sensitivity in games) **NOTICE:** ***really*** not recommended. | bool | false |
{{< hint type=warning >}} {{< hint type=warning >}}
Prefer using `input:sensitivity` over `general:sensitivity` to avoid bugs, especially with Wine/Proton apps. Prefer using `input:sensitivity` over `general:sensitivity` to avoid bugs, especially with Wine/Proton apps.
@ -64,7 +64,7 @@ Prefer using `input:sensitivity` over `general:sensitivity` to avoid bugs, espec
### Decoration ### Decoration
| name | description | type | default | | name | description | type | default |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----- | ---------- | |---|---|---|---|---|
| rounding | rounded corners' radius (in layout px) | int | 0 | | rounding | rounded corners' radius (in layout px) | int | 0 |
| multisample_edges | enable antialiasing (no-jaggies) for rounded corners | bool | true | | multisample_edges | enable antialiasing (no-jaggies) for rounded corners | bool | true |
| active_opacity | self-explanatory, only for windows. (0.0 - 1.0) | float | 1.0 | | active_opacity | self-explanatory, only for windows. (0.0 - 1.0) | float | 1.0 |
@ -116,8 +116,10 @@ _[More about Animations](../Animations)._
### Input ### Input
## Input
| name | description | type | default | | name | description | type | default |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ----- | --------- | |---|---|---|---|---|
| kb_layout | Appropriate XKB keymap parameter | str | us | | kb_layout | Appropriate XKB keymap parameter | str | us |
| kb_variant | Appropriate XKB keymap parameter | str | \[EMPTY\] | | kb_variant | Appropriate XKB keymap parameter | str | \[EMPTY\] |
| kb_model | Appropriate XKB keymap parameter | str | \[EMPTY\] | | kb_model | Appropriate XKB keymap parameter | str | \[EMPTY\] |
@ -133,8 +135,9 @@ _[More about Animations](../Animations)._
| force_no_accel | force no mouse acceleration, bypasses most of your pointer settings to get as raw of a signal as possible. | bool | false | | force_no_accel | force no mouse acceleration, bypasses most of your pointer settings to get as raw of a signal as possible. | bool | false |
| sensitivity | set the libinput sensitivity. This **HAS** to be from -1 to 1, or else it will be clamped. | float | 0.0 | | sensitivity | set the libinput sensitivity. This **HAS** to be from -1 to 1, or else it will be clamped. | float | 0.0 |
| left_handed | switches RMB and LMB | bool | false | | left_handed | switches RMB and LMB | bool | false |
| accel_profile | set the libinput acceleration profile. Can be one of `adaptive`, `flat`. | str | \[EMPTY\] | | accel_profile | set the libinput acceleration profile. Can be one of `adaptive`, `flat`. | str | \[EMPTY\]
| scroll_method | set the libinput scroll method. Can be one of `2fg` (2 fingers), `edge`, `on_button_down`, `no_scroll`. | str | \[EMPTY\] | | scroll_method | set the libinput scroll method. Can be one of `2fg` (2 fingers), `edge`, `on_button_down`, `no_scroll`. | str | \[EMPTY\]
{{< hint type=info >}} {{< hint type=info >}}
@ -156,14 +159,14 @@ For switchable keyboard configs, take a look at [the uncommon tips & tricks page
_Subcategory `input:touchpad:`_ _Subcategory `input:touchpad:`_
| name | description | type | default | | name | description | type | default |
| ----------------------- | ------------------------------------ | ----- | ------- | |---|---|---|---|---|
| disable_while_typing | disables the touchpad while typing | bool | true | | disable_while_typing | disables the touchpad while typing | bool | true |
| natural_scroll | self-explanatory | bool | false | | natural_scroll | self-explanatory | bool | false |
| clickfinger_behavior | self-explanatory | bool | false | | clickfinger_behavior | self-explanatory | bool | false |
| middle_button_emulation | self-explanatory | bool | false | | middle_button_emulation | self-explanatory | bool | false |
| tap-to-click | self-explanatory | bool | true | | tap-to-click | self-explanatory | bool | true |
| drag_lock | enable dragging with drag lock | bool | false | | drag_lock | enable dragging with drag lock | bool | false |
| scroll_factor | control the amount of scroll applied | float | 1.0 | | scroll_factor | control the amount of scroll applied | float | 1.0
{{< hint type=important >}} {{< hint type=important >}}
A subcategory is a nested category: A subcategory is a nested category:
@ -188,7 +191,7 @@ Doing `input:touchpad {` is **invalid**!
_Subcategory `input:touchdevice:`_ _Subcategory `input:touchdevice:`_
| name | description | type | default | | name | description | type | default |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------ | --------- | |---|---|---|---|---|
| transform | transform the input from touchdevices. The possible transformations are the same as [those of the monitors](../Monitors/#rotating-and-the-default-workspace) | int | 0 | | transform | transform the input from touchdevices. The possible transformations are the same as [those of the monitors](../Monitors/#rotating-and-the-default-workspace) | int | 0 |
| output | the output to bind touch devices. Empty means unset and will use the current / autodetected. | string | \[EMPTY\] | | output | the output to bind touch devices. Empty means unset and will use the current / autodetected. | string | \[EMPTY\] |
@ -199,18 +202,19 @@ Described [here](../Keywords#per-device-input-configs).
## Gestures ## Gestures
| name | description | type | default | | name | description | type | default |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ----- | ------- | |---|---|---|---|---|
| workspace_swipe | enable workspace swipe gesture | bool | false | | workspace_swipe | enable workspace swipe gesture | bool | false |
| workspace_swipe_fingers | how many fingers for the gesture | int | 3 | | workspace_swipe_fingers | how many fingers for the gesture | int | 3 |
| workspace_swipe_distance | in px, the distance of the gesture | int | 300 | | workspace_swipe_distance | in px, the distance of the gesture | int | 300 |
| workspace_swipe_invert | invert the direction | bool | true | | workspace_swipe_invert | invert the direction | bool | true |
| workspace_swipe_min_speed_to_force | minimum speed in px per timepoint to force the change ignoring `cancel_ratio`. Setting to `0` will disable this mechanic. | int | 30 | | workspace_swipe_min_speed_to_force | minimum speed in px per timepoint to force the change ignoring `cancel_ratio`. Setting to `0` will disable this mechanic. | int | 30 |
| workspace_swipe_cancel_ratio | (0.0 - 1.0) how much the swipe has to proceed in order to commence it. (0.7 -> if > 0.7 \* distance, switch, if less, revert) | float | 0.5 | | workspace_swipe_cancel_ratio | (0.0 - 1.0) how much the swipe has to proceed in order to commence it. (0.7 -> if > 0.7 * distance, switch, if less, revert) | float | 0.5 |
| workspace_swipe_create_new | whether a swipe right on the last workspace should create a new one. | bool | true |
## Misc ## Misc
| name | description | type | default | | name | description | type | default |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---- | --------- | |---|---|---|---|---|
| disable_hyprland_logo | disables the hyprland logo background. :( | bool | false | | disable_hyprland_logo | disables the hyprland logo background. :( | bool | false |
| disable_splash_rendering | disables the hyprland splash rendering. (requires a monitor reload to take effect) | bool | false | | disable_splash_rendering | disables the hyprland splash rendering. (requires a monitor reload to take effect) | bool | false |
| no_vfr | disables VFR (variable frame rate) - VFR increases battery life at the expense of possible issues on a few monitors. | bool | true | | no_vfr | disables VFR (variable frame rate) - VFR increases battery life at the expense of possible issues on a few monitors. | bool | true |
@ -221,15 +225,15 @@ Described [here](../Keywords#per-device-input-configs).
| animate_manual_resizes | If true, will animate manual window resizes/moves | bool | false | | animate_manual_resizes | If true, will animate manual window resizes/moves | bool | false |
| disable_autoreload | If true, the config will not reload automatically on save, and instead needs to be reloaded with `hyprctl reload`. Might save on battery. | bool | false | | disable_autoreload | If true, the config will not reload automatically on save, and instead needs to be reloaded with `hyprctl reload`. Might save on battery. | bool | false |
| enable_swallow | Enable window swallowing | bool | false | | enable_swallow | Enable window swallowing | bool | false |
| swallow_regex | The _class_ regex to be used for windows that should be swallowed (usually, a terminal) | str | \[EMPTY\] | | swallow_regex | The *class* regex to be used for windows that should be swallowed (usually, a terminal) | str | \[EMPTY\] |
## Binds ## Binds
| name | description | type | default | | name | description | type | default |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---- | ------- | |---|---|---|---|---|
| pass_mouse_when_bound | if disabled, will not pass the mouse events to apps / dragging windows around if a keybind has been triggered. | bool | false | | pass_mouse_when_bound | if disabled, will not pass the mouse events to apps / dragging windows around if a keybind has been triggered. | bool | false |
| scroll_event_delay | in ms, how many ms to wait after a scroll event to allow to pass another one for the binds. | int | 300 | | scroll_event_delay | in ms, how many ms to wait after a scroll event to allow to pass another one for the binds. | int | 300 |
| workspace_back_and_forth | If enabled, an attempt to switch to the currently focused workspace will instead switch to the previous workspace. Akin to i3's _auto_back_and_forth_. | bool | false | | workspace_back_and_forth | If enabled, an attempt to switch to the currently focused workspace will instead switch to the previous workspace. Akin to i3's *auto_back_and_forth*. | bool | false |
| allow_workspace_cycles | If enabled, workspaces don't forget their previous workspace, so cycles can be created by switching to the first workspace in a sequence, then endlessly going to the previous workspace. | bool | false | | allow_workspace_cycles | If enabled, workspaces don't forget their previous workspace, so cycles can be created by switching to the first workspace in a sequence, then endlessly going to the previous workspace. | bool | false |
## Debug ## Debug
@ -241,7 +245,7 @@ Only for developers.
{{< /hint >}} {{< /hint >}}
| name | description | type | default | | name | description | type | default |
| ------------ | ---------------------------------------------------------------------- | ---- | ------- | |---|---|---|---|---|
| overlay | print the debug performance overlay. Disable VFR for accurate results. | bool | false | | overlay | print the debug performance overlay. Disable VFR for accurate results. | bool | false |
| damage_blink | (epilepsy warning!) flash areas updated with damage tracking | bool | false | | damage_blink | (epilepsy warning!) flash areas updated with damage tracking | bool | false |
| disable_logs | self-explanatory | bool | false | | disable_logs | self-explanatory | bool | false |

7
pages/Configuring/Window-Rules.md
View file

@ -58,8 +58,9 @@ you can use `hyprctl clients`.
## Rules ## Rules
=======
| Rule | Description | | Rule | Description |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ---- | ----------- |
| float | floats a window | | float | floats a window |
| tile | tiles a window | | tile | tiles a window |
| fullscreen | fullscreens a window | | fullscreen | fullscreens a window |
@ -77,8 +78,10 @@ you can use `hyprctl clients`.
| rounding \[x\] | forces the application to have X pixels of rounding, ignoring the set default (in `decoration:rounding`). Has to be an int. | | rounding \[x\] | forces the application to have X pixels of rounding, ignoring the set default (in `decoration:rounding`). Has to be an int. |
| noblur | disables blur for the window | | noblur | disables blur for the window |
| nofocus | disables focus to the window | | nofocus | disables focus to the window |
| noborder | disables borders for the window |
| noshadow | disables shadows for the window |
| forceinput | forces an XWayland window to receive input, even if it requests not to do so. (Might fix issues like e.g. Game Launchers not receiving focus for some reason) | | forceinput | forces an XWayland window to receive input, even if it requests not to do so. (Might fix issues like e.g. Game Launchers not receiving focus for some reason) |
| pin | pins the window _note: floating only_ | | pin | pins the window *note: floating only* |
| noanim | disables the animations for the window | | noanim | disables the animations for the window |
### Example Rules ### Example Rules

2
pages/IPC/_index.md
View file

@ -27,7 +27,7 @@ e.g.: `workspace>>2`
### Events list ### Events list
| name | description | data | | name | description | data |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | | --- | --- | --- |
| workspace | emitted on workspace change. Is emitted ONLY when a user requests a workspace change, and is not emitted on mouse movements (see `activemon`) | `WORKSPACENAME` | | workspace | emitted on workspace change. Is emitted ONLY when a user requests a workspace change, and is not emitted on mouse movements (see `activemon`) | `WORKSPACENAME` |
| focusedmon | emitted on the active monitor being changed. | `MONNAME,WORKSPACENAME` | | focusedmon | emitted on the active monitor being changed. | `MONNAME,WORKSPACENAME` |
| activewindow | emitted on the active window being changed. | `WINDOWCLASS,WINDOWTITLE` | | activewindow | emitted on the active window being changed. | `WINDOWCLASS,WINDOWTITLE` |