cleanup and comments

conf.d/bar.conf

@@ -1,3 +1,4 @@
+# i3bar config
 bar {
     mode dock
     status_command ~/.local/bin/py3status

conf.d/key_bindings.conf

@@ -1,6 +1,5 @@
 # Keybindings
 # Note, this is for more of a "global" keybindings.  Modes will have their own mode_whatever.conf keybinding
-bindsym $mod+o exec --no-startup-id rofi -show rofi-sound -modi "rofi-sound:~/.local/bin/rofi-sound-output-chooser"
 
 bindsym $mod+Return exec kitty
 
@@ -16,24 +15,36 @@ bindsym XF86AudioLowerVolume exec --no-startup-id pactl set-sink-volume @DEFAULT
 bindsym XF86AudioMute exec --no-startup-id pactl set-sink-mute @DEFAULT_SINK@ toggle && $refresh_i3status
 bindsym XF86AudioMicMute exec --no-startup-id pactl set-source-mute @DEFAULT_SOURCE@ toggle && $refresh_i3status
 
+# display clipboard contents via rofi
 bindsym Control+$alt+h exec rofi -modi "clipboard:greenclip print" -show clipboard -run-command '{cmd}'
 
+# kill active window
 bindsym $mod+q kill
+# reload i3 config
+bindsym $mod+Shift+c reload
+# restart i3
+bindsym $mod+Shift+r restart
+# quit i3
+bindsym $mod+Shift+e exec "i3-nagbar -t warning -m 'You pressed the exit shortcut. Do you really want to exit i3? This will end your X session.' -B 'Yes, exit i3' 'i3-msg exit'"
 
 bindsym $mod+b bar mode hide
 bindsym $mod+Shift+b bar mode dock
 
+# change window focus, vim binding
 bindsym $mod+h focus left
 bindsym $mod+j focus down
 bindsym $mod+k focus up
 bindsym $mod+l focus right
+# change window focus, arrows
 bindsym $mod+Left focus left
 bindsym $mod+Right focus right
 
+# move active window, vim binding
 bindsym $mod+Shift+h move left
 bindsym $mod+Shift+j move down
 bindsym $mod+Shift+k move up
 bindsym $mod+Shift+l move right
+# move active window, arrows
 bindsym $mod+Shift+Left move left
 bindsym $mod+Shift+Down move down
 bindsym $mod+Shift+Up move up
@@ -47,10 +58,12 @@ bindsym $mod+Shift+space floating toggle
 bindsym $mod+space focus mode_toggle
 bindsym $mod+a focus parent
 
+# bind up and down arrows to volume script
 bindsym $mod+Up exec "~/bin/volume.sh up"
 bindsym $mod+Down exec "~/bin/volume.sh down"
 bindsym $mod+backslash exec "~/bin/volume.sh mtoggle"
 
+# $mod 0-9 to change workspace
 bindsym $mod+1 workspace number $ws1
 bindsym $mod+2 workspace number $ws2
 bindsym $mod+3 workspace number $ws3
@@ -62,6 +75,7 @@ bindsym $mod+8 workspace number $ws8
 bindsym $mod+9 workspace number $ws9
 bindsym $mod+0 workspace number $ws10
 
+# move active containers to workspace number
 bindsym $mod+Shift+1 move container to workspace number $ws1
 bindsym $mod+Shift+2 move container to workspace number $ws2
 bindsym $mod+Shift+3 move container to workspace number $ws3
@@ -72,6 +86,3 @@ bindsym $mod+Shift+7 move container to workspace number $ws7
 bindsym $mod+Shift+8 move container to workspace number $ws8
 bindsym $mod+Shift+9 move container to workspace number $ws9
 bindsym $mod+Shift+0 move container to workspace number $ws10
-bindsym $mod+Shift+c reload
-bindsym $mod+Shift+r restart
-bindsym $mod+Shift+e exec "i3-nagbar -t warning -m 'You pressed the exit shortcut. Do you really want to exit i3? This will end your X session.' -B 'Yes, exit i3' 'i3-msg exit'"

conf.d/mode_audio.conf

@@ -1,4 +1,7 @@
+# switch to audio mode
 bindsym $mod+m mode "audio"
+# output chooser, outside of mode
+bindsym $mod+o exec --no-startup-id rofi -show rofi-sound -modi "rofi-sound:~/.local/bin/rofi-sound-output-chooser"
 mode "audio" {
     bindsym m exec "~/bin/volume.sh mute"
     bindsym j exec "~/bin/volume.sh down"

conf.d/mode_resize.conf

@@ -1,3 +1,4 @@
+# window resizing mode
 bindsym $mod+r mode "resize"
 mode "resize" {
         # These bindings trigger as soon as you enter the resize mode