Manual

glv(1) Manual Page

Name

glv - Git Log Viewer a TUI application with support for folding merges

Synopsis

glv [-w DIR | --workdir=DIR] [REVISION] [-d | --debug] \[[--] <path>…​]
glv --version

Description

An alternative to man:tig[1]/man:lazygit[1] which supports folding the merges and is expandable via plugins. The application can resolve the default merge titles done by using GitHub or Bitbucket to the actual pull request names.

Use kbd:[CTRL+C] or kbd:[q] to exit the application.

Options

REVISION

A branch, tag or commit [default: HEAD]

-w DIR

--workdir=DIR

Directory where the git repository is

-d

--debug

Enable sending debugging output to man:journalctl[1] (journalctl --user -f)

Configuration

The Git Log Viewer user configuration file is loaded in the following way. If $XDG_CONFIG_HOME is set, read user configuration from $XDG_CONFIG_HOME/glv/config. If $XDG_CONFIG_HOME is empty or undefined, read user configuration from ~/.config/glv/config.

The configuration file consists of sections and variables. A section begins with the name of the section in square brackets and continues until the next section begins. Section names are case-insensitive. Only alphanumeric characters, - and . are allowed in section names. Each variable must belong to some section, which means that there must be a section header before the first setting of a variable.

Variables

history.icon_set (string)

The set of icons to use for the icon column. Currently only the following are supported:

• ascii

• nerdfont ← Install NerdFont to use this

history.author_date_color (string)

history.modules_color (string)

history.author_name_color (string)

history.short_id_color (string)

history.icon_color (string)

history.subject_color (string)

history.type_color (string)

history.branches_color (string)

prompt_toolkit style string https://python-prompt-toolkit.readthedocs.io/en/master/pages/advanced_topics/styling.html

history.author_date_format (string)

One of “full”, “long”, “medium”, or “short”.

history.author_name_width (string)

The width of the author name column. Default is set to “10”.

Default Keys

General Keys

The keys listed in the next two tables are available in all views.

Table 1. Movement

Key	Action
kbd:[h]	Show this help.
kbd:[k], kbd:[Up]	Move cursor one line up.
kbd:[j], kbd:[Down]	Move cursor one line down.
kbd:[PgUp],	Move cursor one page up.
kbd:[PgDown], kbd:[Space]	Move cursor one page down.
kbd:[End]	Jump to last line.
kbd:[Tab]	Move focus to the next view
kbd:[q]	Close view, if multiple views are open it will jump back to the previous view in the view stack. If it is the last open view it will quit.
kbd:[Home]	Jump to first line.

Table 2. Searching

Key	Action
kbd:[/]	Search the view. Opens a prompt for entering search regexp to use.
kbd:[?]	Search backwards in the view. Also prompts for regexp.
kbd:[n]	Find next match for the current search regexp.
kbd:[N]	Find previous match for the current search regexp.

Log View

Key	Action
kbd:[Enter]	Open selected commit in diff view
kbd:[l]	Unfold merge or follow the merge if unfolded
kbd:[h]	Fold merge or go up the tree if folded
kbd:[Space]	Toggle fold/unfold on selected commit
kbd:[zo]	Unfold merge or follow the merge if unfolded
kbd:[zc]	Fold merge or go up the tree if folded
kbd:[za]	Toggle fold/unfold on selected commit

Diff View

Key	Action
kbd:[Enter]	Open selected commit in diff view
kbd:[{]	Jump to previous hunk
kbd:[}]	Jump to next hunk