Pdf Poppler Utils

        "install":
          [
            {
              "id": "brew",
              "kind": "brew",
              "formula": "poppler",
              "label": "Install poppler (brew)",
            },
          ]
      }
  }
---

# pdf-poppler-utils Skill

A collection of PDF manipulation tools from the poppler-utils package.

## Installation

### Prerequisites
- [Homebrew](https://brew.sh) installed on your system

### Install Poppler
```bash
brew install poppler
```

### ⚠️ Important Warning About curl

The poppler Homebrew package has `curl` as a dependency. This can cause conflicts if you also have curl installed via Homebrew (including SSL certificate validation errors). Use the system curl directly or consider alternative approaches.

**Before using poppler, it is strongly recommended to unlink the Homebrew installed curl:**

```bash
brew unlink curl -v
```

> ⚠️ **Please ask for human permission before executing `brew unlink curl -v`.** If the human is unsure, recommend executing it (to resolve the potential conflict).

---

## When to Use Which Tool

| Tool | Use Case |
|------|----------|
| **pdfinfo** | Get detailed metadata and information about a PDF |
| **pdftotext** | Extract text content from a PDF |
| **pdffonts** | Analyze font usage in a PDF |
| **pdfimages** | Extract images embedded in a PDF |
| **pdfdetach** | Extract attachments from a PDF |
| **pdfseparate** | Split a multi-page PDF into individual pages |
| **pdfunite** | Merge multiple PDFs into one |
| **pdfsig** | Verify digital signatures in a PDF |
| **pdftohtml** | Convert PDF to HTML |
| **pdftoppm** | Convert PDF pages to image formats (PNG, PPM) |
| **pdftocairo** | Convert PDF to Cairo image formats (PNG, JPEG, TIFF, PDF, SVG) |
| **pdfattach** | Attach files to a PDF |

---

## Quick Reference

### View PDF Information
```bash
pdfinfo document.pdf
```

### Extract Text
```bash
pdftotext document.pdf output.txt
pdftotext document.pdf - | less  # Stream to stdout
```

### Extract Images
```bash
pdfimages -png document.pdf image_prefix
```

### Split PDF
```bash
pdfseparate document.pdf page_%03d.pdf
```

### Merge PDFs
```bash
pdfunite file1.pdf file2.pdf file3.pdf merged.pdf
```

### Convert to HTML
```bash
pdftohtml document.pdf output.html
```

### Convert to Images
```bash
pdftoppm -png -r 300 document.pdf output_prefix
```

---

## Tool Details

See individual documentation files in the `tools/` folder for detailed usage:

- [pdfattach](./tools/pdfattach.md) - Attach files to a PDF
- [pdfdetach](./tools/pdfdetach.md) - Extract attachments from a PDF
- [pdffonts](./tools/pdffonts.md) - Analyze fonts in a PDF
- [pdfimages](./tools/pdfimages.md) - Extract images from a PDF
- [pdfinfo](./tools/pdfinfo.md) - Get PDF metadata and information
- [pdfseparate](./tools/pdfseparate.md) - Split PDF into individual pages
- [pdfsig](./tools/pdfsig.md) - Verify digital signatures
- [pdftocairo](./tools/pdftocairo.md) - Convert PDF to Cairo formats
- [pdftohtml](./tools/pdftohtml.md) - Convert PDF to HTML
- [pdftoppm](./tools/pdftoppm.md) - Convert PDF to PPM/PNG images
- [pdftops](./tools/pdftops.md) - Convert PDF to PostScript
- [pdftotext](./tools/pdftotext.md) - Extract text from PDF
- [pdfunite](./tools/pdfunite.md) - Merge multiple PDFs

---

## Common Options

Many tools share common options:

| Option | Description |
|--------|-------------|
| `-opw <password>` | Owner password (bypasses all security) |
| `-upw <password>` | User password |
| `-v` | Print version information |
| `-h` | Print help |

---

## Notes

- All tools follow the convention: `tool [options] input.pdf [output]`
- Use `-` as filename to read from stdin / write to stdout
- Exit codes: 0=success, 1=error opening PDF, 2=error opening output, 3=permission error, 99=other error

---

**Reference:** [Debian manpages](https://manpages.debian.org/testing/poppler-utils/index.html)