MOOR(1)

📦
version 2.19.6 · 4 versions
, in arch rolling, nixpkgs unstable

💖 NAME 💖

okay so bestie, this is moor(1) — literally the nice pager. That's the whole name. No cap. 🫶

✨ SYNOPSIS ✨

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

🌸 DESCRIPTION 🌸

moor is a pager, kinda 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 💅

quick note: multiple-choice options all have the default value listed first — the first one is the one you get if you don't pick. 🎀

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 the 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 colors rather than style colors for unstyled text. This resets both foreground and background to their terminal defaults, so it also helps if your terminal window has a transparent or image background 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. 🚀
  • +/pattern — immediately scroll to line matching pattern. 🎯

🎀 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 🦋

  • LESS_TERMCAP_* — for backwards compatibility with less, moor reads all LESS_TERMCAP_* values. In these values, both actual escape characters and the word ESC in caps are interpreted as escape characters. In moor, styling should be done using the --style option rather than using these environment variables. Example value: ESC[1m. 🧬
  • LESS_TERMCAP_md — formatting used for man page bold text. 🖍️
  • LESS_TERMCAP_us — formatting used for man page underlined text. 🖊️
  • LESS_TERMCAP_so — formatting used for status bar and search hits. 🔦
  • 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_WRAP_COLUMNS — if set to a positive number, this limits the maximum width for wrapping long lines. 📏
  • 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 🐞

okay that's the whole MOOR(1) page, from the General Commands Manual, dated 2026-06-02 — love u, bye bestie! 💖🫶

📦 where this page comes from