NOICE(1)

💖 NAME

okay so, bestie, meet noice — literally a small file browser. This is page NOICE(1) from the General Commands Manual, and she is lowkey iconic. ✨

✨ SYNOPSIS

noice [dir]

🌸 DESCRIPTION

noice is a simple and efficient file browser that gets out of your way as much as possible. She was initially implemented to be controlled with a TV remote control, which is honestly main character energy. 📺💅

noice defaults to the current directory if dir is not specified. Extra feature alert: if dir is a relative path, noice will not go back beyond the first component of the path using standard navigation key presses. 🦋

noice supports both vi-like and emacs-like key bindings in the default configuration. The default key bindings are described below; their functionality is described in more detail later. iykyk 👑

• k, [Up] or C-p — move to previous entry.
• j, [Down] or C-n — move to next entry.
• [Pgup] or C-u — scroll up half a page.
• [Pgdown] or C-d — scroll down half a page.
• [Home], ^ or M-< — move to the first entry.
• [End], $ or M-> — move to the last entry.
• l, [Right], [Return] or C-m — open file or enter directory.
• h, C-h, [Left] or [Backspace] — back up one directory level.
• / or & — change filter (see below for more information).
• c — change into the given directory.
• ~ — change to the HOME directory.
• . — toggle hidden .dot files.
• d — toggle sort by directory first.
• t — toggle sort by time modified.
• i — toggle case sensitive sort.
• C-l — force a redraw.
• ! — spawn a shell in current directory.
• z — run the system top utility.
• e — open selected entry with the vi editor.
• p — open selected entry with the less pager.
• q — quit.

Backing up one directory level will set the cursor position at the directory you came out of. Cute, right? 🎀

🛠️ CONFIGURATION

noice is configured by modifying config.h and recompiling the code. old-school slay, no cap.

The file associations are specified by regexes matching on the currently selected filename. If a match is found the associated program is executed with the filename passed in as the argument. If no match is found the program less(1) is invoked. This is useful for editing text files as one can use the v command in less(1) to edit the file using the EDITOR environment variable. 📝✨

See the examples section below for more information.

🧚 FILTERS

Filters allow you to use regexes to display only the matched entries in the current directory view. This effectively allows searching through the directory tree for a particular entry. 🔍💖

Filters do not stack on top of each other. They are applied anew every time. periodt.

To reset the filter you can input an empty filter expression. 🫶

If noice is invoked as root the default filter will also match hidden files.

🌈 ENVIRONMENT

The SHELL, EDITOR and PAGER environment variables take precedence when dealing with the !, e and p commands respectively. 💅

🍓 EXAMPLES

The following example shows one possible configuration for file associations which is also the default:

struct assoc assocs[] = {
        { "\.(avi|mp4|mkv|mp3|ogg|flac|mov)$", "mpv" },
        { "\.(png|jpg|gif)$", "sxiv" },
        { "\.(html|svg)$", "firefox" },
        { "\.pdf$", "mupdf" },
        { "\.sh$", "sh" },
        { ".", "less" },
};

💀 KNOWN ISSUES

If you are using urxvt(1) you might have to set backspace key to DEC. not me finding out the hard way 😭

👑 AUTHORS

Lazaros Koromilas <lostd@2f30.org>, Dimitris Papastamos <sin@2f30.org>.

---

That's the whole page, bestie — source/version Debian, dated Jan 19, 2019, page NOICE(1). Mwah 💋