Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/chrisgrieser/alfred-bibtex-citation-picker/llms.txt

Use this file to discover all available pages before exploring further.

The Supercharged Citation Picker follows semantic versioning. Find the full release history, version diffs, and .alfredworkflow download links on GitHub.
The complete, authoritative changelog is maintained on GitHub Releases: https://github.com/chrisgrieser/alfred-bibtex-citation-picker/releases

Latest Version

FieldValue
Version11.9.0
Released2023-09-26
DownloadGitHub Releases (latest)

Major Feature Areas

The following feature categories have been developed and refined across the project’s release history. Each represents a distinct area of functionality that has grown over successive versions.
1

Core Citation Picking and Format Switching

The foundational capability of the workflow: triggering the picker via hotkey or keyword, searching a .bib library at high speed, and inserting formatted citations into any text field system-wide.Support for multiple citation formats has expanded over time — from Pandoc citations as the initial default to a full menu of options including LaTeX, Multi-Markdown, org mode, eta templates, iA Writer, wikilinks, tags, bare citekeys, and bracketed citekeys. The active format is toggled without editing the workflow directly, via scpChange citation format.Smart search (citekey prefix @, keyword prefix #, short queries, et al. matching, tab-completion) and in-picker actions (inline citations, page numbers, multi-citation building) are part of this core layer.
2

Dual Library Support

The workflow supports loading entries from two BibTeX files simultaneously, with the secondary library configured via secondary_library_path. Entries from the second library are visually distinguished by the 2️⃣ prefix in both the title and subtitle.This enables workflows that maintain a personal library alongside a shared or project-specific one, without needing to merge files.
3

PDF Auto-Filing and Management

A dedicated PDF management layer allows the workflow to locate, open, and file PDFs by citekey. PDFs stored in pdf_folder with the naming convention {citekey}.pdf or {citekey}_{suffix}.pdf are automatically associated with their entries and indicated by 📕.The auto-file feature renames and moves PDFs into the managed folder, and the pdf search prefix filters the picker to show only entries that have an associated PDF.
4

Literature Note Creation with Obsidian Integration

Literature notes — Markdown files named exactly after a citekey — can be opened or created directly from the picker via ⌃⌥↵. The 📓 indicator marks entries that already have a note.When the configured literature_note_folder is located inside a registered Obsidian vault, notes are opened directly in Obsidian rather than the system default editor. The vault registry at ~/Library/Application Support/obsidian/obsidian.json is used for detection. The * search prefix filters the picker to show only entries with existing literature notes.
5

DOI and ISBN Entry Addition

New references can be added to the BibTeX library without leaving the keyboard. Select a DOI, ISBN-13, or a URL containing a DOI anywhere on screen, then trigger the workflow via its Universal Action or dedicated hotkey. The workflow fetches metadata from CrossCite (for DOIs), Open Library (for ISBNs), and Google Books, then writes a formatted BibTeX entry directly into bibtex_library_path.Note: this feature is not compatible with BetterBibTeX-managed files, which use a one-way Zotero-to-BibTeX sync.
6

CSL Style Search and Download

Via scpCitation Style Search, the workflow searches the CSL style repository online and downloads .csl files to the configured location (default: ~/.pandoc/csl/). This enables quick setup of custom citation styles for Pandoc-rendered bibliographies without leaving Alfred.
7

AlfredExtraPane Link Preview Support

When the AlfredExtraPane companion app is installed, hovering over an entry in the picker triggers a live preview of the entry’s URL in a sidebar panel. This provides instant visual confirmation of the linked resource (article landing page, DOI resolver page, etc.) without opening a browser tab.

Upgrade Note

After updating the workflow to a new version, your selected citation format may reset to the default (Pandoc Citations). This is a known limitation of Alfred’s environment variable handling during workflow updates.After each update, go to scpChange citation format and re-select your preferred format if needed.

Full Release History

For detailed per-version notes — including bug fixes, breaking changes, and new options — see the full release list on GitHub: https://github.com/chrisgrieser/alfred-bibtex-citation-picker/releases/latest

Build docs developers (and LLMs) love