nnn README

The project's README from github.com/jarun/nnn. As one markdown file: README.md.

nnn
nnn - Supercharge your productivity!

Latest release Availability Circle CI Status GitHub CI Status Privacy Awareness License

[Features] $~~$ [Quickstart] $~~$ [Plugins] $~~$ [Wiki]

nnn (n³) is a full-featured terminal file manager. It's tiny (~150 KiB), nearly 0-config and incredibly fast.

It is designed to be unobtrusive with smart workflows to match the trains of thought.

nnn can analyze disk usage, batch rename, launch apps and pick files. The plugin repository has tons of plugins to extend the capabilities further e.g. live previews, (un)mount disks, find & list, file/dir diff, upload files. A patch framework hosts sizable user-submitted patches which are subjective in nature.

Independent (neo)vim plugins - nnn.vim, vim-floaterm nnn wrapper and nnn.nvim (neovim exclusive).

Runs on the Pi, Termux (Android), Linux, macOS, BSD, Haiku, Cygwin, WSL, across DEs or a strictly CLI env.

(more use cases)

Live demo by Demoshell

Features

Quickstart

Beginners

  1. Install nnn, preferbly using the package manager.
  2. Run the following command to generate (and optionally add to your rc file) a shell function to start with.
    sh -c "$(curl -Ls https://raw.githubusercontent.com/jarun/nnn/master/misc/quickstart.sh)"
    

Use the shell function name you chose to run nnn with your preferred configuration.

Power users

  1. Install nnn and the dependencies you need.
  2. Install plugins.
  3. Configure cd on quit.
  4. The desktop opener is default. Use -e to open text files in the terminal. Optionally open detached.
  5. In a CLI environment, set NNN_OPENER to nuke. Use option -c. For GUI apps, consider xopen.
  6. Sync subshell $PWD to nnn.
  7. Use -x to sync selection to clipboard, show notis on cp, mv, rm and set xterm title.
  8. Bid ls goodbye! alias l='nnn -dDe' :sunglasses:
  9. Visit the Live previews and Troubleshooting Wiki pages.

Don't memorize! Arrows, /, q suffice. Tab creates and/or cycles contexts. ? lists shortcuts.

Wiki

Videos

Elsewhere

Developers

Visit the Tracker thread for a list of features in progress and anything up for grabs. Feel free to discuss new ideas or enhancement requests.

nnn (jarun/nnn)

Searching Database…

22.1K ·GitHub
Что это такое?nnn (n3) — это файловый менеджер для терминала, созданный ради скорости и экономии ресурсов. Бинарник обычно весит около 100 КБ, ему хватает менее 3,5 МБ resident-памяти, и он нормально работает даже с 8 цветами.
Это полноценный файловый менеджер или просто просмотрщик папок?Полноценный: можно создавать, переименовывать, дублировать, копировать, перемещать и удалять файлы, упаковывать их в архивы, создавать ссылки, массово переименовывать целое выделение, а удаления отправлять в корзину, совместимую с FreeDesktop. Кроме того, он работает как анализатор занятого места на диске.
Как его запустить?Установите через свой пакетный менеджер (он есть почти везде) и выполните quickstart-команду, чтобы сгенерировать shell-функцию, либо просто запустите статический бинарник вообще без установки. Дальше для навигации хватает стрелок, / и q.
Нужно ли что-то ещё ставить для дополнительных возможностей?Ядро зависит минимума библиотек и легко компилируется; всё остальное — по желанию. Для удалённых монтирований нужны sshfs или rclone, богатые предпросмотры дают плагины на основе FIFO, а файлы открываются через системный opener вашего рабочего стола (или nuke в чисто консольном окружении).
Есть ли файл настроек, который придётся изучать?Настраивать нечего — конфигурационного файла нет вовсе, только разумные значения по умолчанию, а плагин может сохранять резервную копию ваших настроек. Более тонкая настройка делается на этапе компиляции, где отдельные возможности и зависимости можно включить или выключить при сборке.
Он работает только на десктопном Linux?Нет — он рассчитан на любой POSIX-терминал: Linux, macOS и BSD, WSL на Windows, Raspberry Pi, а также Android через Termux. Горячие клавиши удобны для сенсорных экранов на карманных устройствах, а для маленьких дисплеев есть режим в одну колонку.
Он собирает какие-то данные обо мне?Нет. В проекте осознанно сделан упор на приватность: пользовательские данные без подтверждения не собираются — всё остаётся локально в вашем терминале.
Как работает поиск?Фильтрация происходит мгновенно по мере ввода, в трёх режимах: обычная строка (по умолчанию), нечёткий поиск и регулярные выражения (POSIX/PCRE2). Если совпадение единственное, вы сразу попадаете в нужную папку, а плагин поиска по поддереву позволяет открыть или отредактировать все результаты сразу.
Можно ли посмотреть файл, прежде чем открывать его?Да — для текстовых файлов и папок есть встроенный предпросмотр, плагины на основе FIFO расширяют его на множество других mime-типов, а ещё один плагин добавляет миниатюры картинок, видео и аудио. Архивы можно просматривать, распаковывать или монтировать через FUSE.
Что такое контексты?Это вариант вкладок или рабочих пространств в nnn, у каждого свой цвет; клавиша Tab создаёт их и переключается между ними. Вместе с ними доступны сессии, закладки и система отметок для быстрого перехода к папкам.
Можно ли связать его с моими другими инструментами?Да — плагины не привязаны к языку программирования и запускаются по горячим клавишам, nnn работает как выборщик файлов и поставляется с плагином для (neo)vim, а cd-on-quit и списки путей через stdin упрощают интеграцию с shell. Опытные пользователи делают алиасы вроде l='nnn -dDe'.
What are similar projects?yazi, ranger, neovim, SpaceVim, nerdtree, tig, glances, superfile
Creator
jarun
Size
7.8 MB
Stars
22.1K
Age
10y
Commits · 90 Days