rtfm-filemanager 8.2.0 → 8.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ef7c28629f7646f129d96e76afd871a7ab6030e0adb9983055a247ccc3992ecc
-  data.tar.gz: b1c7f85c145f532f5e3175c5fb2f4642d134149d147fc06b4a26389f25d1f42c
+  metadata.gz: 70a9b068989497362fa5d26c2a31cc1f839af5364ccf978b0f99f68707159255
+  data.tar.gz: f7e15cbab0c75bef8fc163eb179b60559ed08fc2f87244eb0e7ed703758c4581
 SHA512:
-  metadata.gz: 9207a4adaeed8a14f3a7a78a70fafdcba2318635605406168679aefe6f2e859cedc7c4053ebcf0d08f610415874df41f061fedad1fd41955cbcc7ae1eb2206a9
-  data.tar.gz: 1c8b70f11a2436b5beedebf1b0a510395e62e93a99ed1050192f381097693816731864f46c86a22eeebb8139ae9bb09367625c01ad9856142cffb2b271fdb53d
+  metadata.gz: 664d2c0a068716ff76cd10bd525dbc6383b5e8073d696db8d268a2927eaf6050affdcd0c359fbb0be8544612c3591804975a9847594af09392f12de389c76b5b
+  data.tar.gz: c02dce8c6556406b65b0ff87b9062f4f45256d4feccc0fbcf1c8fc2404c84708acdaae8f87b2ddd929377494691accd61d519ca8b964481ed7d686d08ee7d6e1

data/CHANGELOG.md

@@ -5,6 +5,17 @@ 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.2.1] - 2026-03-16
+
+### Added
+- **Trash browser** (`D` key) - Browse trash contents with timestamps and original paths. Restore files, permanently delete individual items, or empty all trash
+- **Disk usage plugin** (`S` key) - Interactive size-sorted directory analyzer with visual bars and cancellable scanning
+- **Duplicate finder plugin** (`F7`) - Find duplicate files by content hash with tag-to-keep workflow and cancellable scanning
+
+### Fixed
+- **Right pane scrolling** - Shift-Down/Up now works after displaying content via `say` (marks, help, system info, etc.)
+- **rcurses pane refresh** - No longer queries cursor position via stdin (uses ANSI save/restore), preventing keypresses from being consumed during progress updates
+
 ## [8.2.0] - 2026-03-15
 
 ### Added

data/README.md

@@ -211,7 +211,7 @@ For complete reference: `man rtfm` or press `?` in RTFM
 | `c` | Rename item |
 | `E` | Bulk rename (patterns) |
 | `d` | Delete (→ trash if enabled) |
-| `D` | Empty trash |
+| `D` | Trash browser (browse, restore, delete) |
 | `Ctrl-d` | Toggle trash on/off |
 | `U` | Undo last operation |
 
@@ -515,6 +515,8 @@ cp examples/git.rb ~/.rtfm/plugins/
 cp examples/bookmarks.rb ~/.rtfm/plugins/
 cp examples/notes.rb ~/.rtfm/plugins/
 cp examples/opener.rb ~/.rtfm/plugins/
