I lost a mind map. How can I restore/recover it?

It has happened that users of Docear lost some mind-maps and hence, the work of days, weeks, or even months. There is a number of reasons why users lost their data. Some had a virus, others bought a new computer and forgot to make a backup of Docear’s data, and a few just deleted their data by mistake. In very few cases it even happened that Docear deleted mind maps, or overwrote them with 0 byte mind maps (this can happen in particular, if exactly when you save a mind map, your computer crashes).

If you lost some data, there is a chance to recover it, but first of all: Do not make any changes on Docear. If Docear is running, do not close it. If Docear is not running, do not start it!

  1. If you have activated Docear’s free web-backup function, you can simply download your mind maps at “My Mind Maps“.
  2. Sometimes Docear needs to convert mind maps to a new data format. In these situations, Docear creates a backup. Docear also creates auto-backups while you use Docear, but deletes these backups once you close Docear. These backups are stored in c:\Users\<windows username>\.docear\backup\   (or ~/.docear/backup/ on Linux and and Mac OS X). If you are lucky, there is a copy of your mind map.
  3. If you have activated the recommendation feature, your mind maps are also transferred to our server but do not appear at “My Mind Maps”. Contact us, we might be able to recover your mind map.
  4. If you have activated backup or recommendations, mind maps that shall be transferred to our servers, are first stored in c:\Users\<windows username>\.docear\users\<docear username>\queue\mindmaps\ (or ~/.docear/users/<docear username>/queue/mindmaps/ on Linux and Mac OS X). Have a look, maybe you find a copy of your mind map in that folder.
  5. If all the previous steps, do not help, you may try the free UndeletePlus. Use it to recover deleted files from c:\Users\<windows username>\.docear\backup\ or c:\Users\<windows username>\.docear\users\<docear username>\queue\mindmaps\backup. If you are really lucky, this works.

We are really sorry, but if none of the above steps recover your data there is probably nothing we can do about it. To prevent data loss in the future, we can only recommend to use Docear’s free backup feature, and ideally you use an additional third party tool. We can highly recommend Backblaze, which backups your entire hard drive for only 5$ a month (we don’t get any money for this recommendation but Backblaze has helped ourselves several times to recover important data). Seriously, data loss can always happen – due to your own faults, errors in the soft- or hardware, or simply bad luck. Therefore, please, take some precautions before you lose your valuable work.

How to post a helpful, i.e. precise, bug report, question, etc.?

If you want us to help you, you need to be as specific as possible when you report a bug or ask a question. Tell us your operating system, the version of Docear or Docear4Word, and provide step-by-step instructions with exact examples that allow us to reproduce the bug or understand your question. Being precise is in your own interest. If you are not, it will take us more time to find the problem or answer your question. This means, we will have less time to implement new features and improve Docear. In addition, if we don’t understand what you want from us, and we ask you to explain your issue in more detail, it will delay the final answer for a few days, because we are visiting the forum only once or twice a week. This means, if you ask a question on Monday, and we ask you on Tuesday to explain your issue in more detail, you probably won’t get a follow-up answer before Friday, even if you directly answer on Wednesday. If you had been precise right away, you would have had the final answer on Tuesday already.

Being precise does not mean that you need to write pages over pages. Just provide as many information as possible in the most concise way to enable us to reproduce the bug or understanding exactly what you want to know.

Here are a few (bad) examples.

Hello, I found a bug. When I accidentally enter an incorrect bibtex key, docear opens two popup windows saying invalid BibTeX key entry.

Such a bug report is of little use. In this particular example, we need to know where you have entered the BibTeX key and we also need a an example of an invalid BibTeX key to reproduce the bug.

Another user sent us this

Docear does not start. What can I do?

Again, such a question is not specific enough. We need to know if this is the very first time that you start Docear, or if you have upgraded from an older version. We need to know your operating system. We need to know what exactly you mean by “Does not start”. Is there any error message? Is just nothing happening? Is Docear starting but then the GUI freezes? …?



When should I send a feature request, bug report or question directly to the Freeplane team?

Docear is based on the mind mapping software Freeplane and whenever the Freeplane team is changing something in Freeplane we will automatically incorporate these changes into Docear (with a few weeks delay). We closely cooperate with the Freeplane team and agreed that Freeplane will focus on mind mapping functionality and we on PDF and reference management and the workspace. Therefore, if you have a feature request or find a bug that relates to the core mind mapping functionality, you can directly contact the Freeplane team. Some examples of such functionality is formatting nodes, printing, navigation in mind maps, time and calender management, or the search and filtering function.

