whatisgithub

What is zotero-glass?

avi7ii/zotero-glass — explained in plain English

Analysis updated 2026-05-18

39JavaScriptAudience · researcherComplexity · 2/5Setup · easy

In one sentence

Zotero Glass adds a real macOS native frosted-glass appearance to the Zotero reference manager's windows, sidebar, and popups, using dark theme only.

Mindmap

mindmap
  root((zotero glass))
    What it does
      Native glass materials
      Dark theme only
      Unified across windows
      In-app settings
    Tech stack
      JavaScript
      AppKit
      NSVisualEffectView
    Use cases
      Frosted-glass Zotero look
      Consistent PDF reader theme
      Adjustable blur and tint
    Audience
      Researchers
      macOS Zotero users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give your Zotero reference manager a native macOS frosted-glass look instead of a flat theme.

USE CASE 2

Apply a consistent glass material across Zotero's library, PDF reader, and annotation popups.

USE CASE 3

Adjust glass transparency, blur, and material settings directly inside Zotero without editing CSS.

What is it built with?

JavaScriptAppKitNSVisualEffectView

How does it compare?

avi7ii/zotero-glassdavidondrej/autogitikunycj/gpt-team-register
Stars393939
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires macOS and Zotero 9.x, download the XPI from releases and install through Zotero's plugin manager.

License terms are not stated clearly in the available README text.

So what is it?

Zotero Glass is a plugin that gives the Zotero reference manager a real glass, frosted appearance on Mac computers. Zotero is popular software researchers use to organize academic papers and citations, and this plugin makes its windows look like they are made of translucent, blurred glass, matching the native look of other Mac apps. What makes this different from a typical theme is that it does not fake the glass look with CSS colors and transparency tricks. Instead it reaches into Apple's own AppKit system and uses a real native component called NSVisualEffectView, the same technology behind the frosted panels seen throughout macOS itself. The plugin applies this consistent glass material across Zotero's main library window, its PDF reader sidebar, annotation popups, and its settings page, all controlled through in-app settings you can adjust immediately without editing any code. The plugin only works on macOS, since it depends directly on AppKit, and it currently only supports Zotero's dark theme. When you enable it, it automatically switches Zotero into dark mode, because all of its visual settings, text contrast, and layering were designed around a dark background. It does not support Windows, Linux, or Zotero's light theme yet. Importantly, the plugin does not touch or rewrite your actual research data. It does not modify your papers, tags, PDFs, database, or column layouts, it only manages its own settings and the visual appearance of Zotero's windows. Disabling it removes all injected styles and native views and restores your previous theme. Installation is done by downloading a ready-made XPI file from the releases page and installing it through Zotero's plugin manager, or by building it from source with an included build script. The project ships with an automated test suite that runs on every code push.

Copy-paste prompts

Prompt 1
How do I install Zotero Glass from a downloaded XPI file into Zotero on macOS?
Prompt 2
Explain why Zotero Glass only supports macOS and dark theme, based on its use of AppKit.
Prompt 3
How do I build Zotero Glass from source using its build script?
Prompt 4
What happens to my Zotero settings and data when I disable the Zotero Glass plugin?

Frequently asked questions

What is zotero-glass?

Zotero Glass adds a real macOS native frosted-glass appearance to the Zotero reference manager's windows, sidebar, and popups, using dark theme only.

What language is zotero-glass written in?

Mainly JavaScript. The stack also includes JavaScript, AppKit, NSVisualEffectView.

What license does zotero-glass use?

License terms are not stated clearly in the available README text.

How hard is zotero-glass to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is zotero-glass for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.