Mobileread
Quick Guide to Shelf Management with calibre 0.9.1 & above (Touch / Glo / Mini /Aura)
#1  PeterT 10-08-2012, 01:51 AM
PLEASE NOTE: I AM LEAVING THIS THREAD HERE FOR DISCUSSION AND HISTORY.

ALL FUTURE UPDATES WILL BE MADE ON THE MOBILEREAD WIKI Kobo_Shelves_and_Collections@Wiki »

ADDITIONALLY PLEASE NOTE THAT YOU THE READER CAN UPDATE THE WIKI ENTRY AS WELL

** NOTE: THIS ALSO APPLIES TO USE OF THE KOBO TOUCH EXTENDED DRIVER ***

ALSO SEE THE END OF THIS POST FOR TIPS ON REMOVING DUPLICATED SHELVES




With the new Kobo driver introduced with calibre 0.9.1, there has been some confusion over how to automate the management of shelves.

The steps I use are the following

Driver / calibre Configuration
This column is just what I made. If you have an existing column (either custom or builtin that YOU want to use, there is NO need to make one.
  1. Added a custom column to calibre
    This column is just what I made. If you have an existing column (either custom or builtin that YOU want to use, there is NO need to make one.
    • Preferences | Change Calibre Behaviour | Add your own columns
    • Select Add custom column
    • Select Tags in Quick create
    • I used Lookup Name myshelves and Column heading My Shelves
      Do make sure this column is of type Comma separated text, like tags, shown in the tag browser.
  2. Configured either the Kobo Touch or the Kobo Touch Extended driver depending on which you are using.
    • Preferences | Advanced | Plugins
    • Expand Device Interface plugins section and look for KoboTouch or Kobo Touch Extended driver
    • With KoboTouch or Kobo Touch Extended highlighted, select Customize plugin
    • In the area for shelf info, type #myshelves, series.
      (Any time a custom column is used within calibre, it HAS to be referenced with a # symbol in front of it.)
      (Please note that #myshelves is just what I used. As I said at the start "These are the steps I used". Nothing prevents you from using an existing column in YOUR calibre setup.)
    • Select any other relevant options. It is suggested that at a minimum you select the Create Bookshelves and Delete Empty Bookshelves options. The other options are not shelf specific.
Now, when you edit the metadata for a book, look for the Custom Metadata area (where it is found depends on the view you are using). In the field My Shelves type in whatever shelves you want the books to be placed.

If you do as I did and also add series to the driver options, a shelf will be created automatically for each book series, and the books added to that shelf.

Configuring calibre's Metadata Management options

calibre has three options as to when it updates Metadata on the device. This also affects when the shelves are managed on the Kobo.

This option is managed as follows:
Changing Book Titles to include Series Info

One probably also wants to change book titles to include Series info. That gets done via what is called a "metadata plugboard". Through these you are able to modify items like the book's title or author as it gets transferred to your device.

Goto Preferences | Import/Export | Metaboard plugboards

It looks complex, but is not.

On the line that reads Add new plugboard do the followingOnce all that is done, take a DEEP breath and hit the Save Plugboard button and then the Apply checkmark at the top of the screen.

You will find a lot more discussion of these over in the calibre Library Management forum with more examples in this thread.

For those people who don't care about syncing of shelves between their device and the cloud (and in turn with other devices), the ability exists to override shelf syncing.

Quote davidfor
While we are on the topic of shelves and syncing, there is a way to prevent shelves from syncing. Add the following line into your "Kobo eReader.conf" file in the "ApplicationPreferences":

SyncShelves=false

To enable shelf syncing again, either remove the line or change the value to "true".
I'm not sure which firmware level this was added, but it is present in 2.8.1 at least.

CLEANING UP DUPLICATE SHELVES

Occasionally, due to issues with the Kobo infrastructure, a sync with Kobo will have the unfortunate side-effect of restoring ALL previously deleted shelves (including the possibility of myriads of duplicated shelf names).

These are a PAIN (if not impossible) to remove from the device itself, but luckily CAN be handled via calibre. Remember, this ONLY effects the shelves on the device; the definitions within calibre stay intact, and shelves WILL be correctly re-added and populated by calibre when the device is next attached.
  1. calibre has available for it a plugin called Kobo Utilities.

    With this plugin installed, and your Kobo attached, launch the plugin. (This will be dependent on where YOU selected to have the icon for the plugin added when you installed it).

    From the plugins menu, select Database and then Fix Duplicate Shelves. The plugin will then display a list of shelves and how many occurences of each shelf are found. Select which shelves to delete, and then indicate whether to keep the oldest or newest shelf of each duplicated one. (I *think* that normally, you would want to keep the newest instance).

    Next, decide whether or not to Purge the shelves from the database. If you decide to Purge, then the records are totally dropped from the Kobo; however, they will remain on the Kobo Server, and, unless the second bullet is done, will reappear. If you decide NOT to purge, then the next sync of your device to Kobo will also remove the duplicate records from their infrastructure.

    Finally, press the OK button and watch the magic happen.
  2. The option also exists to ensure that neither shelves nor their conrents (only Kobo format books) EVER sync to the Kobo servers.

    To do this, with your Kobo attached to your computer, browse through the directories on it and find the .kobo\Kobo directory. (Note that under Linux and OS/X environments, the .kobo directory will be hidden due to the leading period). Within this directory will be a couple of files; the one you are concerned with is the Kobo eReader.conf file. This file contains various options that are used to control the device.

    Open this file in a text editor (on Windows for instance, use Notepad, NOT Word or Write), and look for a line [ApplicationPreferences]. After this line, add a new line SyncShelves=false. Save the file, and disconnect the Kobo as usual.

    The addition of this line will ensure that shelves do NOT get synced to the Kobo Cloud.
Reply 

#2  voidoid 10-08-2012, 03:13 AM
Thankyou PeterT. Your explanation has enabled me to finally get this working properly. Going to save lots of time. Thanks again.
Reply 

#3  Mrs_Often 10-08-2012, 03:46 AM
Thanks Peter! I would have had a hard time figuring out all that on my own. I started adding series first letters and numbers to the titles manually aaages ago and gave up because it's just a hassle. This is exactly what I need!
Reply 

#4  rainio 10-08-2012, 08:29 AM
Thanks for this.
I can change a books shelf and send it to main memory where it will appear in that shelf, but when sending to Card A the shelf isn't recorded.
Is this a known problem?
Thanks.
Reply 

#5  davidfor 10-08-2012, 09:23 AM
Quote rainio
Thanks for this.
I can change a books shelf and send it to main memory where it will appear in that shelf, but when sending to Card A the shelf isn't recorded.
Is this a known problem?
Just did a check and it is working here. I tried a few different combinations, and it worked each time.

Just to check what you have done:

- Configure shelves as above
- Set the shelf for a book
- Connected the device
- Sent the book to the main memory
- Ejected the device and the book was on the shelf
- Deleted the book
- Connected the device
- Sent the book to the SD card
- Ejected the device and the book was not on the shelf

Is that what you did? Or something different?
Reply 

#6  rainio 10-08-2012, 10:18 AM
Thanks, davidor, for taking the time to look into it.
I tried it again, and the selheves worked when using calibre on the original computer I transferred the first shelves to it a few days ago, but this morning when I tried copying 100 books on various shelves on different computer the shelves didn't work.
So it's something to do with using two separate calibres to transfer the books.
Should this be a problem?

Thanks.
Reply 

#7  vice-versa 10-08-2012, 01:37 PM
It worked for me
Reply 

#8  buffaloseven 10-08-2012, 03:32 PM
The instructions worked great. Love being able to change book titles to <Series> - <##> - <Title> as they're transferred to the device; makes it significantly easier to browse on the device. Regarding shelves, Calibre seems to be creating shelves with no problem, but won't delete empty ones. Has anyone else had this problem?
Reply 

#9  vice-versa 10-08-2012, 03:36 PM
Quote buffaloseven
Regarding shelves, Calibre seems to be creating shelves with no problem, but won't delete empty ones. Has anyone else had this problem?
same problem for me, but as I'm to make a factory reset anyway... I'll start with a brand new database and will put my books back "cleanly" on my SD card.
Reply 

#10  buffaloseven 10-08-2012, 03:44 PM
Quote vice-versa
same problem for me, but as I'm to make a factory reset anyway... I'll start with a brand new database and will put my books back "cleanly" on my SD card.
Let me know how it goes; I'd be interested to see if it fixes it or if there's just a small bug in the (new) driver.
Reply 

  Next »  Last »  (1/55)
Today's Posts | Search this Thread | Login | Register