filecon 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b254f6b7438d2e85fe743aacb1a2b5946b6b6ab855cb86259ed12a48b6c7e7f9
+  data.tar.gz: 7c38a7b9c191511d5684def2b6ef312e5d3aef5d37c5b38a22d82654dea96508
+SHA512:
+  metadata.gz: 86fcec1e7a0c0d7d0a77838fc91acdfcb89d81536ea58f348de75cb881fa9e6609e685aaffc8f2d52fa8f3641b1e2af4c6b1a222828e05ca8380c4f82c9a9f61
+  data.tar.gz: 67bff21259f80836d24af248434943a59b6c6803cfb1711a59b6b4cd2cefec45a045767d2b0fbfaaa5f0476c8472535cf61f7ac3b5467e7815f2b3adc379f8bb

data/bin/filecon

@@ -0,0 +1,31 @@
+#!/usr/bin/ruby
+
+begin
+  require "filecon"
+rescue LoadError
+  require_relative "../lib/filecon"
+end
+
+Filecon.setup_config
+
+begin
+  config = Filecon.config
+  term = config[:term] || ENV["TERM"] || ""
+  term_hold = term + (config[:term_hold] || " --hold")
+  Typr.init( color: config[:colors][:default] )
+  Typr.clear
+  Filecon::App.new( right: -1, bottom: -1,
+    dir_history: File.read(Filecon.dir_history_path).split($/),
+    cmd_history: File.read(Filecon.cmd_history_path).split($/),
+    directory: ARGV.first, keymap: { open_file: ?o, cmd_history: ?c },
+    colors: { cmd_history: :red }.merge( config[:colors] || {} ),
+    views: config[:views] || {},
+    commands: config[:commands] || {},
+    term: term,
+    term_hold: term_hold ).fly
+rescue => e
+  File.write File.join(Dir.tmpdir, "filecon_error.log"),
+    "#{e.class}: #{e.message}\n#{e.backtrace.first(10).join("\n")}"
+ensure
+  Typr.exit
+end

data/config.rb

@@ -0,0 +1,91 @@
+
+term:       ENV["TERM"],
+term_hold:  ENV["TERM"] + ' --hold',
+max_history: 100,
+
+#########################################################################
+#
+# COLORS
+# 
+# standard colors:  black red green yellow blue magenta cyan white grey
+# grey shades: grey with percentage ( e.g. :grey62 for 62% grey )
+# 8bit color: 0 - 255
+# rgb values: [ 0-255, 0-255, 0-255 ]
+#
+#########################################################################
+
+colors: { 
+  types: {
+      default: [ :white, :black ],
+        image: :blue,  
+        audio: :green,
+        video: :cyan,
+    directory: :yellow,
+ 'x-pie-executable': :red
+  }
+},
+
+#########################################################################
+#
+# COMMANDS
+#
+# execution type:
+#
+# | output in status line 
+# = output in text space
+# + run in new terminal 
+# ! ruby code evaluation
+#
+# substitutions:
+#
+# %name - selected file name
+# %dir - pick a directory
+# %file - pick a file
+# %str - read string
+#
+########################################################################
+
+commands: {
+#  default: { copy: 'cp %s %s' },#, move: 'mv %s %s' }, 
+   # default:{    list: '!Grid.new({input: %w[%name] }).pick', open: '|xdg-open', 
+   default:{    open: '|xdg-open %name', diskuse: '|du -hs %name',
+                info: '=file %name',   copy: '+rsync --progress %name %dir',
+                move: '|mv %name %dir', delete: '|rm %name '  },
+ directory:{      cd: '!cd %name ' }, 
+      text:{    view: '+less %name',   edit: '+micro %name', 
+               count: '|wc -l %name' },
+      troff: { manual: '+man %name' },
+  "x-ruby":{     run: '+ruby %name' },
+      html:{terminal: '+w3m %name',graphics: '|vimb %name' },
+     image:{    play: '|mpv %name' }, 
+     video:{    play: '|mpv %name' },
+     audio:{    play: '|mpv %name' },
+       pdf:{    view: '|mupdf %name' },
+       # epub: :pdf
+  'x-pie-executable':{ run: '|%name', run_terminal: '+%name', 
+  help: '=%name --help', manual: '+man %name' }
+},
+
+#######################################################################
+#
+# VIEWS
+#
+# system infos : 
+#  target permissions owner group size accessed modified created type subtype
+#
+######################################################################
+
+views: {
+#  detail_ls: { ls: '|ls -l %s' },
+#  mimetypes: { type: '!type', subtype: '!subtype' },
+#  type_detail: { info: %w[ size access ], type: '|file -b %s' },
+  # type_detail:{ size: :size, type: '|file -b %name' },
+   content:{  content: '|head -n 50 %name' },
+  filetype:{  type: true, subtype: true, description: '|file -b %name' },
+     lines:{  lines: '|wc -l %name' },
+
+  # content:{  content: '!`head -n 50 %name `.gsub $/, ?|' },
+    whatis:{    whatis: #'|whatis %name' }
+    '!open(\'|whatis %name 2>&1\').read.match(/[-:]\s(.*)$/)[1] ' }
+    # "!open(\"|whatis %name 2>&1\").read.match(/[-:]\s(.*)$/)[1] " }
+}

