Plugins / Reading & PDFs

Zotero PDF Background

by wangqian06 · github.com/wangqian06/zotero-pdf-background

Changes the PDF reader's background colour to reduce eye strain.

Zotero PDF Background has a Zotero Plugins grade of A (recommended) because every code check came out low. It works with Zotero 7–9, not the current Zotero 10. Last checked 15 Nov 2026.

View source
Downloads a .xpi file (0.07 MB). In Zotero, open Tools → Plugins and install it from the file.
In useAn estimate of how many copies of Zotero have it: Zotero downloads each new version once for every copy that has the plugin, so we count the downloads of its most-downloaded recent release. Rounded. Plugins that update from outside GitHub count low.
5.5k
DownloadsAll-time downloads of its release files from GitHub, counting every update. Installs from elsewhere aren't counted.
35,777
Latest releaseDownloads of version 2.3.0, its latest release, since it came out on 8 Jul 2026. A new release starts from zero; Downloads counts every release.
5,444
ReleasesVersions published on GitHub. Everyone who has the plugin downloads each one again, which adds up in Downloads.
7
AgeTime since its GitHub repository was created, on 3 Jun 2022. The plugin can be younger than its repository.
4 years
StarsPeople who starred the repository on GitHub: a rough measure of interest.
270
ContributorsPeople who have committed code to this plugin. Bots don't count, nor do the authors of a template or project it was copied from.
3
LicenceThe licence the code is published under, as GitHub reports it.
None stated
A
Zotero Plugins gradeRecommended
because every code check came out low
Applies to v2.3.0, released 8 Jul 2026Code checked · tested installed in Zotero 9.0.6 on 27 Sep 2026
Doesn't work with the current Zotero (10)Works with Zotero 7, 8, 9.
Another plugin uses the same IDOne other plugin shares this add-on ID. Zotero can only install one of them.
What we found in the codeSets the gradeThe worst finding in these three areas sets the grade.
Code transparencyReadable code; not yet checked against the published sourceThe developer uploaded the release file from the wangqian06 account. We haven't yet checked whether this file matches the public source code.UnknownWe couldn't check this yet.
Updates
Doesn't update automatically: the update address is copied from Zotero's sample plugin
Where your data goesNo web requests foundLowLow concern: normal for plugins that do this job. Listed so you know.
No further detail for this area yet.
Powerful capabilitiesNo powerful capabilities foundLowLow concern: normal for plugins that do this job. Listed so you know.
No further detail for this area yet.
Before you installShown, not gradedFacts to help you decide. They don't change the grade.
Works withZotero 7, 8, 9 · not 10Doesn't work with the current Zotero (10)MediumMedium concern: worth reading before you install. One medium finding makes the grade B.
Zotero 7 ✓ worksZotero 8 ✓ worksZotero 9 ✓ worksZotero 10 ✗ doesn't workZotero 11 beta not tested yet: Zotero hasn't opened Zotero 11 testing
What you'll needZotero 7, 8, 9Detected automatically from its code
No further detail for this area yet.
MaintenanceArchived · last release 8 Jul 20263 contributors
No further detail for this area yet.
LanguagesDocumentation in EnglishInterface: English and Chinese
No further detail for this area yet.
We report what we found in the code. Open any area for the evidence.How we gradeReport a problem

What it does

Written by AI from the README

Changes the PDF reader's background colour to reduce eye strain. Offers several background modes, a custom colour in settings, an eye button on the toolbar to switch modes, and follows system dark mode.

Plain white pages tire the eyes on long reading sessions. The author says it will not be updated now that Zotero 8 and 9 have their own theme options.

What you'll need

Detected automatically
  • Zotero 7, 8, 9Not working with Zotero 10

Where your data goes

We found: no web requests found.

Forks and copies

1 other plugin uses the same ID as this one. Every Zotero plugin carries an ID, a name tag Zotero uses to tell plugins apart. These 2 plugins carry the same one, because people copied Zotero PDF Background to make their own versions and kept its ID.Show what this means
  • You can only have one. Zotero sees them as the same plugin.
  • Installing another replaces it. If you install one of the others, it takes this one's place.
  • Check what you install. Several share this plugin's name, so make sure the file comes from the one you meant.
Zotero PDF Background · this pluginwangqian06/zotero-pdf-backgroundARecommended35,7778 Jul 2026
Zotero PDF BackgroundFork · azhar-rafiq/zotero-pdf-backgroundARecommended1118 May 2026
See all 2 and how they differ →

2 listed forks.

The developer's response

The developer hasn't responded. Developers can reply here, and their reply sits next to our findings.I'm the developer

Ratings and reviews

What people who use it say. This is separate from the grade, which is what the code does, and never changes it.

No ratings yet.

Write a review
Your rating of Zotero PDF Background v2.3.0

Your review is public, under the name you give, and published with the directory's data under CC BY 4.0. Links are removed. We never store your IP address: a scrambled code made from it is kept for 30 days to catch fake reviews. Every review is checked before it's published; how fake ones are spotted isn't published, so it can't be gamed.

Install Zotero PDF Background
ARecommended
  1. 1Download the plugin fileDownload v2.3.0.xpi · 0.07 MB
  2. 2In Zotero, open Tools › Plugins
  3. 3Click the gear, choose Install Plugin From File… and pick the file
Step-by-step guide with pictures
Or skip the download: use Zotero Atlas

Our free plugin puts this site inside Zotero. Find Zotero PDF Background there and install it in one click; Zotero checks the file against the one we graded.

It never sends your library, notes or files: only your list of plugins, if you say yes. Made by us and graded by the same rules: Zotero Plugins grade B.