MOOR(1)                     General Commands Manual                    MOOR(1)

NAME
       moor - the nice pager

SYNOPSIS
       moor [options] file...
       moor --help
       moor --version

DESCRIPTION
       moor is a pager much like less (1), but with generally nicer out-of-
       the-box behavior.

       More information and screenshots: https://github.com/walles/moor#readme

       Inside of moor, press h to access the built-in help.

       Input is expected to be (optionally compressed) UTF-8 text.  Invalid /
       unprintable characters are by default rendered as '?'.

       If you have opened multiple files, press : to switch between them.

OPTIONS
       Multiple-choice options all have the default value listed first.

       All of these options can be appended to the MOOR environment variable
       for persistent configuration.

       Doing moor --help will also list these options.

       --colors={auto | 8 | 16 | 256 | 16M}
              Size of color palette we output to the terminal

       --debug
              Print debug logs after exiting, less verbose than --trace

       --follow
              Scrolls automatically to follow piped input, just like tail -f

       --lang=string
              Used for highlighting.  Without this flag highlighting is based
              on the input file name.  Valid values are MIME types like
              text/x-markdown, file extensions like md or language names like
              markdown.  For the source of truth on what is supported exactly,
              look in
              https://github.com/alecthomas/chroma/tree/master/lexers/embedded
              or its parent directory.

       --mousemode={auto | select | scroll}
              Guarantee selecting text with the mouse works but maybe not
              mouse scrolling.  Or guarantee mouse scrolling works but
              selecting text requiring extra effort.  Details here:
              https://github.com/walles/moor/blob/master/MOUSE.md

       --no-clear-on-exit
              Retain screen contents when exiting moor.  Affected by --no-
              clear-on-exit-margin.

       --no-clear-on-exit-margin=int
              Leave this number of lines for your shell prompt after exiting.
              Defaults to 1. Affects --no-clear-on-exit and --quit-if-one-
              screen.

       --no-linenumbers
              Hide line numbers on startup, press left arrow key to show

       --no-reformat
              No effect, exists for backwards compatibility. See --reformat.

       --no-search-line-highlight
              Do not highlight the background of lines with search hits. The
              search hits themselves are still highlighted though, even with
              this option.

       --no-statusbar
              Hide the status bar, toggle with =

       --quit-if-one-screen
              Print input contents without paging if the input fits on one
              screen.  Affected by --no-clear-on-exit-margin.

       --reformat
              Reformat supported input files (JSON) before showing them.

       --render-unprintable={highlight | whitespace}
              How unprintable characters are rendered

       --scroll-left-hint=string
              UTF-8 character indicating the view can scroll left, defaults to
              an inverse <.  This can be a string containing ANSI formatting.
              The word ESC in caps will be interpreted as one escape
              character.  Example value for faint (using ANSI SGR code 2)
              tilde characters: ESC[2m~

       --scroll-right-hint=string
              UTF-8 character indicating the view can scroll right, defaults
              to an inverse >.  This can be a string containing ANSI
              formatting.  The word ESC in caps will be interpreted as one
              escape character.  Example value for faint (using ANSI SGR code
              2) tilde characters: ESC[2m~

       --shift=int
              Arrow keys side scroll amount. Or try ALT+arrow to scroll one
              column at a time.

       --statusbar={inverse | plain | bold}
              Status bar style

       --style={native | style}
              Highlighting style from
              https://xyproto.github.io/splash/docs/longer/all.html

       --tab-size=int
              Number of spaces per tab stop, defaults to 8. Or try CTRL-t to
              toggle when moor is running.

       --terminal-fg
              Use terminal foreground color rather than style foreground color
              for unstyled text.  Try this if your terminal window has a
              background image rather than a solid color.

       --trace
              Print trace logs after exiting, more verbose than --debug

       --wrap Wrap long lines, toggle with w

       +1234  Immediately scroll to line 1234

FILES
       $XDG_DATA_HOME/moor/search_history
              Moor will store your search history in this file. If
              $XDG_DATA_HOME is not set, the file will be stored in the
              default XDG location, usually
              ~/.local/share/moor/search_history.

ENVIRONMENT
       LESSSECURE
              Setting this to "1" prevents moor from opening new files or
              launching external programs, as required by systemctl(1).  In
              secure mode, the "v" command for opening the current file in an
              editor is disabled, and the search history file is not updated.

       MOOR   Additional options are read from this variable if it is set,
              just as if those same options had been manually added to each
              moor invocation. Try setting it to --reformat to have JSON input
              automatically reformatted!

       PAGER  If set to "moor", many programs will use moor as their pager.

       PAGER_LABEL
              Other programs can set this to tell moor what name to show for
              stdin input.

BUGS
       Kindly report any bugs here: https://github.com/walles/moor/issues

                                  2022-07-21                           MOOR(1)