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

Features

Focus Mode: Eliminate Distractions

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.

Organize and Create Workspaces

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!

Current Features

Focus Mode

• 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

Create and Navigate

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

Configuration

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

Coming Soon

• 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

Future Roadmap

• 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?)

Getting Started

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

Step 1. Download or Build

Download from Releases Page

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)

OR, Build from Source

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

Step 2. Install

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

• Install i3-wsm by placing it in your PATH

Step 3. Configure

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

Click to see an example i3/config

# 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"

Click to see an example polybar/config.ini

[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