Data

Tools

Indexes

Applications

Experiments

Open Source Science

https://github.com/daeh/zotero-citation-tally

Plugin that tallies citation counts for Zotero items.

https://github.com/daeh/zotero-citation-tally

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ○
    CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ○
    DOI references
  • ○
    Academic publication links
  • ○
    Committers with academic emails
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (12.3%) to scientific vocabulary

Keywords

citations zotero zotero-addon zotero-plugin zotero7
Last synced: 5 months ago · JSON representation

Repository

Plugin that tallies citation counts for Zotero items.

Basic Info
  • Host: GitHub
  • Owner: daeh
  • License: agpl-3.0
  • Language: TypeScript
  • Default Branch: main
  • Homepage:
  • Size: 538 KB
Statistics
  • Stars: 26
  • Watchers: 0
  • Forks: 1
  • Open Issues: 1
  • Releases: 9
Topics
citations zotero zotero-addon zotero-plugin zotero7
Created 9 months ago · Last pushed 7 months ago
Metadata Files
Readme License

README.md

GitHub release (latest by date) GitHub Downloads all releases GitHub Downloads (latest release)

Citation Tally

zotero target version Using Zotero Plugin Template

Displays citation counts for Zotero library items.

Screenshot

This is a plugin for Zotero, a research source management tool. The CitationTally plugin automatically fetches and displays citation counts for research papers in your library from multiple academic databases.

Plugin Functions

  • Automatic Citation Tracking - Fetches citation counts when new items are added to your library
  • Smart Auto-Updates - Keeps citation data current with configurable update schedules
  • Visual Integration - Adds a sortable "Citations" column to your Zotero library view
  • Multiple Databases - Queries Crossref, Semantic Scholar, and INSPIRE in configurable order
  • Intelligent Rate Limiting - Respects API limits with adaptive throttling
  • Persistent Storage - Stores citation data in item's Extra field for sync compatibility

Please post any bugs, questions, or feature requests in the GitHub issues.

Installation

  • Download the plugin (the .xpi file) from the latest release
  • Open Zotero (version 7.x)
  • From Tools -> Plugins
  • Select Install Plugin From File... from the gear icon ⛭
  • Choose the .xpi file you downloaded (e.g. citation-tally.xpi)
  • Restart Zotero

Setup and Configuration

Once installed, the plugin will automatically begin tracking citation counts for items in your library.

