jarun/nnn
1
1
Fork 0
mirror of https://github.com/jarun/nnn.git synced 2024-09-11 04:55:25 +03:00
Code Issues Projects Releases Wiki Activity

Updated Power toys (markdown)

Mischievous Meerkat 2020-04-10 17:03:25 +05:30
parent 20e9479644
commit 856ba03563
1 changed files with 51 additions and 51 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

102
Power-toys.md → Cool-stuff.md

@ -1,4 +1,54 @@
### 1. Redirect selection to a command
### 1. Pin a frequently visited directory
If you need to repeat a directory repeatedly, you can pin it during a session using the shortcut <kbd>,</kbd>. When you have a pinned directory, pressing the bookmark key (<kbd>b</kbd> or <kbd>\^/</kbd>) will list `,` as the first key:
bookmark keys: , w t m i d v n
Press <kbd>,</kbd> after the bookmark key to visit the pinned directory.
You can pin one directory at a time.
### 2. Filter filtered entries
Filtering is the `nnn` way to search files in a directory. Did you know it's possible to apply a new filter on already filtered results?
- Go to a directory
- Press filter key (<kbd>/</kbd>) and type a filter
- Press <kbd>Esc</kbd> or <kbd>Up</kbd> or <kbd>Down</kbd> (the filter will disappear from the status bar)
- Press filter key again
- Type a new filter to find matches in the earlier filtered results
### 3. Mount and modify archives
`nnn` provides you an option to mount archives when you press <kbd>Enter</kbd> on an archive. Press <kbd>m</kbd> to mount the archive and `nnn` will mount the archive and take you to the mountpoint of the mounted archive.
Add some files in the mounted archive, go back to the `nnn` config directory (`${XDG_CONFIG_HOME:-$HOME/.config}/nnn`) and hover on the archive mount point. Press <kbd>u</kbd> to unmount the archive and generate a package with the new files. The original package is saved with the extension `.orig`.
### 4. Hovered file path in `$nnn`
`nnn` exports the hovered file path as `$nnn` when you press the command prompt or spawn shell shortcuts. You can use the variable to run a command on the hovered file:
```sh
ls -l "$nnn"
```
### 5. Preview and edit files
You can easily edit and view the changes to Markdown, man pages etc. in `nnn`. For this you need to use a CLI file opener. You can use plugin [`nuke`](https://github.com/jarun/nnn/blob/master/plugins/nuke), a customizable example opener to specify your preferred apps. To set nuke as the default opener:
```sh
export NNN_OPENER=/absolute/path/to/nuke
```
and start `nnn` as `nnn -c`.
The option `-c` indicates to `nnn` that the opener is a CLI-only opener (note that `nuke` can open files in GUI apps as well; please read the documentation in the file).
Now when you press <kbd>Enter</kbd> on a Markdown file `nuke` will try to open it in `glow` or a man page in `man`.
To edit the file in `$VISUAL` (or `$EDITOR`, or `vi`), hover on the file and press <kbd>e</kbd>.
### 6. Redirect selection to a command
`nnn` allows users to select a file at a time, a range of files or all files in a directory together. Once you are done selecting, you can run a command on all the files by using the selection file as input:
@ -20,56 +70,6 @@ xargs -0 ls -l < $sel
Many plugins work this way!
### 2. Pin a frequently visited directory
If you need to repeat a directory repeatedly, you can pin it during a session using the shortcut <kbd>,</kbd>. When you have a pinned directory, pressing the bookmark key (<kbd>b</kbd> or <kbd>\^/</kbd>) will list `,` as the first key:
bookmark keys: , w t m i d v n
Press <kbd>,</kbd> after the bookmark key to visit the pinned directory.
You can pin one directory at a time.
### 3. Filter filtered entries
Filtering is the `nnn` way to search files in a directory. Did you know it's possible to apply a new filter on already filtered results?
- Go to a directory
- Press filter key (<kbd>/</kbd>) and type a filter
- Press <kbd>Esc</kbd> or <kbd>Up</kbd> or <kbd>Down</kbd> (the filter will disappear from the status bar)
- Press filter key again
- Type a new filter to find matches in the earlier filtered results
### 4. Mount and modify archives
`nnn` provides you an option to mount archives when you press <kbd>Enter</kbd> on an archive. Press <kbd>m</kbd> to mount the archive and `nnn` will mount the archive and take you to the mountpoint of the mounted archive.
Add some files in the mounted archive, go back to the `nnn` config directory (`${XDG_CONFIG_HOME:-$HOME/.config}/nnn`) and hover on the archive mount point. Press <kbd>u</kbd> to unmount the archive and generate a package with the new files. The original package is saved with the extension `.orig`.
### 5. Hovered file path in `$nnn`
`nnn` exports the hovered file path as `$nnn` when you press the command prompt or spawn shell shortcuts. You can use the variable to run a command on the hovered file:
```sh
ls -l "$nnn"
```
### 6. Preview and edit files
You can easily edit and view the changes to Markdown, man pages etc. in `nnn`. For this you need to use a CLI file opener. You can use plugin [`nuke`](https://github.com/jarun/nnn/blob/master/plugins/nuke), a customizable example opener to specify your preferred apps. To set nuke as the default opener:
```sh
export NNN_OPENER=/absolute/path/to/nuke
```
and start `nnn` as `nnn -c`.
The option `-c` indicates to `nnn` that the opener is a CLI-only opener (note that `nuke` can open files in GUI apps as well; please read the documentation in the file).
Now when you press <kbd>Enter</kbd> on a Markdown file `nuke` will try to open it in `glow` or a man page in `man`.
To edit the file in `$VISUAL` (or `$EDITOR`, or `vi`), hover on the file and press <kbd>e</kbd>.
### 7. Prompt shortcuts
Even if you compile `nnn` without libreadline, the native input prompts support several readline-like keys - <kbd>\^A</kbd>, <kbd>\^B</kbd>, <kbd>\^D</kbd>, <kbd>\^E</kbd>, <kbd>\^F</kbd>, <kbd>\^K</kbd>, <kbd>\^U</kbd>, <kbd>\^W</kbd>.