From 65c986b70a1eb8de9b06da7488509a68d1976627 Mon Sep 17 00:00:00 2001
From: Arun Prakash Jana
navigate-as-you-type & du analyzer mode (click for a demo video)
+navigate-as-you-type & du analyzer mode (click on the image for a demo video)
@@ -34,22 +34,28 @@
- [Configuration](#configuration)
- [Cmdline options](#cmdline-options)
- [Keyboard and mouse](#keyboard-and-mouse)
- - [Leader key](#leader-key)
+ - [Leader key](#leader-key)
- [Help](#help)
- [Mentions](#mentions)
- [Developers](#developers)
## Introduction
-`nnn` is a full-featured terminal file manager. It's tiny, extremely light and fast (**[performance](https://github.com/jarun/nnn/wiki/Performance)**).
+`nnn` is a full-featured terminal file manager. It's tiny, extremely light and fast.
-`nnn` is also a disk usage analyzer, a fuzzy app launcher, a batch file renamer and a file picker. 30+ **[plugins](https://github.com/jarun/nnn/tree/master/plugins)** extend the capabilities further. There's an independent [(neo)vim plugin](https://github.com/mcchrish/nnn.vim). Custom plugins are easy to add.
+`nnn` is also a disk usage analyzer, a fuzzy app launcher, a batch file renamer and a file picker. 30+ plugins extend the capabilities further. Custom plugins are easy to add.
If you prefer a lightweight system or productivity-boosting utilities, `nnn` is a delight to have. It's nearly zero-config (with sensible defaults) and can be setup in less than 5 minutes.
-It runs smoothly on the Raspberry Pi, Termux on Android ([demo video](https://www.youtube.com/watch?v=AbaauM7gUJw)), Linux, macOS, BSD, Cygwin and Linux subsystem for Windows. `nnn` works seamlessly with DEs and GUI utilities.
+It runs smoothly on the Raspberry Pi, Termux on Android, Linux, macOS, BSD, Cygwin and Linux subsystem for Windows. `nnn` works seamlessly with DEs and GUI utilities.
-Visit the **[Wiki](https://github.com/jarun/nnn/wiki)** for operational concepts, how tos, use cases, chronology and insights.
+#### Important links
+
+- [Wiki](https://github.com/jarun/nnn/wiki): operational concepts, how tos, use cases, chronology and insights
+- [Performance numbers](https://github.com/jarun/nnn/wiki/Performance)
+- [Plugin repository](https://github.com/jarun/nnn/tree/master/plugins)
+- [(neo)vim plugin](https://github.com/mcchrish/nnn.vim)
+- [`nnn` on Android](https://www.youtube.com/watch?v=AbaauM7gUJw)
## Features
@@ -127,9 +133,9 @@ A curses library with wide character support (like ncursesw), libreadline and st
#### From a package manager
-You can install `nnn` from the package manager of your OS. If the version available is dated please try an alternative installation method.
+Install `nnn` from your package manager. If the version available is dated try an alternative installation method.
-
Packaging status from Repology
+Packaging status from Repology (expand)
@@ -146,11 +152,11 @@ Unlisted distros:
#### Release packages
-Packages for Arch Linux, CentOS, Debian, Fedora and Ubuntu are available with the [latest stable release](https://github.com/jarun/nnn/releases/latest).
+Packages for Arch Linux, CentOS, Debian, Fedora and Ubuntu are auto-generated with the [latest stable release](https://github.com/jarun/nnn/releases/latest).
#### From source
-To cook yourself, download the latest stable release or clone this repository (*risky*). Then install the dependencies and compile (e.g. on Ubuntu 16.04):
+Download the latest stable release or clone this repository (*risky*), install deps and compile. On Ubuntu 16.04:
$ sudo apt-get install pkg-config libncursesw5-dev libreadline6-dev
$ make
@@ -162,7 +168,7 @@ Visit the [developer guides](https://github.com/jarun/nnn/wiki/Developer-guides)
#### Shell completion
-Option completion scripts for Bash, Fish and Zsh can be found in respective subdirectories of [`misc/auto-completion/`](misc/auto-completion). Please refer to your shell's manual for installation instructions.
+Completion scripts for Bash, Fish and Zsh are [available](misc/auto-completion). Refer to your shell's manual for installation instructions.
## Usage
@@ -249,7 +255,7 @@ Press ? in `nnn` to see the list anytime.
^P Prompt/run expr L Lock
```
-Note: Help & settings, file details and archive listing are shown in the PAGER. Use the PAGER-specific keys in these screens.
+Note: Help & settings, file details and archive listing are shown in the PAGER.
| Mouse click | Function |
|---| --- |
@@ -259,7 +265,7 @@ Note: Help & settings, file details and archive listing are shown in the PAGER.
| Left single | Select context or entry |
| Left double | Select context or open entry |
-##### Leader key
+#### Leader key
The Leader/Lead key provides a powerful multi-functional navigation mechanism. It is case-sensitive and understands contexts, bookmarks and location shortcuts.
@@ -299,4 +305,4 @@ To lookup keyboard shortcuts at runtime, press ?.
2. Copyright © 2014-2016 Dimitris Papastamos
3. Copyright © 2016-2019 [Arun Prakash Jana](https://github.com/jarun)
-Contributions are welcome. Please visit the [ToDo list](https://github.com/jarun/nnn/issues/329).
+Contributions are welcome. Head to the [ToDo list](https://github.com/jarun/nnn/issues/329).
--
2.48.1