/JabFox

Firefox addon to allow importing of new items directly from the browser.

Primary LanguageJavaScript

Circle CI JabFox: Firefox Add-on for JabRef

JabFox imports new bibliographic information directly from the browser into JabRef.

Please post any issues or suggestions here on GitHub.

Installation and Configuration

  1. Make sure Zotero is installed in Firefox.
  2. Install the JabFox add-on. The JabRef icon should now appear in the Firefox toolbar.
  3. Adjust the path to the JabRef executable in the add-on settings (under Add-ons > JabFox > Options).

Now you should be able to import bibliographic references into JabRef directly from your browser. Just visit a publisher site or some other website containing bibliographic information (for example, the arXiv) and click the JabRef symbol in the Firefox toolbar. Once JabFox has extracted the references and downloaded the associated PDF's, the import window of JabRef opens.

You might want to configure JabRef so that new entries are always imported in an already opened instance of JabRef. For this, activate "Remote operation" under the Advanced tab in the JabRef Preferences.

On Linux, sometimes directly linking JabRef.jar does not work. In this case, create and link the following bash script

#!/bin/bash
java -jar /my/target/to/JabRef.jar "$@"

Thanks to ClemSc for providing this workaround.

About this Add-On

JabFox is a Firefox add-on for users of the bibliographic reference manager JabRef. It automatically identifies and extracts bibliographic information on websites and sends them to JabRef in one click. A wide range of publisher sites, library catalogs and databases are supported.

Internally, JabFox uses the magic of Zotero's site translators. Thus most of the credit has to go to the Zotero development team and to the many authors of the site translators collection. Note that JabFox does not make any changes to the Zotero database and thus both plug-ins coexist happily with each other.

Contributing to the Development

In order to directly use the source code and help with the development of this add-on the Firefox Add-on SDK has to be installed. Now just follow the typical steps to contribute code:

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Build the add-on by running jpm xpi and test it.
  4. Commit your changes: git commit -am 'Add some feature'
  5. Push to the branch: git push origin my-new-feature
  6. Submit a pull request.