FAQ

    Exchange: Import & Export

  1. How to import books into MapleRead?
  2. How to import books via PC Upload (Wi-Fi)?
  3. My books are already in Calibre. How can I leverage PC Upload?
  4. How to import books from Calibre via its Content Server?
  5. How to import all books from Calibre in one shot?
  6. When and how to use Smart Batch Download for OPDS catalogs?
  7. How to read books in formats other than EPUB and PDF?
  8. How to read non-DRM-free ebooks?
  9. How to transfer books from Kindle?
  10. How to export a user-defined (reading) theme?
  11. How to export a user-defined (library) scene?
  12. How to share books in MapleRead SE's library via its built-in OPDS/HTML server?
  13. How to install user fonts via PC Upload?
  14. How to uninstall user fonts?
  15. Can I rename a user font after installation?
  16. Can I add a font file of the same font family to an installed font?
  17. Which font styles should I install for each user font?
  18. How to import books from Google Drive?
  19. Library Management

  20. How to find the book I most recently read?
  21. How to find all my unread classic/romance/science fiction books?
  22. How to edit a book's metadata and cover image?
  23. What is a book set?
  24. How to create a user-defined book set?
  25. How to move (copy) multiple books at a time from one book set to another?
  26. How to delete multiple books at a time from a book set?
  27. How to sort books by custom order in Library?
  28. What is a tag?
  29. What is a tag pool?
  30. How to assign (unassign) the same tags to (from) multiple books of a set?
  31. Are the tags of imported books dependent on how I import?
  32. How should I make use of book sets and tags to organize my library?
  33. EPUB Viewer

  34. How to find out my current EPUB reading font size?
  35. How to delete a vocab item?
  36. How to choose a different dictionary?
  37. How to set up my own custom command as part of the context menu?
  38. Can I specify a web browser app for My Dictionary or My Command? If yes, how?
  39. Notes Management

  40. How to review in one place all my notes of a book?
  41. How to sort my notes by location?
  42. How to export my notes?
  43. My wife and I share an iPad. For a book we both read, is there a way to take notes without intermingling?
  44. How to view my notes and vocab of each book on a PC or Mac?
  45. Secure Sync

  46. Does MapleRead allow duplicated books in its library?
  47. How to sync the reading position, notes, vocab and bookmarks of a book across devices?
  48. I've followed the instruction to sync, but it does not work. Why?
  49. I've downloaded the same book from Calibre to two devices. How can the two copies turn out to be different?
  50. Misc

  51. Is there a way to restore the bundled books that I somehow deleted?
  52. Is there a way to backup the whole library and everything?
  53. Can I test drive MapleRead for free on my iPad too?
  54. I still can't find here the answer I'm looking for. Where else may I find it?

How to import books into MapleRead?
There are many ways to import books into the app, most initiated from the multi-tabbed Exchange View. In general, you can either import books by downloading from websites, or from your computers. Websites cover OPDS and HTML websites, including services such as Dropbox. In the typical case that your computers is not hosting a webserver such as apache2, you can use iTunes (USB connection)   , Calibre (Wi-Fi) or our PC Upload (Wi-Fi) service. Unless you have a strong personal preference, we recommend using PC Upload.

How to import books via PC Upload (Wi-Fi)?
PC Upload allows you to easily upload files to MapleRead from your PC using a web browser without installing any plugin or software program.
  1. app: Go to the PC Upload View, which is one of the Exchange views reachable from the Library View by tapping the exchange button at the upper left corner, and tap Start  
  2. PC: Open a modern web browser and type in the URL as instructed by the app
  3. PC: Click the Select Files button to select one or multiple files at a time. Alternatively, drag and drop one or multiple files at a time from any desktop folder to the Drop Files Here area.   
  4. app: Monitor the import status of each file as it is transferred and processed   
Note that you may connect to the app this way from multiple computers at the same time.

My books are already in Calibre. How can I leverage PC Upload?
If you know how to select multiple book entries (files) in Calibre Library View and then drag-and-drop them to the desktop, then you may apply the same method to drag-and-drop them to the Drop Files Here area of the browser window    as explained in “How to import books via PC Upload?

