PDF flipbook in TYPO3 – no Ghostscript, no Imagick, no server overhead

PDF flipbooks in the browser – without any server overhead

Brochures, catalogues, price lists – many companies have documents that deserve more than just a PDF link. A flipbook that feels like a real publication makes the difference between "download and forget" and "browse and engage".

I built a TYPO3 extension that does exactly this – without the server dependencies that usually make these kinds of solutions complicated.

The problem with classic PDF flipbook solutions

Most flipbook solutions for CMS platforms work like this: the PDF is converted into individual images on the server at upload time. That requires tools like Imagick or Ghostscript on the server – software that's often unavailable on shared hosting, can't be installed on managed hosting, and is configured differently on every server.

The result: extensions that work on your own machine but fail at the client's. Or solutions that require a dedicated server.

My approach: everything in the browser

The aistea FlippingBook Extension for TYPO3 v14 takes a different approach. There is no server-side PDF conversion, no shell commands, no external dependencies. The PDF is rendered directly in the visitor's browser – using pdf.js by Mozilla and StPageFlip for the page-turning animation.

What that means in practice:

• Works on any hosting – shared, managed, VPS, anything
• No server-side setup required
• No Ghostscript, no Imagick, no shell permissions needed
• All vendor assets are bundled locally – no external CDN dependencies

What it looks like

On desktop, visitors get a full flipbook with a realistic page-turning animation – pages that flip, an optional fullscreen mode and a download button. The first and last pages can be marked as hard covers for an even more book-like feel.

On mobile devices, the extension automatically switches to a scroll mode: pages are loaded incrementally, no long initial load times, no reserved empty space for the entire document at once. For users who prefer the flipping experience on mobile, flip mode can be enabled there too.

For editors: as simple as inserting an image

The TYPO3 backend has a dedicated content element Aistea FlippingBook. Upload the PDF, optionally add a cover image, done. Width, height, start page, theme and shadow intensity can all be adjusted – but don't have to be. The default values work well for most use cases out of the box.

What is it good for?

• Product catalogues and brochures
• Annual reports and company reports
• Price lists and leaflets
• Presentations meant to be browsed online
• Magazines and customer publications

Not ideal for very long PDFs with hundreds of pages – memory usage in the browser increases accordingly. For brochures, catalogues and presentations up to around 50–60 pages, the extension is a great fit.

Availability

The extension is open source and available on GitHub. It requires TYPO3 v14 and is installed as a Composer package. If you have questions about integrating it into an existing TYPO3 project, feel free to get in touch.

TL;DR

1. PDF flipbook as a TYPO3 content element – no Ghostscript, no Imagick, no shell commands
2. Rendering runs entirely in the browser with pdf.js and StPageFlip
3. Works on any hosting type
4. Desktop: real page-turning animation with fullscreen and download
5. Mobile: incremental scroll mode for fast loading
6. Open source, TYPO3 v14, install via Composer