data/config.yaml

@@ -0,0 +1,176 @@
+# =============================================================================
+# Filecon Configuration
+# =============================================================================
+#
+# This is the default configuration file for Filecon, a terminal file manager.
+# Copy this file to ~/.config/filecon/config.yaml and customize as needed.
+#
+# All settings are optional. Filecon will use sensible defaults if values
+# are not specified.
+#
+# =============================================================================
+
+# Terminal settings
+# -----------------
+# The terminal emulator to use for Filecon's interface.
+# Defaults to $TERM environment variable if not set.
+# term: "kitty"
+
+# Suffix appended to term for opening files in a new window.
+# Example: if term is "foot", term_hold becomes "foot --hold"
+term_hold: " --hold"
+
+# Maximum number of history entries to retain.
+# Older entries beyond this limit are automatically pruned.
+max_history: 100
+
+
+# =============================================================================
+# COLORS
+# =============================================================================
+#
+# Customize the color scheme for different file types in the browser view.
+#
+# Color values can be:
+#   - Named colors:  black, red, green, yellow, blue, magenta, cyan, white, grey
+#   - Grey shades:   grey0 through grey100 (e.g., grey62 for 62% grey)
+#   - 8-bit palette: 0 - 255 (maps to terminal's 256-color palette)
+#   - RGB triplets:  [0-255, 0-255, 0-255] (true color terminals)
+#
+# Usage:
+#   Foreground color only:    "blue"
+#   Foreground + background:  ["white", "black"]
+#
+# =============================================================================
+
+colors:
+  default: ["white", "black"]
+  types:
+    image: "blue"
+    audio: "green"
+    video: "cyan"
+    directory: "yellow"
+    "x-pie-executable": "red"
+
+
+# =============================================================================
+# COMMANDS
+# =============================================================================
+#
+# Define commands available for different file types. Each file type (MIME type
+# category) maps to a set of named commands that can be executed on files of
+# that type.
+#
+# COMMAND PREFIXES (execution type):
+#
+#   |  Pipe output to status line
+#      The command's stdout is displayed in the status bar at the bottom.
+#      Example: "|wc -l %name" shows line count in status
+#
+#   =  Display output in text area
+#      The command's output replaces the file listing with a text view.
+#      Example: "=file %name" shows file info in the text area
+#
+#   +  Run in new terminal window
+#      Opens a new terminal window to run the command.
+#      Example: "+less %name" opens a pager in a new window
+#
+#   !  Evaluate as Ruby code
+#      The command string is evaluated as Ruby code.
+#      Example: "!cd %name" executes Ruby's cd command
+#
+# SUBSTITUTION VARIABLES:
+#
+#   %name  - Path(s) to selected file(s)
+#            Single file: "/path/to/file.txt"
+#            Multiple: "/path/to/file1" "/path/to/file2"
+#
+#   %dir   - Opens directory picker, inserts chosen path
+#
+#   %file  - Opens file picker, inserts chosen path
+#
+#   %str   - Prompts for text input, inserts the string
+#
+# =============================================================================
+
+commands:
+  default:
+    open: "|xdg-open %name"
+    diskuse: "|du -hs %name"
+    info: "=file %name"
+    copy: "+rsync --progress %name %dir"
+    move: "|mv %name %dir"
+    delete: "|rm %name"
+
+  directory:
+    cd: "!cd %name"
+
+  text:
+    view: "+less %name"
+    edit: "+micro %name"
+    count: "|wc -l %name"
+
+  troff:
+    manual: "+man %name"
+
+  "x-ruby":
+    run: "+ruby %name"
+
+  html:
+    terminal: "+w3m %name"
+    graphics: "|vimb %name"
+
+  image:
+    play: "|mpv %name"
+
+  video:
+    play: "|mpv %name"
+
+  audio:
+    play: "|mpv %name"
+
+  pdf:
+    view: "|mupdf %name"
+
+  "x-pie-executable":
+    run: "|%name"
+    run_terminal: "+%name"
+    help: "=%name --help"
+    manual: "+man %name"
+
+
+# =============================================================================
+# VIEWS
+# =============================================================================
+#
+# Define custom column views for the file browser. Each view is a named
+# configuration that adds computed columns to the file listing.
+#
+# View values can be:
+#   - true     Use the built-in column for this field
+#   - A string A shell command to execute (with %name substitution)
+#   - A symbol Reference to a system field (e.g., :size, :type, :subtype)
+#
+# Available system fields:
+#   target, permissions, owner, group, size,
+#   accessed, modified, created, type, subtype
+#
+# When a view is activated, its columns are appended to the default file
+# listing, providing additional information about each file.
+#
+# =============================================================================
+
+views:
+  content:
+    content: "|head -n 50 %name"
+
+  filetype:
+    type: true
+    subtype: true
+    description: "|file -b %name"
+
+  lines:
+    lines: "|wc -l %name"
+
+  whatis:
+    whatis: "!open('|whatis %name 2>&1').read.match(/[-:]\\s(.*)$/)[1]"

