Vim-like pager with keyboard selection

New mailing list added

10 months ago

71d0d01 readme: add support me section

~geb pushed to ~geb/hjkl git

1 year, 7 months ago


hjkl is a vim-like pager with keyboard-based text selection. You can use it as a "scrollback pager" to select text on your terminal's buffer without a mouse.

#Install From Source


  • go (>=1.19)
  • scdoc
  • xclip if you're on X11 or wl-clipboard if you're on Wayland.


$ sudo ./install.sh


See the manpage.

#Using hjkl as a Scrollback Pager

Using hjkl to select text on your terminal's buffer requires a terminal emulator that lets you pipe the buffer to an external command, or layering on top a terminal multiplexer with the ability.


You can use hjkl as your scrollback pager for the kitty terminal emulator with these lines in your kitty.conf:

scrollback_pager hjkl -o -e G
map kitty_mod+k show_scrollback


hjkl is installed with an extension for the urxvt terminal emulator to use hjkl as a scrollback pager.


There's a script in this repo to use hjkl as a scrollback pager with st and the externalpipe patch.


I will tag release 0.1 after a little time has passed. Tabs are currently replaced with eight spaces, and I'd like support for manpage style markdown and maybe ansi colors before 1.0.


You can send questions, thoughts or patches by composing an email to ~geb/public-inbox@lists.sr.ht.

#Support Me

Thank you!


GPLv3 only, see LICENSE.

Copyright (c) 2022 John Gebbie