Register Guidelines E-Books Search Today's Posts Mark Forums Read

Go Back   MobileRead Forums > E-Book Software > Calibre Companion

Notices

Closed Thread
 
Thread Tools Search this Thread
Old 08-24-2012, 08:42 AM   #1
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,919
Karma: 1673776
Join Date: Jan 2010
Location: France
Device: Many android devices
Calibre Companion Android App: Information, Change Log, and FAQ

Latest version of Calibre Companion (CC): V3.5.9 on 7/December/2014.

The free demo version of CC is available on Google Play. The full version of CC is available on Google Play and on Amazon.

CC requires calibre version 0.9.2 or later. The "Use calibre's book identifier as file name" option requires calibre version 0.9.15 or later. The performance improvements and new features in CC V3.2.1 require calibre version 1.6 or later. Syncing read information (in CC V.3.3.1) requires calibre 1.28 or later. The "Use the calibre-generated file name in the content server" option (CC V3.4.3) requires calibre 2.0 or later. Several features in CC V3.5.1 require calibre 2.1 or later. Syncing books (CC 3.5.1) requires calibre 2.4 or later.

==============================================

What is Calibre Companion?

Calibre Companion is three applications in one: a superb device-based calibre library organizer, a high-performance WiFi-based calibre device emulator, and a calibre web access client.

The first: CC is a calibre library organizer for your device.
Click the spoiler button for more info and to see some CC screens.
Spoiler:
Once you put books on your device using one of the connection methods described below you can:
  • sort and group books by their metadata (author, tags, series, rating, dates, etc.)
  • see book lists by cover or by list.
  • view details of a book's metadata.
  • mark books read and sync this information with calibre.
  • You can launch your book reader application to read a book (works with most reader applications except for Amazon Kindle).
Click image for larger version

Name:	1.png
Views:	624
Size:	514.2 KB
ID:	120563 Click image for larger version

Name:	2.png
Views:	535
Size:	152.3 KB
ID:	120564 Click image for larger version

Name:	3.png
Views:	474
Size:	278.8 KB
ID:	120565 Click image for larger version

Name:	4.png
Views:	532
Size:	300.7 KB
ID:	120566


The second: Calibre Companion supports connecting to calibre over WiFi and be detected by calibre as a device. No other app, reader or browser, offers this level of integration with calibre.
Spoiler:
  • All calibre device operations are supported, including sending books and metadata, cover thumbnails, deleting books, sending news, and plugins like Reading List.
  • You can specify where different book formats are to go on your device, e.g., epubs in one folder, pdfs in another, and mobis in a third.
  • Calibre Companion updates the metadata for the books on every connect as a wireless device, ensuring the information for your books displayed in Calibre Companion is the same as the information displayed in calibre.
  • Most setup is on the device, making it easy for different users in the same household to have different device configurations, or to use more than one computer running calibre.


The third: Calibre Companion can connect to calibre’s content server.
Spoiler:
Using just your device, you can:
  • Browse all of your library, viewing the books and their metadata.
  • See which books are already on your device.
  • Download books from your library to your device.


Click here to see CC's FAQ

Click here to see CC's Change Log

Last edited by chaley; 12-07-2014 at 01:39 PM.
chaley is offline  
Old 09-06-2012, 02:36 PM   #2
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,919
Karma: 1673776
Join Date: Jan 2010
Location: France
Device: Many android devices
Calibre Companion FAQ


Last edited by chaley; 12-09-2014 at 03:49 AM.
chaley is offline  
Old 01-25-2013, 06:27 AM   #3
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,919
Karma: 1673776
Join Date: Jan 2010
Location: France
Device: Many android devices
Calibre Companion Change Log

CHANGE LOG

V3.5.9 (7/Dec/2014)
  • Increase book limit on demo version to 20
  • [BUG FIX]Fix show read info on booklist option also hiding the option in book details
  • [BUG FIX]Fix sporadic crash when returning to the book list/grid

V3.5.8 (5/Dec/2014)
  • Option to show read check marks in the grid view
  • Option to show cover thumbnails on the right in list view
  • Updated translations: Japanese, Russian
  • Show the name of the other device blocking connections if "calibre is busy" when connecting. Seeing the name requires calibre 2.13 or later.
  • Add code to protect against errors in translated strings
  • [BUG FIX]Fix Read check marks not necessarily appearing after being set in book details
  • [BUG FIX]Fix rare crash on startup after upgrading from several CC versions back

Click on the Spoiler button to see the change log for a previous version. The releases ending in .1 are usually major releases containing many changes and enhancements.

Version 3.5.7 (21/Nov/2014)
Spoiler:
  • Updated translations: German, Japanese, Russian
  • Improvements to debug logging
  • [BUG FIX]Fix rare crash when opening content server book details

Version 3.5.6 (7/Nov/2014)
Spoiler:
  • Option to align cover at top in book list
  • New translation: Japanese
  • Updated translation: German
  • [BUG FIX]Fix rare crash opening the grouping drawer
  • [BUG FIX]Fix restore settings occasionally not restoring some settings
  • [BUG FIX]Fix some strings not re-translating when CC's language is changed

Version 3.5.5b (26/October/2014)
Spoiler:
  • Option not to keep grouping drawer open on wide devices
  • [BUG FIX]Fix crash opening reader on Kindle devices
  • [BUG FIX]Fix German translation not working outside of Germany

Versions 3.5.5/3.5.5a (23/October/2014)
Spoiler:
  • Add German translation (part completed)
  • [BUG FIX]Fix a crash on some Kindle devices when selecting a reader app
  • [BUG FIX]Try harder not to permit downloading books in demo version when the limit is exceeded.
  • [BUG FIX]Fix crash when changing user-defined sorts after adding a sort on a custom column
  • [BUG FIX]Don't refresh book list/grid when returning after nothing was changed
  • [BUG FIX]Make dialog text visible on Gingerbread devices

Version 3.5.4 was never released on Google Play

Version 3.5.3 (18/October/2014)
Spoiler:
  • Option not to show title on grid view before showing covers
  • [BUG FIX]Fix crash on Gingerbread devices
  • [BUG FIX]Fix crash when selecting an FBReader plugin as a default reader
  • [BUG FIX]Fix rare crash when changing the group-by-first-letter option

Version 3.5.2 (17/October/2014)
Spoiler:
  • [BUG FIX]Fix crash when sorting on a custom column that is not present in all books.

