Rustybara

Prepress-focused PDF manipulation toolkit for graphic designers and print operators.

Rustybara is the convergence of three standalone prepress CLI tools into a unified Rust library and interactive toolset, built on the same primitives those tools proved in production:

Origin Tool	Primitive
`pdf-mark-removal`	Content stream filtering, CTM math
`resize_to_bleed_or_trim_pdf`	Page box geometry (MediaBox, TrimBox, BleedBox)
`pdf-2-image`	PDF rasterization and image encoding

It ships as a library crate (rustybara), a CLI/TUI binary (rbara), and a GPU-accelerated PDF page viewer (rbv).

Workspace

Crate	Description	License
`rustybara`	Core PDF manipulation library	LGPLv3
`rustybara-icc`	ICC color management — 22 bundled profiles	LGPLv3
`rustybara-wasm`	WebAssembly bindings — browser, Node.js, edge	LGPLv3
`rbara`	Terminal UI (Ratatui TUI)	GPLv3
`rbara-gui`	Native desktop GUI	GPLv3
`rbv`	GPU-accelerated PDF page viewer (wgpu + winit)	GPLv3

Features

Feature	rustybara	rustybara-icc	rustybara-wasm
Page trim & resize	✓	—	✓
CMYK remap	✓	—	✓
Rasterization (pdfium)	✓	—	—
ICC color transforms	—	✓	—
WebAssembly / browser	—	—	✓
Node.js / edge runtime	—	—	✓

Pipeline API — Chain operations fluently: open → trim → resize → remap → save.
Batch processing — Process entire directories of PDFs from CLI or TUI.
Interactive TUI — App-style terminal interface for designers who prefer guided workflows over raw CLI flags. Configurable output directory.
Prepress vocabulary — Every API surface speaks in boxes, bleeds, and DPI — not generic PDF primitives.

Installation

Pre-built installers for rbara (the CLI/TUI binary) are published with each release. Each installer bundles its own pdfium runtime — no system pdfium needed.

Windows

Download rbara-setup-<version>-x64.exe from the Releases page and run it. This is a per-user Inno Setup installer (no admin required) that installs to %LOCALAPPDATA%\Programs\rbara\, registers an opt-in PATH entry, and adds an Add/Remove Programs entry. SmartScreen may warn the first time — the binary is currently unsigned.

macOS

# Apple silicon

tar -xzf rbara-<version>-macos-arm64.tar.gz && cd rbara-<version>-macos-arm64

./install.sh        # installs to ~/.local


# Intel

tar -xzf rbara-<version>-macos-x86_64.tar.gz && cd rbara-<version>-macos-x86_64

./install.sh

The bundle is unsigned; install.sh strips the com.apple.quarantine attribute automatically. To uninstall: ./uninstall.sh.

Linux (glibc x86_64)

tar -xzf rbara-<version>-linux-x64.tar.gz && cd rbara-<version>-linux-x64

./install.sh                       # ~/.local

sudo PREFIX=/usr/local ./install.sh   # system-wide

Tested on Ubuntu 22.04+, Debian 12+, Fedora 38+, RHEL 9+, Arch, openSUSE Tumbleweed. Musl distros (Alpine) need a source build. To uninstall: ./uninstall.sh.

Docker

docker pull ghcr.io/addy-a/rbara:latest


# CLI usage — bind-mount your working directory

docker run --rm -v "$PWD:/work" ghcr.io/addy-a/rbara:latest \

  trim /work/in.pdf -o /work/out.pdf

The image is ~175 MB (debian:bookworm-slim base) and runs as a non-root user.

Building from source

See the Contributing section. The maintainer-side installer scripts live in installer/ (one subdir per platform, each with its own README).

Quick Start

As a library

Add to your Cargo.toml:

[dependencies]

rustybara = "0.1"

use rustybara::PdfPipeline;

fn main() -> rustybara::Result<()> {
    // Trim marks, resize to 9pt bleed, save
    PdfPipeline::open("input.pdf")?
        .trim()?
        .resize(9.0)?
        .save_pdf("output.pdf")?;

    Ok(())
}

Rasterize a page

use rustybara::{PdfPipeline, encode::OutputFormat, raster::RenderConfig};

fn main() -> rustybara::Result<()> {
    let pipeline = PdfPipeline::open("input.pdf")?;
    let config = RenderConfig::prepress(); // 300 DPI

    pipeline.save_page_image(0, "page_1.jpg", &OutputFormat::Jpg, &config)?;
    Ok(())
}

CLI

# Trim print marks

rbara trim input.pdf


# Resize to 9pt bleed

rbara resize --bleed 9.0 input.pdf


# Export pages as 300 DPI PNGs

rbara image --format png --dpi 300 input.pdf


# Remap a CMYK color (rich black → 60/40/20/100)

