rtfm-filemanager 7.4.1 → 7.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b14592985e916f098fa5cd315891cbfe528408b206dde1a2bf38ca30f7c61f2d
-  data.tar.gz: 96757864620b16e89a965cca06635d428fdfa16d290c4c366fd0a1c0e602a41c
+  metadata.gz: '018b8cadf670850bb5da46914425bf65bed256bf533619cde79a86981fedd86d'
+  data.tar.gz: 8108aecb15519303db63c76ff43fbf4cf3bedc328ddfb5feaaed9f976cbdb109
 SHA512:
-  metadata.gz: ef0b6f71dadfa936491fc8974e2ed57256276592de9e48fd52be80f5d4d2d35084fb42e9a718a52e22a3020573fd19296d714ef2ee3355cb2ea4b46688ce73a3
-  data.tar.gz: 3cd2798f1d8aba4016150914be9936fb052b30dc10fb2727f48edf3cf88ae096e633f790dc7d7855fc9005244b828e8990ae42989303d3b35071248da0000dd1
+  metadata.gz: 8b2bf86a29246f99523f33a4d0ce2350acf541eae64dcdfe98be8f0623ec0869b3f534df0e6dda28c9e22f762c395ccfaba5d212ea2abe256b791c1c330422f3
+  data.tar.gz: 149c13f402fd5a757d427cd5c93dc450baaf9a5bf002cc40594a09a48c721ad076b3ffca56308cf0731d35ba713e9c429ed4853e38db1631becf751e3cd56ada

data/README.md

@@ -29,6 +29,16 @@ After first run, use `r` command to launch RTFM and exit into your current direc
 
 ---
 