How to import books from Calibre via its Content Server?
Start Calibre's Content Server on your PC, and connect to the server from the app, then download books as usual as from any OPDS server.
  1. calibre: Click the Connect/share button, then select Start Content Server in the drop-down menu  
  2. calibre: Verify that the server is really up by clicking the Connect/share button again and confirming that Stop Content Server is displayed in the drop-down menu  
  3. app: Go to the Websites View  , which is one of the Exchange views reachable from the Library View by tapping the exchange button at the upper left corner
  4. app: Make sure that OPDS segment on the top is highlighted. Tap Edit, and then tap Scan for OPDS sites via Bonjour on the same local area network  , where Bonjour is typically bundled with iTunes
  5. app: Within a few seconds, the Calibre server should be discovered  . If yes, go to Step 9.
  6. app: However, if somehow the server is still not discovered, even after repeating Step 4, then add it manually.
  7. calibre: Find out the server URL, which is displayed after the term Stop Content Server  
  8. app: Tap Add OPDS site, and enter the server URL followed by /opds as the OPDS Catalog Address, then tap Save  
  9. app: Download books as usual as from any (built-in or user-defined) OPDS server, including the use of Smart Batch Download

How to import all books from Calibre in one shot?
By default, Calibre's Content Server returns a maximum of 30 OPDS items per query. If you have hundreds or even thousands of books there and want Calibre to return the full book list with just one instead of tens or even hundreds of queries, you need to change that maximum number.
  1. From the top menu, open Preferences > Preferences  
  2. In the Preferenes dialog, open Sharing over the net  
  3. In the Sharing over the net dialog, change the value of Max. OPDS items per query from 30 to a number larger than the number of books stored there, and click Apply  
  4. Click the Stop Server button if applicable
  5. Follow the instructions of “How to import books from Calibre?” as needed

When and how to use Smart Batch Download for OPDS catalogs?
Instead of downloading books one at a time, with Smart Batch Download you may download many books in a batch with only a few taps from any OPDS catalog. Let's use a built-in OPDS catalog as an example.
  1. Go to Exchange's Websites View and tap Sample Books
  2. On the top toolbar tap the icon ⬇️    to enter Smart Batch Download mode
  3. On the top toolbar with the new icons on the right, tap All  
  4. Tap the third icon from the left to initiate the actual background downloading of all selected book files
Instead of or in addition to Step 3, you may tap any row entry to select or de-select it for download.
Actually Smart Batch Download is much more powerful than just described. Let's look at each of its Prefer menu sections.   Note that book title and author(s) are part of the book metadata. If you have updated the title and/or author(s) instead of other parts of the metadata of a given book in Calibre, then obviously you can no longer rely on the assumption that the OPDS copy and the Library copy share the same title and author(s). In this case, you need to choose Overwrite Metadata for If the downloaded book is a duplicate. Otherwise, choosing Overwrite Metadata for If Library has the same title and author(s) should be sufficient for updating the metadata. In both cases, make sure that you have disabled the relevant metadata writer plugins of Calibre.

How to import books from Google Drive?
Install Google Drive app on your iOS device. From within that app, for each book you would like to export, select the book file, open the action menu, tap Open in and choose Copy to MapleRead.
Alternatively, you can import books more conveniently solely from within MapleRead by choosing Exchange | HTML | Clouds | Google Drive. Note that this option is only available in MapleRead 2.1 or later.

How to read books in formats other than EPUB and PDF?
Books published in neither EPUB nor PDF but in one of over a dozen other formats such as MOBI, AZW3, FB2, TXT can be easily converted by Calibre into EPUB, the most common open ebook format. The converted EPUB books can then be imported from Calibre. Don't worry too much about the technical details in Calibre's ebook conversion manual. The default setting is usually good enough for an excellent conversion result.

How to read non-DRM-free ebooks?
Digital rights management (DRM) schemes are access control technologies. There are a few major competing DRM schemes for e-books, including the ones from Adobe, Amazon and Apple respectively. If you own a non-DRM-free book and want to read it with another ebook reader which takes only DRM-free books, then the DRM stuff must first be removed with some deDRM tool. After the book is deDRMed, it can then be converted with Calibre to EPUB as needed. Purchasing DRM-free ebooks in the first place is perhaps a better option if they are available.

