rtfm-filemanager 8.2.1 → 8.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb02bbf2f12ccc66afd6d2fbbef68f6e7a1a05f3d932e48a8143ae8df1a70d39
-  data.tar.gz: e1a1583ccab118308ecf16d898631dff1fcddedb3b46f7462ba2a8486cfad5d1
+  metadata.gz: 4ca25cd86bf46067b73bf66b33635f6e220d937ba528ab25434da99655a04e52
+  data.tar.gz: 58418e13253d8063d73114f361764cf20e04f62649ddea41ec0163abbf224af4
 SHA512:
-  metadata.gz: 8eaeb2806d03dd15601d705bc409b677cbbb3bbe08aa69a1cd8b9135bbf4b5ecfc95c8140b4c9d9e526eb4652fa9057f4102aec05058d6c94272b39027d3e33a
-  data.tar.gz: f9cb7747b1c773a2c545bb1afaa600ceff1a04d13149d9a98cae029687a37cbeccb0b330951659463fd666206104234d5ae0f6298c5cef2ff01d3950be9063ae
+  metadata.gz: 70397c9a79033585cdd6dcb7ff1bd99d5fc6f973a223e3f91cbd7c23f2534ed0c738f9ed2be6432a37e993fe115d872c36617c444844bb9f09e84510541afade
+  data.tar.gz: b346e1b4d9cadd7657eb0649e0111a83b0f2e5332c5195b13b9e82afb3a34703b293c74b934e3e1876f916780b25d085daed25306c18c23a692c4e2bb526c488

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.2.1' # Trash browser, right pane scroll fix, plugin improvements
+@version    = '8.2.3' # Replace bare rescues with typed exceptions
 
 # SAVE & STORE TERMINAL {{{1
 ORIG_STTY = `stty -g`.chomp
@@ -61,7 +61,7 @@ def check_image_redraw # {{{2
       end
     end
     # Kitty and Sixel protocols don't need redraw checks - images persist
-  rescue
+  rescue StandardError # non-fatal image redraw check
     # Silently fail - we don't want focus checking to break anything
   end
 end
@@ -682,7 +682,7 @@ def restore_tab_state # {{{2
   
   begin
     Dir.chdir(tab[:directory]) if Dir.exist?(tab[:directory])
-  rescue
+  rescue Errno::ENOENT, Errno::EACCES # permission denied or missing dir
     # If directory doesn't exist, go to home
     Dir.chdir
     tab[:directory] = Dir.pwd
@@ -910,7 +910,7 @@ if File.exist?(PREVIEW_FILE)
         @plugin_errors << "Invalid preview.rb line #{idx + 1}: #{line}"
       end
     end
-  rescue => e
+  rescue StandardError => e # malformed preview config
     @plugin_errors << "Error loading preview.rb: #{e.class}: #{e.message}"
   end
 end
