Filecon

A terminal-based file manager built on the Typr terminal UI toolkit.

Features

• Directory browsing with MIME-type detection
• Customizable views (content preview, file types, line counts, etc.)
• Command execution with pipe support
• Directory and command history
• Configurable keybindings and colors

Installation

gem install filecon

Or add to your Gemfile:

gem "filecon", "~> 0.1"

Usage

filecon [directory]

Keybindings

Navigation

• Arrow keys / Page Up/Down / Home / End — Navigate files
• Backspace — Go to parent directory
• Number keys — Open file with default command
• Tab — Cycle hint numbers for rows beyond the first 10

Actions

• o — Open list of all commands for selected file
• c — Command history
• h — Help
• v — Views
• s — Sort view
• f — Filter view
• r — Reset view
• R — Toggle recursive listing

Marking

• m — Mark file
• M — Mark range
• a — Mark all
• i — Invert mark

Directory

• ~ — Go to home directory
• ` — Go to root directory
• d — Directory history

Other

• Enter — Select / confirm
• Esc — Quit

Configuration

Config is stored at ~/.config/filecon/config.yaml and includes:

• Color settings
• Command definitions per file type
• View configurations
• History limits

Development

git clone https://codeberg.org/typr/filecon
cd filecon
bundle install
rake test

License

GPL-2.0-only