+cp examples/diskusage.rb ~/.rtfm/plugins/
+cp examples/dupes.rb ~/.rtfm/plugins/
 ```
 
 | Plugin | Key | Description |
@@ -524,6 +526,8 @@ cp examples/opener.rb ~/.rtfm/plugins/
 | **Bookmarks** | `F6` | Unlimited directory bookmarks with fuzzy filtering. Add, delete, and jump to bookmarked directories. Complements the built-in single-letter marks (m/') |
 | **Notes** | `F5` | Attach text notes to any file or directory. View, edit, or delete notes. Stored in `~/.rtfm/notes/` |
 | **Opener** | `RIGHT`/`l` | Custom file openers by extension. Configure a hash of extension-to-command mappings (e.g., `.hl` files open in hyperlist) |
+| **Disk Usage** | `S` | Interactive disk usage analyzer. Extends system info with a browseable size-sorted directory view with visual bars |
+| **Dupes** | `F7` | Find duplicate files by content hash. Two-pass scan (size then SHA256) with in-place deletion of duplicates |
 
 ### Writing Your Own Plugins
 
@@ -692,7 +696,8 @@ Best image experience with: kitty, urxvt, xterm, mlterm, foot
 ### Version 8.2 Highlights
 
 - **Plugin system with live enable/disable** - Plugins in `~/.rtfm/plugins/` are auto-loaded on startup. Toggle them on and off at runtime with the plugin manager (`V` key), no restart needed. Each plugin can register help text viewable with `?`.
-- **Five example plugins** - Settings editor, git operations, directory bookmarks, file notes, and custom file openers. Copy from `examples/` to `~/.rtfm/plugins/` to use.
+- **Seven example plugins** - Settings editor, git operations, directory bookmarks, file notes, custom file openers, disk usage analyzer, and duplicate file finder. Copy from `examples/` to `~/.rtfm/plugins/` to use.
+- **Trash browser** (`D` key) - Browse trash contents with timestamps and original paths. Restore files to their original location, permanently delete individual items, or empty all trash.
 
 ### Version 8.1 Highlights
 

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.0' # Plugin system with live enable/disable and built-in plugin manager
+@version    = '8.2.2' # 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
@@ -242,7 +242,7 @@ CONFIG_FILE   = File.join(RTFM_HOME, 'conf')
     s       = Create symlink to tagged items here
     d       = Delete selected item and tagged items. Confirm with 'y'. 
               Moves items to trash directory (~/.rtfm/trash/) if @trash = true
-    D       = Empty trash directory
+    D       = Trash browser (browse, restore, delete, empty trash)
     Ctrl-d  = Toggle use of trash directory
 
   UNDO OPERATIONS
@@ -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
@@ -4204,14 +4206,152 @@ def empty_trash # {{{3
     remote_download_selected
     return
   end
-  @pB.say(" Really empty Trash (~/.rtfm/trash)? (press 'y')")
-  return unless  getchr == 'y'
+  trash_browser
+end
+
+def trash_browser # TRASH BROWSER {{{3
+  clear_image
+  sel = 0
+  offset = 0
+
+  loop do
+    # Scan trash directory, build item list with metadata
+    raw = Dir.entries(TRASH_DIR).reject { |e| e == '.' || e == '..' }.map { |e| File.join(TRASH_DIR, e) }
+    entries = raw.select { |f| File.exist?(f) || File.symlink?(f) }
+    entries.sort_by! { |f| File.mtime(f) rescue Time.at(0) }
+    entries.reverse!
+    items = entries.filter_map do |f|
+      basename = File.basename(f)
+      orig_name = basename.sub(/^\d{8}_\d{6}_/, '').sub(/_\d{4}$/, '')
+      orig_path = nil
+      @undo_history.each do |op|
+        next unless op[:type] == 'delete' && op[:trash]
+        op[:paths].each { |p| orig_path = p[:path] if p[:trash_name] == basename }
+      end
+      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 Errno::EACCES, Errno::ENOENT # permission denied or missing file
+        size = 0
+        mtime = Time.at(0)
+      end
+      { path: f, basename: basename, orig_name: orig_name, orig_path: orig_path,
+        size: size, mtime: mtime, dir: File.directory?(f) }
+    end
+
+    sel = [sel, items.size - 1, 0].sort[1]
+    page_h = @pR.h - 5
+    page_h = 1 if page_h < 1
+    offset = sel - page_h + 1 if sel >= offset + page_h
+    offset = sel if sel < offset
+    offset = 0 if offset < 0
+    visible = items[offset, page_h] || []
+
+    lines = []
+    lines << "j/k:move  r:restore  d:delete  E:empty all  q:close".fg(240)
+    lines << "Trash".b.fg(254) + "  (#{items.size} items)".fg(240)
+    lines << ""
+
+    if items.empty?
+      lines << "Trash is empty.".fg(240)
+    else
+      visible.each_with_index do |item, i|
+        idx = offset + i
+        size_s = human_size(item[:size])
+        type_indicator = item[:dir] ? "/".fg(69) : ""
+        age = time_ago(item[:mtime])
+        name = item[:orig_name] + type_indicator
+        origin = item[:orig_path] ? "  #{File.dirname(item[:orig_path])}".fg(240) : ""
+        line = "#{size_s.rjust(8).fg(249)} #{age.rjust(6).fg(240)} #{name}#{origin}"
+        line = idx == sel ? line.u : line
+        lines << line
+      end
+      lines << "(#{sel + 1}/#{items.size})".fg(240) if items.size > page_h
+    end
+
+    @pR.update = true
+    @pR.say(lines.join("\n"))
+
+    chr = getchr
+    case chr
+    when 'q', 'ESC'
+      break
+    when 'j', 'DOWN'
+      sel = items.empty? ? 0 : (sel + 1) % items.size
+    when 'k', 'UP'
+      sel = items.empty? ? 0 : (sel - 1) % items.size
+    when 'r'
+      next if items.empty?
+      item = items[sel]
+      if item[:orig_path]
+        dest = item[:orig_path]
+      else
+        dest = @pCmd.ask('Restore to: ', File.join(Dir.pwd, item[:orig_name]))
+      end
+      next if dest.strip.empty?
+      if File.exist?(dest)
+        @pB.say("Destination exists: #{dest}".fg(196))
+        next
+      end
+      begin
+        FileUtils.mv(item[:path], dest)
+        # Remove from undo history
+        @undo_history.each do |op|
+          next unless op[:type] == 'delete' && op[:trash]
+          op[:paths].reject! { |p| p[:trash_name] == item[:basename] }
+        end
+        @pB.say("Restored: #{File.basename(dest)}".fg(156))
+        sel = [sel - 1, 0].max
+      rescue StandardError => e # restore from trash failed
+        @pB.say("Restore failed: #{e.message}".fg(196))
+      end
+    when 'd'
+      next if items.empty?
+      item = items[sel]
+      @pB.say(" Permanently delete #{item[:orig_name]}? (y/n)".fg(196))
+      if getchr == 'y'
+        command("rm -rf #{Shellwords.escape(item[:path])}")
+        @pB.say("Deleted: #{item[:orig_name]}".fg(204))
+        sel = [sel - 1, 0].max
+      end
+    when 'E'
+      @pB.say(" Empty ALL trash? This cannot be undone! (y/n)".fg(196))
+      if getchr == 'y'
+        command("rm -rf #{TRASH_DIR}/*")
+        @undo_history.reject! { |op| op[:type] == 'delete' && op[:trash] }
+        @pB.say("Trash emptied.".fg(204))
+        sel = 0
+      end
+    end
+  end
 
-  command("rm -rf #{TRASH_DIR}/*")
-  @pB.say('Trash is now empty')
+  @pR.update = true
+  refresh
   render
 end
 
+def human_size(bytes) # {{{3
+  if bytes >= 1_073_741_824
+    "%.1fG" % (bytes / 1_073_741_824.0)
+  elsif bytes >= 1_048_576
+    "%.1fM" % (bytes / 1_048_576.0)
+  elsif bytes >= 1024
+    "%.1fK" % (bytes / 1024.0)
+  else
+    "#{bytes}B"
+  end
+end
+
+def time_ago(time) # {{{3
+  seconds = Time.now - time
+  if seconds < 60 then "now"
+  elsif seconds < 3600 then "#{(seconds / 60).to_i}m"
+  elsif seconds < 86400 then "#{(seconds / 3600).to_i}h"
+  elsif seconds < 604800 then "#{(seconds / 86400).to_i}d"
+  else "#{(seconds / 604800).to_i}w"
+  end
+end
+
 def toggle_trash # {{{3
   @trash = !@trash
   @pB.say("Trash (~/.rtfm/trash) = #{@trash ? 'On' : 'Off'}")
@@ -4720,19 +4860,19 @@ def refresh_right # {{{3
 end
 
 def line_down_right # {{{3
-  @pR.linedown; @pB.update = true
+  @pR.update = true; @pR.linedown; @pR.update = false; @pB.update = true
 end
 
 def line_up_right # {{{3
-  @pR.lineup;   @pB.update = true
+  @pR.update = true; @pR.lineup; @pR.update = false; @pB.update = true
 end
 
 def page_down_right # {{{3
-  @pR.pagedown; @pB.update = true
+  @pR.update = true; @pR.pagedown; @pR.update = false; @pB.update = true
 end
 
 def page_up_right # {{{3
-  @pR.pageup; @pB.update = true
+  @pR.update = true; @pR.pageup; @pR.update = false; @pB.update = true
 end
 
 # CLIPBOARD COPY {{{2
@@ -4864,9 +5004,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"
@@ -4895,11 +5035,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"
@@ -4941,11 +5081,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"
@@ -4985,9 +5125,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"
@@ -5021,14 +5161,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"
@@ -5063,9 +5203,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"
@@ -5106,11 +5246,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
 
@@ -5123,7 +5263,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
 
@@ -5322,7 +5462,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
 
@@ -5350,7 +5490,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
@@ -5362,7 +5502,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
   
@@ -5398,7 +5538,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
@@ -5563,7 +5703,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
@@ -5594,7 +5734,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'
@@ -6027,7 +6167,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]
@@ -6103,7 +6243,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
@@ -6136,7 +6276,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
@@ -6265,7 +6405,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
@@ -6585,7 +6725,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
@@ -6598,7 +6738,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
@@ -6627,6 +6767,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
@@ -6641,6 +6782,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
@@ -6681,25 +6823,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
@@ -6756,7 +6906,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
@@ -6937,7 +7087,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
@@ -6955,7 +7105,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/examples/diskusage.rb

@@ -0,0 +1,199 @@
+# @name: Disk Usage
+# @description: Interactive disk usage analyzer for current directory
+# @key: S (extends system info)
+
+KEYMAP['S'] = :diskusage_menu
+
+PLUGIN_HELP['Disk Usage'] = <<~HELP
+  Interactive disk usage analyzer for the current directory.
+
+  Press S to open the system/disk usage menu.
+
+  #{"Menu:".b}
+    s   Show system info (original S behavior)
+    d   Open disk usage analyzer
+
+  #{"Disk Usage Analyzer:".b}
+    j/k       Navigate up/down
+    ENTER     Drill into selected directory
+    LEFT/h    Go up to parent directory
+    q/ESC     Close analyzer
+
+  Scanning can be cancelled with ESC. The analyzer
+  shows all files and directories sorted by size
+  (largest first), with visual bars and human-readable
+  sizes. Directories are shown in blue.
+HELP
+
+def diskusage_menu
+  clear_image
+
+  lines = []
+  lines << "System / Disk Usage".b.fg(254)
+  lines << ""
+  lines << "s".b.fg(112) + "  System info"
+  lines << "d".b.fg(112) + "  Disk usage analyzer"
+  lines << ""
+  lines << "q/ESC: close".fg(240)
+
+  @pR.update = true
+  @pR.say(lines.join("\n"))
+
+  chr = getchr
+  case chr
+  when 's'
+    system_info
+  when 'd'
+    diskusage_browse(Dir.pwd)
+  when 'q', 'ESC'
+    @pR.update = true
+    refresh
+    render
+  end
+end
+
+def diskusage_browse(start_dir)
+  browse_dir = start_dir
+  sel = 0
+  offset = 0
+  cached = {} # dir => entries
+
+  loop do
+    entries = cached[browse_dir] || diskusage_scan(browse_dir)
+    cached[browse_dir] = entries if entries
+    entries ||= []
+    total = entries.sum { |e| e[:size] }
+    max_size = entries.map { |e| e[:size] }.max || 1
+    page_h = @pR.h - 6
+    page_h = 1 if page_h < 1
+
+    sel = 0 if entries.empty?
+    sel = entries.size - 1 if sel >= entries.size && !entries.empty?
+
+    offset = sel - page_h + 1 if sel >= offset + page_h
+    offset = sel if sel < offset
+    offset = 0 if offset < 0
+
+    visible = entries[offset, page_h] || []
+
+    lines = []
+    lines << "Disk Usage".b.fg(254) + "  " + browse_dir.fg(240)
+    lines << ("Total: " + diskusage_human(total)).fg(249)
+    lines << ""
+
+    bar_width = @pR.w - 30
+    bar_width = 10 if bar_width < 10
+
+    visible.each_with_index do |entry, i|
+      idx = offset + i
+      ratio = max_size > 0 ? entry[:size].to_f / max_size : 0
+      filled = (ratio * bar_width).round
+      bar = "\u2588" * filled + "\u2591" * (bar_width - filled)
+
+      name_color = entry[:dir] ? 69 : 249
+      size_str = diskusage_human(entry[:size]).rjust(9)
+      name = entry[:name]
+      name += "/" if entry[:dir]
+
+      line = bar.fg(entry[:dir] ? 69 : 243) + " " +
+             size_str.fg(156) + " " +
+             name.fg(name_color)
+      line = idx == sel ? line.u : line
+      lines << line
+    end
+
+    if entries.size > page_h
+      lines << ""
+      lines << "(#{sel + 1}/#{entries.size})".fg(240)
+    end
+
+    @pR.update = true
+    @pR.say(lines.join("\n"))
+
+    chr = getchr
+    case chr
+    when 'j', 'DOWN'
+      sel = (sel + 1) % entries.size unless entries.empty?
+    when 'k', 'UP'
+      sel = (sel - 1) % entries.size unless entries.empty?
+    when 'ENTER'
+      next if entries.empty?
+      entry = entries[sel]
+      if entry[:dir]
+        browse_dir = File.join(browse_dir, entry[:name])
+        sel = 0
+        offset = 0
+      end
+    when 'LEFT', 'h'
+      parent = File.dirname(browse_dir)
+      if parent != browse_dir
+        browse_dir = parent
+        sel = 0
+        offset = 0
+      end
+    when 'q', 'ESC'
+      break
+    end
+  end
+
+  @pR.update = true
+  refresh
+  render
+end
+
+def diskusage_scan(dir)
+  return [] unless Dir.exist?(dir)
+
+  entries = []
+  # Scan entries one by one for progress and cancellability
+  children = begin
+    Dir.entries(dir).reject { |e| e == '.' || e == '..' }
+  rescue
+    return []
+  end
+
+  children.each_with_index do |name, i|
+    # Check for ESC to cancel
+    begin
+      $stdin.read_nonblock(1)
+      $stdin.read_nonblock(16) rescue nil
+      @pB.say("Scan cancelled.".fg(220))
+      return entries.sort_by { |e| -e[:size] }
+    rescue IO::WaitReadable, EOFError
+      # No keypress, continue scanning
+    end
+
+    @pB.update = true
+    @pB.say(" Scanning #{i + 1}/#{children.size}: #{name}")
+    @pB.refresh
+
+    path = File.join(dir, name)
+    is_dir = File.directory?(path) rescue false
+    begin
+      if is_dir
+        out = `du -sb #{Shellwords.escape(path)} 2>/dev/null`.strip
+        size = out.split("\t").first.to_i
+      else
+        size = File.size(path) rescue 0
+      end
+    rescue
+      size = 0
+    end
+    entries << { name: name, size: size, dir: is_dir }
+  end
+
+  @pB.say("")
+  entries.sort_by { |e| -e[:size] }
+end
+
+def diskusage_human(bytes)
+  if bytes >= 1024 * 1024 * 1024
+    format("%.1f GB", bytes.to_f / (1024 * 1024 * 1024))
+  elsif bytes >= 1024 * 1024
+    format("%.1f MB", bytes.to_f / (1024 * 1024))
+  elsif bytes >= 1024
+    format("%.1f KB", bytes.to_f / 1024)
+  else
+    "#{bytes} B"
+  end
+end

