rtfm-filemanager 7.4.3 → 7.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dedec26a74a7588dd2702c5e021d310b3a0f75c04aa0f9d6fe77b1faa3cd8d94
-  data.tar.gz: 55c68915ea8ecac08e7e9569efb0c2372a14b6b15eb20f780027384ba75aef38
+  metadata.gz: 18d2abf32d35fbe13e8c5ff3b3844b9c7db92161d20a997a87d61a8afd084020
+  data.tar.gz: 2b136306fcf627c432f159671ccc9fe8210028df6b4955ed29dfb7422ae759d3
 SHA512:
-  metadata.gz: 79bb1f74a96e280a4170048d3dfc8c61f4cd523c313699eeec59187dddbe070cac6612244ea5ca898d8062ea9aa09e9125853592d223210b5dcc556b2fb79eee
-  data.tar.gz: aca0a8cdf19728ce003e8065a15339afd9bfe5e9dcfa87c789ceea9225c27ba72f1c824bf8d34d611c9ea06926b6986903e0f363b9f9f901e4d91e21d47832a4
+  metadata.gz: '0259ce617aee78996ba25cb4338712d0cac66905ceff53240ddc0a0076996c78ca863cc9826892ea6d520c03c714389ccf83d06a09823dd6e2307a6df51165b9'
+  data.tar.gz: a2334d014d7534233e1059bbd6bcb78fd126e4c0e38db645a95024bbd9d6a3db4797bac142b60016ff439b43f6790e94cdd827237b5d9eb5cf66616e89c2af4d

data/CHANGELOG.md

@@ -5,6 +5,36 @@ 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).
 
+## [7.5.0] - 2026-01-16
+
+### Added
+- **Native Kitty graphics protocol** - Images now display perfectly in kitty terminal
+  - No more flash during image-to-image navigation
+  - Requires termpix 0.3.0+
+  - Automatic protocol detection (kitty, sixel, or w3m)
+  - Proper aspect ratio preservation
+
+### Changed
+- Updated image positioning for kitty protocol compatibility
+- Optimized image clearing logic - skips unnecessary clears for atomic-replace protocols
+
+### Fixed
+- Fixed `getch` → `getchr` typo in toggle_image function
+
+## [7.4.4] - 2026-01-09
+
+### Fixed
+- **Extract command ('z') improvements** - Fixed two issues with archive extraction:
+  - Now uses current file when nothing is tagged (was empty command before)
+  - Auto-detects archive type and suggests correct command:
+    - `.zip` → `unzip`
+    - `.rar` → `unrar x`
+    - `.7z` → `7z x`
+    - `.tar.bz2`/`.tbz2` → `tar xfj`
+    - `.tar.xz`/`.txz` → `tar xfJ`
+    - `.tar.zst` → `tar --zstd -xf`
+    - Others → `tar xfz`
+
 ## [7.4.3] - 2025-12-09
 
 ### Fixed

data/README.md

