Repository navigation
Releases
Cupertino Zotero Soft Theme v0.6.0
Cupertino Zotero Soft Theme v0.6.0 — original gray/red and named reading colors
A coordinated update with Cupertino Obsidian Soft Theme v0.4.0.
- Original Cupertino gray #EBEBED for panels and tabs, near-white #FAFAFA documents, #F2F2F4 metadata shade, and #333338 reading text.
- Original Cupertino red #FF3B30 for accents; selected rows use the pale #FFE9E8 fill, including a quieter inactive-window state.
- Fixed the disappearing Zotero toolbar above the document list: buttons and column headings remain accessible without hovering; collection and tab controls stay visible.
- Reading Colors supports PDFs and EPUBs through Zotero's native reader theming.
- Soft Gray is the new default: Background #FAFAFA and Foreground #333338.
-
- Custom Colors… opens a named-color dialog. Enter both hex colors or use color pickers; presets and saved user themes remain available.
- Existing v0.5.0 users move to Soft Gray only if their previous Soft Paper default was untouched. Other saved themes and preferences are preserved.
- Keeps native File/Edit/View/Tools/Help menus, opaque Linux titlebar, right-side 40px metadata icon rail, and stable add-on ID cupertino-with-pdf-background@vict0rg.github.io.
Install cupertino-zotero-soft-theme-0.6.0.xpi from:
https://github.com/vict0rg/cupertino-zotero-soft-theme/releases/download/v0.6.0/cupertino-zotero-soft-theme-0.6.0.xpi
Zotero → Tools → Plugins → gear icon → Install Plugin From File. Restart if requested.
Automated structural and native-reader simulation tests run in GitHub Actions. Runtime visual verification on a real Zotero desktop remains advisable. MIT derivative of shenghuang-123/cupertino-for-zotero, preserving original credits and license.
Cupertino Zotero Soft Theme v0.5.0
Cupertino Zotero Soft Theme v0.5.0 — Default-Obsidian aesthetics with gentle Cupertino coral
This release establishes the final shared visual language with Cupertino Obsidian Soft Theme.
- Soft Paper #FAFAF7 remains the default PDF background for fresh reader settings; existing PDF preferences are preserved.
- The Zotero interface now closely matches the default Obsidian light gray shell: pane #F3F3F3, tabs #EEEEEE, borders #DDDEDE.
- Article and e-book rows alternate Soft Paper with a nearly white gray #F3F4F2.
- Selected rows and collections have pale coral #F5E5E5 with a thin #D78381 left accent; inactive-window selections remain visible but slightly muted.
- Preserves the 0.4.1 right metadata navigation rail spacing, always-visible native File/Edit/View/Tools/Help menu, opaque Linux titlebar, and PDF background picker.
- Same installed Zotero add-on ID as the prior Cream/Soft editions, so upgrades do not create a second extension.
- Updates all repository and update-feed URLs after GitHub renaming.
Install cupertino-zotero-soft-theme-0.5.0.xpi via Zotero → Tools → Plugins → Install Plugin From File.
Structural tests run in GitHub Actions, but runtime visual behavior still requires verification on Linux. This MIT derivative retains original copyright notices from Cupertino for Zotero. Notation, Typewriter, Shimmering Focus, Olivier's Theme, and Zotero PDF Background are credited as independent visual/functional references with no unlicensed code reused; see CREDITS.md and LICENSE.
Zotero Cupertino Soft Theme v0.4.1
Zotero Cupertino Soft Theme v0.4.1 — Metadata rail and list contrast
This update fixes two visual issues reported in the v0.4.0 layout.
- Right-hand metadata navigation: its icon rail now reserves a 40px flex column; the adjacent bibliographic area shrinks within its own column rather than letting icons overlap metadata. The Zotero stacked view remains native.
- Article/ebook list: subtle alternating light-gray rows, with a slightly clearer hover shade and unchanged muted selection.
- The Soft Paper PDF reading preset (
#FAFAF7), menu/titlebar opacity, reader buttons, extension identity and saved preferences are unchanged. - Structural layout/regression tests run in GitHub Actions. As always, actual Linux desktop verification is still required.
Install: Download v0.4.1 XPI, choose Tools → Plugins → Install Plugin From File, then restart Zotero.
The code remains a derivative of Cupertino for Zotero (MIT) with preserved copyright and permission notices. Notation, Typewriter, Shimmering Focus, Olivier's Theme, Zotero PDF Background and the Obsidian companion are attributed as inspiration or independent related software; no source from those references was reused. See CREDITS.md.
Zotero Cupertino Soft Theme v0.4.0
Zotero Cupertino Soft Theme v0.4.0
A neutral-gray Cupertino redesign focused on calm PDF reading and consistent styling with Obsidian Cupertino Soft Theme.
- Soft Paper (
#FAFAF7) is the preferred PDF reading preset for a fresh reader configuration. - Gray navigation panes (
#F1F2F3) and titlebar/tab strip (#E8EAEC) with gray dividers (#DDE0E3). - Muted coral selected-item accents; Linux titlebar remains opaque.
- Retains permanent File/Edit/View/Tools/Help menu and the metadata pane no-overlap fix.
- Keeps Soft Paper, Soft Cream, Soft Blue, Soft Sage and Original reader choices.
- Preserves existing user preferences and stored custom reader themes.
- Updates GitHub repository URL and XPI filename to the renamed project.
- Maintains the existing add-on ID for upgrades from Cream releases.
Install: Download zotero-cupertino-soft-theme-0.4.0.xpi, then Tools → Plugins → Install Plugin From File. Restart Zotero and reopen PDFs if necessary.
Licensing: MIT upstream Cupertino for Zotero source reused with original copyright; Notation, Typewriter, Shimmering Focus, Olivier's Theme, Obsidian Cupertino and Zotero PDF Background are credited as design/feature references only, with no source copied. See CREDITS.md.
Not affiliated with Zotero.
Cupertino Cream for Zotero v0.3.2
Cupertino Cream for Zotero v0.3.2 — Letter Paper
Lighter stationery paper and matched visual identity with Cupertino Cream for Obsidian v0.1.1.
- Paper and Soft Cream PDF:
#FFF9EC, less brown than before. - Sidebars:
#F4F0E4, toolbar:#F6EFDE. - First-install Soft Cream default only when no prior reader preferences exist on Zotero 8+.
- Previously saved unchanged Soft Cream presets migrate; user-customized colors remain intact.
- Original restores the native background. Other colors, menus, metadata and Linux titlebar fixes are unchanged.
Install the .xpi from this release. Close and reopen PDF tabs to view the refreshed background. All code source continues from Cupertino for Zotero under MIT; Typewriter, Shimmering Focus, Olivier's Theme, and Notation remain cited only as design references without copied code. See CREDITS.md.
Cupertino Cream for Zotero v0.3.1
Cupertino Cream for Zotero v0.3.1
Linux titlebar opacity fix.
On some KDE and GTK-based Linux desktops, the titlebar and tabs appeared transparent, showing the desktop wallpaper behind Zotero's main menu and reducing readability. This release replaces the inherited transparent surfaces with a solid cream background in light mode and a dark-brown surface in dark mode.
The corrected regions are Zotero's native titlebar, menu strip and tab strip. Native window controls, menu interactions, and dragging behavior are retained.
No changes to the reader's PDF background presets (Soft Cream, Soft Blue, Soft Sage, Soft Paper, Original), metadata pane geometry, item-tree motion, or add-on identity. The MIT source licensing and upstream credit documentation remain unchanged.
Install
Download cupertino-cream-for-zotero-0.3.1.xpi and install using Tools → Plugins → Install Plugin From File. Restart Zotero after updating and disable other complete UI themes to avoid conflicting CSS.
If the fix does not work in your Linux environment, please report Zotero version, KDE/GNOME/other desktop environment, X11 or Wayland, and a screenshot. The prior v0.3.0 remains available for rollback.
Credits: original Cupertino for Zotero by shenghuang-123 et al. (MIT); Notation by deathau (The Unlicense) as design inspiration; PDF Background projects as feature references without reused source. Details: CREDITS.md.
Companion theme: Cupertino Cream for Obsidian.
Cupertino Cream for Zotero v0.3.0
Cupertino Cream for Zotero v0.3.0
First release under the Cupertino Cream for Zotero name.
Changes
- New matched warm-paper and cream palette based on coordinated Notion-like reading surfaces
- Same restrained Cupertino red accent for selected rows and navigation
- Cross-recommended companion theme: Cupertino Cream for Obsidian
- Restored main menu bar and corrected metadata navigation geometry preserved
- Reader PDF Background selector retained: Original, Soft Cream, Soft Blue, Soft Sage and Soft Paper
- Updated repository name, documentation, licensing credits and automatic update URLs
- Retained the same internal add-on identifier as the earlier "Cupertino for Zotero with PDF Background" releases so existing installations can upgrade.
Installation
Download cupertino-cream-for-zotero-0.3.0.xpi and select Tools → Plugins → Install Plugin From File.
License
Based on Cupertino for Zotero under MIT, retaining the original copyright and permission notice. Notation (The Unlicense) is a visual reference, not a code dependency. Zotero PDF Background and azhar-rafiq's fork are credited as functional inspirations with no unlicensed source copied.
See CREDITS.md.
Cupertino for Zotero with PDF Background v0.2.2
Cupertino for Zotero with PDF Background v0.2.2
Public maintenance release — documentation and attribution improvements.
The underlying interface and soft PDF background controls are unchanged from v0.2.1, which was visually validated by the project user on Linux.
Features included
- Persistent Zotero menu bar (File, Edit, View, Tools, Help)
- Cupertino-inspired light/dark interface and smooth item animations
- Metadata navigation rail that does not overlap bibliographic fields
- Reader toolbar PDF Background selector with Original, Soft Cream, Soft Blue, Soft Sage and Soft Paper
- Zotero-native reader themes: no PDF file rewriting or text-layer overlays
- Unique add-on identity independent of upstream Cupertino for Zotero
What's new in v0.2.2
- Entirely reorganized public README and installation instructions in English
- Explicit, verified attribution to Cupertino for Zotero (MIT) and Cupertino for Obsidian (MIT)
- Clear credit to Zotero PDF Background and its azhar-rafiq fork as feature inspirations only: no unlicensed code copied
- New NOTICE.md documenting copyright and provenance
- Clarified reader preference persistence, version support and how to report issues
Installation
Download the attached .xpi, then select Tools → Plugins → gear icon → Install Plugin From File in Zotero. Reopen your PDF tabs if needed.
Targets: Zotero 7–10 for the interface, Zotero 8–10 for the native PDF preset feature. Zotero 11 beta remains unverified.
Licensing
The modified upstream Cupertino for Zotero source is distributed under MIT, preserving its original copyright and license text. Obsidian Cupertino is acknowledged as an MIT-licensed design reference. The PDF Background repositories are acknowledged for inspiration, with no source code or assets copied due to the absence of a confirmed reuse license. See CREDITS.md and NOTICE.md.
Independent community fork. Not affiliated with Zotero or the original projects.
Cupertino for Zotero with PDF Background v0.2.1
Changelog
0.2.1 — Reader toolbar and metadata navigation fixes (experimental)
- Reader background selector: bundle the reader code directly into the Zotero bootstrap script instead of executing it through a separate subscript scope; register the toolbar hook after Zotero UI is ready.
- Right-hand item metadata navigation: remove the original Cupertino 10px hover-to-expand behavior so the navigation rail keeps its native width and does not cover citation metadata.
- Add a mocked reader toolbar test to the GitHub Actions build.
- All v0.2.0 reading colors and earlier changes remain intact.
0.2.0 — Soft PDF backgrounds (experimental)
- Added a clearly labeled PDF Background control to the native reader toolbar.
- Four preset reading colors: Soft Cream, Soft Blue, Soft Sage, and Soft Paper, plus Original.
- Uses Zotero's native reader theme system and synced custom themes, rather than painting semi-transparent overlays on PDF text.
- The selected scheme is applied to light and dark reader modes; the themes remain editable in Zotero's own Appearance (Aa) panel.
- The plugin does not modify PDF files, stored annotations, or bibliographic records.
- Existing custom reader themes are preserved. New themes are registered only when explicitly selected.
- Removing the add-on removes its toolbar selector, but Zotero retains any native custom themes the user chose.
- Current native reader theme support targets Zotero 8–10; the menu and Cupertino UI continue to target Zotero 7, where reader themes may be unavailable.
- Reader UI changes need testing in an actual Zotero session; this is a prerelease.
- The legacy PDF Background add-on was studied for its user-facing idea; no unlicensed source was copied.
0.1.0 — First preview
- Forked upstream Cupertino for Zotero v1.7.6 under a distinct add-on name and identifier.
- Removed the rule that automatically collapses the native main application menubar to 14 px and opacity 0.
- Restored persistent access to File, Edit, View, Tools, Help without changing native menu placement.
- Translated CSS/JavaScript code comments to English; added English manifest and documentation.
- Added reproducible XPI packaging, validation and a GitHub Actions pre-release workflow.
- Retained upstream artwork, styling, animations and MIT attribution.
Not yet included: PDF color preset controls, despite the long-term project name. Planned for v0.2.0.
Cupertino for Zotero with PDF Background v0.2.0
Changelog
0.2.0 — Soft PDF backgrounds (experimental)
- Added a clearly labeled PDF Background control to the native reader toolbar.
- Four preset reading colors: Soft Cream, Soft Blue, Soft Sage, and Soft Paper, plus Original.
- Uses Zotero's native reader theme system and synced custom themes, rather than painting semi-transparent overlays on PDF text.
- The selected scheme is applied to light and dark reader modes; the themes remain editable in Zotero's own Appearance (Aa) panel.
- The plugin does not modify PDF files, stored annotations, or bibliographic records.
- Existing custom reader themes are preserved. New themes are registered only when explicitly selected.
- Removing the add-on removes its toolbar selector, but Zotero retains any native custom themes the user chose.
- Current native reader theme support targets Zotero 8–10; the menu and Cupertino UI continue to target Zotero 7, where reader themes may be unavailable.
- Reader UI changes need testing in an actual Zotero session; this is a prerelease.
- The legacy PDF Background add-on was studied for its user-facing idea; no unlicensed source was copied.
0.1.0 — First preview
- Forked upstream Cupertino for Zotero v1.7.6 under a distinct add-on name and identifier.
- Removed the rule that automatically collapses the native main application menubar to 14 px and opacity 0.
- Restored persistent access to File, Edit, View, Tools, Help without changing native menu placement.
- Translated CSS/JavaScript code comments to English; added English manifest and documentation.
- Added reproducible XPI packaging, validation and a GitHub Actions pre-release workflow.
- Retained upstream artwork, styling, animations and MIT attribution.
Not yet included: PDF color preset controls, despite the long-term project name. Planned for v0.2.0.