#file-explorer #tui #path #ep

app endolphine

TUI file explorer made by Rust

4 stable releases

new 1.0.3 Mar 2, 2025
1.0.2 Feb 28, 2025

#9 in #file-explorer

Download history

130 downloads per month

MIT license

81KB
2.5K SLoC

Endolphine

TUI file explorer made by Rust

Installation

required Cargo:

cargo install endolphine

exec:

$ ep [PATH]

[PATH]: default "."

Usage

Launch explorer

$ ep [PATH]

Open in explorer with PATH directory.
Cannot open a NOT directory items.

Keymapping

# Exit application
exit_app = "Q"

# Cursor moving
# *_ten is skip of 10 items, so FAST
move_up = "k"
move_up_ten = "K"
move_down = "j"
move_down_ten = "J"

# Back to a parent directory
move_parent = "h"

# If the target item is a file, open it with $EDITOR
# if it is directory, enter it
enter_dir_or_edit = "l"

# Toggle visual-selection mode
visual_select = "V"

# Toggle MENU widget
menu_toggle = "M"

# Switch MENU and BODY
menu_move = "m"

# Create a new file or directory
create_new = "a"

# Delete item
delete = "d"

# Rename item
rename = "r"

# Yank with native-command (ex: xclip, wl-*)
yank = "y"

# Paste with native-command (ex: xclip, wl-*)
paste = "p"

# Search item in current directory
search = "/"
search_next = "n"

Configuration

Open config file:

ep -e

Config:

# Editor by using
editor = ["vim"]

# Using theme (Available  "Dark", "Light" and "*NoBg")
# *NoBg is "None Background"
theme = "Dark"

# Item sort priority
# 0: Prefix lowercase (ex: "dotfiles/", "main.rs")
# 1: Prefix uppercase (ex: "Desktop/", "Cargo.toml")
# 2: The "dotfiles" (ex: ".local/", ".git/")
# 3: Other files
sort_by_priority = [
    0,
    1,
    2,
    3,
]

[rm]
# FAST processing
no_enter = true

# Auto yanking
yank = true

# Not deleting item, action replace to move for tmp
for_tmp = true

[paste]
# Collision avoidance suffix when pasting into the same file
copied_suffix = "_Copy"

# Dont ask "Is overwrite?"
force_mode = true

# Answer of "Is overwrite?"
default_overwrite = true

# Menu shortcuts
# Scheme: "Tag:Path"
#
# Tag: Name of be displaying on menu
# Path: Shortcut path (directory only)
#
# Important: **Can't** usable the VARIABLE ($USER is example)
[menu]
items = [
    "Home:/home/${USER}",
    "Downloads:/home/${USER}/Downloads",
    "Desktop:/home/${USER}/Desktop",
]

Uninstall

required Cargo:

cargo uninstall endolphine

LICENSE

MIT

Dependencies

~7–18MB
~245K SLoC