Version 3.5.1 (17/October/2014):
Spoiler:
  • User-defined entries in the book list. See the "Extra information on the book list" preference in the Book List section.
  • Single-level hierarchical columns. See the new setting in the grouping section
  • Optionally sync book files: calibre sends book formats to CC if the copy in calibre is newer than the copy in CC
  • Allow choosing and reordering groups in the grouping drawer
  • Allow choosing and reordering the sorts shown in the menu
  • Per-group first letter control in the grouping drawer
  • Add Languages as a groupable item. See "Make groups for custom columns" to enable this feature.
  • Add formats as a groupable item. See "Make groups for custom columns" to enable this feature.
  • Ability to change CC's user interface between supported languages
  • Make the top-level group name not scroll when the info under it is scrolled
  • Use value-sensitive ranges for numbers in the grouping drawer when doing first-letter grouping
  • Enable the "fast scroller" on the booklist, grouping pane, and the book grid. This is a rectangle that appears when you scroll the list, which you can grab and move to scroll much more quickly.
  • Options to control the scroller: where it appears, which side it is on, and whether it shows permanently.
  • Option to temp-mark a book in calibre if its is-read information was updated by info in CC
  • Option to fall back to automatic connect if connection to the specified IP address fails
  • Option to remove <<>> lines in the grouping drawer
  • Option to specify an auto-sort for the "Groups" line (not grouping)
  • Option to make "Disconnect" appear on the action bar when "Connect" is on the menu
  • Support picking custom fields from a list instead of typing the lookup name. Requires calibre 2.1 or newer
  • Display file size in book details
  • In book details, respect the calibre format for custom number columns if there is one, otherwise use commas.
  • In book details, tapping cover expands the cover to full size. Tapping again reduces it to the size set in settings.
  • Performance improvement in grouping drawer
  • Performance improvement when flinging the book list
  • Support the Samsung version of Kindle for Android
  • Support both standalone content server instances and a calibre instance running the content server on the same local network.
  • Support both standalone content server instances and a calibre instance running the content server on the same computer. Requires calibre V2.0 or newer.
  • Use a "star" character for rating types in the book list instead of a number
  • Support for crowd-sourced translations
  • Some changes to help with dialog boxes on e-ink devices
  • Support more than one removable SD card on Android 4.4+
  • Add an "Advanced option" (at the bottom of the settings) to show the general navigate-to-folder dialog on Android 4.4+ when choosing CC's folders
  • Support for FBReader's pdf and djvu plugins
  • [BUG FIX]Fix not being able to long-press on the first line of a group
  • [BUG FIX]Prevent duplicated Date and Pubdate entries in various selection dialog boxes
  • [BUG FIX]Fix Groups and the category line not using the specified font size
  • [BUG FIX]Ensure that new books will get covers sent on next connect if the current connection is interrupted
  • [BUG FIX]Ensure that restore settings does all necessary setting migration
  • [BUG FIX]Make the progress spinner stop if connect to wireless device is cancelled
  • [BUG FIX]Don't try to launch a reader app on an empty cell in the book grid

Version 3.4.4 (2/September/2014)
Spoiler:
  • [BUG FIX]Fix crash at startup triggered by the combination of grouping on a custom column and having skipped CC versions 3.4.1 & 3.4.2

Version 3.4.3 (31/August/2014)
Spoiler:
  • Option for content server connections to ask calibre to generate file names using the same file name template as the wireless device driver. Requires calibre 2.0 or better.
  • [BUG FIX]Redisplay the grouping drawer correctly after a long-press
  • [BUG FIX]Respect the system orientation setting when the system setting is locked and CC's is not.
  • [BUG FIX]Fix crash on Gingerbread when trying to change the last read date
  • [BUG FIX]Fix rare crash on Honeycomb when in preferences
  • [BUG FIX]Fix several rare crashes related to putting CC into the background while not showing the book list/grid
  • [BUG FIX]Performance: rebuild the database indices that were lost in a previous upgrade

Version 3.4.2 (09/August/2014)
Spoiler:
  • Change text in settings to warn users about CC doing a slow DB upgrade when grouped on lookup names or read info lookup names are changed.
  • Add "sorted by" information to the top of the grouping drawer.
  • Allow user to turn on WiFi from within CC. Requires a new permission: change WiFi state.
  • Allow dragging the scroll bar in book list view.
  • Remove the newly-added goto FAQ menu item. Instead, add a FAQ button to the "failed to connect" dialogs.
  • [BUG FIX]Do not allow connection to calibre during a DB upgrade. Prevents possible corruption of metadata.
  • [BUG FIX]Do not reset the book list to the top if read info changes.
  • [BUG FIX]Make restore settings do a DB upgrade if necessary.
  • [BUG FIX]Fix problems with syncing read information across multiple libraries.
  • [BUG FIX]Fix "Send book to app".
  • [BUG FIX]Fix incorrect month in auto-generated backup file name.
  • [BUG FIX]Show a better error message when device runs out of space while writing book files.
  • [BUG FIX]Correctly detect wifi state on devices without a cellular connection.
  • [BUG FIX]Fix rare crash in Preferences when choosing sorts.

Version 3.4.1 (02/August/2014)
Spoiler:
  • In book details: choose which fields to display and their order
  • Two new sorts: Is Read, and Date added to CC.
  • Define an "auto-sort" used to sort a group when that group is selected in the grouping drawer.
  • Backup and restore CC settings
  • Lock screen orientation in portrait or landscape.
  • Add grouped-on custom columns to the sort menu.
  • Add grouped-on custom columns as an auto-sort option.
  • Choose which sorts are on shown on the menu
  • Choose which group categories show in the grouping drawer.
  • Make grouped custom columns clickable in book details. A custom column is made clickable only if it is displayed in the grouping drawer.
  • Two user-defined three-level sorts, set up in Settings/Sorting.
  • Add "display text" to grouped custom columns, as in "#genre/Genre". The text after the slash will be displayed wherever the group is used. Note that this value is ignored in book details because book details has the values set in calibre.
  • Show the value being sorted by in the book list. Previously it showed a few dates.
  • Don't show first letters in the grouping drawer if only one letter would be shown.
  • Add a "splash" activity that is displayed whenever CC must do a database upgrade because of a version change. This avoids "Application Not Responding" errors on large libraries.
  • Show/hide the "[autosort by ...]" information in the grouping drawer.
  • Show/hide the counts on the item lines in the grouping drawer.
  • Show/hide the first letter check box in the grouping drawer.
  • Optionally show page up/down buttons on the books display. Helps on e-ink devices.
  • Optionally set the maximum length of authors displayed in the book list.
  • Set the size of downloaded covers. Note that changing this option will cause metadata for all books to be downloaded on the next wireless connection.
  • New cover size for book details: extra-large.
  • Optionally make read information syncing one way, only from calibre to CC.
  • Use singular and plural forms of labels in book details
  • Improve application logging in several situations
  • Improvements in connection help
  • [BUG FIX]Fix incorrect total book count when uploading metadata to calibre.
  • [BUG FIX]Enable the "home" button on the action bar for the sub-preferences screens. This works only on Android Honeycomb and later.
  • [BUG FIX]Make wireless disconnection more robust when CC and calibre get confused about which program is sending what.
  • [BUG FIX]Add AM/PM indicator to dates displayed in the book list
  • [BUG FIX]Handle custom series, integer, and float columns correctly when sorting and grouping.
  • [BUG FIX]Fix upload to Google books
  • [BUG FIX]Stop creation of spurious folders when books were deleted.
  • [BUG FIX]Accept uppercase extensions (e.g., .PDF) when scanning for new books.

Version 3.3.6 (09/July/2014)
Spoiler:
  • Add the free version of moon+ to the list of readers to query using extensions such as CBZ and CHM
  • Better logging when searching for reader apps.
  • Add the mimetype for CHM books so that apps will answer "reader" advertisements.
  • BUG FIX: Fix content server "download all" when using URL prefixes.
  • BUG FIX: Use correct font size on the word "Groups" in the grouping pane
  • BUG FIX: Refactor reader app selection to deal with multi-case android package names.
  • BUG FIX: Change "find reader app" broadcasts to avoid Android path name bugs.

Version 3.3.5 (22/May/2014)
Spoiler:
  • Support for Android 4.4 (KitKat) SD card changes
  • Better support for Kindle Fire native reading app
  • Use Moon+ support for CBZ, CBR, and CHM
  • BUG FIX: Fix crash when book details URL identifiers are malformed.
  • BUG FIX: Missing books now respects the "Move connect to menu" option
  • BUG FIX: Fix crash when out of memory when searching
  • BUG FIX: Fix crash when kindle fires get confused about what dialog boxes are open
  • BUG FIX: Better synchronize sending books to help prevent calibre timeouts

Version 3.3.4 (1/April/2014)
Spoiler:
  • Position the book list at a nearby book when a book is deleted in book details. Before, the book list was positioned at the top.
  • Refuse to connect as a wireless device or to the content server if some folders in CC's library are read-only. Required because of the changes Google made in Android 4.4 (KitKat) that force SD cards to be read-only.
  • Move the debug log from the default book folder to a folder that is guaranteed to be writable. Required because the default library folder might be read-only (Android 4.4 (KitKat) changes).