@@ -1075,7 +1075,7 @@ KEYMAP = { # {{{2
 if File.exist?(KEYS_FILE)
   begin
     load KEYS_FILE
-  rescue => e
+  rescue StandardError => e # broken key binding config
     @plugin_errors << "Error loading keys.rb: #{e.class}: #{e.message}"
   end
 end
@@ -1114,7 +1114,7 @@ def load_plugin(name)
     snapshot.each { |k, v| changed[k] = v unless KEYMAP.key?(k) }
     p[:saved_keys] = changed
     p[:enabled] = true
-  rescue => e
+  rescue StandardError => e # plugin load failure
     @plugin_errors << "Error loading plugin #{name}: #{e.class}: #{e.message}"
   end
 end
@@ -1248,7 +1248,7 @@ def refresh_all # {{{3
     if new_h && new_w && new_h >= 10 && new_w >= 20
       @h, @w = new_h, new_w
     end
-  rescue
+  rescue StandardError # terminal size query failed
     # Keep current size if we can't read new size
   end
 
@@ -1346,7 +1346,7 @@ def change_width # {{{3
   @width = 2 if @width == 8
 
   # Persist width setting
-  File.write(File.join(RTFM_HOME, 'width'), @width.to_s) rescue nil
+  File.write(File.join(RTFM_HOME, 'width'), @width.to_s) rescue nil # ignore write error
 
   if @dual_pane
     # Show width setting info for dual-pane mode using the new ratio calculation
@@ -1589,7 +1589,7 @@ def jump_to_mark # {{{3
   if m =~ /[\w']/ && @marks[m]
     @directory[Dir.pwd] = @index
     dir_before = Dir.pwd
-    begin; Dir.chdir(@marks[m]); track_directory_access(@marks[m]); rescue; @pB.say(' No such directory'); end
+    begin; Dir.chdir(@marks[m]); track_directory_access(@marks[m]); rescue Errno::ENOENT, Errno::EACCES; @pB.say(' No such directory'); end
     mark_latest
     @marks["'"] = dir_before
   end
@@ -1692,7 +1692,7 @@ def follow_symlink # {{{3
       
       # Clear history after successful navigation
       @symlink_history.clear
-    rescue => e
+    rescue StandardError => e # symlink resolution failure
       @pB.say("Error following symlink: #{e}")
       @symlink_history&.clear
     end
@@ -1755,7 +1755,7 @@ def tag_current # {{{3
       else
         @tagged.push(item); @tagsize += File.size(item) rescue 0
       end
-      
+
       # Advance to next item in the active pane
       max_index = current_files.size - 1
       if @active_pane == :left
@@ -2124,7 +2124,7 @@ def show_file_properties # {{{3
       mime_output = `file --mime-type #{Shellwords.escape(@selected)} 2>/dev/null`.strip
       mime_type = mime_output.split(':')[1]&.strip || "Unknown"
       text << sprintf("  %-20s %s\n", "MIME Type:", mime_type.fg(156))
-    rescue
+    rescue StandardError # file command failed
       text << sprintf("  %-20s %s\n", "MIME Type:", "Unknown".fg(240))
     end
     
@@ -2143,7 +2143,7 @@ def show_file_properties # {{{3
       owner = Etc.getpwuid(stat.uid).name rescue stat.uid.to_s
       group = Etc.getgrgid(stat.gid).name rescue stat.gid.to_s
       text << sprintf("  %-20s %s\n", "Owner:Group:", "#{owner}:#{group}".fg(156))
-    rescue
+    rescue StandardError # uid/gid lookup failed
       text << sprintf("  %-20s %s\n", "Owner:Group:", "#{stat.uid}:#{stat.gid}".fg(156))
     end
     
@@ -2163,7 +2163,7 @@ def show_file_properties # {{{3
         target = File.readlink(@selected)
         text << sprintf("  %-20s %s\n", "Points to:", target.fg(156))
         text << sprintf("  %-20s %s\n", "Target exists:", File.exist?(target) ? "Yes".fg(156) : "No".fg(196))
-      rescue
+      rescue Errno::ENOENT, Errno::EACCES # permission denied or missing symlink target
         text << sprintf("  %-20s %s\n", "Target:", "Cannot read link".fg(196))
       end
     end
@@ -2178,7 +2178,7 @@ def show_file_properties # {{{3
         dirs = entries.select { |e| File.directory?(File.join(@selected, e)) }
         files = entries.select { |e| File.file?(File.join(@selected, e)) }
         text << sprintf("  %-20s %s\n", "Breakdown:", "#{dirs.length} directories, #{files.length} files")
-      rescue
+      rescue Errno::EACCES, Errno::ENOENT # permission denied or missing dir
         text << sprintf("  %-20s %s\n", "Contents:", "Cannot read directory".fg(196))
       end
     end
@@ -2194,7 +2194,7 @@ def show_file_properties # {{{3
           require 'digest'
           checksum = Digest::SHA256.file(@selected).hexdigest[0, 16]
           text << sprintf("  %-20s %s...\n", "SHA256 (partial):", checksum.fg(156))
-        rescue
+        rescue Errno::EACCES, Errno::ENOENT # permission denied or missing file
           text << sprintf("  %-20s %s\n", "Checksum:", "Cannot calculate".fg(240))
         end
       else
@@ -2209,7 +2209,7 @@ def show_file_properties # {{{3
                      (chunk.bytes.any? { |b| b < 32 && ![9, 10, 13].include?(b) })
           text << sprintf("  %-20s %s\n", "Content type:", is_binary ? "Binary".fg(196) : "Text".fg(156))
         end
-      rescue
+      rescue Errno::EACCES, Errno::ENOENT # permission denied or missing file
         text << sprintf("  %-20s %s\n", "Content type:", "Unknown".fg(240))
       end
     end
@@ -2578,7 +2578,7 @@ def show_binary_comparison(file1, file2, stat1, stat2) # {{{3
     text << "\n  File types:\n".fg(226)
     text << "    #{File.basename(file1)}: #{type1.split(':')[1]&.strip || 'Unknown'}\n".fg(240)
     text << "    #{File.basename(file2)}: #{type2.split(':')[1]&.strip || 'Unknown'}\n".fg(240)
-  rescue
+  rescue StandardError # file type detection failed
     # Ignore file type detection errors
   end
   
@@ -2792,7 +2792,7 @@ def files_identical?(file1, file2) # {{{3
   end
   
   true
-rescue
+rescue Errno::EACCES, Errno::ENOENT, Errno::EISDIR # permission denied or missing file
   false
 end
 
@@ -2808,7 +2808,7 @@ def binary_file?(file) # {{{3
     
     null_count > 0 || (non_printable.to_f / chunk.length) > 0.3
   end
-rescue
+rescue Errno::EACCES, Errno::ENOENT, Errno::EISDIR # permission denied or missing file
   true # Assume binary if we can't read it
 end
 
@@ -2924,7 +2924,7 @@ def parse_archive_listing(archive_path) # {{{3
     else
       parse_tar_listing(raw, entries)
     end
-  rescue => e
+  rescue StandardError => e # archive format or read error
     @pB.say("Error reading archive: #{e.message}".fg(196))
   end
   entries
@@ -3064,6 +3064,7 @@ end
 def enter_archive_mode(archive_path) # {{{3
   @archive_origin_dir = Dir.pwd
   @archive_origin_tagged = @tagged.dup
+  @archive_origin_index = @index
   @archive_mode = true
   @archive_path = archive_path
   @archive_current_dir = ''
@@ -3093,7 +3094,8 @@ def exit_archive_mode # {{{3
   @tagged = @archive_origin_tagged || []
   @archive_origin_tagged = []
   @archive_origin_dir = nil
-  @index = 0
+  @index = @archive_origin_index || 0
+  @archive_origin_index = nil
   @pB.say("Returned to local browsing".fg(156))
   @pL.update = @pR.update = @pT.update = @pB.update = true
   dirlist
@@ -3645,7 +3647,7 @@ def upload_tagged_files # {{{3
         failed_count += 1
         @pB.say("✗ Failed to upload #{File.basename(local_file)}".fg(196))
       end
-    rescue => e
+    rescue StandardError => e # upload failure
       failed_count += 1
       @pB.say("✗ Error uploading #{File.basename(local_file)}: #{e.message}".fg(196))
     end
@@ -4229,7 +4231,7 @@ def trash_browser # TRASH BROWSER {{{3
       begin
         size = File.directory?(f) ? (command("du -sb #{Shellwords.escape(f)} 2>/dev/null").split.first.to_i rescue 0) : File.size(f)
         mtime = File.mtime(f)
-      rescue
+      rescue Errno::EACCES, Errno::ENOENT # permission denied or missing file
         size = 0
         mtime = Time.at(0)
       end
@@ -4300,7 +4302,7 @@ def trash_browser # TRASH BROWSER {{{3
         end
         @pB.say("Restored: #{File.basename(dest)}".fg(156))
         sel = [sel - 1, 0].max
-      rescue => e
+      rescue StandardError => e # restore from trash failed
         @pB.say("Restore failed: #{e.message}".fg(196))
       end
     when 'd'
@@ -4880,7 +4882,8 @@ def copy_path_primary # {{{3
     path = get_selected_full_path
     if path
       copy_to_clipboard(path, 'primary')
-      @pB.say(' Path copied to primary selection (middle-click to paste)')
+      copy_to_clipboard(path, 'clipboard')
+      @pB.say(' Path copied')
     else
       @pB.say(' No selected item path to copy')
     end
@@ -4895,7 +4898,8 @@ def copy_path_clipboard # {{{3
     path = get_selected_full_path
     if path
       copy_to_clipboard(path, 'clipboard')
-      @pB.say(' Path copied to clipboard (Ctrl+V to paste)')
+      copy_to_clipboard(path, 'primary')
+      @pB.say(' Path copied')
     else
       @pB.say(' No selected item path to copy')
     end
@@ -4966,10 +4970,11 @@ def copy_right # {{{3
       @pB.say(' Failed to copy image - xclip may not be installed')
     end
   else
-    # Copy right pane text content
-    clip = 'xclip -selection clipboard'
-    @pB.say(' Right pane text copied to clipboard')
-    shell("echo -n #{Shellwords.escape(@pR.text.pure)} | #{clip} > /dev/null 2>&1", background: true)
+    # Copy right pane text content to both selections
+    escaped = Shellwords.escape(@pR.text.pure)
+    shell("echo -n #{escaped} | xclip -selection clipboard > /dev/null 2>&1", background: true)
+    shell("echo -n #{escaped} | xclip -selection primary > /dev/null 2>&1", background: true)
+    @pB.say(' Right pane text copied')
   end
 end
 
@@ -5002,9 +5007,9 @@ def system_info # {{{3
     text << sprintf("  %-15s %s\n", "Kernel:".fg(249), kernel_version.fg(156))
     text << sprintf("  %-15s %s\n", "Architecture:".fg(249), architecture.fg(156))
     text << "\n"
-  rescue # rubocop:disable Lint/SuppressedException
+  rescue StandardError # OS info unavailable
   end
-  
+
   begin
     # Hardware Information
     text << "Hardware".fg(226).b + "\n"
@@ -5033,11 +5038,11 @@ def system_info # {{{3
       temp_color = temp > 80 ? 196 : temp > 60 ? 220 : 156
       text << sprintf("  %-15s %s\n", "CPU Temp:".fg(249), "#{temp}°C".fg(temp_color))
     end
-    
+
     text << "\n"
-  rescue # rubocop:disable Lint/SuppressedException
+  rescue StandardError # hardware info unavailable
   end
-  
+
   begin
     # Memory Information with visual bar
     text << "Memory".fg(226).b + "\n"
@@ -5079,11 +5084,11 @@ def system_info # {{{3
       swap_used = (parts[2].to_i / 1024.0 / 1024.0 / 1024.0).round(1)
       text << sprintf("  %-15s %s\n", "Swap:".fg(249), "#{swap_used}/#{swap_total} GB".fg(156))
     end
-    
+
     text << "\n"
-  rescue # rubocop:disable Lint/SuppressedException
+  rescue StandardError # memory info unavailable
   end
-  
+
   begin
     # Storage Information with visual bars
     text << "Storage".fg(226).b + "\n"
@@ -5123,9 +5128,9 @@ def system_info # {{{3
       end
     end
     text << "\n"
-  rescue # rubocop:disable Lint/SuppressedException
+  rescue StandardError # storage info unavailable
   end
-  
+
   begin
     # Network Information
     text << "Network".fg(226).b + "\n"
@@ -5159,14 +5164,14 @@ def system_info # {{{3
         `curl -s ifconfig.me 2>/dev/null`.chomp
       end
       text << sprintf("  %-15s %s\n", "Public IP:".fg(249), public_ip.fg(156)) unless public_ip.empty?
-    rescue
+    rescue StandardError # timeout or network error
       # Skip public IP if timeout or error
     end
     
     text << "\n"
-  rescue # rubocop:disable Lint/SuppressedException
+  rescue StandardError # network info unavailable
   end
-  
+
   begin
     # Environment Information
     text << "Environment".fg(226).b + "\n"
@@ -5201,9 +5206,9 @@ def system_info # {{{3
     end
     
     text << "\n"
-  rescue # rubocop:disable Lint/SuppressedException
+  rescue StandardError # environment info unavailable
   end
-  
+
   begin
     # Services & Processes
     text << "Services & Processes".fg(226).b + "\n"
@@ -5244,11 +5249,11 @@ def system_info # {{{3
     text << sprintf("  %-15s %s\n", "Users:".fg(249), "#{users} logged in".fg(156))
     
     text << "\n"
-  rescue # rubocop:disable Lint/SuppressedException
+  rescue StandardError # services info unavailable
   end
-  
+
   @pR.say(text)
-rescue => e
+rescue StandardError => e # system info display failed
   @pR.say("Unable to show system info\n#{e.message}".fg(196))
 end
 
@@ -5261,7 +5266,7 @@ end
 
 def navi_invoke # {{{3
   @navi = `navi`
-rescue
+rescue StandardError # navi command not found
   @pB.say(' navi not installed - see https://github.com/junegunn/fzf')
 end
 
@@ -5460,7 +5465,7 @@ def get_cached_dirlist(dir, ls_options, ls_options_with_long = nil) # {{{2
     dir_mtime = File.mtime(dir).to_i
     file_count = Dir.entries(dir).size
     cache_key = "#{dir}:#{ls_options_with_long}:#{dir_mtime}:#{file_count}"
-  rescue
+  rescue Errno::EACCES, Errno::ENOENT # permission denied or missing dir
     return nil  # Can't cache if we can't get mtime or file count
   end
 
@@ -5488,7 +5493,7 @@ def get_cached_dirlist(dir, ls_options, ls_options_with_long = nil) # {{{2
     @dir_cache.delete_if { |key, _| key.start_with?("#{dir}:") && key != cache_key }
     
     result
-  rescue => e
+  rescue StandardError => e # ls command failed
     # Return empty result on error
     { purels: [], colorls: [] }
   end
@@ -5500,7 +5505,7 @@ def get_cached_file_metadata(file_path) # {{{2
   begin
     file_stat = File.stat(file_path)
     cache_key = "#{file_path}:#{file_stat.mtime.to_i}:#{file_stat.size}"
-  rescue
+  rescue Errno::EACCES, Errno::ENOENT # permission denied or missing file
     return nil
   end
   
@@ -5536,7 +5541,7 @@ def get_cached_file_metadata(file_path) # {{{2
     @metadata_cache.delete_if { |key, _| key.start_with?("#{file_path}:") && key != cache_key }
     
     metadata
-  rescue
+  rescue StandardError # metadata extraction failed
     nil
   end
 end
@@ -5701,7 +5706,7 @@ def dirlist(left: true, directory: nil) # LIST DIRECTORIES {{{2
       pure_output = command("ls #{Shellwords.escape(dir)} #{ls_options}")
       purels = pure_output.pure.split("\n")
       colorls = color_output.split("\n")
-    rescue => e
+    rescue StandardError => e # ls command failed
       purels = []
       colorls = []
     end
@@ -5732,7 +5737,7 @@ def dirlist(left: true, directory: nil) # LIST DIRECTORIES {{{2
     @files = purels
     # Update @selected & @fileattr for left pane
     if purels[@index]
-      @selected = Dir.pwd + '/' + purels[@index]
+      @selected = File.join(Dir.pwd, purels[@index])
       sfile = @selected.dup
       sfile += '/' if File.directory?(@selected)
       time_opt = @is_macos_bsd ? '-T' : '--time-style=long-iso'
@@ -6165,7 +6170,7 @@ def command(cmd, timeout: 5, return_both: false) # {{{2
       @pR.say(msg.fg(196))
       ''
     end
-  rescue => e
+  rescue StandardError => e # command execution failed
     msg = "Error: #{e.message}\n#{e.backtrace.join("\n")}\n"
     if return_both
       ['', msg]
@@ -6241,7 +6246,7 @@ def copy_move_link(type) # COPY OR MOVE TAGGED ITEMS {{{2
       end
 
       @file_op_result = " #{type.capitalize} complete: #{operations.size} item(s)".fg(156)
-    rescue => e
+    rescue StandardError => e # file operation failed
       @file_op_result = " #{type.capitalize} error: #{e.message}".fg(196)
     ensure
       @file_op_progress = nil
@@ -6274,7 +6279,7 @@ def copy_move_link_sync(type, items, dest_dir) # {{{3
         operations << { source_path: item, dest_path: dest }
         @pB.say(' Item(s) symlinked here.')
       end
-    rescue => e
+    rescue StandardError => e # file operation failed
       @pB.say(e.to_s)
     end
   end
@@ -6403,7 +6408,7 @@ def get_interactive_program(file_path) # HELPER FOR OPEN_SELECTED TO USE @intera
         end
       end
     end
-  rescue
+  rescue StandardError # desktop file detection failed
     # If detection fails, fall back to normal behavior
   end
   nil
@@ -6723,7 +6728,7 @@ def showcontent # SHOW CONTENTS IN THE RIGHT WINDOW {{{2
                 end
               end
             end
-          rescue => e
+          rescue StandardError => e # SVG render failed
             @pR.say("Error processing SVG: #{e}")
           end
         when /\.(?:png|jpe?g|bmp|gif|webp|tiff?)$/i
@@ -6736,7 +6741,7 @@ def showcontent # SHOW CONTENTS IN THE RIGHT WINDOW {{{2
               showimage(@selected)
               @image = true
             end
-          rescue => e
+          rescue Errno::EACCES, Errno::ENOENT => e # permission denied or missing image
             @pR.say("Error checking image size: #{e}")
           end
         when /\.(?:mpg|mpeg|avi|mov|mkv|mp4|webm|flv|wmv|m4v)$/i
@@ -6765,6 +6770,7 @@ def showcontent # SHOW CONTENTS IN THE RIGHT WINDOW {{{2
         else
           # Enhanced text file preview with partial loading for large files
           begin
+            Timeout.timeout(5) do # Prevent preview from hanging
             file_size = File.size(@selected)
             
             # For text files, we can preview them partially even if large
@@ -6779,6 +6785,7 @@ def showcontent # SHOW CONTENTS IN THE RIGHT WINDOW {{{2
                 line_count = 0
                 
                 file.each_line do |line|
+                  line = line[0, 10_000] + "...\n" if line.length > 10_000
                   lines << line
                   line_count += 1
                   break if line_count >= preview_lines
@@ -6819,25 +6826,33 @@ def showcontent # SHOW CONTENTS IN THE RIGHT WINDOW {{{2
             else
               # Small files - read entirely as before
               text = File.read(@selected).force_encoding('UTF-8') rescue ''
+              # Truncate extremely long lines to prevent UI hang
+              has_long_lines = text.lines.any? { |l| l.length > 2_000 }
+              if has_long_lines
+                text = text.lines.map { |l| l.length > 2_000 ? l[0, 10_000] + "...\n" : l }.join
+              end
               if text.valid_encoding?
-                if @batuse
-                  # Try bat first, with robust fallback
+                if @batuse && !has_long_lines
+                  # Try bat on original file (safe, no long lines)
                   bat_cmd = "#{@bat} -n --color=always #{Shellwords.escape(@selected)}"
-                  bat_output = command(bat_cmd, timeout: 10)
+                  bat_output = command(bat_cmd, timeout: 5)
                   if bat_output.empty?
-                    # Bat failed or returned empty - try plain cat
                     showcommand("cat #{Shellwords.escape(@selected)}")
                   else
                     @pR.say(bat_output)
                   end
                 else
-                  showcommand("cat #{Shellwords.escape(@selected)}")
+                  # Use truncated text directly (long lines or no bat)
+                  @pR.say(text)
                 end
               else
                 @pR.say("No preview available for #{@selected}")
               end
             end
-          rescue => e
+            end # Timeout.timeout
+          rescue Timeout::Error
+            @pR.say("Preview timed out (file too large or complex)")
+          rescue StandardError => e # file preview failed
             @pR.say("Error previewing file: #{e}")
           end
         end
@@ -6894,7 +6909,7 @@ def showimage(image) # SHOW THE SELECTED IMAGE IN THE RIGHT WINDOW {{{2
         max_height: @pR.h - 1)
       @current_image_path = img_path
     end
-  rescue => e
+  rescue StandardError => e # image display failed
     @pR.text = "Error showing image: #{e.message}"
   end
 end
@@ -7075,7 +7090,7 @@ loop do
         @pT.update = @pL.update = @pR.update = @pB.update = true
         refresh
       end
-    rescue; end
+    rescue StandardError; end # terminal size query failed
   end
 
   # redraw, but ignore TTY‐focus errors
@@ -7093,7 +7108,7 @@ loop do
   # If cwd was deleted externally, jump home
   begin
     Dir.pwd
-  rescue
+  rescue Errno::ENOENT, Errno::EACCES # cwd was deleted or became inaccessible
     Dir.chdir
   end
   # If selected file was removed externally, force pane refresh (skip in archive/remote mode)

data/img/rtfm-kb.svg

@@ -0,0 +1,341 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1500 560" width="1500" height="560" font-family="monospace, Courier New, Courier">
+  <defs>
+    <style>
+      .key { fill: #333; stroke: #555; stroke-width: 1; rx: 5; ry: 5; }
+      .kw { fill: #2a2a2a; stroke: #555; stroke-width: 1; rx: 5; ry: 5; }
+      .kl { font-size: 12px; fill: #bbb; font-weight: bold; text-anchor: middle; }
+      .lo { font-size: 8.5px; fill: #FF8888; text-anchor: middle; }
+      .up { font-size: 8.5px; fill: #88BBFF; text-anchor: middle; }
+      .ct { font-size: 10px; fill: #88FF88; }
+      .sp { font-size: 8.5px; fill: #DDAAFF; text-anchor: middle; }
+      .nv { font-size: 8.5px; fill: #bbb; text-anchor: middle; }
+    </style>
+  </defs>
+  <rect width="1500" height="560" fill="#1a1a1a" rx="8"/>
+  <text x="470" y="22" text-anchor="middle" font-size="15" font-weight="bold" fill="#fff">RTFM Keyboard Reference</text>
+
+  <!-- Row 0: Esc -->
+  <rect x="10" y="34" width="58" height="55" class="key"/>
+  <text x="39" y="54" class="kl">Esc</text>
+  <text x="39" y="80" class="lo">quit</text>
+
+  <!-- Row 1: Number row  kw=62 gap=4 -->
+  <rect x="10" y="97" width="58" height="55" class="key"/>
+  <text x="39" y="117" class="kl">` ~</text>
+  <text x="39" y="143" class="lo">~ home</text>
+
+  <rect x="72" y="97" width="62" height="55" class="key"/>
+  <text x="103" y="117" class="kl">1</text>
+  <text x="103" y="143" class="lo">tab 1</text>
+
+  <rect x="138" y="97" width="62" height="55" class="key"/>
+  <text x="169" y="117" class="kl">2</text>
+  <text x="169" y="143" class="lo">tab 2</text>
+
+  <rect x="204" y="97" width="62" height="55" class="key"/>
+  <text x="235" y="117" class="kl">3</text>
+  <text x="235" y="143" class="lo">tab 3</text>
+
+  <rect x="270" y="97" width="62" height="55" class="key"/>
+  <text x="301" y="117" class="kl">4</text>
+  <text x="301" y="143" class="lo">tab 4</text>
+
+  <rect x="336" y="97" width="62" height="55" class="key"/>
+  <text x="367" y="117" class="kl">5</text>
+  <text x="367" y="143" class="lo">tab 5</text>
+
+  <rect x="402" y="97" width="62" height="55" class="key"/>
+  <text x="433" y="117" class="kl">6</text>
+  <text x="433" y="143" class="lo">tab 6</text>
+
+  <rect x="468" y="97" width="62" height="55" class="key"/>
+  <text x="499" y="117" class="kl">7</text>
+  <text x="499" y="143" class="lo">tab 7</text>
+
+  <rect x="534" y="97" width="62" height="55" class="key"/>
+  <text x="565" y="117" class="kl">8</text>
+  <text x="565" y="143" class="lo">tab 8</text>
+
+  <rect x="600" y="97" width="62" height="55" class="key"/>
+  <text x="631" y="117" class="kl">9</text>
+  <text x="631" y="143" class="lo">tab 9</text>
+
+  <rect x="666" y="97" width="62" height="55" class="key"/>
+  <text x="697" y="127" class="kl">0</text>
+
+  <rect x="732" y="97" width="62" height="55" class="key"/>
+  <text x="763" y="115" class="kl">- _</text>
+  <text x="763" y="133" class="sp">_ image</text>
+  <text x="763" y="146" class="lo">- preview</text>
+
+  <rect x="798" y="97" width="62" height="55" class="key"/>
+  <text x="829" y="115" class="kl">= +</text>
+  <text x="829" y="133" class="sp">+ interact</text>
+  <text x="829" y="146" class="lo">= mkdir</text>
+
+  <rect x="864" y="97" width="76" height="55" class="kw"/>
+  <text x="902" y="130" class="nv">Bksp</text>
+
+  <!-- Row 2: QWERTY  start x=10+80=90 offset, kw=62 -->
+  <rect x="10" y="160" width="76" height="55" class="kw"/>
+  <text x="48" y="183" class="nv">Tab</text>
+  <text x="48" y="206" class="nv">pgdn R</text>
+
+  <rect x="90" y="160" width="62" height="55" class="key"/>
+  <text x="121" y="176" class="kl">Q</text>
+  <text x="121" y="194" class="up">Q nosave</text>
+  <text x="121" y="207" class="lo">q save</text>
+
+  <rect x="156" y="160" width="62" height="55" class="key"/>
+  <text x="187" y="176" class="kl">W</text>
+  <text x="187" y="194" class="up">Write cfg</text>
+  <text x="187" y="207" class="lo">width</text>
+
+  <rect x="222" y="160" width="62" height="55" class="key"/>
+  <text x="253" y="176" class="kl">E</text>
+  <text x="253" y="194" class="up">Bulk ren</text>
+  <text x="253" y="207" class="lo">props</text>
+
+  <rect x="288" y="160" width="62" height="55" class="key"/>
+  <text x="319" y="176" class="kl">R</text>
+  <text x="319" y="194" class="up">Load cfg</text>
+  <text x="319" y="207" class="lo">refresh</text>
+
+  <rect x="354" y="160" width="62" height="55" class="key"/>
+  <text x="385" y="176" class="kl">T</text>
+  <text x="385" y="194" class="up">Tag list</text>
+  <text x="385" y="207" class="lo">tag</text>
+
+  <rect x="420" y="160" width="62" height="55" class="key"/>
+  <text x="451" y="176" class="kl">Y</text>
+  <text x="451" y="194" class="up">Cp clipbd</text>
+  <text x="451" y="207" class="lo">cp primary</text>
+
+  <rect x="486" y="160" width="62" height="55" class="key"/>
+  <text x="517" y="176" class="kl">U</text>
+  <text x="517" y="194" class="up">Undo</text>
+  <text x="517" y="207" class="lo">untag all</text>
+
+  <rect x="552" y="160" width="62" height="55" class="key"/>
+  <text x="583" y="176" class="kl">I</text>
+  <text x="583" y="194" class="up">AI descr</text>
+  <text x="583" y="207" class="lo">invert</text>
+
+  <rect x="618" y="160" width="62" height="55" class="key"/>
+  <text x="649" y="176" class="kl">O</text>
+  <text x="649" y="194" class="up">ls cmd</text>
+  <text x="649" y="207" class="lo">order</text>
+
+  <rect x="684" y="160" width="62" height="55" class="key"/>
+  <text x="715" y="176" class="kl">P</text>
+  <text x="715" y="194" class="up">Move here</text>
+  <text x="715" y="207" class="lo">copy here</text>
+
+  <rect x="750" y="160" width="62" height="55" class="key"/>
+  <text x="781" y="176" class="kl">[ {</text>
+  <text x="781" y="194" class="sp">{ ren tab</text>
+  <text x="781" y="207" class="sp">[ cls tab</text>
+
+  <rect x="816" y="160" width="62" height="55" class="key"/>
+  <text x="847" y="176" class="kl">] }</text>
+  <text x="847" y="194" class="sp">} dup tab</text>
+  <text x="847" y="207" class="sp">] new tab</text>
+
+  <rect x="882" y="160" width="58" height="55" class="key"/>
+  <text x="911" y="176" class="kl">\</text>
+  <text x="911" y="200" class="sp">clr srch</text>
+
+  <!-- Row 3: ASDF  start x=10+90=100 offset -->
+  <rect x="10" y="223" width="86" height="55" class="kw"/>
+  <text x="53" y="255" class="nv">Ctrl</text>
+
+  <rect x="100" y="223" width="62" height="55" class="key"/>
+  <text x="131" y="239" class="kl">A</text>
+  <text x="131" y="257" class="up">Long list</text>
+  <text x="131" y="270" class="lo">all/none</text>
+
+  <rect x="166" y="223" width="62" height="55" class="key"/>
+  <text x="197" y="239" class="kl">S</text>
+  <text x="197" y="257" class="up">Sys info</text>
+  <text x="197" y="270" class="lo">symlink</text>
+
+  <rect x="232" y="223" width="62" height="55" class="key"/>
+  <text x="263" y="239" class="kl">D</text>
+  <text x="263" y="257" class="up">Emp trash</text>
+  <text x="263" y="270" class="lo">delete</text>
+
+  <rect x="298" y="223" width="62" height="55" class="key"/>
+  <text x="329" y="239" class="kl">F</text>
+  <text x="329" y="257" class="up">Filt regex</text>
+  <text x="329" y="270" class="lo">filt type</text>
+
+  <rect x="364" y="223" width="62" height="55" class="key"/>
+  <text x="395" y="239" class="kl">G</text>
+  <text x="395" y="257" class="up">Git status</text>
+  <text x="395" y="270" class="lo">grep</text>
+
+  <rect x="430" y="223" width="62" height="55" class="key"/>
+  <text x="461" y="239" class="kl">H</text>
+  <text x="461" y="257" class="up">Hash dir</text>
+  <text x="461" y="270" class="nv">h = LEFT</text>
+
+  <rect x="496" y="223" width="62" height="55" class="key"/>
+  <text x="527" y="239" class="kl">J</text>
+  <text x="527" y="257" class="up">Prev tab</text>
+  <text x="527" y="270" class="nv">j = DOWN</text>
+
+  <rect x="562" y="223" width="62" height="55" class="key"/>
+  <text x="593" y="239" class="kl">K</text>
+  <text x="593" y="257" class="up">Next tab</text>
+  <text x="593" y="270" class="nv">k = UP</text>
+
+  <rect x="628" y="223" width="62" height="55" class="key"/>
+  <text x="659" y="239" class="kl">L</text>
+  <text x="659" y="257" class="up">Locate</text>
+  <text x="659" y="270" class="nv">l = RIGHT</text>
+
+  <rect x="694" y="223" width="62" height="55" class="key"/>
+  <text x="725" y="239" class="kl">; :</text>
+  <text x="725" y="257" class="sp">: command</text>
+  <text x="725" y="270" class="sp">; history</text>
+
+  <rect x="760" y="223" width="62" height="55" class="key"/>
+  <text x="791" y="239" class="kl">'</text>
+  <text x="791" y="262" class="sp">jump mark</text>
+
+  <rect x="826" y="223" width="114" height="55" class="kw"/>
+  <text x="883" y="248" class="nv">Enter</text>
+  <text x="883" y="268" class="nv">open/refresh</text>
+
+  <!-- Row 4: ZXCV  start x=10+100=110 offset -->
+  <rect x="10" y="286" width="96" height="55" class="kw"/>
+  <text x="58" y="318" class="nv">Shift</text>
+
+  <rect x="110" y="286" width="62" height="55" class="key"/>
+  <text x="141" y="302" class="kl">Z</text>
+  <text x="141" y="320" class="up">Zip</text>
+  <text x="141" y="333" class="lo">unzip</text>
+
+  <rect x="176" y="286" width="62" height="55" class="key"/>
+  <text x="207" y="302" class="kl">X</text>
+  <text x="207" y="320" class="up">Compare</text>
+  <text x="207" y="333" class="lo">open force</text>
+
+  <rect x="242" y="286" width="62" height="55" class="key"/>
+  <text x="273" y="302" class="kl">C</text>
+  <text x="273" y="320" class="up">Config</text>
+  <text x="273" y="333" class="lo">rename</text>
+
+  <rect x="308" y="286" width="62" height="55" class="key"/>
+  <text x="339" y="302" class="kl">V</text>
+  <text x="339" y="320" class="up">Plugins</text>
+  <text x="339" y="333" class="lo">version</text>
+
+  <rect x="374" y="286" width="62" height="55" class="key"/>
+  <text x="405" y="302" class="kl">B</text>
+  <text x="405" y="320" class="up">Border</text>
+  <text x="405" y="333" class="lo">syntax hl</text>
+
+  <rect x="440" y="286" width="62" height="55" class="key"/>
+  <text x="471" y="302" class="kl">N</text>
+  <text x="471" y="320" class="up">Srch prev</text>
+  <text x="471" y="333" class="lo">srch next</text>
+
+  <rect x="506" y="286" width="62" height="55" class="key"/>
+  <text x="537" y="302" class="kl">M</text>
+  <text x="537" y="320" class="up">Show mrks</text>
+  <text x="537" y="333" class="lo">set mark</text>
+
+  <rect x="572" y="286" width="62" height="55" class="key"/>
+  <text x="603" y="315" class="kl">, &lt;</text>
+
+  <rect x="638" y="286" width="62" height="55" class="key"/>
+  <text x="669" y="302" class="kl">. &gt;</text>
+  <text x="669" y="333" class="sp">&gt; follow lnk</text>
+
+  <rect x="704" y="286" width="62" height="55" class="key"/>
+  <text x="735" y="302" class="kl">/ ?</text>
+  <text x="735" y="320" class="sp">? help</text>
+  <text x="735" y="333" class="sp">/ search</text>
+
+  <rect x="770" y="286" width="170" height="55" class="kw"/>
+  <text x="855" y="318" class="nv">Shift</text>
+
+  <!-- Row 5: Bottom -->
+  <rect x="10" y="349" width="70" height="50" class="kw"/>
+  <text x="45" y="378" class="nv">Ctrl</text>
+
+  <rect x="84" y="349" width="58" height="50" class="kw"/>
+  <text x="113" y="378" class="nv">Alt</text>
+
+  <rect x="146" y="349" width="330" height="50" class="key"/>
+  <text x="311" y="378" class="nv">Space</text>
+
+  <rect x="480" y="349" width="62" height="50" class="key"/>
+  <text x="511" y="366" class="kl"># @</text>
+  <text x="511" y="382" class="sp"># locate</text>
+  <text x="511" y="394" class="sp">@ ruby dbg</text>
+
+  <!-- Nav cluster -->
+  <rect x="990" y="97" width="64" height="55" class="key"/>
+  <text x="1022" y="120" class="nv">Home</text>
+  <text x="1022" y="143" class="nv">g first</text>
+
+  <rect x="1058" y="97" width="64" height="55" class="key"/>
+  <text x="1090" y="120" class="nv">End</text>
+  <text x="1090" y="143" class="nv">G last</text>
+
+  <rect x="990" y="160" width="64" height="55" class="key"/>
+  <text x="1022" y="183" class="nv">PgUp</text>
+  <text x="1022" y="206" class="nv">page up</text>
+
+  <rect x="1058" y="160" width="64" height="55" class="key"/>
+  <text x="1090" y="183" class="nv">PgDn</text>
+  <text x="1090" y="206" class="nv">page dn</text>
+
+  <rect x="1022" y="286" width="60" height="55" class="key"/>
+  <text x="1052" y="310" class="nv">UP</text>
+  <text x="1052" y="333" class="nv">k</text>
+
+  <rect x="958" y="349" width="60" height="50" class="key"/>
+  <text x="988" y="370" class="nv">LEFT</text>
+  <text x="988" y="390" class="nv">h</text>
+
+  <rect x="1022" y="349" width="60" height="50" class="key"/>
+  <text x="1052" y="370" class="nv">DOWN</text>
+  <text x="1052" y="390" class="nv">j</text>
+
+  <rect x="1086" y="349" width="60" height="50" class="key"/>
+  <text x="1116" y="370" class="nv">RIGHT</text>
+  <text x="1116" y="390" class="nv">l/enter</text>
+
+  <!-- Right panel: Ctrl combos -->
+  <rect x="1180" y="34" width="300" height="340" rx="6" fill="#1a2a1a" stroke="#4a6a4a" stroke-width="1"/>
+  <text x="1330" y="56" text-anchor="middle" font-size="13" font-weight="bold" fill="#88FF88">Ctrl Combos</text>
+  <text x="1194" y="80" class="ct">C-A   AI chat mode</text>
+  <text x="1194" y="100" class="ct">C-D   Toggle trash view</text>
+  <text x="1194" y="120" class="ct">C-E   Browse remote</text>
+  <text x="1194" y="140" class="ct">C-F   Clear filter</text>
+  <text x="1194" y="160" class="ct">C-L   fzf jump</text>
+  <text x="1194" y="180" class="ct">C-N   Navi cheatsheet</text>
+  <text x="1194" y="200" class="ct">C-O   Change ownership</text>
+  <text x="1194" y="220" class="ct">C-P   Change permissions</text>
+  <text x="1194" y="240" class="ct">C-R   Recent files</text>
+  <text x="1194" y="260" class="ct">C-T   Tag by pattern</text>
+  <text x="1194" y="280" class="ct">C-Y   Copy pane to clipboard</text>
+  <text x="1194" y="300" class="ct">C-;   SSH history</text>
+  <text x="1194" y="328" class="ct">C-Arrows   Move/copy items</text>
+  <text x="1194" y="348" class="ct">S-Arrows   Scroll right pane</text>
+  <text x="1194" y="368" class="ct">S-Tab      Page up right pane</text>
+
+  <!-- Legend -->
+  <rect x="20" y="470" width="14" height="14" fill="#442222" rx="2" stroke="#663333" stroke-width="0.5"/>
+  <text x="40" y="482" font-size="10" fill="#FF8888">lowercase</text>
+  <rect x="120" y="470" width="14" height="14" fill="#222244" rx="2" stroke="#333366" stroke-width="0.5"/>
+  <text x="140" y="482" font-size="10" fill="#88BBFF">UPPERCASE</text>
+  <rect x="240" y="470" width="14" height="14" fill="#224422" rx="2" stroke="#336633" stroke-width="0.5"/>
+  <text x="260" y="482" font-size="10" fill="#88FF88">Ctrl+key</text>
+  <rect x="350" y="470" width="14" height="14" fill="#332244" rx="2" stroke="#553366" stroke-width="0.5"/>
+  <text x="370" y="482" font-size="10" fill="#DDAAFF">special</text>
+  <text x="460" y="482" font-size="10" fill="#bbb">gray = navigation</text>
+</svg>

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rtfm-filemanager
 version: !ruby/object:Gem::Version
-  version: 8.2.1
+  version: 8.2.3
 platform: ruby
 authors:
 - Geir Isene
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-16 00:00:00.000000000 Z
+date: 2026-03-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rcurses
@@ -97,7 +97,7 @@ files:
 - examples/rtfm.conf
 - examples/settings.rb
 - img/logo.png
-- img/rtfm-kb.png
+- img/rtfm-kb.svg
 - man/rtfm.1
 homepage: https://isene.com/
 licenses: