Activation¶

The recommended way to activate papersway is by using it as your bar command:

    bar {
        status_command papersway --i3status
        # [ .. further bar options .. ]
    }

This ensures that you can see a visual representation of your paper workspaces, which will be useful while getting the hang of papersway.

Binding keys¶

Here are some sample bindings to get you started.

    set $mod Mod4
    bindsym $mod+Left exec papersway-msg focus left
    bindsym $mod+Down focus down
    bindsym $mod+Up focus up
    bindsym $mod+Right exec papersway-msg focus right
    bindsym $mod+Shift+Left exec papersway-msg move left
    bindsym $mod+Shift+Down move down
    bindsym $mod+Shift+Up move up
    bindsym $mod+Shift+Right move exec papersway-msg right
    bindsym $mod+f exec papersway-msg monocle toggle
    bindsym $mod+o exec papersway-msg other column
    bindsym $mod+a exec papersway-msg fresh-workspace
    bindsym $mod+n exec papersway-msg fresh-workspace send
    bindsym $mod+t exec papersway-msg fresh-workspace take
    bindsym $mod+e exec papersway-msg absorb_expel left
    bindsym $mod+r exec papersway-msg absorb_expel right
    bindsym $mod+minus exec papersway-msg cols decr
    bindsym $mod+equal exec papersway-msg cols incr
    bindsym $mod+i exec papersway-msg workspace prev
    bindsym $mod+o exec papersway-msg workspace next
    bindsym $mod+Shift+i exec papersway-msg move_workspace prev
    bindsym $mod+Shift+i exec papersway-msg move_workspace next
    bindsym $mod+c [con_mark=caffeinated] inhibit_idle none; \
        inhibit_idle open, mark caffeinated
    bindsym $mod+Shift+c [con_mark=caffeinated] inhibit_idle none, \
        mark --toggle caffeinated
    for_window [con_mark=caffeinated] inhibit_idle open

Incompatibilities¶

The current implementation assumes the default configuration values for the focus_wrapping and workspace_layout configuration options, so remove any customisations you've made to those. You should also unbind the split (and splith etc.), layout, focus parent and focus child commands to avoid confusion (on the parts of both yourself and of papersway).