Hey r/Calibre 👋

This is my first Calibre plugin, so constructive feedback is much appreciated.

**TL;DR**: Free Calibre plugin that batch-processes EPUBs with one click. Repairs, optimizes, and cleans your ebook files automatically. Always creates backups. Works on all platforms.

# Why I built this

I was tired of manually running the same sequence of operations on every EPUB I added to my library (refreshing HTML, cleaning up CSS, fixing errors, optimizing images). So I created a single tool that does it all in one click, with batch processing support.

# What it does

The plugin chains multiple EPUB processing operations into a single automated workflow:

* **Convert EPUB to EPUB** \- Refresh and normalize HTML structure
* **Repair HTML errors** \- Fix malformed markup automatically
* **Beautify code** \- Properly format and indent all code
* **Remove unused CSS** \- Strip out bloated, unused styles
* **Check & auto-fix errors** \- Validate and repair EPUB structure
* **Remove embedded fonts** \- Clean up unnecessary font files
* **Resize images** \- Optimize images to 480px width (perfect for e-ink readers like Xteink)

# Key Features

1. **Simple checkbox interface** \- No command line, no complex configuration 
2. **True batch processing** \- Select dozens of books, process them all at once 
3. **Automatic backups** \- Always creates `filename_backup.epub` before modifications 
4. **Bilingual** \- Fully translated in English and French (auto-detects Calibre's language) 
5. **Non-destructive** \- Your original files are always preserved 
6. **Built on Calibre's polish tools** \- Uses Calibre's proven, reliable processing engine

# Installation (takes 1 minute)

1. Download `epub_workflow_plugin.zip` from the [GitHub repo](https://github.com/kxrz/calibre_workflow)
2. In Calibre: **Preferences → Plugins → Load plugin from file**
3. Select the ZIP file and restart Calibre
4. Add the toolbar icon: **Preferences → Interface → Toolbars & menus**

Then, it's ridiculously simple:

1. Select one or more EPUB books in your library
2. Click the **EPUB Workflow** toolbar icon
3. Check the operations you want to perform
4. Click **OK** and grab a coffee ☕

The plugin processes everything automatically. Find your optimized EPUBs in the same location, with backup copies safely stored.

# Technical Details

* **Requirements**: Calibre 6.0+
* **Platforms**: Windows, macOS, Linux
* **Dependencies**: None (uses built-in Calibre tools)
* **Also includes**: Standalone Python CLI version for automation scripts

# Open Source

Full source code, documentation, and issue tracker:  
**GitHub**: [https://github.com/kxrz/calibre\_workflow](https://github.com/kxrz/calibre_workflow)

The CLI version is in the `Python-CLI` folder if you prefer scripting or automation workflows.

# Limitations & Notes

⚠️ **Image resizing is irreversible** (but backups are always created first)  
⚠️ Some heavily DRM-protected EPUBs may not be compatible  
⚠️ Processing time varies based on file size and selected operations

>Hope this helps your ebook management workflow! Let me know what you think.

EPUB Workflow - Batch Process & Optimize Your EPUBs with One Click