Version 3.3.3 (29/March/2014)
Spoiler:
  • [BUG FIX] Fix regression in V3.3.2 that could cause a crash when disconnecting from the content server.
  • [BUG FIX] Fix failure to connect as a wireless device if a book's metadata is corrupted.
  • [BUG FIX] Fix crash caused by changing the logged-in user.
  • [BUG FIX] Don't crash when Android gets confused about what is actually running (IllegalStateException).
  • [BUG FIX] Don't attempt to update the main booklist when books are downloaded from the content server.

Version 3.3.1 (20/March/2014)
Spoiler:
  • Add the ability to mark a book "Read" in CC. The value is changed in book details, and you can group on this value. The information can be synced with calibre (requires calibre 1.28 or higher).
    • Read/Not Read can be synced with a calibre Yes/No custom column. CC's Date Read can be synced with a calibre Date custom column. See the "Marked Read" options in CC's Settings for more information.
    • Add a "Read" mark on the right side of the book list that shows only if the option "Show Read information" is checked and if the Read info is not empty.
    • Refuse to sync Read info if calibre is not at V1.28 or higher.
    • Show popup messages during connection if the user sets up Read syncing and the calibre columns do not exist or are the wrong type.
  • Attempt to handle read-only folders such as those on external SD cards on devices running Android 4.4 (kitkat). In the folder selector, tell the user if s/he has chosen a read-only folder.
  • Change manual path specification when setting CC's folder to make the process more clear.
  • Add some spacing to the "Groups" item in the grouping drawer.
  • In the grouping drawer, add the count of items under a first letter, e.g., [5 authors, 15 books]
  • Allow closing the grouping drawer with a right-to-left swipe in the grouping drawer itself.
  • Add an option to tell CC to auto-close the grouping drawer when a leaf item is selected.
  • Add options to move the Sort, Connect, and View commands from the action bar to the app's menu. This makes space available in the action bar for more "current grouping" text. This option is mostly useful on phones.
  • Add sort by calibre's publication date.
  • Add the identifiers field to book details.
  • In book details, make Authors, Series, Tags, Publisher, and identifiers clickable. Clicking an item takes you back to the main display, changing the grouping to select the clicked item.
  • Left and right swipe in book details now change the book being displayed.
  • Support sending books to Google Books and to other apps such as cloud sync and email using menu items in book details. Google Books is removed from the list of readers.
  • Reorganize some of the preferences, separating grouping preferences from more display-oriented preferences.
  • Change the URLs in CC to point at the new Calibre Companion MobileRead forum.
  • [BUG FIX] Fix the computation of series_sort when scanning for new books on connect.
  • [BUG FIX] Always display Title over Author in the book list when sorting by dates
  • [BUG FIX] Honor the calibre date display formats when showing pubdate or calibre's date field in the book list.
  • [BUG FIX] Make long-press searching in the grouping pane ignore searching on group names
  • [BUG FIX] Fix crash in book details when there are no authors
  • [BUG FIX] Attempt to tell Android when books are deleted in hopes that it will update the info it shows to MTP clients
  • [BUG FIX] Upgrade the Google support library in hopes of eliminating some rare crashes.
  • [BUG FIX] Don't crash when an app advertises that it can handle a book format but in fact cannot.
  • [BUG FIX] Change how debug logs are sent in hopes that sending from a kindle will attach the debug log to the message
  • [BUG FIX] Fix a few cases where out-of-memory errors crashed the app.
  • [BUG FIX] Fix problem where the "Use grouping drawer buttons" required an app restart to take effect.
  • [BUG FIX] Do not update CC's date changed when doing a database upgrade


Previous releases (2012 - 2013)
Spoiler:

Version 3.2.6 (14 December/2013)
Spoiler:

NEW FEATURES:
  • Improved performance of metadata updating while connected.
BUG FIXES:
  • Remove the code that was causing "security exceptions" in kitkat
  • Include a newer version of Google's support library in hopes that it has improved.
  • Repaint the main window after returning from preferences so that cover size changes take effect immediately.
  • Prevent crash when sending email from CC and the device has no email client.
  • Reset the grouping drawer after a search so that the book counts are correct.

Version 3.2.4/Version 3.2.5 (26 November/2013)
Spoiler:

BUG FIXES:
  • Fix problem in metadata caching (improved startup times) caused by duplicate books in CC's library. Requires calibre 1.13 for best effects. A complete send of metadata from CC to calibre will occur on the first connect after installing calibre 1.13.
  • Fix rare memory leak
  • Prevent crashing when given an invalid date format by calibre.

Version 3.2.3 (5 November/2013)
Spoiler:

BUG FIXES:
  • Fix obscure crash apparently caused by changes to permissions in Android Kitkat
  • Improve error message when bulk downloading in the content server and the book has no acceptable formats
  • Fix two rare crashes caused by orientation changes at inconvenient times

Version 3.2.2 (16 October/2013)
Spoiler:

BUG FIXES:
  • Fix crash on Gingerbread devices when using queued downloading in the content server
  • Fix bug in the content server "download all" command that could result in the wrong book to be downloaded.

Version 3.2.1 (14/October/2013)
Spoiler:

NEW FEATURES:
  • Account for Amazon's Kindle for Android app using a different folder for books (Android/data/com.amazon.kindle/files), and for the app using .prc as its preferred extension.
  • Avoid sending metadata from CC to calibre during wireless device connections, reducing initial connection time by up to a factor of 10. This change requires calibre 1.6 released 12/Oct/2013. Note that you will not see the improvement until after a successful connection/disconnection. CC will continue to work with older versions of calibre, offering no performance improvement.
  • Provide a "Download all" menu item in the content server, permitting you to download all the books in a category such as all books by an author or a series. This change requires calibre 1.5 released 26/9/2013. If calibre has not been updated, using this function will show an error message.
BUG FIXES:
  • Fix crash where the folder depth of a CC book folder exceeds approximately 100. Folders structures that deep cannot be scanned.
  • Reset the grouping drawer after a search so that the book counts are correct.
  • Reduce a timeout to avoid very rare "Application not responding" errors.
  • Don't incorrectly erase the current grouping specification from the title bar.

Version 3.2.0 (25/September/2013)
Spoiler:

NEW FEATURES:
  • You can now group on ratings.
  • Ratings are searchable using relational operators, such as rating:>=3 for books with rating of 3 or higher.
  • Float, int, and date values are now searchable. Date searching uses a fixed syntax yyyy-mm-dd. You can leave off part of the date to do partial checks, for example pubdate:<=2000 will find all books published in 2000 or before.
  • Optionally display comments in book details using the full screen width. This is controlled by a new preference in the "Display" group that defaults to "off" (existing behavior).
  • In book details, use the minimum amount of space for labels that word wrap. Previously these labels forced the column width to its maximum, around 12-15 characters.
  • Don't disable the "read" button in the content server book details page if the book isn't downloaded. Instead give the user a message that downloading is needed.
  • Support wireless device and content server connections to a local computer when tethering and the phone/tablet is hub. The phone/tablet is acting as the wireless hub.
  • Improvement in connecting as a wireless device in certain more complex network setups, in particular those that use both IPv6 and IPV4.
BUG FIXES:
  • Use correct font size in book details for the "Comments" label.
  • Fix rare case where book's grouping information was added incorrectly to the database.
  • Fix incorrect title bar text when returning from book details or the content server.
  • Correctly handle another date format that appeared from nowhere.
  • Remove "phantom books" from the count of books being displayed in grid (cover) view.
  • Fix boolean rows being cut in half in book details when large fonts are being used.
  • Fix rare crash when changing the folders where CC is to put books.

Version 3.1.1 (8/September/2013)
Spoiler:
NEW FEATURES:
  • A new preference setting to control whether extended formatting is shown in comments in book details
  • Performance improvement when returning to the main list from book details.
BUG FIXES:
  • Fixed an uncommon crash returning from book details
  • Fixed display of custom date columns in book details.
  • Fixed the book's unique ID (UUID) not being correctly recognized when scanning books to add to CC's library.
  • CC now finds the correct OPF in epubs when the epub contains more than one OPF file.