How to transfer books from Kindle?
The iOS Kindle app does not have the capability to export its books to another app on the same device. However, you can access the book files by downloading or syncing them to your PC or Mac using “Kindle for PC” or “Kindle for Mac”. The book files are all stored in Content Folder, the location of which can be found by opening Kindle's Preferences View. Once the book files (with extension azw, azw3, or mobi) are located, they may be deDRMed and converted as needed, before importing.

How to export a user-defined (reading) theme?
Open a (EPUB) book, tap the middle of the screen to bring up the top toolbar, then tap the button to bring up the Theme Control View. Tap Edit Theme to bring up another popup view. Tap a (user-defined) theme entry to bring up the Theme Settings View.    Tap Export... and choose one of the three ways to export & share.

How to export a user-defined (library) scene?
In the Library Bookshelf View, tap Scenes button to bring up the Scene Control View. Tap Edit Scene to bring up another popup view. Tap a (user-defined) scene entry to bring up the Scene Settings View. Tap Export... and choose one of the three ways to export & share.

How to share books in MapleRead SE's library via its built-in OPDS/HTML server?
There are two methods to share books in the library: (1) sharing by selected book sets, and (2) sharing by selected books. For the first method, go to Server View, select OPDS or HTML in the top segment control, and follow the instruction there.   For the second method, go to Library View first. To select one book to share, long press on a book and then tap Server.    To select multiple books to share, tap Edit, select multiple books and tap the action button at the upper-left and then tap Server.
If you want MapleRead SE to serve another MapleRead app, say MapleRead CX, then on that app just follow the instructions marked for app in the answer to How to import books from Calibre via its Content Server?

How to install user fonts via PC Upload?
PC Upload allows you to easily install user fonts to MapleRead from your PC using a web browser without installing any plugin or software program.
  1. app: Go to the PC Upload View, which is one of the Exchange views reachable from the Library View by tapping the exchange button at the upper left corner, and tap Start  
  2. PC: Open a modern web browser and type in the URL as instructed by the app
  3. PC: Click the hyperlink Go to Font Installer on the right below the big icon.    
  4. PC: Click the Font Files button to select one or multiple font files (.ttf, .ttc, .otf) with the same embedded font family name in one shot (on Mac OS X or Windows). Alternatively, select just one .zip file containing such font files.  
  5. PC: Enter the optional Font Display Name. If set, this name instead of the embedded font family name will be used for display purposes in Text Font and Heading Font menus of MapleRead. While the embedded name is typically encoded in ASCII, the display name provided by MapleRead is encoded in Unicode, which is great for showing non-English European names, Chinese/Japanese/Korean names and names in other languages of the world.   Just leave it blank if you don't have a good reason not to do so. (You will then know the embedded font family name after a successful installation.)
  6. PC: Click the Install button.
  7. app: Monitor the import status of each attempted font installation as the files are transferred and processed   
  8. PC: Go to Step 4 to install another font.

How to uninstall user fonts?
From the Text Font menu of any EPUB book, simply swipe left to delete the user font entry you want to uninstall, one at a time.   You may also uninstall all user fonts in one shot by turning on Remove All User Fonts in iOS System Settings, followed by an app restart.  

Can I rename a user font after installation?
No, not directly. But you can first uninstall the user font, then install it again with a new font display name.

Can I add a font file of the same font family to an installed font?
No. If the installed font is a user font (instead of a built-in font), you can first uninstall the user font, then install it again with all the relevant font files of the same font family in one shot.

Which font styles should I install for each user font?
A typical EPUB book makes use of four font styles, namely, regular, bold, italic, and bold italic. Therefore, you are recommended to install those four styles for each user font all at once.   (It doesn't hurt to install other styles of the same font, but probably you won't gain anything more, unless you know your book can take advantage of them by design.) However, for Chinese/Japanese/Korean books written in Han characters, only one style (regular style) for each font is typically supplied by the font foundries.  

How to find the book I most recently read?
In a top-level Library view, tap Sort and select Date Read, you will then see all the books listed in reverse chronological order with your most recently read book on the top. This always works unless you have switched the current book set since you close the book. In that case, switch to the built-in book set All Books, and you'll definitely see the book on the top.

