[GUI Plugin] Import Mendeley Documents

[cpina]

This plugin imports Mendeley Documents into Calibre.

The plugin will import all the documents that are saved in the "Calibre" folder in your Mendeley library. The plugin uses Mendeley OAPI to connect to your account and retrieve the documents.

Installation:
1.- Download the last Mendeley-$VERSION.zip file
2.- In Calibre, press the "Preferences" button in the toolbar
3.- Press Plugin-ins
4.- Press "Load plug-in from file"
5.- Open the file that you downloaded in the step 1.-
6.- Restart Calibre
7.- The plugin is installed. You will have a new button in the toolbar that says "Import from Mendeley"

Usage:
1.- In Mendeley Desktop: create a folder called "Calibre"
2.- Add documents to your folder. In Mendeley, documents can exist in more than one folder (it's like GMail folders). (Mendeley tip: if you select a document you can see a subtle highlight in the folders list that indicates in which folders this document has been added)
3.- Synchronise Mendeley Desktop (button "Sync" in the toolbar. Mendeley Desktop synchronises automatically on each startup)
4.- In Calibre, press the "Import from Mendeley" button in the toolbar
5.- [the first time you will need to authenticate this application against the OAPI. You only need this once]
6.- Wait that the plugin fetches the documents
7.- The new documents will be tagged as "Mendeley" (use the Calibre left hand side pane to show only the Mendeley tagged documents).

TODO:
* If you delete one document from the Calibre folder in Mendeley: this document will not be deleted from Calibre
* More flexibility to indicate which documents should be added?
* Better error handling (when there isn't any connection, Mendeley OAPI is down, etc.).

If you have any questions, suggestions, problems, etc. please leave a comment or email me.

CHANGELOG (0.0.4, 29th March 2012):
-Mendeley "calibre" folder can be called "Calibre" (case insensitive
comparation)
-If no documents are found or no folder is found: shows an error message
-Avoids an error if some document doesn't contain any attachment
(previously it was stop syncing)

[greeniron]

This is a great idea but I can't get it to work. I've installed the plug-in, did the password/pin with mendeley, and created a calibre folder. When I use the plug-in, the job list detail shows "Starting job: Importing Mendeley Documents " but nothing further happens. I'm using calibre 0.9.21 on a mac.

[cpina]

Hi greeniron,

I'll have a look today later on or during the weekend.

Thanks for trying it out!

[livia]

Hi! Is it just me, or really is there a limit of 20 documents? I can add a lot of papers in the calibre folder but only a few get imported in Calibre... In that case, pleas DON'T implement the deletion from calibre folder!!

[cpina]

Hi,

Originally Posted by livia

Hi! Is it just me, or really is there a limit of 20 documents? I can add a lot of papers in the calibre folder but only a few get imported in Calibre... In that case, pleas DON'T implement the deletion from calibre folder!!

There were a limit of 20 documents. I've fixed it in the 0.0.4 version:
http://pinux.info/calibre/mendeley-0.0.4.zip

I've also fixed a bug that caused problems (stop syncing) if a document didn't have an attached file. And if the "calibre" plugin is not found it will show an error message instead of doing nothing :-)

If you miss some feature/find some bug please let me know.