JabRef
v6
v6
  • JabRef Bibliography Management
  • Installation
  • Getting started
  • Collect
    • Add entry manually
    • Add entry using an ID
    • Add entry using reference text
    • Searching externally using Online Services
    • Add entry using PDFs
    • Add PDFs to an entry
    • Browser Extension
    • Import
      • Custom import filters
      • Import inspection window
  • Organize
    • Edit an entry
    • Groups
    • Keywords
    • Mark and grade
    • Comment on an entry
    • Searching within the library
    • Complete information using online databases
    • Manage associated files
    • Manage field names and their content
    • Best practices
    • Cleanup entries
    • Check integrity
    • Find duplicates
    • Merge entries
    • Save actions
  • Cite
    • BibTeX and biblatex
    • Pushing to external editor application
    • Export to Microsoft Word
    • OpenOffice/LibreOffice integration
  • Share
    • Sharing a Bib(la)TeX Library
    • Shared SQL Database
      • Migration of pre-3.6 SQL databases into a shared SQL database
    • Export
      • Custom export filters
    • Send as email
  • AI functionality
    • AI providers and API keys
    • AI preferences
    • AI troubleshooting
    • Running a local LLM model
  • Configuration
    • Customize the citation key generator
    • Customize entry types
    • Customize general fields
    • Customize key bindings
    • Library properties
    • Entry preview setup
    • Manage external file types
    • Manage protected terms
    • The string editor
  • Advanced information
    • Main Window
    • Entry Editor
      • Links to other entries
      • The Bibtex / Biblatex source tab
      • The 'owner' field
      • Time stamp field
      • LaTeX Citations Tab
    • About BibTeX and its fields
    • Strings
    • Field content selector
    • URL and DOI links in JabRef
    • Command line use and options
    • Automatic Backup (.sav and .bak) and Autosave
    • XMP metadata support in JabRef
    • Remote operation
    • Custom themes
    • Journal abbreviations
    • New subdatabase based on AUX file
    • How to expand first names of an entry
    • Debugging your library file
    • Resources
    • License
    • Knowledge
      • MS Office Bibliography XML format
      • Comparison of the Medline (txt), Medline (xml), and RIS format
      • EndNote Export Filter
  • Frequently Asked Questions
    • Linux
    • Mac OS X
    • Windows
  • Discussion Forum
  • Contribute to JabRef
    • How to Improve the Help Page
    • How to translate the JabRef User Interface
Powered by GitBook
On this page
  • Installation instructions
  • Troubleshooting
  • Building From Source

Was this helpful?

Edit on GitHub
Export as PDF

Installation

PreviousJabRef Bibliography ManagementNextGetting started

Last updated 2 days ago

Was this helpful?

JabRef can be either installed (the preferred way) or be used as a portable application.

Installation instructions

To get the latest version, head to , download the installer for your system (e.g., dmg files for MacOS and msi files for Windows), run them and follow the on-screen instructions.

Version
🍎
🐧

JabRef 5.6

macOS 10.14 or higher

JabRef 5.12 (dev)

macOS 11 or higher

GTK 3.8 or later

Alternatively, on Windows, you can use the and execute choco install jabref to get the latest version. On Ubuntu, you can use snap install jabref to get the latest stable version .

Portable version

The portable version of JabRef is designed to be run from a USB stick (or similar) with no installation.

Download it from . These are generic archive files (e.g., tar.gz files for Linux and MacOS, and zip files for Windows) which need to be extracted. Inside the archive files you will find the file needed to run JabRef:

  • for Windows JabRef.exe.

  • for Linux

    • either runbin/JabRef

    • or /lib/runtime/bin/JabRef.

  • for Mac, this is the file JabRef.app.

Be sure to activate "Load and Save preferences from/to jabref.xml on start-up (memory stick mode)" in Options → Preferences → General. Also, if the Linux version of JabRef portable is put into a folder named bin, it will not start. Other names are fine, like apps.

Development version

Troubleshooting

Issues with high resolution displays

Warning about preferences

In case you get the following error message

WARNING: Could not open/create prefs root node Software\JavaSoft\Prefs at root 0x80000002. Windows RegCreateKeyEx(...) returned error code 5.

How can I start or focus JabRef with hotkey ⊞+J (Win+J)?

OpenOffice/LibreOffice integration

The connection from JabRef to Libre Office requires some office related jar-archives to be present. For this, you have to install the package libreoffice-java-common.

External program integration in Snap and Flatpak packages

The snap and flatpak packages cannot interact directly with external programs (i.e. programs not contained in the package sandbox). What this means is that for now there is no possible connection between JabRef and Libreoffice if either one is a snap/flatpak.

The integration with TeX editors is fine if JabRef is a deb/rpm, and the editor is a snap/deb/rpm (not a flatpak).

Depending on your use case and needed integrations it is advisable to choose the proper packages. Watch this page for new developments on the interactions with external programs.

Snap
Flatpak
deb/rpm
tar

Libreoffice (system)

❌

❌

✅

✅

Libreoffice (snap)

❌

❌

❌

❌

Libreoffice (flatpak)

❌

❌

❌

❌

TexShow

❌

✅

✅

✅

TexMaker

❌

✅

✅

✅

LyX

❌

✅

✅

✅

Vim/Emacs

❌

❌

✅

✅

Change default application to open files for JabRef snap

Include JabRef in the start menu of Ubuntu

Cannot start JabRef from the command line

Everything looks too big or too small. How can I change it to to a more reasonable size?

Non-latin characters are not showing up properly

