https://github.com/danprince/vsnetrw

🗂️ A split file explorer for vscode
https://github.com/danprince/vsnetrw

file-explorer netrw vim vscode vscode-extension

Last synced: about 2 months ago
JSON representation

🗂️ A split file explorer for vscode

• Host: GitHub
• URL: https://github.com/danprince/vsnetrw
• Owner: danprince
• License: unlicense
• Created: 2022-07-02T19:14:20.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-05-29T09:41:06.000Z (8 months ago)
• Last Synced: 2024-05-29T21:59:32.560Z (8 months ago)
• Topics: file-explorer, netrw, vim, vscode, vscode-extension
• Language: JavaScript
• Homepage: https://marketplace.visualstudio.com/items?itemName=danprince.vsnetrw
• Size: 146 KB
• Stars: 20
• Watchers: 3
• Forks: 3
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# vsnetrw

A [split file explorer][oil-and-vinegar] for vscode, inspired by [netrw][netrw], [vim-vinegar][vinegar], [dired][dired], and [vim-dirvish][dirvish].







## Shortcuts

Use `vsnetrw.open` to open a file explorer at the parent directory of the currently active text editor. Once open the following shortcuts are available.

| Default Shortcut | Command | Description |

| ---------------- | ------- | ----------- |

| enter | `vsnetrw.openAtCursor` | Open the file or directory under the cursor |

| - | `vsnetrw.openParent` | Jump to the parent directory |

| ~ | `vsnetrw.openHome` | Jump to the root of the current workspace folder, or user's homedir. |

| R | `vsnetrw.rename` | Rename the file or directory under the cursor |

| % | `vsnetrw.create` | Create a new file or directory (and any intermediate directories). |

| d | `vsnetrw.createDir` | Create a new directory (and any intermediate ones). |

| D | `vsnetrw.delete` | Delete the file or directory under the cursor. |

| ctrl+l | `vsnetrw.refresh` | Refresh the directory listing. |

| esc | `vsnetrw.close` | Close the active explorer. |

## VSCodeVim Keybindings

To make `-` open an explorer from any file (like `vim-vinegar`) add the following binding to your `vim.normalModeKeyBindings`.

```json

{

  "before": ["-"],

  "commands": ["vsnetrw.open"],

  "when": "editorLangId != vsnetrw"

}

```

This binding can't be provided as part of the extension because native VSCode's keybindings will accidentally trigger in undesirable instances (e.g. pressing `r-` in normal mode).

## Installation

vsnetrw can be installed from the [VSCode Marketplace](https://marketplace.visualstudio.com/items?itemName=danprince.vsnetrw).

You can also download a VSIX from [releases](https://github.com/danprince/vsnetrw/releases) and install it by running `>Extensions: Install from VSIX`.

[netrw]: https://www.vim.org/scripts/script.php?script_id=1075

[vinegar]: https://github.com/tpope/vim-vinegar

[dired]: https://www.emacswiki.org/emacs/DiredMode

[dirvish]: https://github.com/justinmk/vim-dirvish

[oil-and-vinegar]: http://vimcasts.org/blog/2013/01/oil-and-vinegar-split-windows-and-project-drawer/