mirrors/ohmyzsh-mirror
1
0
Fork 0
mirror of https://github.com/ohmyzsh/ohmyzsh.git synced 2026-01-17 23:57:52 +08:00
Code Issues Releases Wiki Activity
098c2d4c94
ohmyzsh-mirror/plugins/pdf/README.md
Hextron 098c2d4c94 pdf plugin
2024-09-25 00:53:19 +05:30

1.2 KiB
Raw Blame History

PDF Plugin for Oh My Zsh

This plugin provides a convenient way to manage and open PDF files from your terminal using fuzzy finding.

Features

  • Automatically detects available PDF readers (okular, evince, xpdf, firefox, and some others)
  • Creates and maintains a list of PDF files in your home directory
  • Uses fzf for fuzzy finding and selecting PDF files
  • Fallback to find command if fd is not available

Requirements

  • Zsh with Oh My Zsh framework
  • Any suitable PDF reader (e.g., okular, evince, xpdf, firefox, zathura, mupdf, qpdfview, atril)
  • fzf for fuzzy finding (recommended)
  • fd command (optional, improves file search performance)

  1. Activate the plugin in ~/.zshrc:

    plugins=(... pdf)

  2. Restart your shell or run:

    source ~/.zshrc

Usage

Example usage:

# Open fzf to select a PDF
pdf

# Open a specific PDF file
pdf ~/Documents/example.pdf

Configuration

The plugin will automatically create a directory ~/.config/pdfiledoc/ and a file pdfs.txt to store the list of PDF files. This list is updated when:

  • The pdfs.txt file doesn't exist
  • No PDF is selected from the existing list