pdf-oxide CLI — найшвидший PDF-інструмент для терміналу

pdf-oxide — інструмент командного рядка для швидкої локальної обробки PDF. Використовує те саме Rust-ядро, що й бібліотека — без хмари та системних залежностей. 23 команди: від text і markdown до compress, encrypt та watermark.

Швидка інсталяція (рекомендовано)

Одна команда — ОС та архітектуру буде визначено автоматично.

Linux / macOS

curl -fsSL oxide.fyi/install.sh | sh

Windows (PowerShell)

irm oxide.fyi/install.ps1 | iex

Інші способи встановити

Homebrew (macOS / Linux)

brew install yfedoseev/tap/pdf-oxide

Cargo

cargo install pdf_oxide_cli

cargo-binstall (готовий бінарник)

cargo binstall pdf_oxide_cli

Готові бінарники

Завантажте архів зі сторінки GitHub Releases та помістіть виконуваний файл у каталог зі списку PATH.

Швидкий старт

# Видобути текст
pdf-oxide text document.pdf

# Конвертувати в Markdown
pdf-oxide markdown document.pdf -o output.md

# Конвертувати в HTML
pdf-oxide html document.pdf -o output.html

# Показати інформацію про PDF (кількість сторінок, метадані, шифрування)
pdf-oxide info document.pdf

# Шукати текст (підтримка regex)
pdf-oxide search document.pdf "pattern"

Команди

Команда	Опис	Основні прапорці
text	Видобуває простий текст	--format plain|words|lines, --area x,y,w,h
paths	Видобуває векторні контури	--format json|rects|lines, --area x,y,w,h
markdown	Конвертує в Markdown	—
html	Конвертує в HTML	—
info	Показує метадані й кількість сторінок	—
search	Шукає текст (regex)	-i (без урахування регістру), --pages
images	Видобуває зображення	--area x,y,w,h, --pages
render	Рендерить сторінки в PNG/JPEG	--dpi N, --format png|jpeg, --quality N
merge	Об’єднує кілька PDF	(потрібно щонайменше 2 файли)
split	Розділяє PDF на окремі сторінки	—
create	Створює PDF з Markdown, HTML чи тексту	--from markdown|html|text
compress	Стискає та оптимізує	—
encrypt	Шифрує паролем (заплановано у v0.4.0 — наразі заглушка)	—
decrypt	Розшифровує захищений PDF	--password PW
rotate	Обертає сторінки	--degrees 90|180|270|-90
delete	Видаляє сторінки	--pages
reorder	Змінює порядок сторінок	--order "3,1,2,5,4"
metadata	Читає, редагує або видаляє метадані	--title, --author, --subject, --keywords, --strip
watermark	Додає текстовий водяний знак	--opacity 0.3, --rotation 45, --font-size 48, --color R,G,B
bookmarks	Виводить структуру документа	—
flatten	Згладжує анотації або форми	--forms, --annotations
crop	Обрізає поля сторінок	--margins L,R,T,B
forms	Виводить, заповнює або експортує поля форм	--fill "k=v,…", --export fdf|xfdf, --area x,y,w,h

Усього 23 команди. Повний перелік прапорців кожної з них показує pdf-oxide <команда> --help.

Глобальні параметри

-o, --output <PATH>        Вихідний файл (за замовчуванням stdout для текстових виводів)
-p, --pages <RANGE>        Діапазон сторінок: "1-5", "1,3,7", "1-3,7,10-12"
    --password <PW>        Пароль для зашифрованих PDF
-v, --verbose              Показує час виконання
-q, --quiet                Придушує несуттєвий вивід
-j, --json                 Вивід у форматі JSON
    --no-banner            Пропускає банер REPL

Приклади

Видобути сторінки 1–5 у Markdown:

pdf-oxide markdown report.pdf --pages 1-5 -o report.md

Об’єднати три PDF:

pdf-oxide merge cover.pdf body.pdf appendix.pdf -o combined.pdf

Додати водяний знак:

pdf-oxide watermark contract.pdf "DRAFT" --opacity 0.2 --font-size 72

Заповнити поля форми:

pdf-oxide forms application.pdf --fill "name=Jane Doe,date=2026-02-28" -o filled.pdf

Пошук regex без урахування регістру:

pdf-oxide search paper.pdf "neural.?network" -i

Відрендерити першу сторінку як PNG 300 DPI:

pdf-oxide render report.pdf --dpi 300 --format png --pages 1 -o page1.png

Видобути шар векторних контурів схеми у JSON:

pdf-oxide paths schematic.pdf --format json -o paths.json

Інтерактивний REPL

Запустіть pdf-oxide без аргументів — відкриється інтерактивний режим:

$ pdf-oxide
pdf-oxide> text /path/to/doc.pdf
(з'являється видобутий текст)
pdf-oxide> info /path/to/doc.pdf
(з'являються метадані)