https://github.com/antonmedv/llama

Terminal file manager
https://github.com/antonmedv/llama

cli file-manager terminal

Last synced: 3 months ago
JSON representation

Terminal file manager

• Host: GitHub
• URL: https://github.com/antonmedv/llama
• Owner: antonmedv
• License: mit
• Created: 2021-12-08T22:50:51.000Z (almost 3 years ago)
• Default Branch: master
• Last Pushed: 2024-07-04T08:45:51.000Z (4 months ago)
• Last Synced: 2024-08-08T17:15:20.432Z (3 months ago)
• Topics: cli, file-manager, terminal
• Language: Go
• Homepage:
• Size: 3.39 MB
• Stars: 3,197
• Watchers: 11
• Forks: 89
• Open Issues: 17
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 🥾 walk



  


  

  




**Walk** — a terminal navigator.

Why another terminal navigator? I wanted something simple and minimalistic.

Something to help me with faster navigation in the filesystem; a `cd` and `ls`

replacement. So I build **walk**. It allows for quick navigation with fuzzy

searching, `cd` integration is quite simple. And you can open `vim` right from

the walk. That's it.

## Install

```

brew install walk

```

```

pkg_add walk

```

```

go install github.com/antonmedv/walk@latest

```

Or download [prebuild binaries](https://github.com/antonmedv/walk/releases).

Put the next function into the **.bashrc** or a similar config:

   Bash/Zsh 

   Fish 

   PowerShell 

```bash

function lk {

  cd "$(walk "$@")"

}

```

```fish

function lk

  set loc (walk $argv); and cd $loc;

end

```

```powershell

function lk() {

  cd $(walk $args)

}

```

Now use `lk` command to start walking.

### Preview mode

Press `Space` to toggle preview mode.



### Delete file or directory

Press `dd` to delete file or directory. Press `u` to undo.



### Display icons

Install [Nerd Fonts](https://www.nerdfonts.com) and add `--icons` flag.



### Image preview

No additional setup is required.



## Usage

| Key binding      | Description        |

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

| `arrows`, `hjkl` | Move cursor        |

| `shift+arrows`   | Jump to start/end  |

| `enter`          | Enter directory    |

| `backspace`      | Exit directory     |

| `space`          | Toggle preview     |

| `esc`, `q`       | Exit with cd       |

| `ctrl+c`         | Exit without cd    |

| `/`              | Fuzzy search       |

| `d`, `delete`    | Delete file or dir |

| `y`              | yank current dir   |

| `.`              | Hide hidden files  |

## Configuration

The `EDITOR` or `WALK_EDITOR` environment variable used for opening files from

the walk.

```bash

export EDITOR=vim

```

The `WALK_REMOVE_CMD` environment variable can be used to specify a command to

be used to remove files. This is useful if you want to use a different

command to remove files than the default `rm`.

```bash

export WALK_REMOVE_CMD=trash

```

Flags can be used to change the default behavior of the program.

| Flag         | Description                |

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

| `--icons`    | Show icons                 |

| `--dir-only` | Show dirs only             |

| `--preview`  | Start with preview mode on |

| `--fuzzy`    | Start with fuzzy search on |

## License

[MIT](LICENSE)