FAQ

  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 edit a book's metadata and cover image?
  8. How to read books in formats other than EPUB and PDF?
  9. How to read non-DRM-free ebooks?
  10. How to transfer books from Kindle?
  11. How to create a user-defined book set?
  12. How to move (copy) multiple books at a time from one book set to another?
  13. How to delete multiple books at a time from a book set?
  14. How to sort books by custom order in Library?
  15. How to find out my current EPUB reading font size?
  16. How to review in one place all my notes of a book?
  17. How to sort my notes by location?
  18. How to export my notes?
  19. My wife and I share an iPad. For a book we both read, is there a way to take notes without intermingling?
  20. Does MapleRead allow duplicated books in its library?
  21. How to sync the reading position, notes, vocab and bookmarks of a book across devices?
  22. I've followed the instruction to sync, but it does not work. Why?
  23. I've downloaded the same book from Calibre to two devices. How can the two copies turn out to be different?
  24. How to view my notes and vocab of each book on a PC or Mac?
  25. How to export a user-defined (reading) theme?
  26. How to export a user-defined (library) scene?
  27. How to share books in MapleRead SE's library via its built-in OPDS/HTML server?
  28. How to delete a vocab item?
  29. How to choose a different dictionary?
  30. How to set up my own custom command as part of the context menu?
  31. Can I specify a web browser app for My Dictionary or My Command? If yes, how?
  32. How to install user fonts via PC Upload?
  33. How to uninstall user fonts?
  34. Can I rename a user font after installation?
  35. Can I add a font file of the same font family to an installed font?
  36. Which font styles should I install for each user font?
  37. Is there a way to backup the whole library and everything?
  38. Can I test drive MapleRead for free on my iPad too?
  39. 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 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.  

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 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.

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 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.

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.

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.

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 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 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.  

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 What's New, especially the screenshots there.