rtfm-filemanager 8.0.2 → 8.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2268b6df0d2f7e4c4c3b16441b1d38c60596271205935b7718d85c279ce583d0
-  data.tar.gz: 6900af4ed1b6b7ff9be6d6d62dc688c62f937dd752bc9a2e164b8eddca243c1b
+  metadata.gz: 65a65b423798385788eb367824c259a5c06afe6fdb758236c1251392d25a3a9c
+  data.tar.gz: 85ffe85ecc519a3ed161895a1c3acbb75abca292a406a91006867beb2094aca0
 SHA512:
-  metadata.gz: 45bc4528912e89d2002139c15c80b214b4824aaa0113f49269ed390bafb15c8a065a4602346abef6bd7163876b8e9d432784d5678d22b88184c48de5fbe33398
-  data.tar.gz: cb124815c4ace418b44d82f2bfadca9b1d7dec1b65d46beddc9c77009ccb5d21eea9b0e88fc2d98522935c7622d7187fe8ce28472ff3af1cc13e636cb5a80f12
+  metadata.gz: 42e385ba69a21ab5f4460c83033c1fa78f18fd0bbf2cbd9efb08288481ea3a11ea6cd79211e5299b2a09acf0c35b19c8d1ed661c354c3c28651e99063e5b66a7
+  data.tar.gz: e3d90244aa51ec34abbfabf044eb5cb51326ee3c264884dc9effbfbe4cc2d4ac99cc0f6174824600c55e02dc3173f2ec229c23889b5e39fd74578abd2a922399

data/CHANGELOG.md

@@ -5,6 +5,16 @@ 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.1] - 2026-03-12
+
+### Fixed
+- **Right pane text not showing over images or file previews** - Fixed monkey-patched `say` method so pane refresh always draws, regardless of prior update state. Also added `clear_image` calls to marks, recent files, file properties, AI description, chat mode, command history, and SSH history
+
+## [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.2' # 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
@@ -134,6 +134,7 @@ module Rcurses
     # Restore original say method override for compatibility
     alias original_say say
     def say(text)
+      self.update = true
       original_say(text)
       self.update = false
     end
@@ -825,9 +826,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 +1217,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 +1229,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
@@ -1886,6 +1903,7 @@ def track_directory_access(dir_path) # {{{3
 end
 
 def show_recent_files # {{{3
+  clear_image
   text = "Recently Accessed Files and Directories\n".b.fg(156)
   text << "=" * 40 + "\n\n"
   
@@ -1959,8 +1977,9 @@ end
 
 # FILE PROPERTIES {{{2
 def show_file_properties # {{{3
+  clear_image
   return unless @selected && File.exist?(@selected)
-  
+
   begin
     stat = File.stat(@selected)
     text = "File Properties: #{File.basename(@selected)}\n".b.fg(156)
@@ -4502,6 +4521,7 @@ def hash_directory # {{{3
 end
 
 def openai_description # {{{3
+  clear_image
   begin
     require 'ruby/openai'
   rescue LoadError
@@ -4541,6 +4561,7 @@ def openai_description # {{{3
 end
 
 def chat_mode # {{{3
+  clear_image
   unless defined?(OpenAI) && @ai && !@ai.empty?
     @pB.say("To make OpenAI work in RTFM, run `gem install ruby-openai` and add to ~/.rtfm/conf:\n  @ai = 'your-secret-openai-key'")
     return
@@ -5092,11 +5113,13 @@ def command_mode # {{{3
 end
 
 def show_history # {{{3
+  clear_image
   @pR.say("Command history:\n\n" + @pCmd.history.reverse.join("\n"))
   @pB.update = true
 end
 
 def show_ssh_history # {{{3
+  clear_image
   history_text = "SSH Connection History\n".b.fg(156)
   history_text << "=" * 50 + "\n\n"
   
@@ -6038,6 +6061,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 +6205,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 +6263,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 +6319,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
@@ -6574,6 +6636,7 @@ def showimage(image) # SHOW THE SELECTED IMAGE IN THE RIGHT WINDOW {{{2
 end
 
 def marks_info # SHOW MARKS IN RIGHT WINDOW {{{2
+  clear_image
   @marks = @marks.sort.to_h
   info = "Directory Marks".b.fg(156) + "\n"
   info << "=" * 50 + "\n\n"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rtfm-filemanager
 version: !ruby/object:Gem::Version
-  version: 8.0.2
+  version: 8.1.1
 platform: ruby
 authors:
 - Geir Isene
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-08 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