How to find all my unread classic/romance/science fiction books?
In any library view, do Sort by Date Read. As the sort is in reverse chronological order, scroll to the bottom for your unread books under the Never Read section. To show only classic/romance/science fiction or books of other subjects, tap Tags on the upper right corner to open up a menu, and tap None, followed by selecting one or more matching tags of your interest. The more tags you select, the more matching books you'll find. Note that a book may have zero or more associated tags.

How to edit a book's metadata and cover image?
In any library view, long press on the book to open a menu, then tap Get Info to open the Metadata view. Alternatively, you can open the view by just tapping on the book icon in any book-list view. Tap Edit on the upper-right hand corner to enter Edit mode. You may now edit any part of the metadata, and the cover image by tapping the corresponding button.  

What is a book set?
A book set is a collection of books. Every book in the Library can be in one or more book sets. The special set All Books contains every book stored in the Library. You can create a book set with a name you pick, such as “My Favorites” or “Reading List”, to group the books you choose. You can create as many such user-defined book sets as you wish.
A book that does not belong to any user-defined book set is automatically placed in another special set Ungrouped. Thus it is often convenient to switch to Ungrouped, and start to organize books by moving them from there to some user-defined book sets.


How to create a user-defined book set?
You may create an unlimited of user-defined book sets, where each book set can contain any number of books you want. Note that a book can be in one or more book sets at the same time. To create a user-defined book set,
  1. Start from any Library view, and tap Sets near the upper left corner
  2. Tap Edit
  3. Tap the first table row with the label New Book Set...
  4. Enter the name of this book set as chosen by you and tap OK

How to move (copy) multiple books at a time from one book set to another?
You may move or copy one or more books at a time from one book set A to another book set B as follows. Suppose the library is set in flat list view.
  1. Tap Sets and switch to book set A if needed, and tap Edit
  2. Tap each book that you want to move (copy)
  3. Tap Move (Copy), and then choose book set B in the popup menu

How to delete multiple books at a time from a book set?
Suppose the library is set in a flat view.
  1. Tap Sets and switch to the book set if needed, and tap Edit
  2. Tap each book that you want to delete
  3. Tap the “trash can” icon

How to sort books by custom order in Library?
You may sort books in any (custom) order you like in each user-defined book set created by you, but not in the two built-in book sets, namely All Books and Ungrouped. As each user-defined book set has its own custom order, changing the custom order of one set does not affect that of another set. Now, assume that you have switched to a user-defined book set, say, “Demo”, and want to re-order its books as you like.
  1. Switch to the Flat Booklist view
  2. Change Sort type to Custom Order  
  3. Tap Edit
  4. Tap Reorder  
  5. Long press and drag each book to where you like  
  6. Tap Done
You may then switch to the Flat Bookshelf view if you like. Note that the custom ordering of books in the Flat Booklist view (going top-down) and that of the Flat Bookshelf view (going top-down left-right) are the same. Note that the same custom ordering is used in both portrait and landscape orientations.

What is a tag?
A tag may be used to denote a category, a subject or any attribute you deem appropriate. A book may have zero, one or more tags. For each book set, there is a corresponding tag list   , which is shown on tapping Tags button at the upper right corner of a library view. The tag list contains and only contains all tags of every book in the set, plus the special tag [Untagged] in case some book does not have any tag.
A book of a set is visible if and only if it has at least one tag matching a checked tag in the corresponding tag list.    Note that by checking and unchecking tags, you only affect the visibility of the books, but not their actual set membership.

What is a tag pool?
The tag pool of your library    is the set of all tags ever assigned to any one book of your library, plus optional tags you have explicitly added. It is accessible by tapping Tags and then Pool. To add a new tag to the tag pool, you may enter it by typing, or tapping + to access a list of category tags    commonly found in bookstores and physical libraries.

How to assign (unassign) the same tags to (from) multiple books of a set?
Go to a Library view.
  1. Tap Sets and switch to the given book set if needed, and tap Edit
  2. Tap each book that you want to assign (unassign) the same tags
  3. Tap the action button at the upper left corner, and then choose Assign Tags...   in the popup menu
  4. Select segment , and select each tag you want to assign
  5. Select segment , and select each tag you want to unassign
  6. Tap Save  
