We want to know if you ever have difficulty running CircularFLO.
Please check the topics below or contact us to receive free support.
If the downloaded DMG disk image doesn’t open on your Mac. Please look for a file named ‘CircularFLO_installer.dmg’ in your browser’s download folder. Double click this DMG file to mount on your desktop or go to the Finder menu Go > Computer.
CircularFLO is a Mac only application (OS X 10.6 and later) and requires Adobe InDesign (version CS6 or CC). If you have more then one version of InDesign installed on your Mac then please close other versions and launch a single version of InDesign CS6 or CC prior to launching CircularFLO
For best results, close other applications and any InDesign documents before running and whilst running leave the Mac alone whilst processing.
The Amazon KF8 format is not a sophisticated as the fixed layout EPUB3 and does not yet support the addition of audio, video, animation or read aloud text highlighting.
So, when any of these CircularFLO Pro features have been added to a book, CircularFLO only produces the EPUB file and does not produce a KF8.
If you would like to produce a KF8, please delete or merge the layers containing audio, video, animation or read aloud information and run CircularFLO again. You will not be charged more than once to make the same eBook.
On the rare occasions when the CircularFLO processing has been interrupted then the ‘run log’ file is very useful. It will show us where in the process things have stopped.
The run log is a small text file named ‘run_log.log’ and it can be found from the CircularFLO menu
If you are experiencing a problem and have a run log to share, please attach to an email to our support team with a short description of the problem and a screenshot of any messages shown.
To email a run log open in the Mac Console application please choose to attach to an email from File menu > Mail
The full path to the run log is your User Folder > Library > Application Support > CircularFLO. Please note this is your USER folder Library which is different to your Macintosh HD Library.
The run log does not contain any personal information.
In order to check that your EPUB is complete and ready for submission to retailers we run a validation. See the Understanding EPUB validation below for more.
This validation uses Java which is no longer bundled with later versions of Mac OS X and so to use this feature we require a one time installation of Java. This is freely available from here and this is the same page that Apple also direct users to in order to get Java installed.
The fixed layout EPUB3 files that CircularFLO produces are validated automatically as part of the process. We use the latest EPUB3 EpubCheck to do this.
As the process is automatic it is rare that an EPUB will not validate but if it does then you will be alerted and the run_log will be shown next to the EPUB. Open the run_log in TextEdit and at the bottom you will see the error report,
There is usually a simple reason but unfortunately the simple reason can be hidden in a difficult to understand and scary looking report.
This site helps to decipher what the report means. The most common reason we find is a ‘required elements missing’ error caused by hyperlinks pointing to none existent page.
If you are having trouble understanding a EPUB check report then please email the run_log to firstname.lastname@example.org
If you would like to validate an EPUB yourself outside of the CircularFLO process we recommend the free tool pagina EPUB-Checker.
CircularFLO can create a fixed layout KF8 directly from the fixed layout EPUB3 produced. By dragging the EPUB file onto the free Kindle Previewer you will convert and open the KF8. The converted file is placed in a folder ‘Compiled-content’ next to the EPUB file. Note: you will always see warnings when converting this way due to the EPUB3 code used which is not recognised as part of the KF8 format, this is normal and does not affect how the KF8 file will work.
Alternatively your EPUB3 can be converted to KF8 automatically as part of CircularFLO’s eBook creation process if Kindlegen is present on your Mac. Kindlegen is a free download and available here.
Although the .mobi files seem very large when compared to the EPUB files, this extra size is removed again once the book is distributed by Amazon.
Although we recommend sending the .epub file to Amazon, CircularFLO can also generate a .mobi for ‘side loading’ onto a Kindle Fire device or viewing your book on a desktop computer.
The best way to preview your KF8 file is to side load onto a Kindle Fire device. A good link about doing this is here.
Another way to view you KF8 is to open it in your Mac/PC using Kindle Previewer
Note: Amazon do not (yet) provide a way to preview your KF8 file using their Reading apps. Your published book WILL be available for purchase and viewing as expected once in their Kindle Store however there is currently no way of previewing the file in the Kindle Reading apps for Android or the iOS (iPad and iPhone). The ‘Send to Kindle’ app does not work for fixed layout KF8 and the ‘Kindle’ app for Mac OS gives a different reading experience and does not support comic zoom.
The automatic KF8 conversion will only be carried out on valid EPUB3 file from CircularFLO so it is rare that a valid KF8 will not also be made.
If the process fails you will be alerted and the run_log will be shown next to the EPUB file.
On the rare occasion that a conversion fails it is usually due to hard to compress images when using the KF8 text zoom mode. The run_log will show the name of the image but if you are having trouble understanding a Kindlegen report then please email the run_log to email@example.com
Sometimes it may be useful to open your EPUB3 folder to add extra functionality or to add or amend the code or content.
For those curious enough to look into the code we recommend these epub-applescripts to be sure to open up and repack the EPUB correctly.
After the initial purchase and processing on an eBook with CircularFLO you are then able then make unlimited updates to your eBook without charge.
In order to protect this from misuse there are some restrictions in place:
- Files need to remain together with the original InDesign book
- Files need to be the original ones used with the original book. They can be modified and saved but not ‘saved as’ into new documents.
- New files can NOT be added to an existing book
- Files within a book can be updated and new pages added or removed
- Files can be removed from a book
If you are having genuine difficulties remaking a pre-purchased book then please contact us.