/know-ur-zotero

Status monitoring and analysis tool for Zotero.

Primary LanguageTypeScriptGNU Affero General Public License v3.0AGPL-3.0

Know Ur Zotero: Status Monitoring and Analysis

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!