Insist HN: Ov – characteristic smartly off terminal pager

Insist HN: Ov – characteristic smartly off terminal pager

PkgGoDev
Actions Status
Go Report Card

ov is a terminal pager.

  • ov could perhaps perchance well additionally be historical barely than much less or extra or tail -f.
  • ov additionally has an effective characteristic for tabular text.

ov1.png

1. Intention

  • Supports mounted header line demonstrate (both wrap/nowrap).
  • Supports column mode, which recognizes columns by delimiter.
  • Supports portion-by-portion movement, splitting sections by delimiter.
  • Dynamic wrap/nowrap switchable.
  • Supports alternating row styling.
  • Shortcut keys are customizable.
  • The vogue of the cease is customizable.
  • Supports apply-mode (fancy tail -f).
  • Supports apply-portion, which is displayed when the portion is updated.
  • Supports following extra than one recordsdata and switching when updated(apply-all).
  • Supports the execution of instructions that toggle both stdout and stder for demonstrate.
  • Supports glimpse mode, which reads recordsdata progressively.
  • Supports incremental search and regular expression search.
  • Better toughen for Unicode and East Asian Width.
  • Enhance for compressed recordsdata (gzip, bzip2, zstd, lz4, xz).
  • Trusty for tabular text. psql, mysql, and so on…

2. Set up

2.1. deb package

Which that it is doubtless you’ll perchance well presumably gather the package from releases.

curl -L -O https://github.com/noborus/ov/releases/gather/vx.x.x/ov_x.x.x-1_amd64.deb
sudo dpkg -i ov_x.x.x-1_amd64.deb

2.2. rpm package

Which that it is doubtless you’ll perchance well presumably gather the package from releases.

sudo rpm -ivh https://github.com/noborus/ov/releases/gather/vx.x.x/ov_x.x.x-1_amd64.rpm

2.3. MacPorts (macOS)

2.4. Homebrew(macOS or Linux)

brew set up noborus/faucet/ov

2.5. pkg (FreeBSD)

2.6. Arch Linux

Which that it is doubtless you’ll perchance well presumably set up ov utilizing an AUR helper.

AUR package: https://aur.archlinux.org/functions/ov-bin

2.7. nix (nixOS, Linux, or macOS)

ov is in the marketplace as a nix package. Which that it is doubtless you’ll perchance well presumably set up it with

nix profile set up nixpkgs#ov

when you make utilize of flakes, or utilizing nix-env in any other case:

2.8. Binary

Which that it is doubtless you’ll perchance well presumably gather the binary from releases.

curl -L -O https://github.com/noborus/ov/releases/gather/vx.x.x/ov_x.x.x_linux_amd64.zip
unzip ov_x.x.x_linux_amd64.zip
sudo set up ov /usr/native/bin

2.9. plod set up

This could perhaps perchance well also be installed in $GOPATH/bin by the following expose.

plod set up github.com/noborus/ov@most up-to-date

2.10. plod derive(particulars or developer model)

Initially, gather most efficient with the following expose with out installing it.

plod derive -d github.com/noborus/ov
cd $GOPATH/src/github.com/noborus/ov

Subsequent, to set up to $GOPATH/bin, traipse the make set up expose.

Or, set up it in a PATH web site for other users to make utilize of
(Shall we speak, in /usr/native/bin).

make
sudo set up ov /usr/native/bin

3. Usage

3.1. Normal utilization

ov supports delivery file title or regular enter.

Veteran by other instructions by environment the ambiance variable PAGER.

Observe the ov enlighten for extra utilize cases.

3.2. Config

Which that it is doubtless you’ll perchance well presumably enlighten vogue and key bindings in the configuration file.

ov will glimpse a configuration file in the following paths in descending define:

$XDG_CONFIG_HOME/ov/config.yaml
$HOME/.config/ov/config.yaml
$HOME/.ov.yaml

On Dwelling windows:

%USERPROFILE%/.config/ov/config.yaml
%USERPROFILE%/.ov.yaml

Assemble a config.yaml file in a single among the above directories. If the file is in the user dwelling itemizing, it could perhaps be named .ov.yaml.

Please consult with the sample ov.yaml configuration file.

Whilst you fancy much less key bindings, replica ov-much less.yaml and put it to use.

3.3. Header

The --header (-H) option fixedly displays the specified assortment of traces.

When historical with the --skip-traces option, it hides the assortment of traces specified by skip and then displays the header.

ov --skip-traces 1 --header 1 README.md

3.4. Column mode

Specify the delimiter with --column-delimiter and enlighten it to --column-mode to focus on the column.

After startup, switch the demonstrate in column mode (default key is c).
Which that it is doubtless you’ll perchance well presumably additionally enter a column-delimiter after startup (default key is d).

ov --column-delimiter "," --column-mode take a look at.csv

3.5. Column rainbow mode

