Configuration

#+STARTUP: showall

#+TAGS: TOC(t)

• Table of contents :TOC_2_gh:

• [[#configuration-files][Configuration files]]
• [[#keybindings][Keybindings]]
  • [[#prefix--modes][Prefix & Modes]]
  • [[#allocation][Allocation]]
  • [[#coherence][Coherence]]
• [[#features][Features]]
  • [[#the-classics][The classics]]
  • [[#vifm][Vifm]]
  • [[#tig][Tig]]
  • [[#kitty][Kitty]]
  • [[#bspwm][Bspwm]]
  • [[#i3-wm][I3 wm]]
• [[#warning][Warning]]

• Configuration files

Content :

• a coherent set of configuration files for my favorite apps.
• little autoloaded functions for vim & neovim

• Keybindings

The keybindings are essentially vim, less or emacs like, depending on the context. For example :

• Vim
  • Neomutt index
• Less
  • Elinks
  • W3m
  • Neomutt pager
  • Newsboat
• Emacs
  • Zsh
  • Elinks edit mode

** Prefix & Modes

Some applications :

• Can use an independant keymap introduced by a prefix key
  • tmux
• Can chain keys
  • sxhkd
• Can use independant keymap modes
  • i3, tmux, emacs, vim

** Allocation

*** Window Manager

The following keys are reserved for Window Manager (i3, bspwm, ...) :

• Hyper (Mod3, I bind it to the Menu key) with any key(s)
• Super (Mod4) with
  • Arrows
  • Page Up / Down
  • Home / End
  • Tab, Backspace
  • F1 .. F12
• Super (Mod4) with any modifier(s) and same keys as above
• Super with Control and
  • Any key(s)
• Super with Shift and
  • Any key(s)
• Prefix chosen among the previous keys
• Sub mode entered with one or more of the previous keys

*** Applications

The following keys are reserved for applications :

• Super with all other keys
  • Letters
  • Digits
  • Insert, Delete, Space, Return
  • & @ ^ $ ! ( ) [ ] { } < > ...
• Prefix chosen among the previous keys
• Sub mode entered with one or more of the previous keys

** Coherence

To be as intuitive as possible, some conventions are applied :

• Move focus between desktops :
  • Hyper + page up / page down
• Move focus between X windows :
  • Super + arrows
  • Super + prior (page up) / next (page down)
• Move focus between tmux panes & vim :
  • Control + arrows
  • Also in emacs
• In tab oriented applications, move focus between tabs
  • Ctrl + page up / down
  • In pager context : ^ and $
    • w3m, elinks, vifm, ...
• Move in history
  • In pager context
    • Backspace = back
    • Shift-Backspace = forward
    • H = back
    • L = forward
  • In REPL context
    • Up, M-p = back, with typed text as filter
    • Down, M-n = forward, with typed text as filter
• Filters
  • &, é, è
• Most Recently Used
  • ù
• Tree / Structure exploration
  • §

• Features

Comments on applications.

** The classics

• Vim & family : Neovim, Kakoune
• Emacs with Org mode and torus.el
• Zsh
• Tmux

** Vifm

• Deep analogy with Vim keys
• Views
  • Dual-pane, vertical or horizontal
  • Tree view (like the tree command)
  • Grid view (ls view)
  • Miller view with 3 panes, like ranger
  • Preview mode
    • Also of images with [[https://github.com/cirala/vifmimg][Vifmimg]] & [[https://github.com/seebye/ueberzug][Ueberzug]]
• Mount
  • Archives with archivemount
    • Handy to quickly edit a file in it
  • Iso images with fuseiso
  • Ssh file systems with sshfs
  • Ftp file systems with curlftpfs
    • And you have a great ftp client
• Can launch background programs
  • You can cancel them in :jobs view
• Cope well with external programs
  • User commands :... and :!...
• Tools to select and modify selection

** Tig

• Feature rich git repo browser
• Views
  • Commits
  • Diffs
  • Log
  • Tree
• Cope well with external programs
  • User commands :... and :!...

** Kitty

• Fast
• Scriptable, you can also open a Kitty shell to control the term
• Support keyboard shortcuts with super key
• Scrollback in pager
• Insert UTF-8 character with completion
• Good image support
• Quickly select url / file / line
• Plugins (kittens)
• Can be used as dropdown with kitti3 on i3

And much more

** Herbstluftwm

• Scriptable via herbstclient
  • You can litteraly juggle with windows
• Modes
  • Tiling and floating
  • Monocle or tabs mode : only one window visible
  • Full screen
• Automatic properties of windows : workspace, floating, ...
• Multi monitors support
• Keybindings
  • Managed by herbstluftwm and sxhkd
  • Support of Super and Hyper keys
  • Keybinding chains with sxhkd
• Panels (bars) : polybar
  • Custom scripts
  • IPC, polybar-msg to send commands, hooks
  • Good choice of internal modules
  • Menu

** Bspwm

• Scriptable via bspc
  • You can litteraly juggle with windows
  • Configurable split ratio
  • Possibility to circulate windows clockwise or counterclockwise
• Modes
  • Tiling and floating
  • Monocle mode : only one window visible
  • Full screen
• Automatic properties of windows : workspace, floating, ...
• Multi monitors support
• Keybindings
  • Managed by sxhkd
  • Support of Super and Hyper keys
  • Keybinding chains
• Panels (bars) : polybar
  • Custom scripts
  • IPC, polybar-msg to send commands, hooks
  • Good choice of internal modules
  • Menu
• Dynamic layouts with bsp-layout (in AUR)

** I3 wm

• Tiling, tabbed, staking and floating modes
  • Tiling means all screen space is available for apps
  • Good support for floating window, so you can use it as an hybrid WM if you want
• Dynamic workspaces
• Support of Super and Hyper keys in bindings
• You can define keybinding modes
• Automatic properties of windows : workspace, floating, size, ...
• Scriptable via i3-msg
• You can add rofi scripts, or any script to the panel (called bar) via i3block ; see also i3status for information
• Multi monitors support

• Warning

I try to be mindful when I code, but some bugs might remain, so be careful.