1 unstable release
0.2.3 | Aug 25, 2023 |
---|
#6 in #navigate
33KB
822 lines
slingshot 0.2.3
Slingshot is a lightweight tool to browse files in the terminal. It allows the user to quickly filter through files in any directory, open them with a text editor (nvim by default), create/edit/delete files , and run commands in a simple interface.
Design Goals
- A quick way to navigate, create and edit files in the terminal.
- Easily maintanable.
- Minimal use of third party crates.
Dependencies
How to install
- Clone the repository & navigate to cloned directory.
- Run
make build
- Run
make install
How to use
-
Moving up/down:
- Arrow Keys
Ctrl+J
/Ctrl+K
-
Creating folders/files:
- For folders, type the desired name followed by a
/
. - For files, type the name of the desired file with the file extension (e.g.
.py
,.txt
, etc.) - Confirm creation by pressing Enter.
- For folders, type the desired name followed by a
-
Deleting files/folders:
- Marking files/folders for deletion is done by pressing Ctrl+D, which will highlight the item red.
- Confirm by pressing
Ctrl+Y
.
-
Command mode:
- Toggling between Command Mode and File Explorer can be done by pressing
Ctrl+N
. - To run the command, type it and confirm with Enter.
- Toggling between Command Mode and File Explorer can be done by pressing
Fish Shell Integration
The only requirement is to have slingshot installed.
- Run
fisher install caio-ishikawa/slingshot-fish
.
The default keybind to open slingshot in the fish shell is Ctrl+S
.
Known issues
- Scrolling/overflows do not work. (filtering is not affected.)
- Crashes if user tries to move back from home directory.
Dependencies
~2–13MB
~97K SLoC