Which that it is doubtless you’ll perchance well presumably additionally coloration every column individually in column mode.
Specify --column-rainbow besides to the --column-mode option.

After startup, switch the demonstrate with column rainbow (default key is ctrl r).

3.6. Wrap/NoWrap

Supports switching between wrapping and not wrapping traces.

The option is --wrap, specify --wrap=spurious when you invent not must wrap.
After startup, toggle demonstrate with wrap (default key w).

3.7. Alternate-Rows

Alternate row styles with the --alternate-rows(-C) option
The vogue could perhaps perchance well additionally be enlighten with Vogue customization.

ov --alternate-rows take a look at.csv

3.8. Fragment

You specify --portion-delimiter, that it is doubtless you’ll also transfer up and down in portion gadgets.
The starting up of the portion could perhaps perchance well additionally be adjusted with --portion-delivery.

section.png

The portion-delimiter is written in an everyday expression (as an instance: “^#”).
(Line breaks are not integrated in matching traces).

Shall we speak, when you specify “^diff” for a diff that incorporates extra than one recordsdata,
that it is doubtless you’ll also transfer the diff for every file.

3.9. Practice mode

Output appended info and transfer it to the final analysis (fancy tail -f).

ov --apply-mode /var/log/syslog
(while :; invent echo random-$RANDOM; sleep 0.1; performed;)|./ov  --apply-mode

3.10. Practice all mode

Associated as apply-mode, and switches to the last updated file when there are extra than one recordsdata.

ov --apply-all /var/log/nginx/derive entry to.log /var/log/nginx/error.log

3.11. Practice portion mode

Practice mode is line-by-line, while apply portion mode is portion-by-portion.
Practice portion mode displays the bottom portion.
The next example is displayed from the header (#) on the bottom.

ov --portion-delimiter "^#" --apply-portion README.md

Gaze mode is a mode throughout which --apply-portion and
--portion-delimiter "^f" are automatically enlighten.

3.12. Exec mode

Make the expose to demonstrate stdout/stderr individually.
Arguments after (--) are interpreted as expose arguments.

Shows the stderr video display as rapidly as an error happens, when historical with --apply-all.

ov --apply-all --exec -- make

3.13. Search

Search by forward search / key(default) or the backward search ? key(defualt).
Search could perhaps perchance well additionally be toggled between incremental search, regular expression search, and case sensitivity.
Displayed when the following are enabled in the quest enter instructed:

Intentiondemonstrate(Default)keyexpose option
Incremental search(I)alt i–incremental
Frequent expression search(R)alt r–regexp-search
Case sensitive(Aa)alt c-i, –case-sensitive

3.14. Imprint

Imprint the demonstrate location with the m key(default).
The label is embellished with StyleMarkLine and MarkStyleWidth.

Marks could perhaps perchance well additionally be erased individually with the M key(default).
It’s additionally doubtless to delete all marks with the ctrl delete key(default).

Exhaust the >subsequent and previous (default) key to transfer to the marked location.

3.15. Gaze

ov has a glimpse mode that reads the file every N seconds and adds it to the reside.
Whilst you attain EOF, add ‘f’ as a replace.
Scramble extra to the last portion.
The default is’portion-delimiter’, so the last loaded express material is displayed.

as an instance.

ov --glimpse 1 /proc/meminfo

3.16. Mouse toughen

The ov makes the mouse toughen its alter.
This could perhaps perchance well also be disabled with the option --disable-mouse.

If mouse toughen is enabled, tabs and line breaks could be interpreted correctly when copying.

Copying to the clipboard uses atotto/clipboard.
For this motive, the ‘xclip’ or ‘xsel’ expose is required in Linux/Unix environments.

Deciding on the vary with the mouse and then left-clicking will replica it to the clipboard.

Pasting in ov is done with the center button.
In other functions, it is pasted from the clipboard (most frequently by pressing the very best-click on).

3.17. Multi coloration highlight

This characteristic styles extra than one phrases individually.
.key(defualt) enters multi-notice enter mode.
Enter extra than one phrases (regular expressions) separated by spaces.

Shall we speak, error info warn debug will coloration errors red, info cyan, warn yellow, and debug magenta.

It’ll additionally be specified with the expose line option --multi-coloration(or -M).
For expose line suggestions, cross them separated by ,(comma).

Shall we speak:

ov --multi-coloration "ERROR,WARN,INFO,DEBUG,not,^.{24}" derive entry to.log

multi-color.png

3.18. Easy

Supports undecorating ANSI traipse sequences.
The option is --undeniable (or -p).
After startup, toggle the customary decoration (default key ctrl e).

3.19. Jump intention

Which that it is doubtless you’ll perchance well presumably specify the traces to be displayed in the quest results.
This characteristic is equivalent to --jump-intention of much less.
Decided numbers are displayed downwards by

𝚆𝚊𝚝𝚌𝚑 𝙽𝙾𝚆 📺