Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tamago324/LeaderF-filer
📂 LeaderF file explorer
https://github.com/tamago324/LeaderF-filer
file-manager leaderf vim
Last synced: 11 days ago
JSON representation
📂 LeaderF file explorer
- Host: GitHub
- URL: https://github.com/tamago324/LeaderF-filer
- Owner: tamago324
- License: apache-2.0
- Archived: true
- Created: 2020-01-29T16:02:11.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-01-15T15:02:07.000Z (over 3 years ago)
- Last Synced: 2024-03-01T14:34:07.763Z (4 months ago)
- Topics: file-manager, leaderf, vim
- Language: Python
- Homepage:
- Size: 3.44 MB
- Stars: 40
- Watchers: 5
- Forks: 4
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-stars - tamago324/LeaderF-filer - 📂 LeaderF file explorer (Python)
README
# LeaderF-filer
This Plugin use [LeaderF](https://github.com/Yggdroot/LeaderF) to navigate the files in directory.
Inspired by [vim-clap's filer provider](https://github.com/liuchengxu/vim-clap/pull/272), [helm's find-files](https://github.com/emacs-helm/helm).
## Installation
```
Plug 'Yggdroot/LeaderF'
Plug 'tamago324/LeaderF-filer'
```
If you use `remove_trash` and `remove_trash_force`, you need [Send2Trash](https://pypi.org/project/Send2Trash/).
## Usage
```
:Leaderf filer
:Leaderf filer --popup
```
## Screenshots
`:Leaderf filer`
`:Leaderf filer --popup`
`let g:Lf_FilerShowPromptPath = 1`
## Mappings
### Insert mode
| Mapping | Command | Description |
|-----------------------------|---------------------------|---------------------------------------------------------------------------------------------------------|
| | nop | Does nothing like ``. |
| ``
`` | quit | Quit from LeaderF. |
| `` | up | move the cursor downward in the result window. |
| `` | down | move the cursor upward in the result window. |
| ``
`<2-LeftMouse>` | accept | Open the file under cursor or create a file with the input pattern file name (when empty results). |
| `` | accept_horizontal | Open the file under cursor in horizontal split window. |
| `` | accept_vertical | Open the file under cursor in vertical split window. |
| `` | accept_tab | Open the file under cursor new tabpage. |
| `` | add_selections | select multiple result. |
| `` | select_all | select all result. |
| `` | clear_selections | clear all selections. |
| `` | preview | Preview the result. |
| `` | page_up_in_preview | Scroll up in the popup preview window. |
| `` | page_down_in_preview | Scroll down in the popup preview window. |
| | close_preview_popup | Close popup preview window. |
| | open_parent | The prompt string is cleared and show files files in the parent directory. |
| `` | open_current | Show files in directory under cursor or open the file under the cursor. |
| `` | toggle_hidden_files | Toggle show hidden files. |
| `` | goto_root_marker_dir | Show files of directory where `g:Lf_RootMarkers` exists. |
| | change_directory | Change the current directory to cwd of LeaderF-filer. |
| | | |
| `` | toggle_regex | Switch between fuzzy search mode and regex mode. |
| `` | switch_normal_mode | Switch to normal mode. |
| | open_parent_or_backspace | Show files in parent directory or delete the preceding character in the prompt if a pattern wasentered. |
| `` | open_parent_or_clear_line | Show files in parent directory or clears the prompt if a pattern was entered. |
| ``
`` | paste | Paste from clipboard. |
| `` | clear_line | Clear the prompt. |
| `` | delete_left_word | Delete the word before the cursor in the prompt. |
| `` | prev_history | Recall last input pattern from history. |
| `` | next_history | Recall next input pattern from history. |
| `` | backspace | Delete the preceding character in the prompt. |
| `` | delete | Delete the current character in the prompt. |
| ``
`` | home | Move the cursor to the begin of the prompt. |
| ``
`` | end | Move the cursor to the end of the prompt. |
| `` | left | Move the cursor one character to the left. |
| `` | right | Move the cursor one character to the right. |
### Normal mode
You can view help in F1.
| Mapping | Command | Description |
|--------------------------------------|----------------------|----------------------------------------------------------------------------------------------------|
| | nop | Does nothing like ``. |
| `q` | quit | Quit from LeaderF. |
| `` | up | move the cursor downward in the result window. |
| `` | down | move the cursor upward in the result window. |
| `o`
``
`<2-LeftMouse>` | accept | Open the file under cursor or create a file with the input pattern file name (when empty results). |
| `x` | accept_horizontal | Open the file under cursor in horizontal split window. |
| `v` | accept_vertical | Open the file under cursor in vertical split window. |
| `t` | accept_tab | Open the file under cursor new tabpage. |
| `s` | add_selections | select multiple result. |
| `a` | select_all | select all result. |
| `c` | clear_selections | clear all selections. |
| `p` | preview | Preview the result. |
| `` | page_up_in_preview | Scroll up in the popup preview window. |
| `` | page_down_in_preview | Scroll down in the popup preview window. |
| `` | close_preview_popup | Close popup preview window. |
| `h`
`` | open_parent | The prompt string is cleared and show files files in the parent directory. |
| `l`
`` | open_current | Show files in directory under cursor or open the file under the cursor. |
| `I` | toggle_hidden_files | Toggle show hidden files. |
| `` | goto_root_marker_dir | Show files of directory where `g:Lf_RootMarkers` exists. |
| `@` | change_directory | Change the current directory to cwd of LeaderF-filer. |
| | | |
| `` | toggle_help | Toggle this help. |
| `` | switch_insert_mode | Switch to insert mode. |
| `H` | history_backward | Go backwards in history. |
| `L` | history_forward | Go forwards in history. |
| `K` | mkdir | Create a directory.
See `g:Lf_FilerMkdirAutoChdir` |
| `O` | create_file | Create a file. |
| `R` | rename | Rename files and directories. |
| `C` | copy | Copy files and directories under cursor. |
| `P` | paste | Paste the file or directory copied by the copy command to cwd of LeaderF-filer. |
| | remove | Remove files. |
| | remove_force | Remove files without confirmation. |
| | remove_trash | Remove files and put in the trash. |
| | remove_trash_force | Remove files and put in the trash without confirmation. |
## Credit
* LeaderF-filer uses some code from [defx.nvim](https://github.com/Shougo/defx.nvim), [ranger](https://github.com/ranger/ranger).
* Thanks [Send2Trash](https://pypi.org/project/Send2Trash/).
## License
Apache-2.0