Version 3.1 (5/September/2013):
Spoiler:
NEW FEATURES:
  • HTML such as <center> is now displayed in book details.
  • Significant performance and stability improvements for large libraries
  • Ability to "clean" CC's database, which will often improve CC's performance.
  • CC now maintains a "debug log" that can be sent to CC's developers, helping to resolve problems.
BUG FIXES:
  • Fix incorrect handing of new custom column date format coming from calibre.
  • Eliminate several rare crashes related to closing CC while a connection attempt was still in progress.
  • Fix rare crashes that happened when tapping on books before the list had settled.
  • Avoid certain calibre "Device didn't respond in a reasonable amount of time" problems that happened when sending hundreds of books at a time.
  • Fix a problem where some devices ran out of memory while searching for the series information in the content server.

Version 3.0.5 (28/Aug/2013)
Spoiler:
BUG FIXES:
  • Fixes to avoid rare crashes when searching and when returning to the book list from the content server.

Version 3.0.4 (19/Aug/2013) (Major release)
Spoiler:

NEW FEATURES:
  • View books by cover in a grid
  • Grouping functions are available from book lists by opening a "drawer".
BUG FIXES:
  • In content server, queuing a book for download that has no acceptable formats no longer hangs the queue.
  • In content server, force a disconnect and go back to the book list if the content server has disappeared.
  • Fix searching after choosing a user collection

Version 2.9.1 (13/Jun/2013)
Spoiler:
BUG FIXES:
  • Fix a crash when using search on some devices, in particuler Nooks

Version 2.9.0 (6/Jun/2013)
Spoiler:
NEW FEATURES:
  • Long-press on a book shown in the content server display starts downloading the book. You can do this with multiple books; the downloads are queued.
  • You can set a device name for your phone/tablet. This name is displayed by calibre when you connect as a wireless device.
  • Added the series information to the content server books display.
BUG FIXES:
  • Fix handling of composite custom columns intended to be comma-separated.

Versions 2.8.0 and 2.8.1 (21/Apr/2013)
Spoiler:
NEW FEATURES:
  • Improvements in connecting to the content server for people who have more than one server or have one server visible both on the home LAN and on the WAN
BUG FIXES:
  • Fix bug encountered when Android kills CC when it is reading from the content server.
  • Fix a rare crash when checking for missing books.

Version 2.7.1 (27/Jan/2013)
Spoiler:
BUG FIXES:
  • Fix regression in sorting books while grouping
  • Fix regression launching Kindle for Android.
  • Fix rare crashes caused by quitting calibre while trying to connect

2.7.0 (25/Jan/2013)
Spoiler:
NEW FEATURES:
  • The sizes of book thumbnails and covers can be changed.
  • Long-tapping on a group searches for books in that group. You can then browse groups showing only those books
  • Sorting on calibre’s date column.
  • Group by date columns using yyyy-MM.
  • Calibre pubdate & date groupable by adding their lookup names to the list of groupable columns.
  • Work around Cool Reader not advertizing that it can handle .mobi books
BUG FIXES:
  • Display plain-text comments without losing new lines.
  • Fix crash caused by doing a search with queries that somehow end up empty.
  • Fix several rare crashes

Version 2.6.1 (16/Jan/2013)
Spoiler:
NEW FEATURES:
  • An option has been added to tell CC and calibre to use calibre's book identifier as the file name. This helps when both the wireless connection and the content server on multiple devices and you want the same file name. The the FAQ "How can I make CC use the same file name for content server and wireless device connections?" above
  • Allow path components in content server URL settings
BUG FIXES:
  • Fix crash in Find books with missing files when the process was restarted
  • Fix rare out-of-memory problems
  • Fix CC occasionally complaining about valid IP addresses
  • While connected, disable some preference settings that should not be changed until disconnected

Version 2.6 (9/Jan/2013)
Spoiler:
NEW FEATURES:
  • You can now set font size in book details and when connected to the content server.
  • Added a "Delete all" option in Find books with missing files
  • Easier to clear a search: just tap the text telling you that a search is active.
BUG FIXES:
  • Moved the Find books with missing files operation back from the settings menu to the main menu
  • Removed search option from Find books with missing files. It didn't do anything useful.
  • Fix font size changes not being respected in some situations.

Version 2.5.3 (23/Dec/2012)
Spoiler:
BUG FIXES:
  • Add a disconnect button to the content server
  • Improve text in the "Can't find a reader app" dialog
  • Fix some rarely-occurring bugs that cause crashes.

Version 2.5.2 (3/Dec/2012)
Spoiler:
BUG FIXES:
  • Fix the "date read" not being set in some cases.
  • Update connection help for the new settings system.

Version 2.5.1 (24/Nov/2012)
Spoiler:
BUG FIXES:
  • Fix book details not returning to the books list when grouping.

Version 2.5 (23/Nov/2012)
Spoiler:
NEW FEATURES:
  • A new, simplified, settings system.
  • The font sizes used in CC’s book/item list and book details displays can be changed.
  • It is now possible to use different IP addresses for the wireless connection and the content server connection.
  • You can use a URL for the content server address instead of an IP address and a port.
  • It is possible to connect to the content server using 3G as long as the content server is visible on the internet (most home calibre content servers are not).
  • The number of subitems shown on the second line when grouping can be changed. Setting it to zero removes the line.
  • You can now search using regular expressions, using calibre’s “~” syntax.
BUG FIXES:
  • Fixed problem with default reader selection causing crashes or opening the wrong book.
  • Fixed several content server connection problems, in particular when using reverse proxies or non-calibre authentication, and when the server had problems providing correct book data.
  • Fixed crashes when navigating up to the root folder when setting folders for extensions.
  • Searching custom columns using prefixes incorrectly compared the prefix to the column name instead of the lookup name.
  • Some text custom columns were ignored when searching.
  • Fixed a few problems triggered by rotating the device at inopportune times.

Version 2..4 (8/Nov/2012)
Spoiler:
NEW FEATURES:
  • Now available in French.
  • Experimental support for audio books (mp3)
BUG FIXES:
  • Change the delay before requesting a review to 24 hours, not 24 minutes.

Version 2.3.2 (19/Oct/2012)
Spoiler:
[/LIST]BUG FIXES:
  • Fix a problem with manual path entry
  • Add a reminder for people to try connecting as a wireless device if they have used only the content server.

Version 2.3.1 (12/Oct/2012)
Spoiler:
[/LIST]BUG FIXES:
  • Fix non-multiple custom fields not being displayed in book details
  • Improvement in memory management for severely-constrained devices.

Version 2.3 (10/Oct/2012)
Spoiler:
NEW FEATURES:
  • The ability to choose a default reader app for a book extension (format)
  • Ability to choose Kindle for Android for Amazon-format books that are stored in the /kindle folder on the device. When you launch K4A from CC, you can easily find that book by going to K4A's "on device" view and sorting by newest.
  • Dramatically improved performance when deleting more than one book from calibre. Requires calibre 0.9.2 or later.
BUG FIXES:
  • Add "languages" to book metadata display.
  • Fix possible crash in content server integration triggered by the combination of a slow(er) calibre server and tapping too quickly.
  • Fix content server integration crash caused by entering IP addresses or domain names that are syntactically incorrect.
  • Fixes for some rare timing problems that could cause CC's content server integration to crash.

Version 2.2.2 (6/Oct/2012)
Spoiler:
BUG FIXES:
  • Fix two rare problems that might cause CC to crash
  • Fix ratings divided by 2 in CC's content server integration

Version 2.2.1 (5/Oct/2012) and version 2.2 (a test release)
Spoiler:
NEW FEATURES:
  • Integration with calibre's content server.
