Filecon

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

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
  • x — List all executables from $PATH directories
  • h — Help
  • v — Views
  • s — Sort view
  • f — Filter view
  • r — Reset view
  • R — Recursive file listing

Marking

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

Directory

  • ~ — Go to home directory
  • ` — Open commands for current directory
  • d — Directory history

Other

  • Enter — Select / confirm
  • Esc — Quit

Configuration

Config is stored at ~/.config/filecon/config.yaml (YAML format) and includes:

  • Color settings (named colors, 8-bit palette, RGB triplets)
  • Command definitions per MIME type
  • View configurations
  • History limits and terminal settings

Command prefixes:

  • | — pipe output to status line
  • + — run in a new terminal window
  • = — display output in the text viewer
  • ! — evaluate as Ruby code

Substitution variables: %name (file path), %dir (directory picker), %file (file picker), %str (text input)

See filecon(1) or the installed filecon.yaml for full details.

Development

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

License

GPL-2.0-only