gitwtfhub

wtf is zotero-glass?

avi7ii/zotero-glass — explained in plain English

Analysis updated 2026-05-18

39JavaScriptAudience · researcherComplexity · 2/5Setup · easy

TL;DR

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

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

What's in the stack?

JavaScriptAppKitNSVisualEffectView

How it stacks up

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 spin it up?

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.

Wtf does this do

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.

Yoink these 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

wtf 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.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.