Skip to content

A simple utility to bulk generate EPUB graphical novels from image files

License

Notifications You must be signed in to change notification settings

ConnoisseurOfCookies/GraphicNovelEPUBuilder

Repository files navigation

Graphic Novel EPUB Builder

Description

A simple tool to create E-reader compatible EPUB files out of image collections

Index

Instructions


File naming

Filenaming convention is Title-Chapter-Page.
  • Chapter: -00x or p000
  • Page: p000, p001, etc.
    • p000 is reserved for the cover page

my_graphic_novel-c001-p000.jpeg

They should be ordered chronologically. You can use the in-app bulk renaming tool if the files are ordered.

Folder Naming

If you're not compiling from multiple folders at once then it doesn't matter.

However, if you are the title will be the folder name. The renaming tool uses the Name-Volume convention, like so:

MyNovel-v001

Bulk Compiling

If you wan't to create multiple graphic novels tick the "Multiple Folders In Directory" checkbox. There should only be folders you intend to turn into EPUB files in the directory.

Make sure there are only image files in the folders and that they follow the naming convention, since the parsing relies heavily on namechecks. Also make sure they're ordered chronologically, page 1 first etc.

Bulk Renaming

If files and folders are ordered chronologically already you can use the bulk renaming tool. Simply select the target folder, choose a title and go. If you're renaming files from multiple folders make sure the parent directory is selected.

Compression

You can adjust the amount of compression by adjusting the slider, the lower the number the lower the quality. At 20, the default setting, a 220+ page novel at 300+ MB compresses down to about 45-50MB, and the images still look quite nice. Incidentally the limit for Kindle E-Mail transfer is around 50MB.

The lowest quality, 0, looks garbage and I do not reccommend. For a shorter comic, or lower quality files, you can get away with no compression.

Issues


  • I've been lazy so limited input validation and no error handling at the UI level

  • Since this app resulted from a quick flight of fancy I haven't written unit or integration tests either, so edge cases are likely to occur

  • Various metadata parsing not implemented in code:

    • Description
    • Tags
    • Author
    • Language

  • This is still a rather crude application but useable if input files are set up correctly

  • Lots of XML writer gore in the code :/

To Do

  • Simplify structures by templating

About

A simple utility to bulk generate EPUB graphical novels from image files

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages