Skip to content

zotero_library_utils

This project aims to provide tools to understand the makeup of a Zotero library - entirely locally - by reading from Zotero's SQLite database. This package focuses on providing tools that Zotero itself does not provide.

Installation

pip install zotero_library_utils

Tools

Counts

Provides counts of several pieces of metadata:

  1. Number of articles from each author. Optionally, you can specify the number of slices shown.

    python -m zotero_library_utils show-items-per-creator --num-slices=20
    
    Number of Articles from Top 20 Authors

  2. Number of different authors in the database (identified by first and last name)

    python -m zotero_library_utils count-distinct-authors
    

  3. Number of articles with 1-N authors. Optionally, you can specify the number of slices shown.

    python -m zotero_library_utils show-creators-per-item --num-slices=20
    
    Number of Authors Per Article

Timelines

Visualize when articles were published

python -m zotero_library_utils show-timeline-date-published --show-details=false
Article Publication Timeline

Contributing

For errors and feature suggestions, please open an issue. Pull requests are also appreciated and will be reviewed ASAP.

Roadmap

I'd like to be able to build a graph of the references between items in the Zotero database. Sticking to the local-first design, this means parsing PDF's for their references, which is a notoriously difficult problem. Any suggestions are welcome, please open an issue!