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)是一个追求速度和低资源占用的终端文件管理器。它的二进制文件通常只有 100KB 左右,常驻内存一般不到 3.5MB,即使只有 8 色的终端也能流畅运行。
它是完整的文件管理器,还是只能浏览目录?是完整的文件管理器:可以创建、重命名、复制副本、复制、移动、删除、压缩和链接文件,对选中的一批文件批量重命名,还能把删除的文件送进符合 FreeDesktop 标准的回收站。它也可以当作磁盘占用分析工具来用。
怎么把它跑起来?用软件包管理器安装(它被广泛打包了),然后运行 quickstart 命令生成一个 shell 函数;或者干脆不做任何安装,直接运行静态二进制文件。之后用方向键、/ 和 q 就能基本操作了。
想用高级功能还需要额外装什么吗?核心部分几乎不依赖第三方库,编译也很简单;附加功能都是可选的。远程挂载需要 sshfs 或 rclone,丰富的预览功能由基于 FIFO 的插件提供,文件会通过你桌面环境的默认打开方式打开(纯命令行环境下则用 nuke)。
有没有需要学习的配置文件?没有要设置的——它没有配置文件,默认设置就很合理,还可以用插件备份你的设置。更深度的定制在编译阶段完成,可以把功能和依赖编进去或去掉。
它只能在桌面版 Linux 上用吗?不是——它面向任何 POSIX 终端:Linux、macOS 和各 BSD 发行版、Windows 上的 WSL、树莓派,以及通过 Termux 使用的 Android。快捷键对手持设备做了触屏友好设计,小屏幕还有单列模式。
它会收集我的数据吗?不会。它明确注重隐私,不会在未经确认的情况下收集用户数据——所有东西都留在你的终端里。
搜索功能是怎么工作的?输入时即时过滤,有三种模式:普通字符串(默认)、模糊匹配和正则表达式(POSIX/PCRE2)。如果结果唯一,会直接跳进匹配的目录;子树搜索插件还能对所有结果执行打开或编辑操作。
打开文件之前能预览吗?可以——文本文件和目录有内置预览,基于 FIFO 的插件把预览扩展到许多其他 mime 类型,还有插件可以生成图片、视频和音频的缩略图。压缩包可以列出内容、解压或通过 FUSE 挂载。
什么是 contexts?它们是 nnn 对标签页或工作区的实现,每个 context 可以设置自己的颜色;按 Tab 就能创建并在它们之间切换。除此之外还有会话、书签,以及一套目录的标记并快速跳转系统。
能和我其他的工具配合使用吗?可以——插件不限定编程语言,可以用快捷键运行;nnn 可以当文件选择器用,还自带一个 (neo)vim 插件;退出时自动 cd 再加上 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