Initial Setup

  • Plugin Activation: After installation and restart, the plugin will automatically add a "Citations" column to your Zotero library view.

    • The citation count column should automatically appear in your library view.
    • (If you don't see the column, right click the column titles and check "Citations")

    show Citations column

  • Preferences Access: Configure the plugin by going to Zotero -> Settings -> Citation Tally on MacOS ( Edit -> Preferences -> Citation Tally on linux).

Automatic Behavior

  • New Items: Citation counts are automatically fetched when items with DOIs or arXiv IDs are added
  • Auto-Updates: Can be configured to update outdated citations on Zotero startup
  • Smart Scheduling: Items are processed from newest to oldest based on when they were added to your library

Manual Actions

  • Update Selected Items: Right-click → "Update Citation Tallies"

    • NB Manual updates bypass all retry restrictions and cooldown periods

  • Update All Outdated: Tools menu → "Retally outdated item citations"

    • This runs at startup but you can also trigger it manually.

Configuration Options

Database Settings - **Database Priority Order**: Configure which databases to query and in what order. The plugin will try each database until it finds citation data. - Default order: `crossref, semanticscholar, inspire` - You can reorder these based on your field and preferences - For physics papers, you might prefer: `inspire, crossref, semanticscholar` - For general academic papers: `crossref, semanticscholar` - **Automatic Updates**: Enable automatic citation updates on startup for outdated items - **Adaptive Rate Limiting**: Smart rate limiting that starts with base delays and automatically increases up to 10x when rate limits are detected, then gradually decreases on success - **Database-Specific Rate Limits**: Configure individual base rate limits for each database (Crossref, INSPIRE, Semantic Scholar)

Troubleshooting

Common Issues - **No citation data found**: The plugin requires items to have DOIs, arXiv IDs, or other identifiers that databases can match. Journal articles, conference papers, and books with DOIs work best. Items like web pages, theses, or older publications without digital identifiers may not have citation data available in academic databases. - **Rate limiting**: The plugin aims to be respectful of the databases that make citation information available by adaptively throttling request frequency and avoiding unnecessary requests. It starts with base delays (1-3 seconds) and automatically increases delays up to 10x when rate limits are detected, then gradually decreases on successful requests. Large batch updates may take time but will complete automatically. The plugin keeps track of items that do not appear in databases and avoids requesting them frequently, but will periodically check to see these items have been added. - **Network issues**: Ensure Zotero has internet access and your firewall isn't blocking requests to academic databases.
Advanced Features & Behavior ### Intelligent Retry System The plugin tracks items that fail to return citation data and intelligently schedules retries: - **Not Found Items**: - 1st attempt: Wait 7 days - 2nd attempt: Wait 30 days - 3rd attempt: Wait 90 days - 4+ attempts: Wait 180 days - **Manual Override**: Right-click updates bypass all retry restrictions ### Adaptive Rate Limiting The plugin respects API limits with intelligent throttling: **Base Delays:** - Crossref: 1 second - INSPIRE: 1 second - Semantic Scholar: 3 seconds **Adaptive Behavior:** - Increases delay by 1.5× on rate limit errors (up to 10× maximum) - Decreases by 0.9× on successful requests - Maintains separate multipliers for each database ### Performance Optimizations - **Session Caching**: Items without identifiers are cached for the session - **Progress Indicators**: Real-time updates during bulk operations - **Network Detection**: Pauses and retries when network is unavailable - **Automatic Cleanup**: Monthly removal of data for deleted library items ### Supported Identifiers The plugin can fetch citations for items with: - DOIs (Digital Object Identifiers) - arXiv IDs - INSPIRE record IDs - Semantic Scholar paper IDs

Supported Databases

  • Crossref: Comprehensive database for scholarly publications with DOIs
  • Semantic Scholar: AI-powered academic search engine with citation analysis
  • INSPIRE: High-energy physics literature database

Related Projects

Notes

GitHub: Source code repository

This extension uses the zotero-plugin-template.

License

Distributed under the GNU Affero General Public License v3.0.

Author

Personal Website BlueSky

Owner

  • Name: Dae
  • Login: daeh
  • Kind: user
  • Location: Cambridge, MA
  • Company: MIT

Neukom Computational Science Postdoc Fellow at Dartmouth. PhD from MIT Brain and Cognitive Sciences.

GitHub Events

Total
  • Create event: 29
  • Issues event: 7
  • Release event: 15
  • Watch event: 29
  • Delete event: 20
  • Issue comment event: 20
  • Push event: 9
  • Pull request event: 11
  • Fork event: 2
Last Year
  • Create event: 29
  • Issues event: 7
  • Release event: 15
  • Watch event: 29
  • Delete event: 20
  • Issue comment event: 20
  • Push event: 9
  • Pull request event: 11
  • Fork event: 2

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 1
  • Total Committers: 1
  • Avg Commits per committer: 1.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 1
  • Committers: 1
  • Avg Commits per committer: 1.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Dae Houlihan d****v@d****o 1
Committer Domains (Top 20 + Academic)
daeh.info: 1

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 6
  • Total pull requests: 14
  • Average time to close issues: 5 days
  • Average time to close pull requests: 3 days
  • Total issue authors: 6
  • Total pull request authors: 3
  • Average comments per issue: 1.17
  • Average comments per pull request: 0.43
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 11
Past Year
  • Issues: 6
  • Pull requests: 14
  • Average time to close issues: 5 days
  • Average time to close pull requests: 3 days
  • Issue authors: 6
  • Pull request authors: 3
  • Average comments per issue: 1.17
  • Average comments per pull request: 0.43
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 11
View more stats
Top Authors
Issue Authors
  • Joel-Baptista (1)
  • du33169 (1)
  • schorschinho (1)
  • gustavdelius (1)
  • Deg2v (1)
  • thangckt (1)
Pull Request Authors
  • dependabot[bot] (11)
  • ajcerejeira (2)
  • nkh0472 (1)
Top Labels
Issue Labels
bug (1)
Pull Request Labels
dependencies (11) javascript (11)