rbara remap-color --from 1.0 1.0 1.0 1.0 --to 0.6 0.4 0.2 1.0 input.pdf

TUI

Launch rbara with no arguments to enter the interactive terminal interface:

rbara

Arrow keys navigate, Enter selects, Esc goes back. Single-letter shortcuts are shown in the footer bar. Press ? for the full keyboard reference.

rustybara-wasm

WebAssembly bindings for rustybara. Run PDF manipulation in any JavaScript or TypeScript environment — browser, Node.js, Deno, or Cloudflare Workers — with no native dependencies.

Exposes the pure-Rust pipeline subset:

trim() — strip content outside TrimBox
resize(bleed_pts) — expand page boxes by a bleed margin
remap_color(from, to, tolerance) — substitute CMYK values in content streams
to_pdf_bytes() — serialize result as bytes for download or further processing

Rasterization (pdfium) and ICC color transforms (lcms2) require the native crate and are not available in the wasm build.

Browser quickstart

import init, { PipelineHandle } from './pkg/rustybara_wasm.js'

await init('./pkg/rustybara_wasm_bg.wasm')

const bytes = new Uint8Array(
  await fetch('input.pdf').then((r) => r.arrayBuffer()),
)
let handle = new PipelineHandle(bytes)
handle = handle.trim()
handle = handle.resize(8.504)
const result = handle.to_pdf_bytes()

Build

cd rustybara-wasm

wasm-pack build --target web --out-dir pkg --release

npm

npm distribution coming soon. Pre-built artifacts are available via the rustybara playground on the marketing site.

Architecture

Module Map

rustybara/src/
  lib.rs          — Public re-exports
  pipeline.rs     — PdfPipeline: high-level chaining API
  error.rs        — Unified error type
  geometry/
    rect.rs       — Rect (position + dimensions, PDF coordinate system)
    matrix.rs     — Matrix (2D affine CTM transformations)
  pages/
    boxes.rs      — PageBoxes: TrimBox, MediaBox, BleedBox, CropBox reader
    split.rs      — Page extraction and splitting utilities
  stream/
    filter.rs     — ContentFilter: CTM-walking content stream filter
    color_ops.rs  — ColorRemap: CMYK→CMYK value substitution in content streams
  raster/
    render.rs     — PageRenderer trait, CpuRenderer (pdfium-render)
    config.rs     — RenderConfig (DPI, annotation toggles)
  encode/
    save.rs       — OutputFormat enum, image encoding (JPG/PNG/WebP/TIFF)
  color/          — (feature-gated: "color")
    icc.rs        — Re-exports from rustybara-icc crate
    transform.rs  — Re-exports from rustybara-icc crate

rustybara-icc/src/  (separate crate, optionally used via "color" feature)
  lib.rs          — ICC color management engine
  color_space.rs  — ColorSpaceKind enum (CMYK, RGB, Gray, Lab)
  error.rs        — IccError type for color operations
  intent.rs       — RenderingIntent enum for ICC transforms
  pixel_format.rs — PixelFormat enum (RGB8, CMYK8, etc.)
  transform.rs    — ColorTransform: pixel-level ICC profile transforms
  pdf.rs          — PdfColorConverter: document-level color space conversion
  profiles/       — Bundled ICC profiles (FOGRA39, GRACoL2006, etc.)

Public API

rustybara is a high-level, prepress-scoped crate. The public API speaks in prepress vocabulary:

// Prepress operations
PdfPipeline::open(path)?
    .trim()?                    // Remove content outside TrimBox
    .resize(bleed_pts)?         // Expand page boxes by bleed margin
    .remap_color(from, to, tolerance)?  // Substitute CMYK values
    .save_pdf(path)?;           // Write the result

// Rasterization
pipeline.render_page(0, &config)?;                          // → DynamicImage
pipeline.save_page_image(0, path, &format, &config)?;       // → file

// Page inspection
let boxes = PageBoxes::read(&doc, page_id)?;
boxes.trim_or_media()           // TrimBox if present, else MediaBox
boxes.bleed_rect(9.0)           // Expand trim by bleed amount

// Color space conversion (requires "color" feature)
#[cfg(feature = "color")]
{
    use rustybara::color::{ColorTransform, RenderingIntent, profiles};

    let transform = ColorTransform::new(
        &profiles::COATED_FOGRA_39,
        &profiles::COATED_GRACOL_2006,
        RenderingIntent::RelativeColorimetric,
    )?;

    pipeline.convert_color_space(&transform)?;  // Convert entire document
}

Renderer Trait

Rendering is behind a trait for future GPU backend support:

pub trait PageRenderer {
    fn render(&self, page: &PdfPage, config: &RenderConfig)
        -> Result<DynamicImage>;
}

pub struct CpuRenderer;   // pdfium-render — ships today
// pub struct GpuRenderer; // vello/wgpu — future work