Note that book tag assignment and unassignment performed inside the app are saved as app data, and do not modify the book files themselves (and thus their unique MD5 signatures).

Are the tags of imported books dependent on how I import?
Yes. EPUB books usually embed multiple subject attributes, which are extracted and saved as tags after import in general. However, if they are imported via OPDS catalogs, then the tags of the corresponding OPDS entries completely override the embedded ones.

How should I make use of book sets and tags to organize my library?
As any book in this app's library may have multiple tags, and may belong to multiple book sets, you may organize your library by purely using tags or sets. There is no single correct way to organize. However, we recommend you to use a hybrid organization. Use tags for intrinsic attributes such as Biography, History, Science, Romance, Science Fiction, and Thriller; use sets for extrinsic attributes such as My Reading List, and My Favorites.

How to find out my current EPUB reading font size?
Turn on Diagnostics in System Settings   . The next time you do a pinch-and-spread    for font size change, you'll see the current reading font size.

How to delete a vocab item?
From within an EPUB book, tap the middle of the screen to bring up the top toolbar. Tap the third icon from the left to bring up a popover view and select the VOCAB segment. Swipe to left on the vocab item you want to delete and tap the red Delete button to confirm. Note that this is a standard iOS swipe gesture that can be found in many iOS apps.

How to choose a different dictionary?
To choose a different dictionary for Define, follow the following steps: (1) open an EPUB book, (2) select some text so as to bring up the context menu, (3) tap More to bring up the More menu, (4) in the Dictionary for Define section choose something else other than the default, iOS Dictionary.
If you choose My Dictionary, you may further customize it by tapping Set My Dictionary... to enter the dictionary URL. A good example of such URL is http://en.wiktionary.org/wiki/{text}, where {text} stands for the word or string to be looked up. Another example is https://en.wiktionary.org/wiki/{text}. In these two examples, http and https are the respective URL schemes.
An iOS dictionary app may or may not have a correpsonding URL scheme. If it has one and you know it, you may use it for My Dictionary, even if the proper URL that should embed “{text}” is missing or unknown. For example, the URL scheme (or one of the URL schemes) of “Merriam-Webster Dictionary” app is “mw-collegiate”, but its proper URL is unknown. To work around the syntax check, enter mw-collegiate://{text}. The catch is that you will then have to manually paste the text into some search bar of the dictionary app when opened. Remember to turn on Implicit Copy in the More menu, so that the selected text is automatically copied to the shared system pasteboard as a side effect of executing such command.

How to set up my own custom command as part of the context menu?
To set up your own custom command, follow the following steps: (1) open an EPUB book, (2) select some text so as to bring up the context menu, (3) tap More to bring up the More menu, (4) turn on Show My Command, (5) tap Set My Command... to enter your own command name, and the URL. A good example of such URL is comgooglemaps://?q={text}, where {text} presumably stands for the place name to be looked up in “Google Maps” app. In cases where you only know the URL scheme but not the proper URL, consult the answer to How to choose a different dictionary? for a workaround.

Can I specify a web browser app for My Dictionary or My Command? If yes, how?
Yes, when the URL scheme in question is either http or https. Two web browser apps are supported. To specify “Safari” app, prepend “{safari}” to the URL. To specify “Google Chrome” app, prepend “{chrome}” to the URL. For example, {safari}https://en.wiktionary.org/wiki/{text} will always open the URL with Safari instead of the built-in simple web browser for Define. This may be useful if you prefer the full-screen view of Safari. Note that this prefix convention is an advanced feature of MapleRead and is not a universal standard.

How to review in one place all my notes of a book?
Open the book containing the notes of interest, tap the middle of the screen to bring up the top toolbar, then tap the button to bring up a multi-segment view. Select the NOTES segment to see the Note List View.
If you want to choose another note list as This List, tap the label in the middle of the third row for iPad, or tap the button on the left of the second row for iPhone.

How to sort my notes by location?
In the Note List View, tap the button, and select Book Location 