BUG FIXES:
  • EPUB scanning didn't store series.
  • Unusual opf files in EPUBs caused duplication of author names and missing author sort values
  • Ensure that generated file names do not contain illegal characters.

Version 2.1.2 (24/Sep/2012)
Spoiler:
BUG FIXES:
  • Fixed possible crash when returning to book details after it has been hidden for a long time.
  • Worked around problem with Android 4.1 (Jelly Bean) where displaying certain HTML-formatted text caused a crash
  • Prevent entering a file path when choosing an arbitrary folder for storing books.
  • Fixed rare crash when grouping by series/tags etc when a book has no series/tags/etc.

Version 2.1.1 (19/Sep/2012)
Spoiler:
NEW FEATURES:
  • Calibre Companion shows a dialog when it cannot connect to calibre because another device is already connected. This has become important because of calibre's MTP support. Requires calibre 0.8.70.
  • Improved performance when scanning for EPUBs already on device, and when uploading and downloading books. Requires calibre 0.8.70.
BUG FIXES:
  • Shorten path names so that Windows Explorer can see and open books put on the device by CC. Requires calibre 0.8.70.

Version 2.1 (15/Sep/2012)
Spoiler:
NEW FEATURES:
  • Search for books using calibre-like search expressions. You can search for most text fields. NB: searching the comments field has been disabled for performance reasons. A way to explicitly search comments (comments:whatever) will be added in a future release.
  • Scan for books in the folders managed by CC. Pass them to calibre to do the metadata analysis. This requires calibre 0.8.69.
  • Added a "Date read" date. You can sort by this date.
  • Added a "header" to the lists that describes what the list is showing.
  • Fix display of empty boolean values in books details.
BUG FIXES:
  • Improved wording in some progress dialogs.
  • The sort menu did not come back when using the back button to exit grouping by user collections.

Version 2.0.2 (10/Sep/2012)
Spoiler:
BUG FIXES:
  • Improved performance in grouped lists.
  • Honor the sort criteria in all lists of books

Version 2.0.1 (6/Sep/2012)
Spoiler:
BUG FIXES:
  • Don't crash when user does a missing books check when no books are on the device.

Version 2.0 (4/Sep/2012)
Spoiler:
NEW FEATURES:
  • Option to not group books initially by first letters.
  • When changing where books are saved, your books are now moved to the new location.
  • You can long-press on a book to skip straight to reading it.
  • You can check for books in the database that are missing their associated file.
  • More extensive in-app help.
  • Better performance across the board, particularly when showing long lists of items when grouping.
BUG FIXES:
  • Return to the same position in the list when using the back arrow.
  • Yet another Improvement in handling memory for images.
  • Improvements in handling memory during book transfer.

Version 1.10.1 (4/Sep/2012)
Spoiler:
NEW FEATURES:
  • Improvement in connection that should help if the machine running calibre has multiple IP addresses, such as VPNs or virtual machines.
  • The book details window can now be rotated.
BUG FIXES:
  • Fixed crash when looking book details when a date was empty.

Version 1.10 (29/Aug/2012)
Spoiler:
NEW FEATURES:
  • Addition of a book details display
  • Ability to delete a book in CC
  • Support for calibre "save to" templates containing folders.
  • Tapping a sort twice will invert that sort. For example, tapping title twice will sort from A to Z then Z to A.
  • Sort by date last changed (in Calibre Companion)
  • Improvements in handling of connection progress and connection failure. These improvements require calibre 0.8.67
BUG FIXES:
  • Fixed problem in mDNS (bonjour) that might have made connections more difficult in Gingerbread-based phones.
  • Prevent "half-stored" books (metadata but no book) if calibre is disconnected in the middle of a transfer.

Version 1.9 (27/Aug/2012)
Spoiler:
NEW FEATURES:
  • Addition of an "About" dialog
  • Improvements in handling of connection progress and connection failure.
  • Improvements to the IP address entry dialog, including display of the device's IP address on the WiFi adapter.
BUG FIXES:
  • Changed the Android default 3-minute connection failure timeout to 5 seconds.
  • Make the connection progress spinner persist across device rotations.
  • Remove the "Add books to library" background text when there is only one book in the library.

Version 1.8.2 (25/Aug/2012)
Spoiler:
BUG FIXES:
  • Bug fixes for DB upgrading on Honeycomb devices
  • Fixed problem causing grouping to be reapplied when a book is tapped after grouping was turned off using the "back" button.

Version 1.8.1 (24/Aug/2012)
Spoiler:
NEW FEATURES:
  • Added pdf and azw3 to the default extensions
BUG FIXES:
  • Fixed problem with DB upgrades when the DB had been damaged somehow.
  • Fixed problem selecting folders on "non-standard" SD cards when the folder already exists.

Version 1.8 (23/Aug/2012)
Spoiler:
NEW FEATURES:
  • Dramatic performance improvements in sorting and grouping
  • Performance improvements when connecting to calibre
  • Progress bars when uploading metadata to calibre or downloading metadata from calibre.
  • Ability to enter arbitrary paths for folders, allowing access to "non-standard" SD cards.
  • Notifications during certain database upgrade operations.
BUG FIXES:
  • Better use of memory when downloading books. Should help devices like the Nook Color.
  • Font color problems when choosing folders
  • Improved separation of items when grouping, to avoid confusion between items containing commas and items separated by commas.
  • Improvements in connection, attempting to avoid spurious connection failure messages.
  • Better information in calibre about IP addresses and ports.
  • Fixed a problem when sorting by series.
  • Indicate on the action bar when grouping is active.

Version 1.7.1 (21/Aug/2012)
Spoiler:
BUG FIXES:
  • Fixed problem in changing storage folders.

Version 1.7 (20/Aug/2012)
Spoiler:
NEW FEATURES:
  • Improved function of the back button.
  • Dramatically improved performance when not using grouping. (Grouping performance improvements to come.)
  • Improved "flinging" performance by displaying covers in the background.
BUG FIXES:
  • Fixed license verification for older devices when using multiple google accounts.
  • Multiple send-book jobs no longer confuse the progress dialog.
  • More reductions in memory usage.
  • Cleanly disconnect from calibre when the app is exited using the back button.

Version 1.6.1 (18/Aug/2012)
Spoiler:
NEW FEATURES:
BUG FIXES:
  • Fix regression in group-by displays. (sigh. Long days lead to silly mistakes.)

Version 1.6 (18/Aug/2012)
Spoiler:
NEW FEATURES:
  • Grouping is saved and restored
  • Book/format folder routing (folder per extension)
  • Splash screen on startup while loading books
  • Message saying "transfer books now" when library is empty
BUG FIXES:
  • Total redo of memory management to (one hopes) eliminate the out-of-memory errors when sending books and on display of large libraries.
  • Don't force a particular sort when grouping
  • Ask for WiFi permissions, something that HTC seems to demand.

Version 1.5 (17/Aug/2012)
Spoiler:
NEW FEATURES:
  • Add error messages for incorrect IP addresses, for example to the content server.
  • Book/format folder routing (folder per extension)
BUG FIXES:
  • Better handle screen rotations when showing progress dialogs.
  • More information from the license manager

Version 1.4 (15/Aug/2012)
Spoiler:
NEW FEATURES:
BUG FIXES:
  • Fix regression in IP address handling

Version 1.3 (14/Aug/2012)
Spoiler:
NEW FEATURES:
  • Better IP address and password dialogs
  • Multi-level sorting
BUG FIXES:
  • Fix crash caused by missing covers.
  • Make progress bars survive application sleeping

Version 1.2 (13/Aug/2012)
Spoiler:
NEW FEATURES:
  • Attempt to detect connecting to the content server instead of the device handler.
  • Prevent WiFi sleeping when connected
  • Add the CC version number to the dialog with calibre.
BUG FIXES:
  • Make transfer and initialization dialogs sticky.

