Entries for September 2017

29 eBookBinder Tutorial - Embed Video- and Audio-files

In the following, I'll explain in detail how video- and audio-files have to be prepared/embedded in text-files so eBookBinder can integrate them later in the final eBook. This article has become quite long and sometimes a bit technical. But if you have done it once, consecutive edits should then easily go of the hand. A small note: For this tutorial eBookBinder 1.4.0 Beta 1 is required. You can download this version from following links:

Whether you use the Sandboxed- or the sandbox-free-version, does not matter in this case.

For more information about eBookBinder 1.4.0 Beta 1 can be found in the last post::eBookBinder 1.4.0 Preview

Now, let's get to the topic:

What has to be considered

When using audio- and video-files inside eBooks you need to consider a few things.

1. Not all eBook-readers and -programs for reading eBooks support audio- and video-files. In particular, eBookreaders with eInk technology can not play videos in most cases.

2. The choice of video- and audio-format. For video formats there are basically three options:

  • mp4
  • ogg
  • webM

iBooks and eBook-Readers based on the Webkit-engine running on Apple devices can also play the mov format. iBooks however, cannot play neither webM nor ogg. In order to achieve maximum coverage the mp4-format should be used.

For audio-files, the following three formats are supported in principle:

  • mp3
  • ogg
  • wav

Also in this case there should be used only one format: mp3. Mp3 offers the widest coverage and causes the fewest problems.

Video- and Audio-files in eBookBinder

Like pictures, video- and audio-files need to be included in the chapters itself before they are added in eBookBinder. For doing so, the textfile-formats RTFD, Textbundle and Textpack are the best choices.


RTFD files can be easily created with Apple's word-processor Textedit, which is pre-installed on every Mac. The video- or audio-file that you want to add to the chapter can be easily added via drag'n drop into the text at any location. That's all in this case to prepare. When importing the chapter, eBookBinder automatically detects the included video/audio-file and prepares the chapter to embed the video for the final eBook. Within the Chapter-editor the result can already be watched.

Textbundle- and Textpack-files

Embedding video- and audio-files in Textbundle-/Textpack-files must comply to following conditions:

  • the media files must be in the directory assets of the respective Textbundle- or Textpack-file
  • a correct integration of the HTML-code in the text, so that the media can be displayed

Textbundle-/Textpack-files are always associated with a markup-language. For the languages ​​Markdown, MultiMarkdown and Wikitext the examples below can be copied directly. Additional formatting is necessary for other languages (for example, in Smark the code below has to be embedded in %SAVED-HTML-1%).

After embedding, do not forget to replace the file name ( and ) in accordance with the name of your own files.

<video src="assets/video-file.mp4" type="video/mp4" controls="controls">
Your browser does not support the video tag.

<audio src="assets/audio-file.mp3" type="audio/mpeg" controls="controls">
Your browser does not support the audio tag.

If this preliminary work is completed on each chapter you want videos in, the chapters can be added directly into eBookBinder. Everything else is done by eBookBinder automatically.

Until next time!

22 eBookBinder 1.4.0 Preview

It's been a while since the last update of eBookBinder. Version 1.4.0 will be a free update for all existing users of eBookBinder, sports some interesting new features, especially a lot of internal improvements and upgrades with it. Due to internal changes the system requirements for eBookBinder had to be raised to macOS 10.10 or later. Because of the many internal changes, the test phase until the final release will be a little longer than usual.

Textbundle / Textpack

One of the most important new features is the support for Textbundle- and Textpack-files. Both formats are open standards that are of particular interest to those using markup-languages ​​in their documents. The special thing about these file formats is that media-files are included (pictures / video / audio) in a open container and therefore the access to the data is convenient. For more information about the Textbundle-format can be found on the official site: http://textbundle.org

Audio / Video

Since the first release of eBookBinder I get requests regarding video- and audio-file-support every now and then. Now it is finally here, eBookBinder can see embedded video- and audio-files in chapters and include them in the final eBook. However, there's a few things to consider, currently only video- and audio-files in RTFD, Textbundle- and Textpack-files can be processed. In addition there are a few more things that need to be considered. I will publish a detailed tutorial soon. Those who want to experiment with video- and / or audio-files at once, should use the writing-app Textedit (on any Mac already installed) with RTFD-file-format and use mp3-files for audio and mp4-files for video.


The last topic I want to discuss is the creation of mobipocket-files (kindle Amazon eBook reader). In recent macOS versions SIP (System Integrity Protection) was introduced. SIP prevents eBookBinder, which operates in a sandbox, the access to the "kindlegen" Terminal-tool, which is necessary for the creation of mobipocket-files. For those who want to create mobipocket-files with eBookBinder, I now offer a sandbox-free version of eBookBinder directly on this page. Mac App Store customers of eBookBinder are automatically recognized and can use the direct version without restrictions.

The most important thing: the download links to eBookBinder 1.4.0 Beta 1 and the complete, detailed list of changes:

  • Note: - Changed System-Requirements; eBookBinder requires mocOS 10.10 or higher
  • Note: - Changed internal save-dtructure: eBookBinder 1.4.0 uses a new internal save-structure. When using eBookBinder 1.4.0, you should avoid further use of an older version of eBookBinder

eBookBinder 1.4.0 complete list of changes


  • (direct-version only) kindlegen-support and support of the MultiMarkdown-Terminal-Tool in der the sandbox-free version of eBookBinder 1.4.0
  • (direct-version only) update-checker implemented
  • Textbundle- and Textpack-files have been added to the list of supported files whick can be imported
  • support for embedded video- and audio-files in RTFD- and Textbundle/Textpack-files
  • rearranged preferences
  • chapter-files can now added to the chapter-table using drag'n drop
  • new appearance for the dark-mode
  • when using the dark-mode, the chapter-editor also gets a dark appearance


  • new markup-transformation-engine implemented
  • several elements of the user-interface adjusted to match the appearance of the laters macOS versions
  • many internal elements of eBookBinder optimized or reworked
  • website-links in the menu-bar have been updated
  • improved saving when adding chapters to a project
  • help-files updated

Until next time!

   October (1)
   September (2)
   August (3)
   July (1)
   June (1)
   May (5)
   April (1)
   March (3)
   February (1)
   January (1)
   December (1)
   November (1)
   October (1)
   September (2)
   August (2)
   July (4)
   June (3)
   May (1)
   April (2)
   March (3)
   February (3)
   January (2)
   December (1)
   November (4)
   October (1)
   September (1)
   August (2)
   July (2)
   June (4)
   May (1)
   April (1)
   January (1)
   December (1)
   October (2)
   July (2)
   June (1)
   May (1)
   April (1)
   March (1)
   February (1)
   January (2)