data/examples/dupes.rb

@@ -0,0 +1,335 @@
+# @name: Dupes
+# @description: Find duplicate files by content hash in current directory
+# @key: F7
+
+require 'digest'
+require 'shellwords'
+
+KEYMAP['F7'] = :find_dupes
+
+PLUGIN_HELP['Dupes'] = <<~HELP
+  Find duplicate files by content hash.
+
+  Press F7 to scan the current directory for files
+  that share identical content.
+
+  #{"Scanning:".b}
+    Files are first grouped by size, then only
+    same-size files are hashed (SHA256) to confirm
+    duplicates. Press 'r' at the start prompt to
+    scan recursively.
+
+  #{"Navigation:".b}
+    j/k         Move between duplicate groups
+    PgDn/PgUp   Jump 10 groups
+    LEFT/RIGHT  Move between files in a group
+    t           Tag file to KEEP
+    d           Delete all untagged files in group
+    q/ESC       Close
+
+  #{"Deletion:".b}
+    If trash mode is enabled, deleted files are
+    moved to the trash and can be undone. Otherwise
+    files are permanently removed.
+
+  #{"Display:".b}
+    Groups are sorted by wasted space (largest
+    first). Each group shows a partial hash, file
+    size, and the list of duplicate paths.
+HELP
+
+def find_dupes
+  clear_image
+
+  @pB.say("Scan duplicates: ENTER=current dir, r=recursive, q=cancel")
+  chr = getchr
+  return if chr == 'q' || chr == 'ESC'
+  recursive = (chr == 'r')
+
+  dupes_progress("Collecting files#{recursive ? ' recursively' : ''}... (any key to cancel)")
+
+  # Collect files with cancellation support
+  all_files = []
+  cancelled = false
+  if recursive
+    dirs = [Dir.pwd]
+    while dirs.any?
+      break if cancelled
+      dir = dirs.shift
+      begin
+        Dir.foreach(dir) do |entry|
+          next if entry == '.' || entry == '..'
+          path = File.join(dir, entry)
+          if File.directory?(path) && !File.symlink?(path)
+            dirs << path
+          elsif File.file?(path) && !File.symlink?(path)
+            all_files << path
+          end
+          if all_files.size % 200 == 0
+            dupes_progress("Collecting: #{all_files.size} files... (any key to cancel)")
+            if dupes_cancelled?
+              cancelled = true
+              break
+            end
+          end
+        end
+      rescue Errno::EACCES, Errno::ENOENT
+        next
+      end
+    end
+  else
+    Dir.foreach(Dir.pwd) do |entry|
+      next if entry == '.' || entry == '..'
+      path = File.join(Dir.pwd, entry)
+      all_files << path if File.file?(path) && !File.symlink?(path)
+    end
+  end
+
+  if cancelled && all_files.empty?
+    @pB.say("Scan cancelled.")
+    return
+  end
+
+  if all_files.empty?
+    @pB.say("No files found.")
+    return
+  end
+
+  # Pass 1: group by size (with cancellation)
+  by_size = {}
+  all_files.each_with_index do |f, i|
+    if i % 500 == 0
+      dupes_progress("Pass 1/2: sizing #{i}/#{all_files.size}... (any key to cancel)")
+      if dupes_cancelled?
+        cancelled = true
+        break
+      end
+    end
+    begin
+      sz = File.size(f)
+      (by_size[sz] ||= []) << f
+    rescue
+      next
+    end
+  end
+  by_size.delete(0)
+  candidates = by_size.values.select { |g| g.size > 1 }
+
+  if candidates.empty?
+    @pB.say(cancelled ? "Scan cancelled. No duplicates in partial results." : "No duplicate candidates (all files have unique sizes).")
+    return
+  end
+
+  # Pass 2: hash same-size files (with cancellation)
+  total = candidates.sum(&:size)
+  done = 0
+  by_hash = {}
+  candidates.each do |group|
+    break if cancelled
+    group.each do |f|
+      done += 1
+      if done % 10 == 1 || done == total
+        dupes_progress("Pass 2/2: hashing #{done}/#{total}... (any key to cancel)")
+        if IO.select([$stdin], nil, nil, 0)
+          $stdin.read_nonblock(16) rescue nil
+          cancelled = true
+          break
+        end
+      end
+      begin
+        digest = Digest::SHA256.new
+        File.open(f, 'rb') do |io|
+          buf = String.new(capacity: 65536)
+          while io.read(65536, buf)
+            digest.update(buf)
+          end
+        end
+        hex = digest.hexdigest
+        (by_hash[hex] ||= []) << f
+      rescue
+        next
+      end
+    end
+  end
+
+  if cancelled
+    @pB.say("Scan cancelled. Showing partial results...")
+  end
+
+  dupes = by_hash.values.select { |g| g.size > 1 }
+
+  if dupes.empty?
+    @pB.say("No duplicates found (same-size files had different content).")
+    return
+  end
+
+  # Sort by wasted space descending
+  dupes.sort_by! { |g| -(File.size(g[0]) * (g.size - 1)) rescue 0 }
+
+  # Precompute group metadata
+  group_meta = dupes.map do |group|
+    sz = File.size(group[0]) rescue 0
+    { size: sz, waste: sz * (group.size - 1) }
+  end
+  wasted_total = group_meta.sum { |m| m[:waste] }
+
+  group_idx = 0
+  file_idx = 0
+  kept = {} # group_idx => Set of file indices to keep
+
+  loop do
+    group = dupes[group_idx]
+    meta = group_meta[group_idx]
+    kept[group_idx] ||= []
+
+    lines = []
+    lines << "j/k:group  LEFT/RIGHT:file  t:keep  d:delete untagged  q:close".fg(240)
+    lines << "Duplicate Files".b.fg(254) + "  (#{group_idx + 1}/#{dupes.size} groups, #{format_bytes(wasted_total)} wasted)".fg(240)
+    lines << ""
+
+    header = "#{format_bytes(meta[:size])} x#{group.size} (#{format_bytes(meta[:waste])} wasted)"
+    lines << header.b.fg(112)
+
+    group.each_with_index do |f, fi|
+      rel = f.start_with?(Dir.pwd + '/') ? f.sub(Dir.pwd + '/', '') : f
+      is_kept = kept[group_idx].include?(fi)
+      marker = is_kept ? " KEEP ".bg(22).fg(255) : "      "
+      label = "#{marker} #{rel}"
+      label = fi == file_idx ? label.u.fg(254) : label.fg(250)
+      lines << label
+    end
+
+    lines << ""
+    # Show neighboring groups for context (compact, no file listing)
+    context_start = [group_idx - 2, 0].max
+    context_end = [group_idx + 5, dupes.size - 1].min
+    (context_start..context_end).each do |gi|
+      next if gi == group_idx
+      g = dupes[gi]
+      m = group_meta[gi]
+      lines << "  [#{gi + 1}] #{format_bytes(m[:size])} x#{g.size} (#{format_bytes(m[:waste])} wasted)".fg(240)
+    end
+
+    @pR.update = true
+    @pR.say(lines.join("\n"))
+
+    chr = getchr
+    case chr
+    when 'q', 'ESC'
+      break
+    when 'j', 'DOWN'
+      group_idx = (group_idx + 1) % dupes.size
+      file_idx = 0
+    when 'k', 'UP'
+      group_idx = (group_idx - 1) % dupes.size
+      file_idx = 0
+    when 'PgDOWN'
+      group_idx = [group_idx + 10, dupes.size - 1].min
+      file_idx = 0
+    when 'PgUP'
+      group_idx = [group_idx - 10, 0].max
+      file_idx = 0
+    when 'RIGHT', 'l', 'ENTER'
+      file_idx = (file_idx + 1) % group.size
+    when 'LEFT', 'h'
+      file_idx = (file_idx - 1) % group.size
+    when 't'
+      # Toggle keep tag on current file
+      if kept[group_idx].include?(file_idx)
+        kept[group_idx].delete(file_idx)
+      else
+        kept[group_idx] << file_idx
+      end
+      file_idx = (file_idx + 1) % group.size if file_idx < group.size - 1
+    when 'd'
+      # Delete all files NOT tagged as keep
+      to_keep = kept[group_idx] || []
+      if to_keep.empty?
+        @pB.say("Tag at least one file to keep first (press t).")
+        next
+      end
+      to_delete = group.each_index.reject { |i| to_keep.include?(i) }
+      if to_delete.empty?
+        @pB.say("All files tagged as keep, nothing to delete.")
+        next
+      end
+      names = to_delete.map { |i| File.basename(group[i]) }
+      @pB.say("Delete #{to_delete.size} files? (y/n)")
+      if getchr == 'y'
+        deleted = 0
+        to_delete.sort.reverse.each do |fi|
+          path = group[fi]
+          begin
+            if @trash
+              timestamp = Time.now.strftime('%Y%m%d_%H%M%S')
+              trash_name = "#{timestamp}_#{File.basename(path)}_#{rand(1000..9999)}"
+              trash_path = File.join(TRASH_DIR, trash_name)
+              command("mv -f #{Shellwords.escape(path)} #{Shellwords.escape(trash_path)}")
+              add_undo_operation({ type: 'delete', trash: true, paths: [{ path: path, trash_name: trash_name }], timestamp: Time.now })
+            else
+              command("rm -rf #{Shellwords.escape(path)}")
+            end
+            deleted += 1
+          rescue
+          end
+        end
+        # Remove deleted files from group (reverse order to preserve indices)
+        to_delete.sort.reverse.each { |fi| group.delete_at(fi) }
+        kept.delete(group_idx)
+        file_idx = 0
+        # Update metadata
+        meta[:waste] = (meta[:size] * (group.size - 1)) rescue 0
+        group_meta[group_idx] = meta
+        wasted_total = group_meta.sum { |m| m[:waste] }
+        # Remove group if only one file remains
+        if group.size <= 1
+          dupes.delete_at(group_idx)
+          group_meta.delete_at(group_idx)
+          # Shift kept indices
+          new_kept = {}
+          kept.each { |k, v| new_kept[k > group_idx ? k - 1 : k] = v if k != group_idx }
+          kept = new_kept
+          if dupes.empty?
+            @pB.say("All duplicates resolved! Freed #{format_bytes(wasted_total)}.")
+            break
+          end
+          group_idx = [group_idx, dupes.size - 1].min
+          wasted_total = group_meta.sum { |m| m[:waste] }
+        end
+        @pB.say("Deleted #{deleted} files.")
+      end
+    end
+  end
+
+  @pR.update = true
+  refresh
+  render
+end
+
+def dupes_progress(msg)
+  @pB.update = true
+  @pB.say(msg)
+  @pB.refresh
+end
+
+def dupes_cancelled?
+  begin
+    $stdin.read_nonblock(1)
+    $stdin.read_nonblock(16) rescue nil
+    true
+  rescue IO::WaitReadable, EOFError
+    false
+  end
+end
+
+def format_bytes(bytes)
+  if bytes >= 1073741824
+    "%.1f GB" % (bytes / 1073741824.0)
+  elsif bytes >= 1048576
+    "%.1f MB" % (bytes / 1048576.0)
+  elsif bytes >= 1024
+    "%.1f KB" % (bytes / 1024.0)
+  else
+    "#{bytes} B"
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rtfm-filemanager
 version: !ruby/object:Gem::Version
-  version: 8.2.0
+  version: 8.2.2
 platform: ruby
 authors:
 - Geir Isene
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-15 00:00:00.000000000 Z
+date: 2026-03-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rcurses
@@ -89,6 +89,8 @@ files:
 - docs/remote-browsing.md
 - docs/troubleshooting.md
 - examples/bookmarks.rb
+- examples/diskusage.rb
+- examples/dupes.rb
 - examples/git.rb
 - examples/notes.rb
 - examples/opener.rb