Dependencies

Crate	Role
`lopdf` 0.40	PDF object graph manipulation
`pdfium-render` 0.9	PDF rasterization via PDFium
`image` 0.25	Bitmap encoding (JPEG, PNG, WebP, TIFF)
`rayon` 1.11	Parallel page rendering
`rustybara-icc` 0.1	ICC color management (optional, `color` feature)
`lcms2` 6.1	Little CMS color engine (via rustybara-icc, `color` feature)

Runtime Requirement — PDFium

The render_page and save_page_image functions require the PDFium shared library at runtime. Place the appropriate binary alongside your executable:

Platform	File
Windows	`pdfium.dll`
macOS	`libpdfium.dylib`
Linux	`libpdfium.so`

Pre-built binaries: pdfium-binaries

Note: End-users of the rbara binary do not need to do this manually — the pre-built installers bundle the matching pdfium for each platform. This requirement applies only when consuming rustybara as a library in your own Rust project.

Operations that do not rasterize (trim, resize, save_pdf, page_count, PageBoxes::read) work without PDFium.

rbara — CLI & TUI Binary

rbara is the interactive front-end for rustybara. It provides both a flag-based CLI for scripting and a TUI for guided workflows.

Keyboard Reference (TUI)

Key	Action
`↑` / `↓`	Navigate menu
`Enter`	Select / confirm
`Esc`	Back / quit
`t`	Trim print marks
`r`	Resize to bleed
`x`	Export to image
`m`	Remap colors
`p`	Preview page
`o`	Toggle overwrite mode
`/`	Output path
`f`	Change files
`q`	Quit
`?`	Keyboard reference overlay

UX Model

The TUI follows an app-style keyboard model — arrow keys, Enter, Esc — designed for designers who have never used a terminal before. Vim-style bindings may be layered on as aliases in a future version.

File-first workflow: launch → select file or directory → commands become available. Directories auto-glob *.pdf files.

rbv — PDF Page Viewer

rbv is a minimal GPU-accelerated window for PDF page preview, built on wgpu + winit. It is spawned by rbara on demand and communicates via command-line arguments and exit codes.

rbv <file_path> <page_index> [--dpi <n>]

Status: Not yet implemented. See the roadmap below.

Known Limitations

Limitation	Notes
sRGB rasterization only	CMYK→sRGB via PDFium. ICC color transforms available via `color` feature for stream-level operations.
JPEG quality not configurable	Fixed encoder quality. `--quality` flag planned.
Spot color approximation	PDFium renders spot inks as CMYK approximations.
No Form XObject ColorSpace pruning	Inherited limitation from content stream filtering.
`rbv` requires display server	No headless preview. Graceful error on missing GPU.

Roadmap

ICC color management (color module via lcms2) — v0.1.2
CMYK→CMYK color remapping in content streams — v0.1.2
Cross-platform installers (Windows / macOS / Linux / Docker) with bundled pdfium — v0.1.3
GitHub Actions release pipeline (one tag → all installers + GHCR image) — v0.1.3
RGB→CMYK conversion (vector graphics + embedded images)
Spot color detection service
rbv GPU-accelerated page viewer
PDF/X validation and preflight reports
Configurable JPEG quality (--quality flag)

Contributing

cargo test --workspace

MSRV is Rust 1.85 (edition 2024). Do not raise this floor without discussion.
Targets: x86_64, aarch64, wasm32-unknown-unknown (via rustybara-wasm)
The TrimBox is always the source-of-truth reference box. It is never modified by any operation.
Public API additions require documentation and at least one integration test.
The app-style keyboard model is the UX baseline for rbara. Modal bindings are opt-in aliases only.

Cutting a release

Releases are fully automated by .github/workflows/release.yml. To cut a new version:

Bump version in rbara/Cargo.toml (and rustybara/Cargo.toml if the lib changed).
Commit and push.
Tag and push the tag:
```
git tag v0.1.4

git push --tags
```
The workflow will build the Windows installer, the Linux tarball, both macOS tarballs (Apple silicon + Intel), and the Docker image, then create a GitHub Release with all artifacts and a SHA256SUMS.txt attached.

The pdfium chromium build is pinned via PDFIUM_CHROMIUM env var in the workflow (currently 7776). Bump it there to refresh pdfium across all artifacts in lockstep.

Playground

Try rustybara-wasm live in the browser at rustybara.com/playground. Upload a PDF or use a sample file — trim, resize, and remap CMYK values entirely client-side via WebAssembly. No account, no upload, no server.

License

rustybara (library): LGPL-3.0-only
rbara and rbv (binaries): GPL-3.0-only

The LGPL license on the library allows downstream tools to link against rustybara without copyleft obligations on their own code, while the binaries remain fully copyleft.

rustybara 0.1.5