Know Ur Zotero: Status Monitoring and Analysis

August 1, 2025 ยท View on GitHub

zotero target version Using Zotero Plugin Template

๐Ÿงฉ Outline

๐Ÿง What is this?

๐Ÿ‘‹ Install

๐Ÿงฒ API

๐Ÿ”ง Development

๐Ÿ”” Disclaimer

๐Ÿง What is this?

This plugin can monitor the status of the Zotero desktop app with:

  • Activity Monitor: Monitor the CPU usage of diffrent activities in Zotero. Useful for plugin debugging and performance optimization.

Activity Monitor

  • Status Indicator: Show the status of the Zotero app in the toolbar.
  • Activity Log: Log the status to file (menu: Tools -> Start Recording Activity).

๐Ÿ‘‹ Install

  • Download the plugin (.xpi file) from below.

    Note: If you're using Firefox as your browser, right-click the .xpi and select "Save As.."

  • In Zotero click Tools in the top menu bar and then click Plugins

  • Go to the Extensions page and then click the gear icon in the top right.

  • Select Install Add-on from file.

  • Browse to where you downloaded the .xpi file and select it.

  • Finish!

๐Ÿงฒ API

KuZ provides APIs for plugin developers in Zotero.kuZ.api.${API_MODULE}. See api.ts.

  • profiler: Monitor the CPU usage of different activities in Zotero.

๐Ÿ”ง Development

This plugin is built based on the Zotero Plugin Template. See the setup and debug details there.

To start, run

git clone https://github.com/windingwind/know-ur-zotero.git
cd know-ur-zotero
npm install
npm run build

The plugin is built to .scaffold/build/*.xpi.

To debug, run

npm run start

This will open a new Zotero instance with the plugin installed.

๐Ÿ”” Disclaimer

Use this code under AGPL. No warranties are provided. Keep the laws of your locality in mind!