Simple yet powerful tool to create ebook in CLI.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Gem Version Build Status Coverage Status Inline docs Join the chat at

Epuber is simple tool to compile and pack source files into EPUB format. Offers to define multiple "targets" which allows to create multiple versions of the book by running only one command. Eliminates copying code and information, eliminates needs to use git branches to differ ebook content.


Simple example of .bookspec file defining all book's metadata and Table Of Contents. This file can be generated by running command epuber init. do |book|
  book.title = 'Epuber example book' = 'Roman Kříž'
  book.isbn = '123-45-67890-12-3'
  book.version = '1.0.1'
  book.build_version = '5'

  book.cover_image = 'cover'
  book.add_default_style 'default_style.styl'

  # create spine and toc
  book.toc do |toc|
    toc.file 'cover', :landmark_cover
    toc.file 'copyright', :landmark_copyright
    toc.file 'toc', :landmark_toc

    toc.file 'intro', 'Intro'

    toc.file 'chapter_01', 'Chapter One' do
      toc.file '#section_01', 'Section One, awesome'
      toc.file '#section_02', 'Section Two, more awesome'
      toc.file '#section_03', 'Section Three, wow, much, very'

    toc.file 'conclusion', 'Conclusion'

    toc.file 'footnotes', 'Footnotes', linear: false

  # load basic validators folder with ruby scripts
  book.use 'basic_validators/'

Except for paths to plugins book.use, every path could be only name of the file, even without extension. So you can rename them, move them, the correct path will always resolved. Only exception is when the same name has more then one file.

       | Epuber

-----------|------------------------------------------------------------ 📖 | Creates seamless workflow for creating ebooks 🚝 | Defines different targets for several book stores (iBookstore, Google Play store, ...) 🔧 | Extend and customise the functionality with plugins ✏️ | Defines constants so you can have link to related book in proper book store 📝 | Defines mechanisms to deal with duplicated 🎩 | Easy setup assistant to get started in a few minutes 👻 | Automatically validates generated text so you don't have to worry about typos and other mistakes 🚀 | Saves you hours when developing new or updating existing book 📃 | Supports template engines, CSS preprocessors and standard EPUB formats at the same time 💻 | Have local development web server to iterate and experiment quickly | Automatically refresh web browser when some source file changes 💣 | Quick jumping through pages with arrow keys on keyboard 📕 | Supports EPUB 2 and 3


First of all Epuber uses RMagick which has several external dependencies, so you have to install that first:

  • ImageMagick
  • pkg-config

On OS X make sure you Xcode Command Line Tools installed:

xcode-select --install

And the easiest way to install prerequisites on OS X is to use brew:

brew install imagemagick pkg-config

On Ubuntu, you can run:

sudo apt-get install libmagickwand-dev


Then just type following line to terminal:

sudo gem install epuber

If everything goes well, try running following line in terminal:

epuber --help


After checking out the repo, run bundle install to install dependencies. Then, run rake spec to run the tests.

To install this gem onto your local machine, run bundle exec rake install.


Bug reports and pull requests are welcome on GitHub at This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.


  • move all cards from Trello to GitHub
  • create documentation
  • create several examples of book specification


The gem is available as open source under the terms of the MIT License.