Awesome
<img src="https://raw.githubusercontent.com/MariaLetta/free-gophers-pack/master/characters/svg/50.svg" width="150" align="right">FMAN
<div align="center">Awesome TUI File Manager
Features • Installation • Built With • Themes • License
</div>
:rocket: Features
- Mouse Support
- Clean UI
- File Preview
- Syntax Highlighting
- Themes
- Copy Path to Clipboard
More on the way!!
NOTE: If you want to edit your files in the terminal you must set the
EDITORenvironment variable to your favorite editor. Example:vim, nvim, emacs...
:zap: Installation
Pre-built Binaries
You can install pre-built binaries on the releases page
GO
$ go install github.com/nore-dev/fman@latest
NPM
$ npm i @nore-dev/fman
Brew
brew install fman/tap/fman
:keyboard: Keybindings
| Key | Description |
|---|---|
q, Ctrl+C | Exit from application |
a, h, left | Move to parent directory |
d, l, right | Move to selected directory |
s, j, down | Move cursor down |
w, k, up | Move cursor up |
enter | Open file with default program |
c | Copy selected entry path to the clipboard |
shift+g | Move to the end of the list |
g | Move to the beginning of the list |
m | Toggle showing hidden Files |
~, . | Move to the home directory |
shift+down | Scroll preview down |
shift+up | Scroll preview up |
? | Toggle help |
:computer: CLI options
| Key | Type | Values | Default value |
|---|---|---|---|
--theme | string | dracula,brogrammer | dracula |
--icons | string | nerdfont,emoji,none | nerdfont |
:heart: Built With
Without these projects this project would not have existed at all.
:lipstick: Themes
| <img width="1604" alt="dracula" src="./assets/dracula.png"> dracula | <img width="1604" alt="catppuccin" src="./assets/catppuccin.png"> catppuccin |
| <img width="1604" alt="nord" src="./assets/nord.png"> nord | <img width="1604" alt="gruvbox" src="./assets/gruvbox.png"> gruvbox |
| <img width="1604" alt="brogrammer" src="./assets/brogrammer.png"> brogrammer | <img width="1604" alt="everblush" src="./assets/everblush.png"> everblush |
:busts_in_silhouette: CONTRIBUTING
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
:page_facing_up: LICENSE
Distributed under the MIT License. See LICENSE for more information.
:question: Acknowledgments
Inspired by knipferrc/fm