Version 1.1 (12/Aug/2012)
Spoiler:
NEW FEATURES:
BUG FIXES:
  • Fix problems caused by library redisplay while downloading.
  • Don't redisplay on every book. See if more books will arrive in time.
  • Fix problem with creation of default folder.

Last edited by chaley; 12-07-2014 at 02:05 PM.
chaley is offline  
Old 01-25-2013, 06:27 AM   #4
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,919
Karma: 1673776
Join Date: Jan 2010
Location: France
Device: Many android devices
CC is worth more than you charge. Can I contribute more?

We are surprised and gratified every time we get this question. It has happened often enough that we have decided to accept contributions.

If you wish to contribute to CC development, go to the page http://charles.the-haleys.org/calibre/. Part-way down you will see three PayPal "Pay Now" buttons, one for US dollars (USD), one for Euros (EUR), and one for Great Britain Pounds (GBP). Push the button, enter the amount you wish to contribute, then click "Update". Continue to making the payment. PayPal might ask you for a delivery address, or might not. I have tried to convince their button builder that the payment is for intangible goods and nothing will ever ship, but it doesn't always work.

FYI: we are using "Pay Now" instead of "Donate" because of PayPal rules. PayPal insists that Donate buttons be used only by charities, which we are obviously not. Some people seem to get away with using Donate buttons and others have come to some understanding with PayPal. Others have had all their contributions confiscated by PayPal. We decided to avoid the problem by selling our gratitude.

Last edited by chaley; 09-29-2014 at 08:00 AM.
chaley is offline  
Old 01-25-2013, 06:42 AM   #5
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,919
Karma: 1673776
Join Date: Jan 2010
Location: France
Device: Many android devices
Using Kindle for Android with Calibre Companion

Kindle for Android (K4A) is one of the very few reader apps that does not publish to Android the kinds of books that it can open. Because of this, Calibre Companion cannot automatically pass books to it. It is possible that this can happen with other reader apps, in which case the steps below could help resolve the problem.

You can resolve this problem one of two ways:
  1. Use a different reader app that can open .mobi files (or the format you are trying to open). There are several. This will work only if your books are not infested with Amazon's DRM.
  2. Set Calibre Companion's storage folder to K4A's books folder. Its name is "kindle". Its location depends on the version of Android you are running. NB: later versions of Kindle for Android put books into different places. Some experimentation may be required to find the right folder so the K4A will see books stored by CC ("side loaded" in Amazon terminology).

    To change the folder CC uses for amazon books see FAQ How do I control which book extensions for instructions on how to change the storage folder.

    Important: K4A does not support subfolders in the "kindle" folder. Because of this, when using K4A you must not use a calibre save template that sends books to subfolders. The default calibre save template for smart phones does not use subfolders. If you have changed the template using the preferences for the "smartdevice", you must change it back or use CC's setting to use the calibre "book identifier" as the filename. To change the save template in calibre, click on Preferences, then Plugins (on the last line of icons). Enter SmartDevice into the search box as shown in the following image then press Enter.
    Click image for larger version

Name:	19-smartdevice_template.png
Views:	1062
Size:	185.9 KB
ID:	100018
    Double-click on the Smartdevice line. The following dialog will open.
    Click image for larger version

Name:	18-smartdevice_config-2.jpg
Views:	759
Size:	109.5 KB
ID:	100019
    You should uncheck the box "Use sub directories", and you should also change the template to something that has no slash characters ('/') in it. The example in the image, "{title} - {authors}" typed without the quotes, should work in most cases. If you have different books with the same title and authors, then use "{title} - {authors} {id}", again without the quotes.
  3. After having changed the storage folder, the next time K4A is started it will import the books you have sent to Calibre Companion so you can read them.
Note: CC does some things with files to try to make Kindle for Android put the book you want to read at the top of its list. Unfortunately, starting with Kindle for Android version 3.8.2.4 (or perhaps a bit earlier), these "things" no longer work; the books are not re-sorted. We have tried and failed to find a way to cause K4A to reorder its list of books.

Note: Starting in early 2013, Kindle for Android started putting books in the Android/data/com.amazon.kindle/files folder, and switched to using the .prc extension. CC 3.2.1 supports that folder as well as the existing /kindle folder, and also knows that .prc books in either folder can be opened by the kindle app.

Last edited by chaley; 11-24-2014 at 05:30 PM.
chaley is offline  
Old 01-25-2013, 06:44 AM   #6
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,919
Karma: 1673776
Join Date: Jan 2010
Location: France
Device: Many android devices
Calibre Companion won’t connect to calibre. What do I do?

We have tried very hard to make Calibre Companion able to automatically connect to calibre in many different network setups and situations. Unfortunately there are as many different network setups as there are networks and operating systems, and some combinations are unusual or complicated enough to defeat auto-connection.

First, try setting up automatic connection. To do this, first ensure that you have started the wireless device driver in calibre. Click on Connect/Share, then “Start wireless device connection”.
Click image for larger version

Name:	01-calibre_menu.png
Views:	621
Size:	89.9 KB
ID:	100020
Now attempt to connect CC to calibre. In CC, tap Connect, then As Wireless Device. Normally this is all you will need to do.

In some situations where the networking setup is unusual or complex, Calibre Companion will fail to connect. If this is your situation, continue with the steps below to troubleshoot the problem.
  1. Check that your firewall is allowing calibre to send and receive messages. For example, in Windows 7, go to the control panel, select Windows Firewall, and click "Allow a program or feature through Windows Firewall". Scroll down the list until you see "The main calibre program". Ensure that it has a check mark on the left side and (at least) in the "Home/Work (Private) column.
    Click image for larger version

Name:	20-Windows_firewall.png
Views:	947
Size:	73.5 KB
ID:	100021
    Some firewalls don't support application-based permissions, in which case you will need to use a fixed port (see below) and open that port in your firewall.

    As there are many firewalls, most of which we do not have, we are unable to give more instructions for opening a port in the firewall. However, if you have McAfee, user feedback indicates that two settings must be checked: which programs are allowed to access the internet and whether the "home network" is trusted. Calibre should have "Full" access to the internet and the home network should be marked as fully trusted. If you look at the network map in McAfee, you should see your device and it should be trusted.
  2. Check that your antivirus/antimalware package is not blocking connections. This is not a problem if you are running Microsoft Security Essentials. We have heard that MalwareBytes and "ESET Smart Security" can block connections between CC and calibre. In general, if you are running a network "Security Suite" then be sure that it allows traffic to and from calibre. One way to do that might be to "exclude" calibre from checks. It is also possible that you will need to use a fixed port (see below).
  3. Check if the computer running calibre is also using a Virtual Private Network (VPN). If you don't know what a VPN is then you probably aren't using one. Using a VPN can make it impossible for Calibre Connection to connect to calibre. If you are in this situation then the only solution is to turn off the VPN.
  4. If the computer running calibre is running Windows, verify that the "Network Location" you are connected to is not "Public", but is instead "Home" or (on Windows 7) "Work". If the network location is Public then your device will not be able to connect to calibre. The tutorial Simple Questions: What are Network Locations in Windows 7 & Windows 8? might help verify and, if necessary, change the setting.
  5. If the computer running calibre is using WiFi, check that it is using the same network "band" that the Android devices are using. Many home routers come with 2 WiFi bands: 2.4 GHz and 5 GHz. Devices using one band often cannot talk to devices using the other band. Either ensure that all the devices including the computer running calibre are using the same band, or ensure that your router permits devices on one band to talk to devices on the other.
  6. If after making the above checks Calibre Companion still cannot connect to calibre then the next step is to use a fixed port and enter calibre’s IP address and port into Calibre Companion. See the instructions below.
Using a fixed IP address and port
If Calibre Companion does not connect automatically and you went through the steps described above, then you probably need to tell CC to connect using a fixed IP address and port. An IP address is a group of 4 numbers separated by periods, for example 192.168.0.44 , and a port is a single number, for example 9090.

