Learn how to prepare an interactive animation or an HTML5 app zip file that can then be added to any ebook as a widget.


With Kotobee Author you can use your favorite HTML5-animation software, such as Adobe Animate, Tumult Hype or Google Web Designer to create HTML5 apps, that will run smoothly inside your ebook. 

An ebook widget is basically a special packaging of an HTML5 app. The HTML5 app may consist of a root HTML file along with a collection of images, javascript, and CSS files. 

Here are some guidelines for the zip file:

  • The root HTML file of the app must be named one of the following names: index.html, index.htm, main.html, main.htm
  • If you would like users to click on an icon that represents this widget, then the widget opens in a popup window, the icon should be named Default.png and should sit at the root level.
  • If you would like to specify further details for the widget, such as the width and height of the container, you may include an Info.plist file. The Info.plist file also allows you to change other things such as the location of the root file. This is an example of an Info.plist file:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0"><dict>
<key>BackwardsCompatibleClassLookup</key>
<true/>
<key>CFBundleDevelopmentRegion</key>
<string>English</string>
<key>CFBundleDisplayName</key>
<string>calculator</string>
<key>BRNotifiesOnReady</key>
<true/>
<key>CFBundleIdentifier</key>
<string>com.bookry.calculator.embed</string>
<key>CFBundleName</key>
<string>calculator</string>
<key>CFBundleShortVersionString</key>
<string>1.0</string>
<key>CFBundleVersion</key>
<string>1.0</string>
<key>KFNotifiesOnReady</key>
<true/>
<key>Height</key>
<integer>768</integer>
<key>MainHTML</key>
<string>ibooks_container.html</string>
<key>Width</key>
<integer>1024</integer>
<key>IBNotifiesOnReady</key>
<true/>
</dict>
</plist>
  •  All the files must be placed into a folder postfixed with ".wdgt". This folder should be compressed into a zip file. This zip file is the widget file.

Now with your zip file ready, you can add the HTML5 app to your ebook as a widget. 

For any difficulties you may face with widgets, please contact customer support.

Next step

Add a widget