FS — Terminal File System Navigator

A beautiful, interactive TUI file browser for your terminal — powered by blessed and chalk.

Features

• 📂 Browse directories with keyboard navigation
• 🖱 Clickable file/folder entries — single click to select, double-click to open
• 🗂 Breadcrumb path bar at the top — click any segment to jump directly to that directory
• 📄 Opens text files with nano
• 🎬 Opens videos with mpv (if installed) or falls back to your browser
• 🖼 Opens images/audio/PDFs with your system default app
• 🔍 Live search/filter — press / to filter entries in real time
• 🎨 Color-coded file types (folders, videos, images, audio, text, etc.)
• 📊 File sizes and modification dates in the listing

Installation

Step 1 — Install

npm i -g fs-cliui

Step 2 — Use

fs                     # navigate starting from current directory
fs /path/to/start      # navigate starting from a specific path

Keyboard Shortcuts

| Key | Action | |-----|--------| | ↑ / ↓ or k / j | Move selection up/down | | Enter | Open file or enter directory | | Backspace | Go up one directory | | / or f | Start search/filter | | Esc | Clear search or cancel | | ~ | Jump to home directory | | PgUp / PgDn | Page through entries | | Home / End | Jump to first/last entry | | q or Ctrl+C | Quit |

Mouse Support

• Click any file/folder to select it
• Click again (same item) to open it
• Click a breadcrumb segment to navigate directly to that directory

File Handling

| File Type | Action | |-----------|--------| | Text files (.js, .md, .py, .json, etc.) | Opens in nano | | Video (.mp4, .mkv, .avi, etc.) | Opens in mpv (terminal player) or browser | | Images | Opens with system default | | Audio | Opens with system default | | PDF | Opens with system default | | Unknown/binary | Prompts to open with system default |

Optional: Install mpv for in-terminal video

# macOS
brew install mpv

# Ubuntu/Debian
sudo apt install mpv

# Arch
sudo pacman -S mpv

Dependencies

• blessed — Terminal UI framework
• chalk — Terminal color output