First, follow these steps to try using a fixed port:
  1. In calibre, go to wireless connection menu shown above. If it says "Stop wireless device connection", click it and answer the question about auto-connection (however as you wish), then click the menu "Start wireless device connection" again. You will see the following dialog box.
    Click image for larger version

Name:	13-calibre_ip_port_customization-1.png
Views:	1251
Size:	164.6 KB
ID:	100025
    Check the box "Use a fixed network port". Change the default port number (9090) if you wish. You must not enter the same port used by calibre's content server. Press OK. Calibre will complain if there is a problem with the port, for example if it is being used by another application on your computer.
  2. Be sure that any firewall you are running on the computer running calibre allows incoming connections to the chosen port.
Before going on to the next steps, try to connect Calibre Companion to calibre. In many situations, simply setting a fixed port in calibre and opening that port on your the firewall will be enough to permit Calibre Companion to connect.

If connection still does not work, then you need to enter calibre's IP address into Calibre Companion. Follow the steps below to do this.
  1. Click again on calibre's connect/share menu. Assuming that the wireless driver is running (a green dot is shown next to the menu line), you will see calibre’s IP address and port on the menu line. If you do not see the port then something went wrong when you checked the "Used fixed port" box as described above and you should follow those instructions again. If all went well, you should see something similar to the following:
    Click image for larger version

Name:	02-IP_Address-1.png
Views:	625
Size:	114.7 KB
ID:	100024
    Make a note the displayed IP address and port.Important note: If you see more than one IP address, read the answer to "My computer has more than one IP address. Which one do I use?" below.
  2. Enter calibre's IP address into Calibre Companion on your device. To do this, click CC's “Settings” menu item.
    Click image for larger version

Name:	03-app_ip_address-1.png
Views:	513
Size:	13.3 KB
ID:	100026
    then click the wireless device connection line
    Click image for larger version

Name:	22-cc_settings_wd_ip.png
Views:	627
Size:	37.4 KB
ID:	100027
    You will see the following dialog.
    Click image for larger version

Name:	04-app_ip_dialog-2.png
Views:	583
Size:	23.9 KB
ID:	100028
    Enter the IP address and port that you saw in the step above. You must enter the IP address exactly as it was shown in calibre, without any spaces or extra periods.

    As an aide, Calibre Companion's dialog shows you the IP address of your device. The IP address for Calibre you noted should be very similar to the one CC shows. For example, if your device's IP address begins with 192.168.203 then calibre's IP address should also begin with 192.168.203.

    You must always enter both an IP address and a port number. You must not enter the port used by calibre's content server or any other web server.
If after all of this Calibre Companion still cannot connect, ask for help by emailing us. Calibre Companion's help menu has a button that will create an email message. In your email, please give us all the IP addresses that calibre displays, and the IP address of your device you found as described above. Also give us the port number that you set up.

Connections worked, but have stopped working

It is possible that connections can work for a time then stop working. The most common reason is that the computer running calibre changed its IP address. The can happen if that computer has not connected to the home network for some time (e.g., a laptop that was traveling), or if there was a general power failure and the home network controller box ("router") was restarted. If Calibre Companion has been successfully connecting but suddenly stops, then verify that the IP address entered in Calibre Companion still matches the one displayed by calibre. If it does not, then change the address in CC to match the new IP address shown in calibre.

Technical note 1: You can avoid having calibre's IP address change by setting up a "static lease" for that computer in your home network router. How to do this, or even if it can be done, depends on your router. The setup is usually in the DHCP setup section. Check the manual for your router to see how to set up static leases. Note that your router may call these something else, such as fixed IP addresses or static IP addresses.

Technical note 2: Calibre Companion will accept domain names in lieu of IP addresses. This can be useful if you are on a routed network or if calibre is on a machine that doesn't have a fixed IP address and you have access to a dynamic DNS server.

Last edited by chaley; 04-08-2014 at 04:02 AM. Reason: change commas to period
chaley is offline  
Old 01-25-2013, 10:27 AM   #7
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,919
Karma: 1673776
Join Date: Jan 2010
Location: France
Device: Many android devices
What does CC offer over a web browser?

No other app, reader or browser, offers connection as a calibre device. Connecting as a device gives you bulk operations, integration with calibre plugins, and the other advantages listed in the first post.

In addition, CC's library is on the device. You do not need an internet connection once you have transferred books.

Last edited by chaley; 03-20-2014 at 07:04 AM.
chaley is offline  
Old 01-25-2013, 10:29 AM   #8
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,919
Karma: 1673776
Join Date: Jan 2010
Location: France
Device: Many android devices
Where do I get Calibre Companion?

Calibre Companion is available on Google Play and on Amazon Appstore for Android. It runs on Android Gingerbread (2.3) and later.

Last edited by chaley; 03-20-2014 at 07:05 AM.
chaley is offline  
Old 01-25-2013, 10:30 AM   #9
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,919
Karma: 1673776
Join Date: Jan 2010
Location: France
Device: Many android devices
I must pay for CC to try it. What happens if I don't like it?

If you have any concerns about whether CC will meet your needs, please try the free demo version of CC. It is fully functional except that it is limited to ten books.

Last edited by chaley; 09-29-2014 at 07:47 AM.
chaley is offline  
Old 01-25-2013, 10:32 AM   #10
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,919
Karma: 1673776
Join Date: Jan 2010
Location: France
Device: Many android devices
How do I get help?

The best way to contact us is to post a message in this forum. We and other users can carry on a discussion to try to work out what problem you might be having and how to solve it.

Reporting problems or asking for help in reviews on Google Play is the most difficult for us. Our first problem is contacting you for more info; it isn't easy to find an email address for a reviewer, and might be impossible. The second problem is that other people who might have solved to problem cannot answer at all. The third problem is that we can't be sure that you even want a response and that you might consider us contacting you an invasion of privacy. We are not suggesting that people should not leave reviews, good, bad, or indifferent. Instead, we are suggesting that if you want support from us, a review is not the best way to go about it.

It could be that we will need a calibre debug log to help analyze the problem. You can get a calibre debug log by running calibre in debug mode. Start calibre, then click the small down arrow next to preferences as shown in this screenshot.
Click image for larger version

Name:	12-calibre_debug_mode.png
Views:	386
Size:	85.1 KB
ID:	100033
Click on "Start calibre in debug mode". Let calibre restart and answer OK to the dialog that confirms that calibre is in debug mode. Attempt to connect CC to calibre. Get to where you are having the problem, then close calibre. You will see a debug log in a new window, probably in a text editor. An example is
Spoiler:
SMART_DEV ( 0.00: 0.002) startup_on_demand try port 18700
SMART_DEV ( 0.89: 0.803) startup_on_demand listening on port 18700
Started up in 37.73 seconds with 66 books
SMART_DEV ( 95.11: 12.261) reset
SMART_DEV ( 95.12: 0.000) set_progress_reporter
SMART_DEV ( 95.14: 0.000) open
SMART_DEV ( 95.17: 0.016) _call_client GET_INITIALIZATION_INFO
SMART_DEV ( 95.90: 0.718) open selected formats [u'epub', u'mobi']
SMART_DEV ( 95.92: 0.000) card_prefix
SMART_DEV ( 96.17: 0.218) set_progress_reporter
Job: 1 Get device information started
SMART_DEV ( 96.20: 0.000) get_device_information
SMART_DEV ( 96.25: 0.016) _call_client GET_DEVICE_INFORMATION
SMART_DEV ( 96.56: 0.281) _call_client SET_CALIBRE_DEVICE_INFO
SMART_DEV ( 96.82: 0.249) card_prefix
SMART_DEV ( 96.84: 0.000) free_space
SMART_DEV ( 96.85: 0.000) _call_client FREE_SPACE
DeviceJob: 1 Get device information done, calling callback
DeviceJob: 1 Get device information callback returned
SMART_DEV ( 97.18: 0.312) set_progress_reporter
Job: 2 Get list of books on device started
SMART_DEV ( 97.20: 0.000) books None
SMART_DEV ( 97.21: 0.000) _call_client GET_BOOK_COUNT
Job: 1 Get device information finished
No details available.
SMART_DEV ( 104.11: 6.879) books carda
SMART_DEV ( 104.14: 0.000) books cardb
DeviceJob: 2 Get list of books on device done, calling callback
SMART_DEV ( 107.98: 3.822) set_plugboards
READING LIST: Metadata available: {u'main': {u'device_store_uuid': u'efc3cde6-794f-4d23-bf8d-c7f95613e2b3', u'prefix': u'', u'device_name': u'SmartDevice', u'calibre_version': u'0.8.64', u'location_code': u'main', u'last_library_uuid': u'62e15c2b-a8ca-40fd-a784-05773082742a', u'date_last_connected': u'2012-08-12T12:17:32.261000+00:00'}}
READING LIST: Sync Now - force_sync= False
DeviceJob: 2 Get list of books on device callback returned
Job: 2 Get list of books on device finished
No details available.
SMART_DEV ( 108.18: 0.187) set_progress_reporter
Job: 3 Send metadata to device started