Similarily, if you have a question that relates only to the mind mapping functionality (e.g. how to use floating nodes or the calender function, …) you might also ask the Freeplane team because we are not 100% familiar with all the functions that Freeplane offers. Of course, you can also ask us and if we can answer the question we will happily do.

Why is Docear not starting on Microsoft Windows?

A few Microsoft Windows users have trouble to start Docear. These two hints have helped them:

Delete Docear’s installation folder and install Docear again afterwards

When you have used older versions of Docear succesfully, but the new version does not start, you should delete Docear’s installation folder and install Docear again aftwerwards. Docear’s installation folder is located at “C:\Program files\Docear” on 32-Bit or “C:\Program files (x86)\Docear” on 64-Bit systems by default. It contains both the “Docear.bat” and the “Doceat.exe” files.

Tell Docear to use another location in order to store and restore its settings

If your Windows user folder is located on a network drive, which is the default configuration in some companies, Docear won’t find its settings.and can’t start. You can tell Docear to use a different location for this settings folder. In order to do that, please follow these steps:

Please navigate to your installation folder of Docear, i.e. the folder containing both the “Docear.exe” and the “Docear.bat” file (you can find further information at the top of this page). Now copy the Docear.bat file to your Desktop (you won’t be able to modify it in the “C:\Program files” location. Now open it with your default text editor (e.g. right-click it and select modify or edit from the context menu). Do not use any rich text editors like Microsoft Word!
You have to attach an aditional parameter to the command String in order to tell Docear where it should store and restore its settings from. You need to add this entry (including the quotation marks somewhere between other “-D…” entries) and modify the path according to your needs, e.g.:

Now copy the file back to Docear’s installation folder and start it from there.

A full version of this file might look like this:

@echo off
set freeplanedir=%~dp0
set xargs=init.xargs
set defines= “-Dorg.freeplane.param1=%~1″ “-Dorg.freeplane.userfpdir=C:\Users\stefan\.docear” “-Dorg.freeplane.param2=%~2″ “-Dorg.freeplane.param3=%~3″ “-Dorg.freeplane.param4=%~4″
set resdir=”-Dorg.freeplane.globalresourcedir=%freeplanedir%resources/”
@echo on
java -Xmx512m “-Dorg.knopflerfish.framework.bundlestorage=memory” “-Dorg.knopflerfish.gosg.jars=reference:file:%freeplanedir%core/” %resdir% %defines% -jar “%freeplanedir%framework.jar” -xargs “%freeplanedir%props.xargs” -xargs “%freeplanedir%%xargs%”

Why is Docear not starting on Mac OS X?

Mac OS X 10.9.x requires all software to be signed. Docear is not signed yet, but there is help. Please find official information here or read:

  • When you have never used Docear before you can start it by switching in your system preferences -> security -> allow apps from anywhere. You can also right-click the app, open it and select that you want to execute it although it is not signed.
  • When you have already used Docear and upgrade to a newer version of Docear, OS X 10.9.x fails to verify the Docear app and reports that it was tampered.

To solve this issue you need to open a terminal shell and execute the following commands::

sudo spctl --list | grep Docear
This will return a line with an ID and some additional information like this: 3529[UNLABELED] P0 allow execute [/Applications/Docear.app]

Then you need to remove it.
sudo spctl --remove --rule 3529 # e.g. with an id of 3529. It may be different for you.

Next you have to tell the system to put Docear.app back in quarantine to test if the signature is valid again and we can use the right click method again.
xattr -rd com.apple.quarantine /Applications/Docear.app # your app location can be different.

Now the application will open when you right-click it and press OPEN.

What is a project and when should I create a new one?

In Docear, you may work with multiple projects that are all listed in your workspace panel. We are often asked what a project is intended for and for what kind of work exactly one should create a new project? We suggest that you create different projects only for entirely different and independent kind of works. For instance, I created a project for Docear’s manual, another project for Docear’s teaser video, and another project for my own PhD thesis. I am not creating new projects for every paper I write (instead, I only create a new mind map within my Thesis project to draft a new paper).

You might think of a project as something you would want to share with others. For instance, I do have my PhD thesis project with all the literature I annotated during the past few years. When I want to write a new paper with my colleague, I wouldn’t mind to give him access to all my literature including annotations, and my other drafts, because my colleague would need access to most of my literature, and maybe even to old drafts, to write the current paper. Therefore, all my literature and drafts that somehow relate to my PhD thesis are in one project, and I do share the entire project with my colleague via Dropbox.

Now, for Docear’s manual I needed to create many examples that do not have anything to do with my thesis or papers I am writing. It might also be that a user (you?) asks for access to the example files to translate them to another language. I certainly wouldn’t mind to give you access to the manuals’ example project. However, I wouldn’t give someone who wanted to look at the example files, and whom I don’t know, access to my PhD project. Hence, the example files for the manual are in a separate project, so I could share the project easily via Dropbox, independently from my PhD project.

If in doubt, manage everything in a single project rather than creating a project for every little piece of work, and keep in mind that it is not (yet) comfortably possible to use literature from one project in another project.

Why should I use a mind mapping tool to draft my documents?

Mind maps are suited perfectly for organizing your ideas and drafting your documents, since:

  • you can store the information hierarchically (instead of using a plain table or a list of nodes)
  • you can hide/show (un)necessary information really fast by collapsing or expanding any nodes.
  • you can outline your document by using 1st level nodes as chapters, 2nd level nodes as sections, …, and you can directly add both pdf annotations and your own ideas as leaves to the right place
  • you can change the structure of your drafted document really fast by dragging nodes (representing for instance a section) around and dropping them on another node

What has Docear to do with Freeplane?

Docear is based on the mind mapping software Freeplane. That means, we adopt the source code from Freeplane, extend it with further functionality e.g. regarding PDF and reference management, and build Docear from it.  That means, every change the Freeplane team is doing in Freeplane, is automatically available in Docear (as soon as we update to the latest Freeplane source code which happens every couple of months). This also means that when you have a feature request or bug report you may consider to submit it to the Freeplane team. This is particularly recommendable if the bug report or feature request related to a basic mind mapping function such as layout, printing, notes, links, etc. Anything related to the workspace, reference management, PDF management and the Docear online services definitely should be addressed to the Docear team.

PDF Viewers

Why is Docear showing a “The access to the file is blocked” warning?

To import new annotations, Docear needs write access to a PDF. Write access is needed because Docear writes unique IDs to each annotation in the PDF when the annotations are imported. This is necessary because some PDF readers occasionally overwrite the standard annotation IDs. However, most PDF viewers block write access for a PDF that is opened in that PDF viewer. Hence, when Docear wants to open a PDF and realizes that there is no write access, this dialog appears:

When this dialog appears, there is no other option than closing the PDF in your PDF viewer, or skipping the process of importing annotations for that PDF. Currently, this dialog always appears when a PDF is opened in your PDF viewer, even when you have not created any (new) annotations in the PDF file. We know that this is not ideal and plan to change this. This means, in one of the next versions, Docear won’t show the warning message if the PDF does not contain any new annotations (if there are new annotations in the PDF, such a warning dialog is inevitable) .

If this warning dialog annoys you too much, you might consider to use a PDF reader that does not block write access to PDFs. In this case, Docear could writes its own annotation IDs to a PDF although it is opened in a PDF viewer. However, we would not recommend this. If Docear changes annotation IDs while the PDF is opened in your PDF viewer, and you make some changes in your PDF viewer and save the PDF, Docear’s changes will be lost. This might result in unpredictable behaviour such as non-working links or a duplicate import of annotations in Docear. According to one user, a Windows PDF Reader that does not block writing access to PDFs is Foxit Reader 4.2 (or older). Please note that we will not provide support, if some of your data get lost because you used such an old PDF viewer!


Why is PDF-XChange Viewer or Adobe Acrobat Pro not recognized?

Sometimes, PDF-XChange Viewer is not recognized by Docear. There are three potential reasons.
  1. You did not install PDF-XChange Viewer. Please note that PDF-XChange viewer it not installed by Docear automatically. It needs to be installed by you.
  2. You did install the wrong PDF viewer. Tracker Software offers several PDF viewers with nearly the same name. Please make sure to download the free PDF-XChange viewer application. Other products, e.g. PDF X-Change editor, will not work!
  3. You downloaded the wrong download type. By default, a ZIP file is offered as download and there is also a portable version. Neither the ZIP nor the portable version will work with Docear. Docear can only recognize PDF-XChange viewer, when it is properly installed. This means, you need to download the EXE Installer.

It’s best to download the EXE Installer of PDF-XChange Viewer from TrackerSoftware’s download page because the product page is not well structured. Alternatively, you can directly download the correct file here: http://www.tracker-software.com/downloads/PDFXVwer.exe (download the file and then execute it).

If you downloaded and installed the correct version, and Docear still does not find the installation of the PDF X-Change viewer, please report this problem in our forum and answer the following questions to help us tracking down the issue:
  1. Which operation system with which architecture do you use? e.g.: Windows 7, 64-Bit
  2. Which version of Docear do you use? e.g.: stable build214 (You can find the version of Docear by clicking “Help” > “About” in Docear’s ribbon bar.
  3. Which version of the PDF X-Change viewer do you use? e.g.: 2.5 (Build 212.0)
  4. Which version of Java do you use? Please open the console and execute the command “java -version” in order to find out. On Windows 7 systems you can open the console by pressing the “Start”-Button and typing “cmd” in the small input field inside the menu.

If Adobe Acrobat Pro is not recognized by Docear, please try to start Docear as an Administrator.

Migration from Other Reference Managers

How to resolve duplicated references?

As you may know, there is no real BibTeX standard but lots of different dialects and styles.

Zotero for instance creates BibTeX references with un-escaped semicolon or colon characters, although they are used to separate multiple files from each other and to separate meta information like the file’s description and the file type from the actual file path.

Warning dialog about duplicate references

You can now select that you want Docear to always ignore duplicate references. Instead of manually resolving them and leaving only one reference per PDF document or URL that Docear can find unambiguously, Docear will always use the first reference it finds in your Library. This means you don’t have to worry about duplicates in BibTeX files created by Mendeley. This also means that you might link different references in your mind map files, however, we think that this should not be a big problem, since the references are duplicates and hence should contain the same data.


How to migrate from Mendeley?

Migrating from Mendeley to Docear is easy (as long as you did not annotate your PDFs in Mendeley).

Migrating References

In Mendeley, first empty your trash. Then, open Mendeley’s preferences and activate “BibTeX syncing” as shown in the screenshot. Specify a path that is within your Docear project home. Then close Mendeley. Now, there should be a library.bib in the path you specified.

Mendeley BibTeX Settings

This library.bib is the file you can use in Docear. In Docear, open the workspace panel, and do a right click on the “References” entry. Chose “Change reference database” and select the library.bib. If you should experience any problems, please contact help@docear.org.

Migrating PDFs

In Docear, just add the folder in which your PDF files are, as new literature repository. This will allow Docear to import all your PDFs. However, if you created annotations (highlighted text or notes) with Mendeley in your PDFs, then you have a problem. Mendeley is storing the annotations in a proprietary format and currently (October 2013) there is nothing you can do about it. There is no way to get these annotations in the standard PDF format that would allow Docear (and any other standard PDF reader) to access them. What you can do, is urging the Mendeley team to implement a decent export. Otherwise, if you want to use Docear, you would have to re-annotate all PDFs again. You can read more about this in our Blog (in particular in the comments).

How to migrate from Citavi?

Sorry, we have no specific instructions on how to migrate from Citavi because no users have told us how to do it (and we don’t have Citavi installled). If you migrate from Citavi to Docear, we would very much appreciate if you could send us some instructions that we can publish here in the FAQ.

How to migrate from Endnote?

One of our users sent us the following instruction for migrating from Endnote. This procedure will capture all entries but not all fields.

1. Get the Bibtex style from the link below and double click on it while EndNote is running.

This style file is for exporting citations, not for exporting the database. There are many other fields within EndNote,  some of which have no mapping to BibTex fields!

2. In EndNote X7, go to Edit->Output Style->Open Style Manager, then check the Bibtex export and close the window.
3. Go to Edit->Output Style->and select BibteX Export.
4. Select the whole library or the references which you want and go to File->Export and : 1. Save as type= Text File(*.txt) 2. Output Style= Bibtex Export, then save it.
5. Go to the location of the saved text file and change the extension to *.bib and save it.
6. Now you need to configure Docear. Select your Endnote BibTeX file in Docear (right mouse click on References->change location in the left column and locate your bib file).
7. After selecting the BibTeX file, you need to tell Docear where EndNote saves your PDF files. First, open the “Change location” dialog in Docear (right mouse click on “Literature Repository”) (or add the EndNote repository as an additional literature repository). Note that EndNote repository is in the folder which you save your library. Inside this folder there is another folder which ends with “.Data”. Open it and select PDF folder. (Also, you can select the parent folder since Docear can read subfolders automatically. Important. Every time you insert a new reference in EndNote, you have to repeat the first 5 steps since EndNote doesn’t save bib automatically.

The above will not export the file links into the BibTex file giving direct access from JabRef as provided by the legacy PDF and PS directory configuration within JabRef. There can also be file links in Endnote to files outside the Endnote database that will not be captured by the above procedure.

How to migrate from RefWorks?

Sorry, we have no specific instructions on how to migrate from RefWorks because no users have told us how to do it (and we don’t have RefWorks installled). If you migrate from RefWorks to Docear, we would very much appreciate if you could send us some instructions that we can publish here in the FAQ.

How to migrate from JabRef?

Docear has integrated JabRef. This means, Docear offers most (but not all) of JabRefs functionality. All you need to do, do migrate is specifying your JabRef BibTeX file in Docear. Then, you will have all your data from JabRef also available in Docear’s reference panel.

How to migrate from other reference managers?

To migrate from other reference managers, you need to look whether your current tool has a BibTeX export. If you can export your data as BibTeX, you may specify the BibTeX file in Docear.

How to migrate from BibTeX based reference managers?

If you are using a reference manager that stores its references in BibTeX format, a migration is easy since Docear also uses the BibTeX format. All you need to do is specifying in Docear where your BibTeX file is stored. Then, Docear will show your data in its reference panel.

How to migrate from Zotero?

If you want to migrate from Zotero to Docear you need to export Zotero’s data as BibTeX file.

  1. Export Zotero’s references as shown on the screenshot to a BibTeX file. Save the BibTeX file in a location that will be part of your Docear project home, e.g. c:\university\zotero.bib. 
  2. Select your Zotero BibTeX file in Docear (right mouse click on “References”).
  3. After selecting the BibTeX file, you need to tell Docear where Zotero saves your PDF files.
    1. First, open the “Change location” dialog in Docear (right mouse click on “Literature Repository”) (or add the Zotero repository as additional literature repository)
    2. Select the folder in which your PDFs are. In Windows 7, the path looks like this
  4. To have a better overview in Docear we would recommend making the following setting (Monitoring – Settings – Flatten directories), but this is optional.

Zotero can export its data to BibTeX BUT for whatever reason Zotero does not export the file names and paths. Therefore, Docear cannot analyse which BibTeX key is assigned to a PDF. Potential workarounds are

  1. Visit Zotero’s forum and support our request to include file names and paths in the exported BibTeX file (just register and post a “me too”)
  2. Consider using Docear’s integrated reference manager instead of Zotero. There is a tutorial on how to switch from Zotero to JabRef. Since Docear uses JabRef, this tutorial should work for Docear users as well. Feel free to let us know your experience.
  3. Use Mendeley as converter. Download Mendeley, go to Tools | Options… and pick Zotero / CiteULike and select your Zotero database. Mendeley will then permanentely create a BibTeX file (of course you have to start Mendeley from time to time). Read here how to set up Mendeley to create a BibTeX file automatically.
  4. A user of Zotero has created a solution that should work exactly as we need it for Docear (start reading from the post from Mar 16th 2012). However, it requires quit a bit of work and at least for some users it does not work at all.

If you find a way how to switch from Endnote to BibTeX/Docear or using both in conjunction, please let us know.

Working with Docear and other reference managers at the same time

How to use Mendeley and Docear at the same time?

In principle, it’s possible to use both Docear and Mendeley with the same data. However, there are two problems, namely Mendeley’s slightly awkward BibTeX export, and their proprietary PDF format. If you want to use Mendeley, we suggest you have a look at why Mendeley might be considered a bad reference manager that will lock-you in. If you disagree, or don’t mind, and still want to use Docear and Mendeley, read on…

Using the same reference data

Mendeley has a feature to create and update a BibTeX file that can be used with Docear. To activate this function in Mendeley, select “Tools -> Options -> BibTeX” and ensure all settings are as in the screenshot. The Path is not fundamentally important but ideally it should be within the project home of Docear.

Mendeley BibTeX Settings 

To tell Docear where your Mendeley-BibTeX file is stored, do a right click in the workspace panel on the “References” database and chose “Change reference database”. Then select your Mendeley BibTeX file (it is called library.bib and it is stored in the path you specified above).

Important: Do any changes on your reference data directly in Mendeley. Do not change reference data in Docear because all changes made in Docear will be overwritten by Mendeley. If you like, visit the Mendeley support forum and vote on the idea that Mendeley synchronizes BibTeX data in both  directions.  

Resolving duplicate BibTeX entries

If you export a BibTeX file from Mendeley the exported file will probably have a lot of duplicated entries. The Mendeley team knows about this issue since April 2010, but they have not changed it yet. Docear depends on unique references and in general it does not make any sense to have any duplicates in a BibTeX file, so please vote to fix it. Until they have fixed it you can work around this bug by emptying your trash in Mendeley before exporting your reference database to a BibTeX file. If this does not help and you still get duplication warnings in Docear, please send your BibTeX file to  along with a comment what went wrong and we will try to find the error and fix it for you. Also, Mendeley does not include entries set to “Details need review”. Please vote here  to have Mendeley include all entries in their BibTeX export.

Using the same PDF files

We highly recommend to deactivate the functions “Sort files into subfolders” and “rename document files” because otherwise problems might occur in Docear when files are automatically renamed by Mendeley (Docear won’t find them when Mendeley renames them).

Mendeley File Organizer

If you have activated the function “Organize my files” in Mendeley, it is important to specify the directory that you specified in Mendeley also as your literature repository in Docear. Only then, Docear and Mendeley can work with the same PDF files. To do so, do a right click on “literature repository” in the workspace panel and select “Add Literature repository”. Select the same directory you have specified in Mendeley.

If you do not have activated the function ”Organize my files” in Mendeley, you need add the folder you are watching in Mendeley as literature repository in Docear. You find this folder in Mendeley in the Options in the tab “Watched Folders”.

Mendeley Watch Folder

Finally, you should be aware that Mendeley is not using the standard PDF format for storing annotations in PDFs. This means, when you create annotations in Mendeley, Docear cannot access them (nor can any other normal PDF editor). Therefore, we strongly suggest that you create and manage your annotations only with Docear and your favorite PDF viewer but not with Mendeley. 


How to use Zotero and Docear at the same time?

If you want to use Zotero together with Docear you need to export a BibTeX file, each time you change or add an entry in Zotero. This process can be done automatically with the Zotero plugins “AutoZotBib” and “Zotero Autoexport“.

If you don’t want to use these plugins you can export the BibTeX file manually by following these steps (you have to do it each time you make changes in Zotero):

  1. Export Zotero’s references as shown on the screenshot to a BibTeX file. Save the BibTeX file in a location that will be part of your Docear project home, e.g. c:\university\zotero.bib. 
  2. Select your Zotero BibTeX file in Docear (right mouse click on “References”).
  3. After selecting the BibTeX file, you need to tell Docear where Zotero saves your PDF files.
    1. First, open the “Change location” dialog in Docear (right mouse click on “Literature Repository”)
    2. Select the folder in which your PDFs are. In Windows 7, the path looks like this
  4. To have a better overview in Docear we would recommend making the following setting (Monitoring – Settings – Flatten directories), but this is optional.

There are many more add-ons for Zotero that facilitate BibTeX export etc. For an excellent overview, read here.


Why am I being blocked and can’t log-in or comment?

We are using various Anti-Spam Add-Ons to prevent spammers flooding our Blog and forum with spam. If you are blocked and can’t comment, log-in, post or what so ever, please send an email to help @ docear.org and tell us what exactly you did and what your IP is. We will set your UIP on a whitelist then.

What to do if I forgot my password and/or username?

Passwords in our database are all encrypted. Therefore, there is no way to retrieve your old password but you can try this: Look in your email archive for an email from noreply@docear.org with the subject “Docear Account Signup Confirmation”. It includes your username and the last three characters of your password. If you don’t have this email any more, or if the last three characters don’t help, reset your password.

Other Mind Mapping Tools

Freeplane vs. Docear — what are the differences?

Sometimes users ask us whether they should use Docear or Freeplane, and what exactly the differences are. Well, Docear is based on Freeplane, extended by some additional functionality. Namely, we added some special PDF management capabilities (import of PDF annotations), reference management (based on JabRef), the workspace concept, and some online features such as backup. Although, the latter two features (workspace and backup) soon will be available in Freeplane, too. That means Docear can do everything Freeplane can do, and a little bit more. This might sound like you should always use Docear but that is not true. There are some good reasons (for some people) to use Freeplane. Namely, if you don’t need Docear’s special features we recommend using Freeplane. This gives you three advantages. First, you don’t get annoyed by features you don’t need. Second, and more importantly, the start-up of Docear is very slow because we start all the program code from Freeplane plus JabRef (reference management) plus the other features. That means, Freeplane is much faster. Third, the Freeplane team is highly active and releases new versions of Freeplane very often. We update to Freeplane’s source code once in a while which means with Docear you might not always have the latest bug fixes which are already included in the latest Freeplane version.

In short: if you need Docear’s features, use Docear. If you don’t need Docear’s features, use Freeplane because it’s faster and usually contains less bugs.


How can I change/add keyboard-shortcuts?

It is very easy to add or change a keyboard shortcut. Simply find the function you want a keyboard shortcut in the menu, hold the CTRL key on your keyboard and click on the entry in the menu. A dialog will open that allows you to specify the keyboard shortcut. That’s it :-).


How can I create references in footnotes or text-fields?

Sorry, currently, you cannot create references in footnotes or text-fields. We know, this is annoying and we hope that we can fix this problem soon, but it might take a while.

How can I localize strings like “p.”, “pp.”, “et al.”, … ?

If you are writing a non-english article, you might not want page numbers abbreviated by “p” or “pp” but in your particular language. Or you might “et al.” in another language. You can change these strings in your Sys.js file which is located in c:\Program Files (x86)\Docear4Word\JavaScript\. In that file search for the string you want to change, change it, and save the file.

Why is the order/numbering of citations not correct?

Users often ask why citations are numbered e.g. … [1] … [3] … [2]  and not … [1] … [2] … [3] . The answer is easy: because of the citation style you use. Some (but not all) citation styles order the entries in the bibliography by the authors’ last name. In the example, a bibliography might look like this

[1]    Agarwal, N. et al. 2005. Research Paper Recommender Systems: A Subspace Clustering Approach. Proceedings of the 6th international conference on Advances in Web-Age Information Management (WAIM’05) (2005), 475–491.

[2]    Burke, R. 2002. Hybrid recommender systems: Survey and experiments. User modeling and user-adapted interaction. 12, (2002), 331–370.

[3]    Castells, P. et al. 2009. Novelty and Diversity Metrics for Recommender Systems: Choice, Discovery and Relevance. Proceedings of International Workshop on Diversity in Document Retrieval (DDR) (2009), 29–37.

The list is ordered alphabetically. Therefore, if you cite the paper by Burke first in your paper, it will be numbered [2]. If you want your citations numbered by the order they appear in the full-text, you must select another citation style that supports this (e.g. the IEEE style).

There is another issue some users experience. When you cite two references at once, they might appear as [2,1], though it should be [1,2]. If this happens, your citation style was not written properly. In this case you can edit it with a text editor locally, or, ideally you fix the citation style online so other users can benefit from the change. To fix the sorting issue, add a

   <key variable=”citation-number” sort=”ascending”/> 


after the command <citation collapse…> and before the command <layout…>.

If this also does not help, please send an example Word document and your BibTeX file to help@docear.org.

How can I keep two (or more) words as last name?

Sometimes, a name consists of multiple words and you don’t want a reference to show only one of that words. For instance, when you want to cite “Karl-Theodor zu Guttenberg” you want “zu Guttenberg” to appear in the reference as last name and not only “Guttenberg”. Similarly, when you want to cite “Google Inc.” you don’t want “Inc.” to appear in the reference but “Google Inc.”. To indicate this situation in Docear (or Docear4Word), write the name like this in Docear:

Karl-Theodor \{zu~Guttenberg\}


How do I upgrade to the latest citeproc-js version?

Docear4Word is using citeproc-js which is responsible for the formatting of the references. Sometimes there are new releases of citeproc-js that fix some bugs or ad some new features. You can either wait a few weeks until we integrated the latest citeproc-js version into Docear4Word or upgrade manually. To upgrade manually, replace c:\Program Files (X86)\Docear4Word\JavaScript\citeproc.js with the latest version which you can download here.