claudeers.
// Claude Plugins

openzine

Turn a PDF or a folder of images into a 3D flip book you can page through. A skill for Claude Code and Codex.

// Claude Plugins[ api ][ web ][ mobile ][ claude ]#claude#plugins◷ NOASSERTION$open-sourceupdated about 1 month ago
Actively maintained
100/100
last commit about 1 month ago
last release about 1 month ago
releases 1
open issues 0
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up openzine (claude-plugin project) into my current project.
Found on https://claudeers.com/openzine
Repo: https://github.com/JosssphZhou/openzine
Homepage/docs: https://openzine.pen-ine.workers.dev
Detected install method: claude-plugin → /plugin install openzine@JosssphZhou/openzine
Category: plugins. Platforms: api, web, mobile.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)
/plugin marketplace add JosssphZhou/openzine
/plugin install openzine@JosssphZhou/openzine
// or clone
git clone https://github.com/JosssphZhou/openzine

// compatibility

Platformsapi, web, mobile
Operating systems—
AI compatibilityclaude
LicenseNOASSERTION
Pricingopen-source
LanguageJavaScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

OpenZine: a PDF to an agent, a book in seconds. A booklet cover bends in 3D beside the title.

OpenZine is an agent skill that turns a PDF or a folder of page images into a 3D booklet you page through in the browser.

Try it: page through a live booklet. 中文说明

The page-turn renderer, paper shader and paper grain come from Paper's paper.design/mono. They are copyright Paper and are not under this repository's MIT License. See Credits.

What it does

Pages turn like paper

Each page bends as it turns, catches the light, and casts a shadow on the page underneath. The paper has a grain texture.

An OpenZine booklet mid-turn: a page curls over the spine and catches the light

Ways to turn a page

  • Drag a page. Let go and it falls the rest of the way at the speed you gave it, or drops back if you did not pull it far enough.
  • Click a page to turn it.
  • Press and hold on a page to keep turning. Each turn comes faster than the one before.
  • Press the left and right arrow keys to turn one page. Press Home for the front cover and End for the back cover.

Covers

The first page is the front cover and opens closed, like a real booklet. The last page is the back cover.

Phones

Portrait screens show one page at a time, using Paper's mobile renderer. A Single / Spread switch sits under the page numbers. Switching keeps you on the page you were reading.

A portrait screen: one page at a time, with the Single / Spread switch under the page numbers

PDFs and image folders

  • Give it a PDF, scanned PDFs included, or a folder of PNG, JPG, WebP or AVIF pages.
  • Pages in a different shape are shown whole on a paper-coloured margin. They are never cropped or stretched.
  • A 60-page NASA graphics standards manual went from PDF to finished booklet in 19 seconds.

Claude Code and Codex

OpenZine installs as a Claude Code plugin or as a Codex skill. Any other agent that can read a SKILL.md and run Node.js can use it too.

The result is one .html file with the pages, renderer and grain inside. It makes no network requests, so you can email it or put it on any static host.

Install

Claude Code

/plugin marketplace add JosssphZhou/openzine
/plugin install openzine@openzine

From a local clone, use the folder path instead: /plugin marketplace add ./openzine. The skill is invoked as /openzine:openzine, and Claude also uses it on its own when you ask for a flipbook, zine or booklet.

Codex

Codex loads skills from ~/.codex/skills. Copy the skill folder there and restart Codex:

git clone https://github.com/JosssphZhou/openzine
cp -R openzine/plugins/openzine/skills/openzine ~/.codex/skills/openzine

Then ask Codex for a flipbook, or mention $openzine.

Other agents, or by hand

The skill is the folder plugins/openzine/skills/openzine. It needs only Node.js 18 or newer. Point your agent at its SKILL.md, or run the command yourself.

Use

Ask your agent "make a flipbook from portfolio.pdf", or run the command:

node scripts/make-book.mjs --input <folder-or-pdf> --out <book.html> [--title "My zine"] [--lang en|zh] [--portrait single|spread]

scripts/make-book.mjs at the repository root forwards to plugins/openzine/skills/openzine/scripts/make-book.mjs. --lang zh shows the viewer interface in Chinese; the default is English. Try it on the bundled demo:

node scripts/make-book.mjs --input examples/demo-pages --out demo.html --title "OpenZine demo"

When something fails, the command prints Error: with the cause and the fix, then exits with code 1.