Copy all the text in that window and send it to the email address provided in the thread. Alternatively, attach it to the thread where we are having the discussion. Do note that there might be information about your library in the log that you do not want public, in which case don't post it. Please do not paste the log into a post. It will lose formatting and be too long to easily analyze.

When you send a calibre debug log you should also send one from CC. To send a CC debug log, go to CC's settings, scroll all the way to the end, and choose "Send a debug log to MultiPie". When given a choice of which app to use to send the log, pick your email client. You should see a message open addressed to us, with the debug log as an attachment. We might ask you to remove one or the other of the standard "To:" addresses you see in that dialog.

Last edited by chaley; 10-07-2014 at 03:55 AM.
chaley is offline  
Old 01-25-2013, 10:33 AM   #11
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,919
Karma: 1673776
Join Date: Jan 2010
Location: France
Device: Many android devices
How do I report bugs or make comments?

Please make comments or report bugs using the Calibre Companion MobileRead forum (this forum) (a thread per comment would be good), via private messages to either of us (chaley or steve_haley), or via email to “steve [at] MultiPie dot co dot uk”. Be sure to type “MultiPie” (many pies) and not “multiple”.

Please don't post problems (that you actually want us to fix) in reviews on Google Play. We want to fix problems but because we can't contact you for more information, in most cases we can do nothing about the problems you are reporting.

Last edited by chaley; 03-22-2014 at 03:18 AM.
chaley is offline  
Old 01-25-2013, 10:35 AM   #12
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,919
Karma: 1673776
Join Date: Jan 2010
Location: France
Device: Many android devices
Isn't support for MTP (newer Android devices) built into Calibre?

MTP (Media Transfer Protocol, designed for cameras and the like) is supported in calibre as of version 0.8.70 when running on Linux, Windows Vista, and Windows 7. Calibre does not support MTP on MacOS or Windows XP.

Note that Calibre Companion has many features not included in calibre's MTP support. See the first post for a list.
chaley is offline  
Old 01-25-2013, 10:39 AM   #13
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,919
Karma: 1673776
Join Date: Jan 2010
Location: France
Device: Many android devices
My computer has more than one IP address. Which one do I use?

If you see more than one IP address listed in calibre after you start the wireless device driver (see "The app won’t connect to calibre. What do I do?" above), then it is highly likely that only one of the IP addresses will work in Calibre Companion. The following image shows two IP addresses.
Click image for larger version

Name:	21-calibre_2_ip_addresses.png
Views:	468
Size:	14.1 KB
ID:	100034
You need to pick the IP address that your computer uses to talk to the wireless network. You can find the correct IP address to use with the help of Calibre Companion by clicking on the “Calibre’s IP address” menu item.

Click image for larger version

Name:	03-app_ip_address-1.png
Views:	338
Size:	13.3 KB
ID:	100035

then click the wireless device connection line

Click image for larger version

Name:	22-cc_settings_wd_ip.png
Views:	399
Size:	37.4 KB
ID:	100037

You will see the following dialog.

Click image for larger version

Name:	17-app_ip_address.png
Views:	375
Size:	24.2 KB
ID:	100036

The dialog shows you the IP address of your device. Calibre's IP address should be very similar to the device's IP address. To give some examples: if your device's IP address begins with 192.168.220. then calibre's IP address should also begin with 192.168.220. If your device's IP address begins with 192.168.0. then calibre's IP address should begin with 192.168.0. If your device's IP address begins with 172. then calibre's IP address should begin with 172. For example, in the image of calibre's menu above, you see 2 IP addresses: 192.168.220.38 and 192.168.102.10. In the image of CC's IP dialog you see 192.168.220.6. You pick the closest match that in this case are the IP addresses beginning with 192.168.220, meaning you would enter 192.168.220.38 into Calibre Companion. And remember, enter an IP address shown by calibre, not one shown in this answer.

If you cannot determine which IP address to use, ask for help by emailing us. Calibre Companion's help menu has a button that will create an email message. In your email, please give us all the IP addresses that calibre displays, and the IP address of your device you found as described above. Also give us the port number that you set up when following the instructions in the "Calibre Companion won’t connect to calibre. What do I do?" answer above.

Last edited by chaley; 01-25-2013 at 10:42 AM.
chaley is offline  
Old 01-25-2013, 10:43 AM   #14
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,919
Karma: 1673776
Join Date: Jan 2010
Location: France
Device: Many android devices
I have books on my device that don’t show up in CC. How do I fix this?

You can ask Calibre Companion to scan the folders where it puts books. Click on the menu button, select settings, then "Scan for books on connect" to check the box. The next time you connect, CC will do the scan and add any new books to its database.

Notes:

1) CC does not add books to your calibre library. It does check if the book matches an existing book in your library, and if it does CC will download that book's metadata. If the book CC found does not match a book in your library,the metadata for that book in CC will likely be incorrect because it is coming from the book itself.

2) Calibre Companion does not look in folders other than the ones for formats/extensions selected in its "Book formats and folders" dialog. CC also looks only for the formats that it is willing to put in that folder. For example, If mobi and epub files are going into two different folders, CC will not scan for .mobi files in the epub folder and vice versa. If you are in this situation then you should either combine the folders or move the books to the right folder.

3) If you want to add the book(s) to your calibre library, connect as a wireless device and go to calibre's device view. Right-click on a book and either add the book to calibre's library or match the book with an existing book in calibre's library.

Last edited by chaley; 02-17-2014 at 01:58 PM.
chaley is offline  
Old 01-25-2013, 11:24 AM   #15
chaley
"chaley", not "charley"
chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.chaley ought to be getting tired of karma fortunes by now.
 
Posts: 5,919
Karma: 1673776
Join Date: Jan 2010
Location: France
Device: Many android devices
CC connects but then sits there doing nothing. What do I do?

Calibre Companion connects to calibre as a "device", which means that calibre is in charge. After Calibre Companion connects, you use calibre to send books to your device and delete books from your device, just as if your device were connected using a cable.

After connecting, go to your computer running calibre, select some books, then click on the "Send to device" button.
chaley is offline  
Closed Thread

Thread Tools Search this Thread
Search this Thread:

Advanced Search

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
[Android App] Calibre Companion - incompatible richardhc Calibre Companion 8 12-19-2013 04:01 AM
[Android App] Best Android reader software for use with Calibre / Calibre Companion ellett Devices 11 12-16-2012 05:27 PM
[Android App] Calibre Companion Wishlist? jackie_w Devices 11 10-03-2012 09:51 AM
[Android App] Calibre Companion, First Take DoctorOhh Devices 61 08-27-2012 01:38 PM


All times are GMT -4. The time now is 08:18 PM.


MobileRead.com is a privately owned, operated and funded community.