rtfm-filemanager 8.0.1 → 8.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34e1069fa8b9c2a587f6216f06a98ae9a68feb1290898bf45a8a991063cef65f
-  data.tar.gz: d90988e37f5bd7910929e66207d8862af8ba2307b2ab0abc214f5317faf3907a
+  metadata.gz: f1ec26a45d5adbaeb2aeb253b7078c255ae40bdc6aebb45f26234f0ba28c89de
+  data.tar.gz: 4aeaf423db737eb9956e22f53eea0f6e8b02cbff48c62b92b13834932074bc54
 SHA512:
-  metadata.gz: 2096032a084f6851ae1ffdd87a72a96469b3239e605af345f8a8e4a4aa08e8b781640a25465518c1139127e764b9d78e504b581e137810124a6d952739a3a5e0
-  data.tar.gz: 6a07bab823af11d303d7ef8ff92699f6145f68350dcf0471107c9f9ffb4e844614485d4e80c573680533c3800b0018712c8a6c2e4692aba30232ff24cf567a63
+  metadata.gz: 7df8b94d058bd3c169cf08d59b81a1cb1ceb0c26f21617d57e04c89083317200f88f6aae9164fc7a1dc1d546a08a07c49861dc2fcdf7bf54ca30aaa868d42602
+  data.tar.gz: 4cbd8be47ef2ee06285e1fcf89a03d01a44524070c5019c6c6491a50416677a053d42476769919702462b0c4780245a4d579fc72003b61bebeca15fa3f144328

data/CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to RTFM will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [8.1.0] - 2026-03-12
+
+### Added
+- **File picker mode** (`--pick`) - Launch RTFM as a file picker for other applications. Tag files with `t`, quit with `q`, and the tagged file paths are written to the specified output file. Usage: `rtfm --pick=/path/to/output.txt [start_directory]`
+
 ## [8.0.1] - 2026-03-07
 
 ### Changed

data/README.md

@@ -22,6 +22,9 @@ rtfm
 # Or start in specific directory
 rtfm ~/Documents
 
