Available for beta testing: Reader appearance popup with theme support

edited February 7, 2025
In the Zotero 7.1 beta, we've added a new Appearance popup to the reader that provides quick access to view settings and introduces new support for reader themes:

https://s3.amazonaws.com/zotero.org/images/forums/u6/3fdnwzer0wntb6uo88cg.png
The view settings are per-document settings. (We still plan to make it possible to set default view settings.) Themes are applied globally for all documents, including in the attachment preview in the item pane, and apply to PDFs, EPUBs, and webpage snapshots.

We offer a number of built-in themes ("Dark", "Snow", "Sepia"), and you can create custom themes just by specifying a foreground and background color. (Some other theme engines require additional accent colors, but we've tried to make this as simple as possible for users by automatically adjusting other colors based on the foreground and background colors.) You can set a different theme that applies to light mode and dark mode.

The themes replace the previous on-by-default "Use Dark Mode for Content" option, which inverted images in dark mode. We're now simply darkening images a bit when using a dark theme (currently only for PDFs). Images and ink annotations in the reader sidebar and note editor are now only darkened as well (and only when Zotero itself is in dark mode).

When possible, we also try to apply themes to PDF pages containing full-page images (e.g., scanned papers) by replacing whitish/dark colors with theme colors. This is still experimental, and it's only possible when images are of sufficient quality with very few colors. (Otherwise we simply darken the page slightly.)

The PDF theme engine is loosely based on Doq, an add-on for PDF.js, the Firefox PDF viewer on which Zotero's reader is based. Snapshot theming uses Dark Reader. We've borrowed some colors from Doq, Firefox's reader mode, and the Nord theme.

Let us know how these new features work for you. Please create new threads for any specific issues.
  • @dstillman Thank you very much for this new addition. I have been testing it and it is working very well. I especially appreciate the possibility to adjust or create one's own theme.

    For example, I liked the sepia theme, but I was able to darken the foreground a bit for more contrast. Thanks!
  • edited February 7, 2025
    Thanks a lot. It must be said it is another great improvement for Zotero.

    But, precisely, it also must be remarked the issues, such as that themes seem to have some glitches yet: https://forums.zotero.org/discussion/121699/math-fonts-remain-dark-in-ieee-transactions-with-dark-theme#latest
  • edited March 2, 2025
    Customizing themes with just foreground and background colors is simple, and the darkening of images in dark mode is a useful improvement. Looking forward to (https://www.concretesrichmondva.com/) how the full-page image theming develops!
  • I came here to thank you for all the nice things you've done on Zotero 7.0, and then I saw this. I cannot thank you enough! It's working very well!
  • Thank you ! It works great. A minor issue : highlighted text seems to keep the light theme. For instance in papers, the citations appear very strongly in dark mode (example here: dx.doi.org/10.1016/j.jclepro.2016.05.077).
  • I literally came here to talk about how the old dark mode was making it extremely difficult to read. I saw this and updated Zotero, and boom, there it is. I really appreciate the new dark mode, making life much easier. Thank you!!

    PS: Speaking of colours and legibility, please let us pick different colours for main folders (with the colour of their respective subfolders being synced to them). I would be forever grateful for such a feature.

    Thank you again for making Zotero happen.
  • In the latest beta, we've added syncing of custom themes between devices.
  • Niiiice. Thank you so much for these improvements!
  • Thanks a lot for this new feature!

    That said, would it be possible to keep the option for the old dark mode settings? I’ve gotten used to them over the years, and personally, the inverted colors worked really well for me. Would love to have the choice to stick with the old version!
  • Lovely feature! One very small thing: I was suprised that it is not possible to scroll within the PDF anymore while the theme panel is opened. I think it would be more intuitive if scrolling wouldn't be disabled, as that allows the user to preview their changes.
  • +1 for keeping an option for old dark mode settings. Inverted colors for images is much preferred for scanned pdfs.
  • edited April 14, 2025
    The new dark mode amazes me! I like it so much.
  • Hi there. This seems to be working as expected with PDFs, but with snapshots it only shows the "Split View" option and nothing by way of themes. Is it yet to be implemented for snapshots?
  • @Deepakkumasan: It's implemented for snapshots, but it won't be offered on some pages where it would be too resource intensive. Start a new thread and provide an example URL and we can confirm. We'll add a message to the popup when dark mode is disabled.
  • edited 9 days ago
    No, no, NOOOO! (insert Michael Scott screaming GIF)

    I'm sorry for the strongly-worded comment, but it is what it is: this new functionality is ABYSMAL for scanned book/document PDFs. It completely borked the dark mode content view for anything but clean, all-digital-workflow PDFs. I've tried all darker themes (and even a custom #000000 / #FFFFFF one) on some post-processed documents with transparent backgrounds and they looked like, well, outright illegible crap (the text is much too dark to even register as such), and in other vanilla, untreated documents with straight JPG/PNG facsimile content, it plainly won't work, at all, it will remain mostly light or become slightly darker.

    I can show you screenshots if you wish, but unless you figure out some sort of AI-level wizardry to separate text and images from backgrounds and process them accordingly, this feature is just unacceptable as-is for those, it's fundamentally incompatible with a large portion of content that worked just fine-ish before (yes, I know, colour images and even some B&W stuff looked weird inverted, but we could live with that and turn it off if needed).

    Please, please, PLEASE bring back that old dark mode engine/setting, as a basic “invert content” mode (maybe even on a sticky, per-item basis, as that would be great for all those users who have a varied mix of documents). You can please everyone – yes, I understand that other people may wish to theme their digital PDFs to their hearts' content, and that's fine, I'm not asking you to revert the whole thing to what it looked and worked like and likely *will* make use of this themeability myself on the documents that are indeed compatible with it – by just adding it to the list as an uneditable “theme” of sorts, if you must.

    I love the new annotation display and search functionality, but I'm now basically forced to choose between having it and burning my retinas with the normal light content mode, or eschewing it altogether and being able to read old stuff – of which I'm pulling quite a lot of citations lately. And in the long run, I may have to keep the current release version of Zotero running on my main machine, with the big dual screens where I read stuff, or to resort to looking for plugins or other shenanigans to revert this behaviour… This is an egregious regression if I've ever seen one, and that's how dependent I became on the old dark content mode (for context, on top of extremely aggressive f.lux settings which I still use to this day much to the chagrin of bystanders, I used to invert my entire Macs' screens with a keyboard shortcut before system-level dark mode was even a thing, and it included, back then, Mendeley and Microsoft Word, which made a big difference on how long I could work on my dissertation each day)… I don't even have any serious eyesight disability, just a recurring but relatively mild one that does trigger photosensitivity when it flares up, but please consider the users who have it even worse.
  • @joaofrgomes Yes, please show the screenshots.
  • edited 2 days ago
    Okay, so here are a couple of examples:

    https://s3.amazonaws.com/zotero.org/images/forums/u6505448/n1n5mjmej3ouwx7hhpp1.jpg
    This is a scanned document, with the default light theme.


    https://s3.amazonaws.com/zotero.org/images/forums/u6505448/efosux3dcz8mgog0pj7c.jpg
    This is the same document, with my custom #000000/#FFFFFF theme (but all other dark themes will produce the same slightly darker result).


    https://s3.amazonaws.com/zotero.org/images/forums/u6505448/ciuyecpxl0znmc0n5qcs.jpg
    This is another document, with the default light theme (it was highly processed, but doesn't have a transparent background).


    https://s3.amazonaws.com/zotero.org/images/forums/u6505448/nhmkc1xnl4fgffdq4rdc.jpg
    This is that second document, with my custom theme.


    https://s3.amazonaws.com/zotero.org/images/forums/u6505448/ohcusqh6ql8ux4vklv4n.jpg
    This is a third document, with the default light theme; it doesn't have a white/transparent background, but the text layer does seem to have an alpha channel.


    https://s3.amazonaws.com/zotero.org/images/forums/u6505448/9wdw2spu9vl9j0k07ol2.jpg
    This is the same document, with the new default dark theme (as you can see, it is, indeed, an unreadable mess).


    https://s3.amazonaws.com/zotero.org/images/forums/u6505448/2qz5x78ltgmemb76nx8c.jpg
    And finally, this is the same document, with my custom theme (yes, legibility improved a bit, but it seems the text stays the same gray colour, and a full-on inversion would work great).


    For sure, some of these documents may be a bit non-standard or whatever, and I can send you them for analysis, but they exist in people's libraries, have good contrast on light mode and had the same decent contrast when inverted, and now they range from unpleasant to borderline unreadable.

    IMHO, the easiest way to accommodate these edge cases is to just bring back basic inversion as an option instead of trying to parse their contents/layers, as I believe the PDF standard is just that messy and complex to begin with.
  • @dstillman I’m sorry for the harsh language and now the bump and tag, and for not having checked these beta updates sooner, but surely you can now agree, in light of these examples, that this is a very serious regression, right?

    Example #3 was, IIRC, processed by me with Acrobat Pro, but examples #1 and #2 (especially #1, which is a proper unprocessed facsimile of a historical issue of the Bauhaus magazine) were imported into Zotero just as found on the web (and you can find millions of such documents on Archive.org), and don’t work *at all* with the new themes (as I said, I'm not expecting magical behaviour from those, only the addition of the old inverted “theme” that did work, even with its limitations, much like the dedicated dark mode extensions of yore).

    Maybe I'm in the minority here, in not using Zotero just to read fresh, LaTeX or InDesign-made PDFs from ScienceDirect, SpringerNature, etc., but I'm still part of a sizeable minority, I reckon.
Sign In or Register to comment.