How to export my notes?
In the Note List View, tap Edit, then select at least one note. Tap the now-enabled button, and choose one of the three ways to export & share.  

My wife and I share an iPad. For a book we both read, is there a way to take notes without intermingling?
Yes. One way is for each of you to switch to your own note list when you read. Note that you can create and name as many note lists as you like.

How to view my notes and vocab of each book on a PC or Mac?
You can view your notes and vocab via a web browser running on a PC, Mac or (iOS or Android) mobile devices, after the data have been synced to the Cloud. To view the sync data securely, go to www.maplepop.com and click Login in the top menu bar, and then follow the instruction there. Once you can view your sync data, you can view the updated data (due to your latest sync from your iOS device) by refreshing the corresponding webpage.

Does MapleRead allow duplicated books in its library?
Absolutely no. Two books are considered identical by MapleRead if and only if the two corresponding book files are bit-by-bit identical. Note that two books with identical metadata (title, author, series, tags) and/or filenames are not necessarily identical. If you suspect that two books in MapleRead's library are duplicates, you may reassure yourself that they are not by verifying that they have different MD5 values. To find out a book's MD5 value, which is computed by MapleRead when the book is added, turn on Diagnostics in System Settings   , and then look at the last line in the corresponding Book Info View.

How to sync the reading position, notes, vocab and bookmarks of a book across devices?
Suppose you want to sync data of a book from device A to device B.
  1. device A: Open the book, bring up the toolbar, tap the button.
  2. device B: Open the same book, bring up the toolbar, tap the button.
Note that for device A to see the data changes by device B that has now synced to the Cloud, device A should sync again from the Cloud.
If you want to sync the whole library at a time, you can easily do that by simply tapping the button near the bottom of the Library View. If you want to sync multiple books at a time, you can do that by tapping Edit, then tapping each book you choose to sync, and tap the action button (at the upper left corner) and tap Sync.

I've followed the instruction to sync, but it does not seem to work. Why?
Suppose your network connection is fine for both devices A and B. The most likely reason of failure is that the supposedly identical book on device B is actually different from the one on device A. This can be checked by comparing the MD5 values, as explained in “Does MapleRead ever allow duplicated books in its library?

I've downloaded the same book from Calibre to two devices. How can the two copies turn out to be different?
If you have somehow updated the metadata of the book in Calibre between the two download events, and you import via Calibre's Content Server, then the two downloaded (EPUB) book files can be different due to the change in metadata. By default, Calibre generates a new book file on-the-fly by modifying the original book file with its current metadata as saved in Calibre's Content Library. In contrast, if you drag-and-drop the book from Calibre to PC Upload, then what is downloaded is always the original book file. However, you can change the default behavior of Calibre's Content Server to always serve the original book files by disabling some plugin. Open Preferences > Plugins. Select Metadata writer plugins > Set EPUB metadata, and disable it by pressing Enable/Disable plugin. Disable similar plugins for books of other file formats as needed. Finally, remember to restart the Content Server.

Is there a way to restore the bundled books that I somehow deleted?
Yes. In iOS System Settings. find the matching app name entry, turn on Restore Built-in Books, followed by an app restart.

Is there a way to backup the whole library and everything?
Yes. Independent backup and restore operations are available under the Exchange iTunes tab  . You should do such a MapleRead-specific backup operation, if you want to be sure to restore the library content later after an iOS upgrade, especially via iTunes, in case something has gone wrong. (Note that restoring from standard iTunes or iCloud backup will not work in this case due to an over-restricted App Store policy.) In addition, you may use this mechanism to transfer your whole library and everything from one device to another.

Can I test drive MapleRead for free on my iPad too?
Yes and No. While the free app MapleRead CX is built solely for iPhone, it can also be run on iPad, just as any iPhone app can, albeit in the smaller iPhone format and with limited features. CX with Pro Upgrade is functionally equivalent to CE, but is not as powerful as SE, which has PDF support and the unique Server feature. To download MapleRead CX from within the App Store app on iPad, search for mapleread, and select iPhone Only instead of iPad Only in the leftmost menu.   Have fun test-driving! 😊

I still can't find here the answer I'm looking for. Where else may I find it?
You may look at Overview and What's New, especially the screenshots there.