data/filecon.1

@@ -0,0 +1,171 @@
+.TH FILECON 1 "2026-07-26" "filecon" "User Commands"
+.SH NAME
+filecon \- interactive terminal file manager with speed-typing navigation
+.SH SYNOPSIS
+.B filecon
+.RI [ directory ]
+.SH DESCRIPTION
+.B filecon
+is a terminal-based file manager built on top of the
+.B typerspeed
+Ruby library. It displays directory entries in a grid with columns for name,
+symlink target, permissions, owner, group, size, timestamps, and MIME type.
+Directories appear first in yellow; files are colored by MIME type.
+.PP
+Navigation is done by typing hint characters (1\-9, 0) displayed at the
+start of each row, enabling fast keyboard-only operation.
+.SH OPTIONS
+.TP
+.I directory
+Starting directory to browse. Defaults to the current working directory.
+.SH NAVIGATION KEYS
+.TP
+.B h
+Show help
+.TP
+.B r
+Reset view (clears filters and sorts)
+.TP
+.B d
+Open directory history picker
+.TP
+.B m / M
+Mark row / mark range
+.TP
+.B a / i
+Mark all files / invert selection
+.TP
+.B v
+Switch column view
+.TP
+.B s
+Sort by column
+.TP
+.B f
+Filter rows
+.TP
+.B R
+Recurse directory tree
+.TP
+.B `
+Navigate to root directory
+.TP
+.B ~
+Navigate to home directory
+.TP
+.B Return
+Confirm: cd into directories or open files
+.TP
+.B Escape
+Quit
+.SH FILECON KEYS
+.TP
+.B o
+Open file with configured command (prompts command picker if multiple match)
+.TP
+.B c
+Browse command history
+.SH COMMANDS
+Commands are triggered by the [o]pen action on a file. The command executed
+depends on the file's MIME type and subtype. If multiple commands match the
+file type, a picker is shown.
+.SS Command Prefixes
+.TP
+.B |
+Internal execution (output piped to a viewer within the UI)
+.TP
+.B +
+Terminal execution (spawns an external terminal program, e.g. mpv, nano)
+.TP
+.B !
+Ruby code evaluation (result displayed in UI)
+.SH CONFIGURATION
+On first run, the default
+.B config.rb
+is copied from the installation directory to
+.BR ~/.config/filecon/ .
+.SS Config File Locations
+.TP
+.B ~/.config/filecon/config.rb
+Main configuration (colors, commands, views, term)
+.TP
+.B ~/.config/filecon/dir_history
+Directory navigation history
+.TP
+.B ~/.config/filecon/cmd_history
+Command execution history
+.SS Command Substitutions
+.TP
+.B %name
+Selected file name(s), quoted and space-separated
+.TP
+.B %dir
+Prompt to pick a directory
+.TP
+.B %file
+Prompt to pick a file
+.TP
+.B %str
+Prompt for a text string (line input)
+.SH CONFIGURATION EXAMPLES
+.nf
+colors: {
+  types: {
+    directory: :yellow,
+    image: :blue,
+    video: :cyan,
+    audio: :green,
+    text: 146,
+    'x-pie-executable': :red
+  }
+}
+
+commands: {
+  default: { info: '|file %name', copy: '+rsync --progress %name %dir' },
+  text:    { view: '+less %name', edit: '+nano %name' },
+  html:    { terminal: '+w3m %name', graphics: '|vimb %name' },
+  image:   { play: '|mpv %name' },
+  video:   { play: '|mpv %name' },
+  pdf:     { view: '|mupdf %name' },
+  'x-pie-executable': { run: '|%name', run_terminal: '+%name',
+                         help: '+%name --help', manual: '+man %name' }
+}
+
+views: {
+  content: { content: '|head %name' },
+  whatis:  { whatis: "!open('|whatis %name 2>&1').read.match(...)..." }
+}
+.fi
+.SH VIEWS
+Column views control which fields are shown for each file entry.
+.TP
+.B content
+Displays first lines of file content via head(1)
+.TP
+.B whatis
+Shows man page description via whatis(1)
+.PP
+Custom views can be defined in config.rb by adding entries to the views hash.
+.SH ENVIRONMENT
+.TP
+.B TERM
+Terminal type used for curses initialization.
+.TP
+.B HOME
+Used to resolve ~ and config directory path (~/.config/filecon/).
+.SH FILES
+.TP
+.I ~/.config/filecon/
+Configuration and history directory
+.SH SEE ALSO
+.BR mpv (1),
+.BR less (1),
+.BR nano (1),
+.BR file (1),
+.BR rsync (1),
+.BR whatis (1),
+.BR typr (1)
+.SH AUTHOR
+Part of the Typerspeed ecosystem.
+.SH LICENSE
+GPL-2.0-only

data/lib/filecon/version.rb

@@ -0,0 +1,3 @@
+module Filecon
+  VERSION = "0.1.0"
+end

data/lib/filecon.rb

@@ -0,0 +1,169 @@
+require "fileutils"
+require "open3"
+require "yaml"
+
+begin
+  require_relative "../../typr/lib/typr"
+rescue LoadError
+  require "typr"
+end
+
+require_relative "filecon/version"
+
+module Filecon
+  PATH = File.join(ENV["HOME"], ".config/filecon/")
+
+  def self.dir_history_path
+    File.join(PATH, "dir_history")
+  end
+
+  def self.cmd_history_path
+    File.join(PATH, "cmd_history")
+  end
+
+  def self.setup_config
+    FileUtils.mkpath PATH unless File.exist? PATH
+    FileUtils.cp File.join(__dir__, "../config.yaml"), PATH unless File.exist? File.join(PATH, "config.yaml")
+    FileUtils.touch dir_history_path
+    FileUtils.touch cmd_history_path
+  end
+
+  def self.deep_symbolize_keys(obj)
+    case obj
+    when Hash
+      obj.each_with_object({}) { |(k, v), h| h[k.to_sym] = deep_symbolize_keys(v) }
+    when Array
+      obj.map { |v| deep_symbolize_keys(v) }
+    else
+      obj
+    end
+  end
+
+  def self.config
+    config_path = File.join(PATH, "config.yaml")
+    if File.exist?(config_path)
+      deep_symbolize_keys(YAML.safe_load(File.read(config_path), permitted_classes: [Symbol]))
+    else
+      {}
+    end
+  end
+end
+
+class Filecon::App < Typr::Browser
+  include Typr
+
+  def cd dir, append=false; super
+    File.write Filecon.dir_history_path,
+    	@dir_history[0..Filecon.config["max_history"]].join($/)
+    return
+  end
+
+  def switch_to id=nil
+    return unless id
+    id = @views.keys[id] if id.is_a? Integer
+    view = @views[id]
+    return super if view.is_a? Array
+    data = @data.map.with_index{ |row, id| row + view.values.map{ |cmd|
+      run( build cmd, id ).read(width).to_s.scrub.gsub(/[\n\t]/, ?|) if
+        cmd.is_a?(String) }.compact }
+    @sequence = [ NAME ] + view.keys.map{ |head|
+      @header.index(head.to_s) || (@header += [head.to_s]; @header.count-1) }
+    clear
+    self << data
+    @current = id
+  end
+
+  def open_file id=nil, default=false
+    return unless id ||= @selected[:rows].empty? ?
+      @user.ask( open:[self, :row] ) : @selected[:rows]
+    types = if id.is_a? Array
+      eval id.map{ |id| @data[id].values_at(SUBTYPE,TYPE).to_s }.join(?&)
+    else @data[id].values_at(SUBTYPE, TYPE)
+    end - [??] + [:default]
+
+    commands = @commands.values_at( *types.map(&:to_sym) ).map(&:to_a).flatten 1
+    cmd = if default; commands.first.last
+    else move left+1,top+1
+      if id.is_a?(Array); show "#{id.count.to_s} files: (#{ 
+        types.join ?, })".ljust width
+      else print id end
+      return unless cmd = Grid.new( left:1, top:3, right: -1,
+      input:commands, border: :light, format: [:min, :max],
+      borders: { top: nil }, alternate: false,
+      colors: {columns: [:green, :red] }  ).pick( :row )
+      commands[ cmd ].last
+    end
+    cmd = build cmd, id
+    if cmd.start_with? ?|
+      fork { io = run( cmd, true )
+        until io.eof?
+          @user.draw io.readline.strip.scrub
+          sleep 0.1
+        end
+      }
+    else run( cmd, cmd[0..2] != '!cd' ) end
+    draw
+  end
+
+  def build str, id
+    cmd = ""
+    while str[/\%(name|dir|file|str)/]
+      @user.draw( cmd += $` )
+      case $&
+        when '%name'; cmd += ?"+( id.is_a?( Array ) ? id.map{ |id|
+          @directory + @data[id][NAME] }.join('" "') :
+          @directory + @data[id][NAME] )+?"
+        when '%dir';  cmd += ?"+(pick :directory)+?"
+        when '%file'; cmd += ?"+(pick :file)+?"
+        when '%str';  cmd += Typr.read :line
+      end
+      str = str[($`+$&).size..-1]
+    end
+    cmd += $' || str
+    return cmd
+  end
+
+  def run cmd=nil, store=false
+    return unless cmd
+    cmd = @cmd_history[cmd] if cmd.is_a? Integer
+    case cmd[0]
+      when ?! then io = StringIO.new eval( cmd[1..-1] ).to_s
+      when ?| then io = open( cmd + " 2>&1" )
+      when ?+ then io = open( ?| + @term +' '+ cmd[1..-1] + " 2>&1" )
+      when ?= then Text.new(top: 2, right:-1, bottom:-2, border: :light,
+        input:open( ?|+cmd[1..-1]+" 2>&1" ) ).pick :none
+    end
+    if store
+      @cmd_history.unshift cmd
+      @cmd_history.uniq!
+      File.write Filecon.cmd_history_path, @cmd_history[0..Filecon.config["max_history"]].join($/)
+    end
+    return io
+  end
+
+  def cmd_history; run popup( { input: @cmd_history, align:[:left], left:left,
+    colors: { columns: [ @colors[:cmd_history] ] } } ).pick(:row), true
+  end
+
+  def initialize args={}
+    super
+    @user.bindings.insert 1, "[o]pen"
+    @user.bindings.insert 7, "[c]ommands"
+    @user.draw
+  end
+
+  def fly
+    loop do
+      draw
+      draw_hints :rows
+      key = Typr.read :key
+      @user.reset
+      case key
+        when KEY_ESCAPE; exit
+        else
+          id = send( key )
+          open_file id, true if id.is_a? Integer
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification
+name: filecon
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kilian Reitmayr
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-07-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: typr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: unicode-display_width
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A terminal-based file manager with customizable views, commands, and
+  MIME-type based file operations, built on the Typr terminal UI toolkit.
+email:
+- reitmayr@protonmail.com
+executables:
+- filecon
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/filecon
+- config.rb
+- config.yaml
+- filecon.1
+- lib/filecon.rb
+- lib/filecon/version.rb
+homepage: https://github.com/kilianh/filecon
+licenses:
+- GPL-2.0-only
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.15
+signing_key:
+specification_version: 4
+summary: Terminal file manager built on Typr
+test_files: []