Skip to content

Commit

Permalink
make ws11+ docs more brief
Browse files Browse the repository at this point in the history
  • Loading branch information
end-4 committed Feb 24, 2024
1 parent 4545743 commit 3de3340
Showing 1 changed file with 13 additions and 14 deletions.
27 changes: 13 additions & 14 deletions src/content/docs/en/i-i/02.usage.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,29 +47,28 @@ Workspace Grouping introduces a flexible system that allows for an unlimited num

- **Scalable Workspaces**: Go beyond the 10-workspace limit without cluttering workspace bar or overview widget. Create as many workspaces as needed without compromising organization.
- **Workspace Groups**: Workspaces are automatically divided into groups of 10 (e.g., 1-10, 11-20, 21-30). The active workspace determines the visible group in the bar.
- **Focused Navigation**: The workspace bar dynamically updates to reflect the currently active group. A single dot '•' decoration highlights the active workspace within the group for clarity.
- **Enhanced Overview**: The overview widget (`SUPER`) mirrors the workspace-grouping concept, only the workspaces in active groups are shown.
- **Keybind Support**: Hyprland keybinds adapt seamlessly to this feature.
- Pressing `Super` + `3` moves you to workspace 3 if your current workspace is 1-10, or workspace 13 if your current workspace is 11-20.
- **Keybind Support**: Hyprland keybinds are configured to seamlessly adapt to this feature
- Pressing `Super` + `3` moves you to workspace 3 if your current workspace is 1-10, or workspace 13 if your current workspace is 11-20

## Benefits

- **Multitasking Mastery**: Effortlessly switch between different tasks or projects by dedicating workspace groups to specific contexts.
- **Decluttered Environment**: Maintain a clean and organized desktop experience, even with a high number of workspaces.
- **Multi-Monitor Power**: Create monitor-specific workspace groups for an [awesome-wm](https://awesomewm.org/) inspired workflow.
- **Multitasking Mastery**: Effortlessly switch between different tasks or projects by dedicating workspace groups to specific contexts
- **Decluttered Environment**: Maintain a clean and organized desktop experience, even with a high number of workspaces
- **Multi-Monitor Power**: Create monitor-specific workspace groups for an [awesome-wm](https://awesomewm.org/)-inspired workflow
- E.g. 1-10 in monitor-1, 11-20 in monitor-2, 21-30 in monitors-3, and so on.

## Navigation & Workspace Management

- **Navigating / moving workspaces within a group**: Standard Hyprland keybinds apply.
- `Super` + `2` navigates to workspace 2 if the current workspace is within 1-10 (group 1).
- `Super` + `2` navigates to workspace 12 if the current workspace is within 11-20 (group 2).
- `Super` + `Alt` + `3` silently moves the focused window to workspace 3 if the current workspace is within 1-10 (group 1).
- `Super` + `Alt` + `3` silently moves the focused window to workspace 13 if the current workspace is within 11-20 (group 2).
- `Super` + `2` → workspace **2** if you're in workspace **1-10 (group 1)**.
- `Super` + `2` → workspace **12** if you're in workspace **11-20 (group 2)**.
- `Super` + `Alt` + `3` silently moves focused window → workspace **3** if you're in workspace **1-10 (group 1)**.
- `Super` + `Alt` + `3` silently moves focused window → workspace **13** if you're in workspace **11-20 (group 2)**.

- **Navigating between groups**:
- Spawn a new workspace in the next group by navigating beyond the last workspace of the current group. E.g., Press `Super` + `0` to move to workspace 10, and then press `Control` + `Super` + `Right` to move to the next workspace, i.e. 11 in the next group.
- Alternatively, you can scroll with the cursor over workspace bar to quickly navigate to the next group.
- Consider adding following Hyprland keybinds for direct group jumps.
- Consider adding following Hyprland keybinds for jumping to adjacent workspace groups
```ini title="~/.config/hypr/hyprland/keybinds.conf"
bind = SUPER ALT, Z, workspace, r-10
bind = SUPER ALT, X, workspace, r+10
Expand All @@ -83,7 +82,7 @@ If you wish to modify the keybinds or include [more features](https://wiki.hyprl

Consider these strategies for effective multi-monitor management:
- Allot group 1 (workspaces 1-10) to primary monitor while group 2 (workspaces 11-20) to secondary monitor.
- On startup, manually move the starting workspace on the secondary monitor into the second group (e.g., workspace 11) using `Super` + `0`, then `Control` + `Super` + `Right`.
- On startup, manually move the starting workspace on the secondary monitor into the second group (e.g., workspace 11) using `Super` + `0`, then `Ctrl` + `Super` + `Right`.
- In effect, this will also create separate overview widget per monitor.
- Use [workspace binding](https://wiki.hyprland.org/Configuring/Workspace-Rules/#rules) to always place specific workspaces on specific monitors. Get all your monitor names using `hyprctl monitors | grep Monitor`.
```ini title="~/.config/hypr/hyprland.conf"
Expand All @@ -106,7 +105,7 @@ Consider these strategies for effective multi-monitor management:
- Focus on two workspaces at a time on each monitor and move/swap windows across monitor/groups (using `Super` + `Left/Right/Up/Down` or `Super` + `Shift` + `Left/Right/Up/Down`) as needed.

:::note
Workspace groups is not natively supported in Hyprland, AGS or any status bar programs like Waybar/Polybar. This setup tries to achieve this by simply tinkering wth Hyprland dispatcher and few custom AGS modules. If you feel certain elements would benefit from further refinement, feel free to open a discussion or submit a PR.
Workspace groups is not natively supported in Hyprland, AGS or any status bar programs like Waybar/Polybar. This config tries to achieve this by simply tinkering wth Hyprland dispatcher and few custom AGS modules. If you feel certain elements would benefit from further refinement, feel free to open a discussion or submit a PR.
:::


Expand Down

0 comments on commit 3de3340

Please sign in to comment.