⚡ Quick Start

# 1. Fetch an entire ORCID profile as clean BibTeX
ezbib 0000-0002-1825-0097 -o publications.bib

# 2. Filter publications from 2021 onwards
ezbib 0000-0002-1825-0097 -y 2021 -o recent_papers.bib

# 3. Resolve a DOI directly into BibTeX
ezbib 10.1016/j.actamat.2025.121319

# 4. Generate formatted text citations (Nature, IEEE, APA, ACS, etc.)
ezbib 0000-0002-1825-0097 -f text --style nature

# 5. Export a clickable Markdown publication list for your CV or website
ezbib 0000-0002-1825-0097 -f markdown -o cv_publications.md

# 6. Read DOIs from a pipe or standard input
cat dois.txt | ezbib - -o references.bib

Note: ezbib, orcid2bib, and orcid2bibtex commands are all supported and can be used interchangeably!

💡 Why ezbib?

Raw bibliographic metadata from academic APIs is frequently inconsistent, filled with XML fragments, cluttered with unreviewed preprints, and cumbersome to organize. ezbib was built specifically for researchers, lab managers, and scientific developers who need clean, publication-ready records without installing heavy dependencies.

🏗️ Architecture & Pipeline

flowchart LR
    subgraph Inputs
        A[ORCID iD / URL]
        B[DOI / DOI URL / List]
        C[Standard Input / Pipe]
    end

    subgraph Core Engine
        D[ORCID v3.0 REST API]
        E[Crossref CSL Negotiation]
        F[LaTeX / MathML Sanitizer]
        G[Preprint Deduplicator]
    end

    subgraph Output Formats
        H[Clean BibLaTeX\n+ Grant Tags]
        I[Interactive Markdown\nfor CVs / Sites]
        J[Formatted Text\nNature, IEEE, APA, ACS]
    end

    A --> D
    B --> E
    C --> B
    D --> F
    E --> F
    F --> G
    G --> H
    G --> I
    G --> J

✨ Key Features

