Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/innocenzi/rename
Batch-rename files from your preferred editor
https://github.com/innocenzi/rename
cli editor multi-cursor rename
Last synced: about 1 month ago
JSON representation
Batch-rename files from your preferred editor
- Host: GitHub
- URL: https://github.com/innocenzi/rename
- Owner: innocenzi
- License: mit
- Created: 2021-06-09T17:29:19.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2021-10-08T17:12:12.000Z (almost 3 years ago)
- Last Synced: 2024-05-01T16:30:59.800Z (5 months ago)
- Topics: cli, editor, multi-cursor, rename
- Language: TypeScript
- Homepage:
- Size: 366 KB
- Stars: 51
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
Renamer
A command line utility to batch-rename files via your editor.
npm i -g @innocenzi/rename
## Usage
In a directory, use `rn` to open your configured editor. Each line corresponds to a file:
- If you change a line, the corresponding file will be renamed accordingly.
- If you erase the line while keeping the line jump, the file will be deleted.
Note the following scenarios:
- If you completely delete a line, all operations will be canceled.
- If you rename multiple files with the exact same name, the last one will take over and the previous ones will be deleted.
- If you are deeply renaming paths and have renamed a shared base directory, you need to update other related paths accordingly.
## Options
| Argument | Description |
| ----------------- | ---------------------------------------------------------------------- |
| `--dry` | Prints the output to the console without actually applying the changes |
| `--silent` | Prevents from printing to the console |
| `--dirs` | Only match directories |
| `--files` | Only match files |
| `--base ` | Defines the base directory in which the rename will be performed |
| `--depth ` | Defines the maximum depth in case a globstar is used (`**`) |
## Configuration
Your `RENAME_EDITOR` or `EDITOR` environment variable will be used to determine your editor of choice. If none of these are defined, Visual Studio Code will be used instead. If Code is not installed either, or if the configured editor can not be opened, the program will fail.
The following table is a reference from the [Git documentation](https://git-scm.com/book/en/v2/Appendix-C%3A-Git-Commands-Setup-and-Config#ch_core_editor) that can be used to set up your editor.
| Editor | Environment variable value |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Atom | `atom --wait` |
| BBEdit (Mac, with command line tools) | `bbedit -w` |
| Emacs | `emacs` |
| Gedit (Linux) | `gedit --wait --new-window` |
| Gvim (Windows 64-bit) | `'C:\Program Files\Vim\vim72\gvim.exe' --nofork '%*'` |
| Kate (Linux) | `kate` |
| nano | `nano -w` |
| Notepad (Windows 64-bit) | `notepad` |
| Notepad++ (Windows 64-bit) | `'C:\Program Files\Notepad\notepad.exe' -multiInst -notabbar -nosession -noPlugin` |
| Scratch (Linux) | `scratch-text-editor` |
| Sublime Text (macOS) | `/Applications/Sublime\ Text.app/Contents/SharedSupport/bin/subl --new-window --wait` |
| Sublime Text (Windows 64-bit) | `'C:\Program Files\Sublime Text 3\sublime_text.exe' -w` |
| TextEdit (macOS) | `open --wait-apps --new -e` |
| Textmate | `mate -w` |
| Textpad (Windows 64-bit) | `'C:\Program Files\TextPad 5\TextPad.exe' -m` |
| UltraEdit (Windows 64-bit) | `Uedit32` |
| Vim | `vim` |
| Visual Studio Code | `code --wait` |
| VSCodium (Free/Libre Open Source Software Binaries of VSCode) | `codium --wait` |
| WordPad | `"C:\Program Files\Windows NT\Accessories\wordpad.exe"` |
| Xi | `xi --wait` |
·
·
Built with ❤︎ by Enzo Innocenzi