You might need to install an additional font for JabRef to display characters correctly.

System
Language
Font

ArchLinux

Japanese

Submenus from the menu bar close immediately after left click is let go of if the menu bar was clicked in its top half

Note: This could not work in JabRef 5.12. or later.

I cannot start JabRef 5.9 due to file beeing damaged

Execute xattr -d com.apple.quarantine /Applications/JabRef.app (This is a known problem related to Apple's notarization)

JabRef is slow/hangs sometimes

Some characters are not displayed in the main table (math characters or some upper-cased letter)

Building From Source

To build JabRef from source, you first need to have a working Java Development Kit (see above link for details) and Git installed on your system. After installing the two requirements, you open a terminal window (i.e., a command prompt) and type the following:

git clone --recurse-submodules --depth=10 https://github.com/JabRef/jabref
cd jabref
./gradlew assemble
./gradlew jlink

In a nutshell, you clone the latest snapshot of JabRef into jabref directory, change directory to jabref, initialize and update all the submodules (dependencies) of JabRef, assemble them to be built via JDK and finally build and link them together.

The output should be the jabgui/build/image subdirectory that contains the JabRef binary with all of its Java dependencies. To start JabRef, you need to run bin/JabRef (in Linux and MacOS) or bin/JabRef.bat (in Windows) under jabgui/build/image subdirectory.

If you want to take advantage of the , you can use pre-built binaries crafted from the latest development branch. To use the prebuilt binaries, visit and download the packaged binaries (e.g., dmg files for MacOS and exe files for Windows), run them and follow the instructions.

If you want to try the development version in parallel with the stable version, we recommend to download the portable version (e.g. JabRef-X.Y.portable_windows.zip, JabRef-X.Y.portable_macos.tar.gz, or JabRef-X.Y.portable_linux.tar.gz) from to ensure that both versions do not conflict.

You have to change the "compatibility settings" for JabRef to "Disable scaling for high DPI settings". Further information is available at .

Further reading: and .

start regedit and create the following key: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\JavaSoft\Prefs. []

Use and provided at .

When JabRef is installed as a snap, it initially asks which application should be used to open PDFs (or other files). However, after selecting the same application three times, that application is set as default and there is no obvious way to select another application ("Preferences" -> "External File Types" does not help here, because the snap sandbox does not "see" any of the user's applications). This setting is stored in the XDG permission storage, and can be changed with a command like the following (see for further information, and have a look at flatpack permissions to find the correct "Table": look for a line where the "App" is snap.jabref - in the below example, the table is the default desktop-used-apps):flatpak permission-set --data "{'always-ask':<false>}" desktop-used-apps application/pdf snap.jabref okularApplication_pdf 0 3 In this example, the default application to open PDF files is set to okularApplication_pdf, and the counter for when to stop asking how to open PDF files is set to 0/3. If you want JabRef to ask you which application to use every time, use 'always-ask':<true> in the data parameter.

See for details.

You have several Java Virtual Machines installed, and under the command line the wrong one is chosen. Have a look at the previous question that tells you how to change the virtual machine used. For Ubuntu you may also have a look at the .

In the background, JabRef uses . Applications using JavaFX can be scaled via java -Dglass.gtk.uiScale=1.5 -jar <application>.jar. If you have installed JabRef via a package manager, you probably don't have a .jar file but a binary file. In this case, you need to find your JabRef.cfg in your installation folder (possibly located at /opt/JabRef/lib/app/JabRef.cfg) and add in the section [JavaOptions] the line -Dglass.gtk.uiScale=1.5. Then, restart JabRef. Try finding a value that is suitable for you. On high resolution displays, values around 1.5 seem to be reasonable.

This issue seems to be related to this . A temporary workaround is to click the menu bar in its lower half. To fix the issue permanently set the following system property: java -Djdk.gtk.version=2. This can be done globally by adding _JAVA_OPTIONS="-Djdk.gtk.version=2" to /etc/environment. It can also be set locally by editing JabRef.cfg in your installation folder (possibly located at /opt/JabRef/lib/app/JabRef.cfg) and add the line -Djdk.gtk.version=2 in the [JavaOptions] section.

Some users with macOS Sierra have reported freezes when using JabRef. It seems this is a bug in the networking part of Java on macOS. seems to solve these issues.

This is one the one hand a font problem and second a lognstanding . This might be a problem related to the font you are using. You can download some other font that supports mathematical alphanumeric symbols, for example, FreeSerif or Cambria Math. A list of fonts supporting Math Unicode blocks is available at .

This method is mainly for package maintainers and users who would like to build the latest snapshots of JabRef directly from the source. If you want to setup JabRef for development, follow the instructions for .

downloads.jabref.org
chocolatey package manager
from snapcraft
Getting started
downloads.jabref.org
latest features
builds.jabref.org/main
builds.jabref.org/main
https://www.microsoft.com/surface/en-us/support/apps-and-windows-store/app-display-issues?os=windows-10
https://github.com/JabRef/jabref/issues/415
http://discourse.jabref.org/t/jabref-3-6-on-hires-laptop-screen-messed-up/277
source
AutoHotkey
JabRef.ahk
koppor's autohotkey scripts
this forum thread
http://askubuntu.com/a/721387/196423
Ubuntu page on Java
JavaFX
JavaFX bug
Adding a host mapping for 127.0.0.1
JavaFX bug
http://www.fileformat.info/info/unicode/block/mathematical_alphanumeric_symbols/fontsupport.htm
setting up a workspace
otf-ipafont