+# Use as file picker (tag files with t, quit with q)
+rtfm --pick=/tmp/selected_files.txt
+
 # Press ? for help
 ```
 
@@ -84,6 +87,7 @@ After first run, use `r` command to launch RTFM and exit into your current direc
 - **Cryptographic hashing** - Directory tree verification
 - **OpenAI integration** - File descriptions and interactive chat
 - **Tab management** - Multiple tabs with duplication and renaming
+- **File picker mode** - Use RTFM as a file selector for other applications (`--pick`)
 - **Fuzzy search** - fzf integration
 - **Navi integration** - Interactive command cheatsheets
 
@@ -646,6 +650,10 @@ Best image experience with: kitty, urxvt, xterm, mlterm, foot
 
 ## Latest Updates
 
+### Version 8.1 Highlights
+
+- **File picker mode** - `rtfm --pick=/path/to/output.txt` launches RTFM as a file selector. Browse and tag files normally with `t`, then quit with `q`. Tagged file paths are written one per line to the output file. Enables integration with email clients, upload tools, and other applications that need a file selection dialog.
+
 ### Version 7.3 Highlights
 
 - **Modern image display** with termpix gem (Sixel + w3m protocols)

data/bin/rtfm

@@ -18,7 +18,7 @@
 #             get a great understanding of the code itself by simply sending
 #             or pasting this whole file into you favorite AI for coding with
 #             a prompt like this: "Help me understand every part of this code".
-@version    = '8.0.1' # Archive browsing, async file ops, scrollable diff viewer
+@version    = '8.1.0' # File picker mode (--pick) for integration with other tools
 
 # SAVE & STORE TERMINAL {{{1
 ORIG_STTY = `stty -g`.chomp
@@ -825,9 +825,22 @@ rescue StandardError => e
   errormsg("⚠ Errors while loading #{CONFIG_FILE}\nCheck your config file or delete it to remake in a fresh RTFM start.", e)
 end
 load_config
+# Load persisted width setting if it exists
+width_file = File.join(RTFM_HOME, 'width')
+if File.exist?(width_file)
+  saved_width = File.read(width_file).strip.to_i
+  @width = saved_width if saved_width >= 2 && saved_width <= 7
+end
 @marks['0']  = Dir.pwd # Original dir
 @marks["'"]  = Dir.pwd # Initial mark
 
+# File picker mode: --pick=/path/to/output writes tagged files on quit
+@pick_output = nil
+if (pick_arg = ARGV.find { |a| a.start_with?('--pick=') })
+  @pick_output = pick_arg.split('=', 2).last
+  ARGV.delete(pick_arg)
+end
+
 # Handle start dir {{{2
 Dir.chdir(ARGV.shift) if ARGV[0] && File.directory?(ARGV[0])
 
@@ -1203,7 +1216,10 @@ end
 def change_width # {{{3
   @width += 1
   @width = 2 if @width == 8
-  
+
+  # Persist width setting
+  File.write(File.join(RTFM_HOME, 'width'), @width.to_s) rescue nil
+
   if @dual_pane
     # Show width setting info for dual-pane mode using the new ratio calculation
     dir_panes_ratio = [0.5 - (@width - 2) * 0.034, 0.33].max
@@ -1212,7 +1228,7 @@ def change_width # {{{3
   else
     @pB.say("Width: #{@width}")
   end
-  
+
   refresh
   @pL.update = @pR.update = @pT.update = @pB.update = true
   # Also update dual-pane objects if they exist
@@ -2564,9 +2580,9 @@ end
 def render_side_by_side(lines1, lines2, name1, name2, offset, page_height) # {{{3
   half_width = (@pR.w - 7) / 2
   half_width = [half_width, 10].max
-  text = "\n"
-  text << sprintf("  %-#{half_width}s | %s\n", name1[0, half_width], name2[0, half_width]).fg(226)
-  text << "  " + "-" * half_width + "-+-" + "-" * half_width + "\n"
+  text = +"\n"
+  text << sprintf("  %-#{half_width}s \u2502 %s\n", name1[0, half_width], name2[0, half_width]).fg(226)
+  text << "  " + "\u2500" * half_width + "\u2500\u253C\u2500" + "\u2500" * half_width + "\n"
 
   max_lines = [lines1.size, lines2.size].max
   end_line = [offset + page_height, max_lines].min
@@ -2577,7 +2593,7 @@ def render_side_by_side(lines1, lines2, name1, name2, offset, page_height) # {{{
     same = lines1[i] == lines2[i]
     color = same ? 240 : (lines1[i].nil? ? 156 : (lines2[i].nil? ? 196 : 226))
 
-    text << sprintf("  %-#{half_width}s | %s\n", l1, l2).fg(color)
+    text << sprintf("  %-#{half_width}s \u2502 %s\n", l1, l2).fg(color)
   end
 
   text
@@ -6038,6 +6054,42 @@ def mark_latest # UPDATE MARKS LIST {{{2
   @marks["'"] = Dir.pwd
 end
 
+def mailcap_command(file_path) # FIND VIEWER VIA ~/.mailcap {{{2
+  # Detect MIME type
+  mime_type = IO.popen(['file', '--brief', '--mime-type', file_path]) { |f| f.read.strip }
+  return nil if mime_type.nil? || mime_type.empty?
+
+  # Search mailcap files in order of preference
+  mailcap_files = [File.join(Dir.home, '.mailcap'), '/etc/mailcap']
+  mailcap_files.each do |mc_file|
+    next unless File.exist?(mc_file)
+    File.foreach(mc_file) do |line|
+      line = line.strip
+      next if line.empty? || line.start_with?('#')
+      # Handle continuation lines (trailing backslash)
+      # For simplicity, skip multi-line entries
+      next if line.end_with?('\\')
+      parts = line.split(';').map(&:strip)
+      next if parts.length < 2
+      pattern = parts[0]
+      command = parts[1]
+      flags = parts[2..].join(';')
+      # Skip entries with copiousoutput (meant for text dump, not viewing)
+      next if flags =~ /copiousoutput/i
+      # Check if MIME type matches (supports wildcards like "image/*")
+      pattern_re = Regexp.new('^' + Regexp.escape(pattern).gsub('\\*', '.*') + '$', Regexp::IGNORECASE)
+      next unless mime_type.match?(pattern_re)
+      # Replace %s with the file path in the command
+      if command.include?('%s')
+        return command.gsub('%s', Shellwords.escape(file_path))
+      else
+        return "#{command} #{Shellwords.escape(file_path)}"
+      end
+    end
+  end
+  nil # No mailcap match found
+end
+
 def get_interactive_program(file_path) # HELPER FOR OPEN_SELECTED TO USE @interactive {{{2
   begin
     inter_list = (@interactive || '').split(',').map(&:strip)
@@ -6146,16 +6198,11 @@ def open_selected(html = nil) # OPEN SELECTED FILE {{{2
   # Use tagged items if any exist, otherwise use selected item
   paths   = @tagged.empty? ? [@selected] : @tagged
   if html # html mode - open in HTML-browser
-    esc = paths.map { |p| Shellwords.escape(p) }.join(' ')
-    shell("xdg-open #{esc} &", err: tmpfile)
-    Rcurses.clear_screen; refresh; render
-    if File.exist?(tmpfile)
-      sleep 0.5
-      err = File.read(tmpfile)
-      showimage('clear') if @image
-      @pR.say(err.fg(196))
-      File.delete(tmpfile)
+    paths.each do |p|
+      pid = Process.spawn('xdg-open', p, [:out, :err] => '/dev/null')
+      Process.detach(pid)
     end
+    Rcurses.clear_screen; refresh; render
     return
   end
   # Check if file is text (UTF-8, UTF-16, or other text encodings)
@@ -6209,21 +6256,22 @@ def open_selected(html = nil) # OPEN SELECTED FILE {{{2
     render
     return
   end
-  if @runmailcap # Open with run-mailcap or xdg-open
-    arg = paths.map { |p| Shellwords.escape(p) }.join(' ')
-    shell("run-mailcap #{arg} &", err: tmpfile)
+  # Try mailcap first, then fall back to run-mailcap or xdg-open
+  mc_cmd = mailcap_command(@selected)
+  if mc_cmd
+    pid = Process.spawn(mc_cmd, :in => '/dev/null', [:out, :err] => '/dev/null')
+    Process.detach(pid)
+  elsif @runmailcap
+    paths.each do |p|
+      pid = Process.spawn('run-mailcap', p, :in => '/dev/null', [:out, :err] => '/dev/null')
+      Process.detach(pid)
+    end
   else
-    shell("xdg-open #{Shellwords.escape(@selected)} &", err: tmpfile)
+    pid = Process.spawn('xdg-open', @selected, :in => '/dev/null', [:out, :err] => '/dev/null')
+    Process.detach(pid)
   end
   # Clean up
   Rcurses.clear_screen; refresh; render
-  if File.exist?(tmpfile)
-    sleep 0.5
-    err = File.read(tmpfile)
-    showimage('clear') if @image
-    @pR.say(err.fg(196))
-    File.delete(tmpfile)
-  end
 end
 
 def conf_write(all: false) # WRITE TO ~/.rtfm/conf {{{2
@@ -6264,6 +6312,13 @@ def conf_write(all: false) # WRITE TO ~/.rtfm/conf {{{2
 end
 
 def exit_rtfm # CLEAN EXIT {{{2
+  # Pick mode: write tagged file paths to output file
+  if @pick_output
+    begin
+      File.write(@pick_output, @tagged.join("\n") + "\n")
+    rescue StandardError
+    end
+  end
   # If invoked with a stub filename, write out our cwd
   if ARGV[0]
     begin

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rtfm-filemanager
 version: !ruby/object:Gem::Version
-  version: 8.0.1
+  version: 8.1.0
 platform: ruby
 authors:
 - Geir Isene
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-07 00:00:00.000000000 Z
+date: 2026-03-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rcurses
@@ -71,7 +71,8 @@ description: 'RTFM v8.0: Browse and modify archives as virtual directories (extr
   side-by-side mode. A full featured terminal browser with syntax highlighted files,
   images shown in the terminal, videos thumbnailed, etc. Features include remote SSH/SFTP
   browsing, interactive SSH shell, comprehensive undo system, OpenAI integration,
-  bookmarks, and much more. RTFM is one of the most feature-packed terminal file managers.'
+  bookmarks, and much more. RTFM is one of the most feature-packed terminal file managers.
+  v8.1: File picker mode (--pick) for integration with other tools.'
 email: g@isene.com
 executables:
 - rtfm