i3-wsman Goto Github PK

Create, reorder, group, and focus workspaces fast and easily in i3.

Enable Focus Mode: Use groups and focus mode to hide workspaces so you can focus.

Stay Focused, by limiting navigation to workspaces in the current focus mode.

Allow Important Distractions Through: Urgent workspaces will peek through, so you don't miss anything.

Multitask: Right-click to focus multiple groups at a time.

Quickly Group Workspaces: Middle-click to assign the current workspace to a group.

No More Looping: Creating a workspace is now as easy as going to the next workspace! Workspaces are created automatically.

Organize Workspaces: Reorder workspaces left and right to optimize workflow.

Create Adjacent Workspaces: Squeeze in a new workspace to the left or right, so you don't have to reorder!

• Assign workspaces to groups
• Select one or more groups to focus
  • Optional: Auto-focus on nearest workspace
• Multi-monitor support
  • Optional: Per-monitor groups and focus mode

• Reorder workspaces
• Create adjacent workspace
• Next/Prev Workspace
  • Optional: Create new, loop, or do nothing
• New workspaces inherit the group of the current workspace

• i3-wsman configuration
  • New Startup, Create, and Navigation options coming
• Polybar module formatting and styling

• Finish i3-wsman configuration
• Polybar formatting:
  • Last missing label styles: label-*-minlen, -maxlen, -ellipsis, -alignment
  • Add missing labels: label-separator, label-output-separator
• CLI Configurator for config and polybar styling
• Move window/container to next/prev workspace
• Move window/container to new workspace on the left/right
• Auto-assign new workspace based on application

• Polybar animations for actions (fade out workspaces, animation for swapping, etc...)
• New UI for assigning Workspace to Group
• Workspace Picker UI: Preview workspaces Expose-style
• Assign a workspace to multiple groups (maybe?)

This project is brand new. These steps will become easier and more automated soon. Star and watch this repo for updates!

1. Download the i3-wsman executable from the Releases Page
2. Place it somewhere in your PATH
3. Ensure that it is executable (chmod +x)

1. Clone this repo
2. Build the project with cargo build --release

Distro-specific packages will be coming soon. Star and watch this repo for updates!

• Install i3-wsm by placing it in your PATH

1. Copy examples/i3-wsman.toml to ~/.config/i3/i3-wsman.toml (CLI Configurator coming soon)
2. Update your ~/.config/i3/config
   • Be sure to add exec --no-startup-id "i3-wsman polybar watch"
3. Update your ~/.config/polybar/config.ini

# switch to workspace
bindsym $mod+1 exec --no-startup-id "i3-wsman goto 1"
bindsym $mod+2 exec --no-startup-id "i3-wsman goto 2"
bindsym $mod+3 exec --no-startup-id "i3-wsman goto 3"
bindsym $mod+4 exec --no-startup-id "i3-wsman goto 4"
bindsym $mod+5 exec --no-startup-id "i3-wsman goto 5"
bindsym $mod+6 exec --no-startup-id "i3-wsman goto 6"
bindsym $mod+7 exec --no-startup-id "i3-wsman goto 7"
bindsym $mod+8 exec --no-startup-id "i3-wsman goto 8"
bindsym $mod+9 exec --no-startup-id "i3-wsman goto 9"
bindsym $mod+0 exec --no-startup-id "i3-wsman goto 10"

# Left/Right Navigation
# Ctrl + Super + Left/Right
bindsym $mod+Ctrl+Left exec --no-startup-id "i3-wsman prev create group nogroup output"
bindsym $mod+Ctrl+Right exec --no-startup-id "i3-wsman next create group nogroup output"

# Reorder Workspace
# Ctrl + Super + Shift + Left/Right
bindsym $mod+Ctrl+Shift+Left exec --no-startup-id "i3-wsman reorder left"
bindsym $mod+Ctrl+Shift+Right exec --no-startup-id "i3-wsman reorder right"

# Create adjacent workspace
# Ctrl + Alt + Super + Left/Right
bindsym $mod+Ctrl+Mod1+Left exec --no-startup-id "i3-wsman adjacent left"
bindsym $mod+Ctrl+Mod1+Right exec --no-startup-id "i3-wsman adjacent right"

# Assign workspace to group
# Super + Shift + g
bindsym $mod+Shift+g exec --no-startup-id i3-input -F 'exec --no-startup-id "i3-wsman group assign %s"' -P 'Group: '

# Rename workspace
# Super + Shift + n
bindsym $mod+Shift+n exec --no-startup-id i3-input -F 'exec --no-startup-id "i3-wsman rename %s"' -P 'Workspace Name: '

# Start the i3-wsman watcher
exec --no-startup-id "i3-wsman polybar watch"

[bar/my-bar]
; Must enable ipc!
enable-ipc = true
; ...
modules-left = i3wsm-groups i3wsm-workspaces i3wsm-toggle-hidden

[module/i3wsm-groups]
type = custom/ipc
hook-0 = i3-wsman polybar module-groups
initial = 1
format = <label>
format-font = 3

[module/i3wsm-toggle-hidden]
type = custom/ipc
hook-0 = i3-wsman polybar module-toggle-hidden
initial = 1
format = <label>
format-font = 3

[module/i3wsm-workspaces]
type = custom/ipc
hook-0 = i3-wsman polybar module-workspaces
initial = 1
format = <label>
format-font = 3