Page rules

  • Order is the file name in natural order (2.png before 10.png). The first page is the front cover, the last is the back cover.
  • An odd page count gets one blank page at the end.
  • PNG, JPG, WebP and AVIF are supported. Other files are skipped and listed.
  • The page shape is width : height = 1 : 1.377 (for example 1440 × 1983 px). Other ratios are shown whole on a paper-coloured margin, never cropped or stretched.
  • PDF pages are converted to 1440 px wide JPGs with Poppler's pdftoppm when it is installed, otherwise with pdf.js (run npm install in the skill folder once). --pdf-engine pdftoppm|pdfjs forces one.
  • Landscape screens show the two-page spread. Portrait screens open with Paper's single-page mobile renderer and show a Single / Spread switch under the page numbers; --portrait spread opens portrait screens on the spread instead.

Limits

  • Needs WebGL. Very old browsers or browsers with hardware acceleration turned off show a load error.
  • Every page is embedded, so a 60-page book of large PNGs can pass 100 MB. JPG pages around 1440 px wide keep it small.

Repository layout

.claude-plugin/marketplace.json     Claude Code marketplace entry
plugins/openzine/                   the installable plugin
  .claude-plugin/plugin.json
  skills/openzine/
    SKILL.md                        instructions for the agent
    scripts/make-book.mjs           the command (no dependencies)
    runtime/openzine.js             prebuilt viewer: Paper renderer + Three.js + viewer shell
    runtime/grain.webp              Paper's paper grain texture
    runtime/PAPERMONO-OFL.txt       licence of the Paper Mono typeface used by the viewer
    package.json                    optional pdf.js fallback dependencies
renderer/                           sources for runtime/openzine.js
  src/book.js, loader.js, performance.js   extracted from paper.design/mono (two-page spread)
  src/mobile-book.js                extracted from paper.design/mono (single page, portrait)
  src/viewer.js                     OpenZine viewer shell
  vendor/three.module.min.js        Three.js r162 from the same Paper bundle
  vendor/PaperMono.woff2            Paper Mono typeface (SIL OFL 1.1), embedded in the viewer
  reference/                        Paper's published files, for verification
examples/demo-pages/                eight demo pages
evidence/                           screenshots and source verification

Rebuild the viewer

npm install
npm run verify:source   # checks book.js and mobile-book.js against Paper's published code
npm run build           # writes plugins/openzine/skills/openzine/runtime/openzine.js

verify:source parses both files and confirms that the extracted renderer differs from Paper's published function only in four documented places: the configurable first spread, the local grain texture URL, a page-change callback, and a controller object in place of the cleanup function. All 16 shader template strings match exactly, and the grain texture matches its recorded SHA-256. It checks mobile-book.js the same way against Paper's mobile function: all 14 shader template strings match, and the only differences are the local grain texture URL, one added page-change call, and the controller object. The mobile camera frame constant is compared with Paper's published value.

Credits

The page-turn renderer, paper shader and paper grain texture are extracted from Paper's paper.design/mono page. They are copyright Paper and are not covered by this repository's MIT License. Three.js r162 is bundled under the MIT License, and the Paper Mono typeface under the SIL Open Font License 1.1. Every generated book links to paper.design/mono in its footer. See LICENSE for which files are under which terms.

License

Mixed. OpenZine's own code is MIT. The Paper renderer, shader and texture are copyright Paper. Three.js is MIT. The Paper Mono typeface is SIL OFL 1.1. LICENSE lists the files under each.

// faq

What is openzine?

Turn a PDF or a folder of images into a 3D flip book you can page through. A skill for Claude Code and Codex.. It is open-source on GitHub.

Is openzine free to use?

openzine is open-source under the NOASSERTION license, so it is free to use.

What category does openzine belong to?

openzine is listed under plugins in the Claudeers registry of Claude-compatible tools.

26 views
★ 41 stars
unclaimed
updated about 1 month ago

// embed badge

openzine on Claudeers
[![Claudeers](https://claudeers.com/api/badge/openzine.svg)](https://claudeers.com/openzine)

// retro hit counter

openzine hit counter
[![Hits](https://claudeers.com/api/counter/openzine.svg)](https://claudeers.com/openzine)

// reviews

// guestbook

0/500

// related in Claude Plugins

🔓

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

// pluginsmultica-ai/★ 230,631[ claude ]
🔓

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explainin…

// pluginsanthropics/⟨Python⟩★ 154,558[ claude ]
🔓

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

// pluginsHKUDS/⟨Python⟩★ 58,467◷ Apache-2.0[ claude ]
🔓

financial-services — a Claude ecosystem project on GitHub.

// pluginsanthropics/⟨Python⟩★ 41,027◷ Apache-2.0[ claude ]
→ see how openzine connects across the ecosystem