filecon 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 47e7fc518a42a7037832b88feb1e3c7d3b23c64968de970928104d1fe5c47ef1
-  data.tar.gz: e7cc5f0746c241fc6b3d3866b1efb3220b1274870c7446f7a6c48ac8abd0aa10
+  metadata.gz: d62cae7fca7f8ef2348b79ac2df27edfafbc5da7ada9523a2fad5b38de27e5a9
+  data.tar.gz: 20fe942d398a0dd68e27a5cdc5b40d16d296e33399327494aaa608d847401e47
 SHA512:
-  metadata.gz: f34237e27ff2d45a8aee3e577afd2f6aa5e0bca8e1fbc03fcec77615500aab08b459575ac17715ed89a5c20eac959388e78d7afd0c446281e01fb502d8f41e5b
-  data.tar.gz: 9c639e9634aa690a09d4bad83732f16153b6852ffaee84967b55dc140e97ba27a151cd904ff93633c24d12b1dbeadd466c7021b8b75af7050bee87087f66facc
+  metadata.gz: 1d2ac9423eecd422db9ac518ba264ef56b3f9d17823950f648e56eff3de0dd08326daba18bfd8eeeba51d76e072a060f4be5c6542a50c709623adac370f080f0
+  data.tar.gz: 198c5fa607c36cbc86808d42e3b0a806d83832ba5432827c871526d8ebaebaaa8cc3864f7a486e586b00ce2e983086e81184d08fe993f93ca2fa58fd7b0c9fd6

data/README.md

@@ -2,15 +2,32 @@
 
 # Filecon
 
-A terminal-based file manager built on the [Typr](https://codeberg.org/typr/typr) terminal UI toolkit.
+## Description
+
+Filecon is a terminal-based file manager built on the [Typr](https://codeberg.org/typr/typr) terminal UI toolkit. It packs everything a file manager should do into a keyboard-driven terminal program: every file, command, and directory is reachable in a few keystrokes, and the most common operations take the fewest key presses.
+
+Filecon is designed to be **intuitive**, **complete**, **powerful**, and the **fastest possible** file manager. The whole interface is built around that principle:
+
+- **Hint navigation** — every visible row carries a number hint (1–9, 0); pressing it acts on that row immediately, no cursor movement needed.
+- **Live search in popups** — command and history popups open in `/` search mode; type to distill the list, then pick one of the few remaining results with a number.
+- **Frequency-ordered history** — directory and command history are ranked by use count, so the most likely choice is always near the top.
+
+Filecon's long-term goal is to become an **interactive shell**: a separate companion program will handle command building, and combined with Filecon the two will form a full interactive shell that competes with interactive CLI shells.
+
+Filecon runs on Typr, whose self-contained terminal layer ships its own precompiled terminfo key table and MIME-type database in the gem — no ncurses or external tooling required — so Filecon works on any raw, ANSI-capable terminal (including Termux).
 
 ## 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
+- **Directory browsing with MIME-type detection** — files are typed from a packaged MIME database and colored accordingly, with optional `file --mime-type` magic detection for unknowns
+- **Fastest possible navigation** — hint numbers (1–9, 0) open rows directly; TAB pages hints beyond the first ten
+- **Default `[/]:search` in popups** — command and history popups open in search mode: start typing to distill the list down to the matches, then press a number hint to pick from the few remaining results. The listing itself searches the same way
+- **Mouse support** — click a row to open it with its default action; the mouse wheel scrolls the listing (pointer-only mode is planned)
+- **Command execution modes** — commands run in one of four ways, chosen by prefix: `|` status line, `=` text viewer, `+` new terminal window, `!` Ruby eval; per-MIME-type command sets with `%name`, `%dir`, `%file`, `%str` substitution
+- **Customizable column views** — view columns run shell commands with `%name` substitution (content preview, char/word/line counts, type info, disk usage, man-page descriptions)
+- **Directory and command history with a frequency counter** — entries stored as `[count, entry]` pairs, most-used first then most-recent; `frequency_limit` controls how many frequent entries lead the list
+- **Shell history import** — on first run, `~/.bash_history` and `~/.zsh_history` are validated, alias-resolved, and merged into the command history; directory paths referenced by those commands are collected into the directory history
+- **Power browsing** — recursive directory listing, `execute` ($PATH browser), marking, filtering, sorting, and switchable column views
+- **Fully documented configuration** — a self-documenting `config.yaml` covers colors, commands, views, history, and terminal settings
 
 ## Installation
 
@@ -42,6 +59,7 @@ filecon [directory]
 - `f` — Filter view
 - `r` — Reset view
 - `R` — Recursive file listing
+- `/` — Search the listing by name
 
 **Marking**
 - `m` — Mark file
@@ -58,25 +76,40 @@ filecon [directory]
 - Enter — Select / confirm
 - Esc — Quit
 
+### Mouse
+
+Click a row to open it with its default action; the mouse wheel scrolls the listing. Mouse reporting is enabled automatically when Filecon starts.
+
+### Popups and search
+
+Command and history popups open in `/` search mode. Type a few characters to **distill** the list down to the matching entries; when only a handful remain, press the number hint of the one you want. Large lists can be narrowed in a keystroke or two. The main listing searches the same way when you press `/`.
+
 ### Configuration
 
-Config is stored at `~/.config/filecon/config.yaml` (YAML format) and includes:
+Config is stored at `~/.config/filecon/config.yaml` (YAML). On first run the bundled, fully documented `config.yaml` is copied there. It includes:
 
-- Color settings (named colors, 8-bit palette, RGB triplets)
-- Command definitions per MIME type
-- View configurations
+- Color settings (named colors, 8-bit palette, RGB triplets) — including the `colors.commands` pair used by the command picker and status line
+- Command definitions per MIME type, with execution-mode prefixes
+- View configurations (columns that run shell commands)
 - History limits and terminal settings
 
-**Command prefixes:**
+State and history files live under `~/.local/share/filecon/`.
 
-- `|` — pipe output to status line
+**Command execution modes:**
+
+- `|` — pipe output to the 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.
+See `filecon(1)` for the full manual.
+
+## Roadmap
+
+- **Pointer-only mode** — full mouse-driven operation of the entire interface, building on the click/wheel mouse support already present
+- **Interactive shell** — a separate command-building program that combines with Filecon into an interactive shell competing with interactive CLI shells
 
 ## Development
 

data/config.yaml

@@ -148,7 +148,8 @@ commands:
     shell: "+$SHELL -c 'cd %name && exec $SHELL'"
     # zsh: "+zsh -c 'cd %name && exec zsh'"
     disk_use: "|du -hs %name | cut -wf1"
-    
+    play: "+mpv %name"
+
   text:
     view: "+moor %name"
     edit: "+micro %name"

data/lib/filecon/version.rb

@@ -1,3 +1,3 @@
 module Filecon
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

data/lib/filecon.rb

@@ -329,6 +329,14 @@ class Filecon::App < Typr::Browser
       next unless key
       case key
         when KEY_ESCAPE; exit
+        when Typr::Mouse
+          if key.wheel? and key.press?
+            send( key.wheel_up? ? @keymap[:up] : @keymap[:down] )
+          elsif key.press? and key.left?
+            id = hit( key.y, key.x )
+            open_file( id, true ) if id.is_a? Integer
+          end
+          @user.reset
         else
           id = send( key )
           open_file( id, true) if id.is_a? Integer

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: filecon
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Kilian Reitmayr
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: unicode-display_width
   requirement: !ruby/object:Gem::Requirement