Skip to content
Graphical Java application for managing BibTeX and biblatex (.bib) databases
Java TeX CSS Python Groovy Shell
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci add env var also to mv command Sep 12, 2019
.dependabot Set correct labels on dependabot pull requests Sep 9, 2019
.github Update FUNDING.yml Jun 27, 2019
.idea/runConfigurations Improve drag and drop (#5306) Sep 13, 2019
buildSrc/src/main/groovy/org/jabref/build Fix gitignore Jun 3, 2019
buildres Allow gui tests to fail using TravisCI's functionalities Aug 25, 2019
config Add checkstyle for JavaDoc and fix related issues Sep 8, 2019
docs/adr Switch from tika-parsers to tika-core (#5217) Aug 24, 2019
gradle/wrapper Update gradle from 5.5.1 to 5.6 Aug 24, 2019
javafx/scene/control Make it easier to create FXML dialogs (#3880) Mar 23, 2018
lib Include latex2unicode May 11, 2019
licenses Remove JGoodies (#4895) Apr 18, 2019
scripts update install4j to 8.0.1 Sep 12, 2019
snap Add MIT license field Sep 12, 2019
src Bump src/main/resources/csl-styles from `fa125ec` to `0581021` Sep 16, 2019
.editorconfig Add trim_trailing_whitespace to .editorconfig Dec 13, 2016
.gitattributes Update gradle from 4.4.1 to 4.5 and tweak .gitattributes Jan 30, 2018
.gitignore snap: Add custom gradle plugin Sep 11, 2019
.gitmodules Revert "[WIP] Get JabRef running in eclipse" (#5280) Sep 5, 2019
.mailmap Fix right clicking on any entry and selecting "Open folder" results i… Apr 13, 2019
.travis.yml Remove testing on OracleJDK - we stick to OpenJDK only Aug 25, 2019
AUTHORS Fixes for pull request May 20, 2019
CHANGELOG.md Add changelog entry Sep 15, 2019
CONTRIBUTING.md Reformat Understanding the basics section of CONTRIBUTING.md (#4978) May 18, 2019
DEVELOPERS Update DEVELOPERS Feb 5, 2018
LICENSE.md udpate year Jul 19, 2019
README.md Add Java 11 to README.md Jul 13, 2019
build.gradle Merge pull request #5320 from JabRef/dependabot/gradle/com.gradle.bui… Sep 16, 2019
codecov.yml Update codecov.yml to disable PR comments May 11, 2016
crowdin.yml Remove menu* from crowdin.yml (#4094) Jun 4, 2018
eclipse.gradle Make JabRef work in eclipse Sep 5, 2019
external-libraries.txt Add ADR-0004 (#5202) Aug 23, 2019
gradlew Update gradle from 5.5.1 to 5.6 Aug 24, 2019
gradlew.bat Update gradle from 5.5.1 to 5.6 Aug 24, 2019
jabref.install4j remove unix again Sep 12, 2019
settings.gradle Javadoc for the whole project can be built using gradle Mar 17, 2014

README.md

JabRef Bibliography Management

Build Status codecov.io Donation Crowdin

JabRef is an open-source, cross-platform citation and reference management tool licensed under the MIT license.

Stay on top of your literature: JabRef helps you to collect and organize sources, find the paper you need and discover the latest research. main table

Table of Contents

Features

JabRef is a cross-platform application that works on Windows, Linux and Mac OS X. It is available free of charge and is actively developed. JabRef supports you in every step of your research work.

Collect

  • Search across many online scientific catalogues like CiteSeer, CrossRef, Google Scholar, IEEEXplore, INSPIRE-HEP, Medline PubMed, MathSciNet, Springer, arXiv, and zbMATH
  • Import options for over 15 reference formats
  • Easily retrieve and link full-text articles
  • Fetch complete bibliographic information based on ISBN, DOI, PubMed-ID and arXiv-ID
  • Extract metadata from PDFs
  • JabFox Firefox Add-on lets you import new references directly from the browser with one click

Organize

  • Group your research into hierarchical collections and organize research items based on keywords/tags, search terms or your own manual assignments
  • Advanced search and filter features
  • Complete and fix bibliographic data by comparing with curated online catalogues such as Google Scholar, Springer or MathSciNet
  • Customizable citation key generator
  • Customize and add new metadata fields or reference types
  • Find and merge duplicates
  • Attach related documents: 20 different kinds of documents supported out of the box, completely customizable and extendable
  • Automatically rename and move associated documents according to customizable rules
  • Keep track of what you read: ranking, priority, printed, quality-assured

Cite

  • Native BibTeX and Biblatex support
  • Cite-as-you-write functionality for external applications such as Emacs, Kile, LyX, Texmaker, TeXstudio, Vim and WinEdt.
  • Format references in one of the many thousand built-in citation styles or create your own style
  • Support for Word and LibreOffice/OpenOffice for inserting and formatting citations

Share

  • Many built-in export options or create your own export format
  • Library is saved as a simple text file and thus it is easy to share with others via Dropbox and is version-control friendly
  • Work in a team: sync the contents of your library via a SQL database

Installation

Fresh development builds are available at builds.jabref.org. The latest stable release is available at FossHub.

JabRef runs on any system equipped with the Java Virtual Machine (Java 11 or higher), which can be downloaded at no cost from AdoptOpenDJK. From JabRef 4.0 onwards, JavaFX support has to be installed.

  • Windows: JabRef offers an installer, which also adds a shortcut to JabRef to your start menu. Please also see our Windows FAQ
  • Linux: Please see our Installation Guide.
  • Mac OS X: Please see our Mac OS X FAQ.

In addition, JabRef can be downloaded as an executable .jar file. Try to double click the jar file or execute the following command: java -jar <path to jar>

Bug Reports, Suggestions, Other Feedback

Donation

We are thankful for any bug reports or other feedback. If you have ideas for new features you want to be included in JabRef, tell us in our forum! If you need support in using JabRef, please read the documentation first and have a look at our community forum. You can use our GitHub issue tracker to file bug reports.

An explanation of donation possibilities and usage of donations is available at our donations page.

Contributing

Help Contribute to Open Source Join the chat at https://gitter.im/JabRef/jabref OpenHub

Not a programmer? Learn how to help.

Want to be part of a free and open-source project that tens of thousands scientist use every day? Check out the ways you can contribute, below:

  • For details on how to contribute, have a look at our guidelines for contributing.
  • You are welcome to contribute new features. To get your code included into JabRef, just fork the JabRef repository, make your changes, and create a pull request.
  • To work on existing JabRef issues, check out our issue tracker. New to open source contributing? Look for issues with the "good first issue" label to get started.

We view pull requests as a collaborative process. Submit a pull request early to get feedback from the team on work in progress. We will discuss improvements with you and agree to merge them once the developers approve.

If you want a step-by-step walk-through on how to set-up your workspace, please check this guideline.

To compile JabRef from source, you need a Java compiler supporting Java 1.8 and JAVA_HOME pointing to this JDK. You have to set GRADLE_OPTS to -Dfile.encoding=UTF-8 as gradle uses the JVM's platform encoding.

To run it, just execute gradlew run. When you want to develop, it is necessary to generate additional sources using gradlew generateSource and then generate the Eclipse gradlew eclipse. For IntelliJ IDEA, just import the project via a Gradle Import by pointing at the build.gradle.

gradlew test executes all tests. We use Travis CI for executing the tests after each commit. For developing, it is sufficient to locally only run the associated test for the classes you changed. Travis will report any other failure.

Acknowledgements

We use install4j, the multi-platform installer builder. We've got an open-source license.

License

Since version 3.6, JabRef is licensed under the MIT license. See the LICENSE.md for the full MIT license.

JabRef also uses libraries, fonts, and icons distributed by other parties. See external libraries for details.

You can’t perform that action at this time.