+## Screenshots
+
+| OpenAI File Analysis | Interactive AI Chat |
+|:---:|:---:|
+| ![AI analyzing a PDF](img/screenshot-ai-file.png) | ![AI chat mode](img/screenshot-ai-chat.png) |
+| **Syntax Highlighting** | **System Information** |
+| ![Ruby code highlighting](img/screenshot-syntax.png) | ![System stats (press S)](img/screenshot-system.png) |
+
+---
+
 ## Table of Contents
 
 - [Key Features](#key-features)
@@ -105,6 +115,17 @@ sudo apt install ruby-full x11-utils xdotool bat pandoc poppler-utils \
 gem install rtfm-filemanager
 ```
 
+#### ArchLinux/derivatives
+```bash
+sudo pacman -Syu ruby bat pandoc poppler odt2txt docx2txt unzip gnumeric catdoc w3m imagemagick ffmpegthumbnailer p7zip libreoffice-fresh
+gem install rtfm-filemanager
+```
+
+Note: catppt is not available in official repos, but RTFM will fall back to using LibreOffice's soffice for .ppt files. For xls2csv, use an AUR helper:
+```
+yay -Syu perl-xls2csv
+```
+
 #### macOS:
 ```bash
 brew install ruby imagemagick w3m bat pandoc poppler
@@ -390,16 +411,11 @@ RTFM includes built-in AI features powered by OpenAI's API for intelligent file
 
 ### Setup
 
-1. **Install the ruby-openai gem:**
-   ```bash
-   gem install ruby-openai
-   ```
-
-2. **Get an API key:**
+1. **Get an API key:**
    - Sign up at https://platform.openai.com/
    - Generate an API key from your account settings
 
-3. **Configure RTFM:**
+2. **Configure RTFM:**
    Add your API key to `~/.rtfm/conf`:
    ```ruby
    @ai = "sk-your-actual-api-key-here"
@@ -407,6 +423,8 @@ RTFM includes built-in AI features powered by OpenAI's API for intelligent file
    @aicolor = 17             # Optional: chat pane background color
    ```
 
+The `ruby-openai` gem is already included as a dependency when you install RTFM.
+
 ### Features
 
 #### File Description (Press `I`)

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.0' # Comprehensive documentation release
+@version    = '7.4.2' # LibreOffice soffice fallback for legacy MS Office formats + ArchLinux support
 
 # SAVE & STORE TERMINAL {{{1
 ORIG_STTY = `stty -g`.chomp
@@ -456,7 +456,7 @@ def display_welcome_message # {{{2
   • docx2txt - Viewing MS Word docx files
   • unzip - Viewing MS PowerPoint pptx files
   • ssconvert (from gnumeric) - Viewing MS Excel xlsx files
-  • catdoc, xls2csv, catppt - Viewing older MS Office formats
+  • catdoc/xls2csv/catppt (with soffice fallback) - Viewing older MS Office formats
   • w3m, ImageMagick - Viewing images
   • ffmpegthumbnailer - Video thumbnails\n".fg(195)
 @firstrun += "
@@ -464,11 +464,15 @@ def display_welcome_message # {{{2
 @firstrun += "
   • Linux (Debian/Ubuntu): Use apt
   • Linux (Fedora/RHEL): Use dnf/yum
+  • Linux (ArchLinux): Use pacman
   • macOS: Use Homebrew (brew)
   • BSD: Use pkg or ports
 
   For Ubuntu/Debian users, install all dependencies with:
   sudo apt install ruby-full git libncurses-dev x11-utils xdotool bat pandoc poppler-utils odt2txt docx2txt unzip gnumeric catdoc w3m imagemagick ffmpegthumbnailer
+  
+  For users of ArchLinux and derivatives, install all dependencies available outside of AUR with:
+  sudo pacman -Syu ruby git ncurses xdotool bat pandoc poppler odt2txt docx2txt unzip gnumeric catdoc w3m imagemagick ffmpegthumbnailer
 
   Note: Package names may vary between platforms. The 'libncurses-dev' package is Linux-specific.".b.fg(87)
 @firstrun += "\n\n
@@ -835,9 +839,9 @@ preview_specs = {
   'docx'               => "docx2txt @s -",
   'xlsx'               => "ssconvert -O 'separator=   ' -T Gnumeric_stf:stf_assistant @s fd://1",
   'pptx'               => "unzip -qc @s | ruby -e '$stdin.each_line{ |i| i.force_encoding(\"ISO-8859-1\").scan(/<a:t>(.+?)<\\/a:t>/).each{ |j| puts j } }'",
-  'doc'                => "catdoc @s 2>/dev/null",
-  'xls'                => "xls2csv @s 2>/dev/null",
-  'ppt'                => "catppt @s 2>/dev/null",
+  'doc'                => "catdoc @s 2>/dev/null || soffice --headless --cat @s 2>/dev/null",
+  'xls'                => "xls2csv @s 2>/dev/null || soffice --headless --cat @s 2>/dev/null",
+  'ppt'                => "catppt @s 2>/dev/null || soffice --headless --cat @s 2>/dev/null",
   # compressed archives
   'zip'                => "unzip -l @s",
   'tar'                => "tar -tvf @s",

data/docs/getting-started.md

@@ -21,6 +21,14 @@ sudo apt install ruby-full x11-utils xdotool bat pandoc poppler-utils \
 gem install rtfm-filemanager
 ```
 
+#### ArchLinux/derivatives
+```bash
+sudo pacman -Syu ruby xdotool bat pandoc poppler odt2txt docx2txt unzip \
+  gnumeric catdoc w3m imagemagick ffmpegthumbnailer tar gzip bzip2 xz unrar p7zip libreoffice-fresh
+
+gem install rtfm-filemanager
+```
+
 ### macOS
 
 ```bash

data/docs/troubleshooting.md

@@ -40,10 +40,13 @@ ruby --version
 # Update Ruby (Ubuntu)
 sudo apt install ruby-full
 
+# Update Ruby (ArchLinux)
+sudo pacman -Syu ruby
+
 # Update Ruby (macOS)
 brew install ruby
 
-# Or use rbenv/rvm for version management
+# Or use rbenv/rvm/asdf for version management
 ```
 
 ## Display Issues

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rtfm-filemanager
 version: !ruby/object:Gem::Version
-  version: 7.4.1
+  version: 7.4.2
 platform: ruby
 authors:
 - Geir Isene
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-04 00:00:00.000000000 Z
+date: 2025-11-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rcurses
@@ -67,7 +67,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '7.4'
 description: |-
-  RTFM v7.4.1: Fixed directory cache not updating when files added/deleted externally.
+  RTFM v7.4.2: Added LibreOffice soffice fallback for legacy MS Office formats (.doc/.xls/.ppt) and comprehensive ArchLinux installation support.
    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: