rtfm-filemanager 7.4.4 → 7.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 440ceb07d691f73f54c697705ba7fbf12a9b99dadef6ca8d0000c55a4b700388
-  data.tar.gz: b3f74a7003436a6da9ecc72ba4372d67a148635d79e1444695e4af91e91a60c2
+  metadata.gz: 18d2abf32d35fbe13e8c5ff3b3844b9c7db92161d20a997a87d61a8afd084020
+  data.tar.gz: 2b136306fcf627c432f159671ccc9fe8210028df6b4955ed29dfb7422ae759d3
 SHA512:
-  metadata.gz: e39e16a338f15eb3f226990c011273060396fb2a2fa6a60844a8c993e3ed032e98951d0e5e7d2f90ea939193928953a9a9950b53dbfe5b15ee7d87c264c531f8
-  data.tar.gz: 7955536ab5b28817ca0eb41a8ce6a86b0671037346f3bdd8c003cbbb819c4ec15de41c57b6a1dadf5383a39c722d2218995bcce11fa6f00c3b831f106157ea16
+  metadata.gz: '0259ce617aee78996ba25cb4338712d0cac66905ceff53240ddc0a0076996c78ca863cc9826892ea6d520c03c714389ccf83d06a09823dd6e2307a6df51165b9'
+  data.tar.gz: a2334d014d7534233e1059bbd6bcb78fd126e4c0e38db645a95024bbd9d6a3db4797bac142b60016ff439b43f6790e94cdd827237b5d9eb5cf66616e89c2af4d

data/CHANGELOG.md

@@ -5,6 +5,22 @@ 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

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.4' # Fix 'z' command to use current file when nothing tagged and detect archive type
+@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
@@ -4863,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
     
@@ -4903,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
 
@@ -5527,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
@@ -5724,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
 
@@ -5754,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.4
+  version: 7.5.0
 platform: ruby
 authors:
 - Geir Isene
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-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.4: Fixed 'z' (extract) command to use current file when nothing tagged and auto-detect archive type (zip, rar, 7z, tar.bz2, tar.xz, tar.zst).
-   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