@@ -556,7 +556,7 @@ RTFM uses the [termpix](https://github.com/isene/termpix) gem for modern multi-p
 | urxvt | w3m | ✓ Perfect |
 | xterm | Sixel | ✓ Perfect |
 | mlterm | Sixel | ✓ Perfect |
-| kitty | w3m | ✓ Works (brief flash) |
+| kitty | Kitty | ✓ Perfect |
 | foot | Sixel | ✓ Perfect |
 
 ### Features
@@ -569,7 +569,7 @@ RTFM uses the [termpix](https://github.com/isene/termpix) gem for modern multi-p
 
 ### Terminal Compatibility
 
-Best image experience with: urxvt, xterm, mlterm, Eterm
+Best image experience with: kitty, urxvt, xterm, mlterm, foot
 
 ---
 

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    = '7.4.3' # Fix docx preview corrupting left pane display by filtering carriage returns
+@version    = '7.5.0' # Native Kitty graphics protocol - no more flash in kitty terminal
 
 # SAVE & STORE TERMINAL {{{1
 ORIG_STTY = `stty -g`.chomp
@@ -1220,7 +1220,7 @@ def toggle_image # {{{3
   end
   @showimage = !@showimage
   @pB.say("Image preview = #{@showimage ? 'On' : 'Off'}")
-  getch
+  getchr
 end
 
 def toggle_syntax # {{{3
@@ -3645,9 +3645,27 @@ end
 
 # ARCHIVES {{{2
 def unzip_items # {{{3
-  first = @tagged.first
-  tar   = Shellwords.escape(first)
-  cmd   = @pCmd.ask('Command: ', "tar xfz #{tar}")
+  first = @tagged.empty? ? @selected : @tagged.first
+  return unless first
+  escaped = Shellwords.escape(first)
+  # Detect archive type and suggest appropriate command
+  default_cmd = case first.downcase
+                when /\.zip$/
+                  "unzip #{escaped}"
+                when /\.rar$/
+                  "unrar x #{escaped}"
+                when /\.7z$/
+                  "7z x #{escaped}"
+                when /\.tar\.bz2$|\.tbz2?$/
+                  "tar xfj #{escaped}"
+                when /\.tar\.xz$|\.txz$/
+                  "tar xfJ #{escaped}"
+                when /\.tar\.zst$/
+                  "tar --zstd -xf #{escaped}"
+                else
+                  "tar xfz #{escaped}"
+                end
+  cmd = @pCmd.ask('Command: ', default_cmd)
   # Reset bottom pane after command input
   @pB.clear; @pB.update = true
   shellexec(cmd) unless cmd.nil? || cmd.strip.empty?
@@ -4845,8 +4863,10 @@ def render # RENDER ALL PANES {{{2
 
   # RIGHT pane (or Preview pane in dual-pane mode) {{{3
   if @pR.update && @preview
-    # Actually clear the image overlay when rendering new content
-    showimage('clear') if @image
+    # Track if we had an image (for kitty deferred clear)
+    had_image_render = @image
+    # Clear image overlay unless protocol supports atomic replace (kitty)
+    showimage('clear') if @image && @termpix.protocol != :kitty
     @image = false
     righttext = @pR.text
     
@@ -4885,6 +4905,11 @@ def render # RENDER ALL PANES {{{2
       end
     end
     
+    # Deferred clear for kitty: if we had an image but now don't, clear it
+    if had_image_render && !@image && @termpix.protocol == :kitty
+      showimage('clear')
+    end
+
     @pR.full_refresh unless @pR.text == righttext || @image
   end
 
@@ -5509,9 +5534,14 @@ end
 def showcontent # SHOW CONTENTS IN THE RIGHT WINDOW {{{2
   # Only process content if preview is enabled
   return unless @preview
-  
+
+  # Track if we had an image (for deferred clear with kitty)
+  had_image = @image
+
   if @pR.update
-    showimage('clear') if @image
+    # Clear image unless protocol supports atomic replace (kitty)
+    # Kitty will clear later only if new content is not an image
+    showimage('clear') if @image && @termpix.protocol != :kitty
     @image = false
     @pR.clear
   end
@@ -5706,6 +5736,13 @@ def showcontent # SHOW CONTENTS IN THE RIGHT WINDOW {{{2
   rescue StandardError => e
     errormsg("⚠ Error while previewing #{@selected}", e)
   end
+
+  # Deferred clear for kitty: if we had an image but now don't, clear it
+  # This happens after content is determined, so image→image has no flash
+  if had_image && !@image && @termpix.protocol == :kitty
+    showimage('clear')
+  end
+
   @pR.update = false
 end
 
@@ -5736,11 +5773,13 @@ def showimage(image) # SHOW THE SELECTED IMAGE IN THE RIGHT WINDOW {{{2
         term_height: @h)
       @current_image_path = nil
     else
-      # Display image using termpix (use original absolute row 2)
+      # Display image using termpix
       img_path = File.absolute_path(image)
+      # Kitty needs y+1 to account for border (uses character positions directly)
+      img_y = @termpix.protocol == :kitty ? 3 : 2
       @termpix.show(img_path,
         x: @pR.x,
-        y: 2,
+        y: img_y,
         max_width: @pR.w - 2,
         max_height: @pR.h - 1)
       @current_image_path = img_path

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rtfm-filemanager
 version: !ruby/object:Gem::Version
-  version: 7.4.3
+  version: 7.5.0
 platform: ruby
 authors:
 - Geir Isene
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-09 00:00:00.000000000 Z
+date: 2026-01-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rcurses
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.3'
 - !ruby/object:Gem::Dependency
   name: bootsnap
   requirement: !ruby/object:Gem::Requirement
@@ -66,9 +66,12 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '7.4'
-description: |-
-  RTFM v7.4.3: Fixed display corruption when viewing .docx files by filtering carriage returns from docx2txt output.
-   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, bookmarks, and much more. You can bookmark and jump around easily, delete, rename, copy, symlink and move files. RTFM is one of the most feature-packed terminal file managers.
+description: 'RTFM v7.5.0: Native Kitty graphics protocol - images now display perfectly
+  in kitty terminal with no flash. 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, bookmarks,
+  and much more. You can bookmark and jump around easily, delete, rename, copy, symlink
+  and move files. RTFM is one of the most feature-packed terminal file managers.'
 email: g@isene.com
 executables:
 - rtfm