~geb/hjkl

Vim-like pager with keyboard selection
~geb/public-inbox

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

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

Requires:

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

Run:

$ sudo ./install.sh

#Usage

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.

#kitty

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

#rxvt-unicode

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

#st

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

#Status

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.

#Contact

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

#Support Me

Thank you!

#License

GPLv3 only, see LICENSE.

Copyright (c) 2022 John Gebbie