• 📦 Zero External Dependencies — Built 100% on the Python Standard Library (urllib, json, re, html, argparse). No third-party packages required.
• ⚡ First-Class Executable & Package — Install via pip install ezbib, run directly as a standalone executable script (./orcid2bib.py), or execute via python3 -m orcid2bib.
• 🔄 Smart Input Detection — Seamlessly parses bare ORCID iDs (0000-0002-1825-0097), full ORCID URLs (https://orcid.org/...), single/multiple DOIs (10.1016/...), and piped standard input (-).
• 🧹 LaTeX & MathML Sanitization — Cleans XML entities and converts complex MathML tags into standard LaTeX math (e.g. <mml:math><mml:mi>α</mml:mi></mml:math> $\rightarrow$ $\alpha$, $\Sigma$).
• 🧠 Intelligent Preprint Deduplication — Identifies and suppresses preprint versions (arXiv, bioRxiv, ChemRxiv, Research Square) when peer-reviewed journal versions exist in the profile.
• 🏷️ Grant-Ready BibLaTeX Categorization — Injects keywords = {quality_assured} or keywords = {other} to instantly generate split CV/grant bibliographies (e.g., for DFG, EU Horizon Europe, and NSF).
• 🎨 8+ Academic Citation Styles — Outputs styled bibliographies in APA 7th, Nature, IEEE, ACS, Elsevier, Chicago, Harvard, and Springer formats.
• 📤 Multiple Export Formats — Produces structured .bib, clickable .md lists with DOI links, or styled plain text.

🚀 Installation

Option 1: Install with pip / pipx (Recommended)

# Install from PyPI
pip install ezbib

# Or install in an isolated environment with pipx
pipx install ezbib

Or install the latest development version directly from GitHub:

pip install git+https://github.com/prnvrvs/ezbib.git

Option 2: Clone and Install Locally

git clone https://github.com/prnvrvs/ezbib.git
cd ezbib
pip install .

For editable development mode:

pip install -e .

Option 3: Standalone Single-File Script (Zero Installation)

Because ezbib is self-contained with no external dependencies, you can download orcid2bib.py directly and execute it anywhere:

# Download single script
curl -O https://raw.githubusercontent.com/prnvrvs/ezbib/main/orcid2bib.py
chmod +x orcid2bib.py

# Run directly:
./orcid2bib.py 0000-0002-1825-0097

Option 4: Run as a Python Module

python3 -m orcid2bib 0000-0002-1825-0097

📖 Usage Recipes

1. 🆔 ORCID Profile Lookup

Fetch all publications for an ORCID profile and output clean BibTeX:

# Print to terminal
ezbib 0000-0002-1825-0097

# Save to a .bib file
ezbib 0000-0002-1825-0097 -o my_publications.bib

# Full ORCID URL is also accepted
ezbib https://orcid.org/0000-0002-1825-0097 -o my_publications.bib

2. 📅 Year Filtering

Filter works to match grant reporting periods, tenure reviews, or recent activity:

# Publications from 2021 to present
ezbib 0000-0002-1825-0097 -y 2021 -o recent.bib

# Publications within a specific year window (2020-2024)
ezbib 0000-0002-1825-0097 --min-year 2020 --max-year 2024 -o phd_papers.bib

3. 🔎 Direct DOI Resolution

Retrieve clean BibTeX for one or more DOIs:

# Single DOI
ezbib 10.1016/j.actamat.2025.121319

# Full DOI URL
ezbib https://doi.org/10.1016/j.actamat.2025.121319

# Multiple comma-separated DOIs
ezbib -d 10.1016/j.actamat.2025.121319,10.1016/j.ijhydene.2025.02.435 -o papers.bib

4. 🚰 Standard Input & Shell Pipelines

Pipe DOIs or ORCID iDs from other command-line tools:

# Pipe a single DOI
echo "10.1016/j.actamat.2025.121319" | ezbib -

# Batch process a text file of DOIs (one per line)
cat doi_list.txt | ezbib - -o bibliography.bib

5. 📝 Markdown Export (For CVs & Academic Websites)

Generate a numbered Markdown publication list with clickable DOI hyperlinks:

ezbib 0000-0002-1825-0097 -y 2021 -f markdown -o cv_publications.md

Example Markdown Output:

# Publications from ORCID 0000-0002-1825-0097

1. **Hydrogen embrittlement mechanisms in high-strength alloys** (2025) — *Acta Materialia* ([DOI: 10.1016/j.actamat.2025.121319](https://doi.org/10.1016/j.actamat.2025.121319))
2. **Phase transformation dynamics under extreme strain** (2024) — *Nature Materials* ([DOI: 10.1038/s41563-024-00000-x](https://doi.org/10.1038/s41563-024-00000-x))

6. 📄 Styled Plain Text Bibliographies

Generate pre-formatted citations in your desired journal format:

# Default APA 7th style
ezbib 10.1016/j.actamat.2025.121319 -f text

# Nature style
ezbib 10.1016/j.actamat.2025.121319 -f text --style nature

# IEEE style
ezbib 10.1016/j.actamat.2025.121319 -f text --style ieee

# ACS style
ezbib 10.1016/j.actamat.2025.121319 -f text --style acs

7. 🔄 Controlling Preprint Deduplication

By default, ezbib suppresses preprints (e.g. arXiv, bioRxiv) if a corresponding journal article exists in the profile. To keep all raw entries without deduplication:

ezbib 0000-0002-1825-0097 --no-dedup -o all_raw_records.bib

8. 👥 Batch Processing for Research Teams

Fetch publications for an entire lab or research group using a simple Bash script:

#!/usr/bin/env bash

declare -A LAB_MEMBERS=(
  ["Prof_Smith"]="0000-0002-1825-0097"
  ["Dr_Johnson"]="0000-0001-5109-3700"
  ["Dr_Lee"]="0000-0003-1234-5678"
)

for NAME in "${!LAB_MEMBERS[@]}"; do
  ORCID="${LAB_MEMBERS[$NAME]}"
  echo "[*] Fetching publications for $NAME ($ORCID)..."
  ezbib "$ORCID" -y 2021 -o "${NAME}_publications.bib"
done

🎨 Citation Styles

🧭 CLI Command-Line Reference

usage: ezbib [-h] [-d DOI] [-y YEAR] [--max-year YEAR] [-o FILE]
             [-f {bibtex,markdown,text,apa}] [-s STYLE] [--no-dedup] [-v]
             [target]

🐍 Python API

ezbib can also be imported and used programmatically in any Python 3.7+ application:

import orcid2bib as ezbib

# 1. Query an ORCID profile
works = ezbib.fetch_orcid(
    "0000-0002-1825-0097",
    min_year=2021,
    dedup=True
)

for work in works:
    print(f"[{work['year']}] {work['title']} (DOI: {work['doi']})")

# 2. Convert DOI to clean, formatted BibTeX
bibtex_entry = ezbib.doi_to_bibtex(
    "10.1016/j.actamat.2025.121319",
    extra_keywords="quality_assured"
)
print(bibtex_entry)

# 3. Format DOI citation into a specific journal style
nature_citation = ezbib.doi_to_text(
    "10.1016/j.actamat.2025.121319",
    style="nature"
)
print(nature_citation)

📑 Grant Reporting & BibLaTeX Integration

ezbib automatically categorizes works by injecting keywords = {quality_assured} for peer-reviewed journal articles and keywords = {other} for preprints, conference proceedings, or unreviewed outputs.

This makes generating split academic CVs (such as for DFG, EU Horizon Europe, or NSF proposals) straightforward in LaTeX:

\documentclass[11pt,a4paper]{article}

\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{mathptmx}
\usepackage[margin=2.2cm]{geometry}

\usepackage[
  backend=biber,
  style=numeric,
  sorting=ydnt,
  maxbibnames=99,
  defernumbers=true
]{biblatex}

\addbibresource{publications.bib}

\begin{document}

\section*{Principal Investigator — List of Publications}
\nocite{*}

\subsection*{Category A: Peer-Reviewed & Quality-Assured Journal Publications}
\printbibliography[
  keyword=quality_assured,
  heading=none,
  resetnumbers=true
]

\subsection*{Category B: Preprints, Conference Proceedings & Other Works}
\printbibliography[
  keyword=other,
  heading=none,
  resetnumbers=true
]

\end{document}

To compile:

pdflatex publication_list.tex
biber publication_list
pdflatex publication_list.tex

❓ Frequently Asked Questions

% Work without DOI: Title of Publication (Year)

📄 License

This project is licensed under the MIT License — feel free to use it in academic, open-source, and commercial projects.