AUX Scanner

You can populate a collection, or tag items in your library, from an existing paper by scanning the aux file generated by bibtex, or a pandoc-markdown file, for referenced used. Scanning can be triggered from the Tools menu (for tagging the cited items) or by right-clicking a collection (for adding them to a collection). The scanner will read your AUX files and will put entries you cited in the associated LaTeX document into the current collection.

By default, BBT will add a note for entries cited in the LaTeX document but which do not exist in your Zotero library, but citation keys must be present in your library before the scan is started – BBT will by default not create new items for citekeys it doesn’t already know about. You can enable ‘AUX Import’ in the preferences, and when that is on, if the scan finds citekeys not already in your Zotero library, it will attempt to read those (but only those) items from the bibtex file named in the aux file.

For BBT users who don’t use LaTeX directly, you can create a custom aux file to use with the AUX scanner by hand. It is a text file formatted like this:


Where CITEKEY1, CITEKEY2 etc are the citation keys that you want to include in the collection.

For pandoc-markdown scanning, BBT needs to actually run pandoc, and for that pandoc must be in your $PATH. On MacOS, if you installed pandoc using homebrew, it will likely not be in the PATH that Zotero can see. You can enter the path manually by going into the Zotero preferences, Advanced tab, open the config editor, and create a text entry named extensions.zotero.translators.better-bibtex.path.pandoc and setting it to the full path of the pandoc binary.