Skip to content

falktimon/marco

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

18 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

marco

A minimal terminal file explorer.

Installation

curl -sSL https://raw.githubusercontent.com/falktimon/marco/main/install.sh | sh

Or manually:

git clone https://github.com/falktimon/marco.git
cd marco
make install  # may require sudo

Keybindings

Key Action
j/โ†“ Move down
k/โ†‘ Move up
u Scroll up half a page
d Scroll down half a page
h Go to parent directory
l/โ†’ Open directory / edit file
Space Toggle selection
c Copy selected files
x Cut selected files
p Paste files
: Run shell command
q/Esc Quit

Features

Selection & Clipboard - Select files with Space, then copy (c) or cut (x) and paste (p) elsewhere. Copying in the same directory creates duplicates with _copy suffix.

Shell Commands - Press : to run any shell command in the current directory. Output is displayed in the terminal.

Half-page Navigation - Use u/d to jump multiple entries at once.

Configuration

Create ~/.config/marco/marco.toml:

[colors]
bg = "default"
fg = "white"
highlight_fg = "black"
highlight_bg = "cyan"

padding = 2
editor = null  # uses $EDITOR, $VISUAL, or vi

[keybindings]
select = " "
copy = "c"
cut = "x"
paste = "p"
page_up = "u"
page_down = "d"
quit = "q"

About

A minimal file browser for the terminal ๐Ÿ—„๏ธ

Topics

Resources

Stars

Watchers

Forks

Contributors