Zum Inhalt springen
Jefferson Gonçalves
← Zurück zu den Projekten

Zotero Zotts

# ZoTTS

ZoTTS is a Zotero plugin to add TTS functionality

Zotero target version 7 Using Zotero Plugin Template

[!WARNING] Text To Speech is currently in Beta as a built in feature for Zotero, since it will likely do everything ZoTTS can and turnaround on new features will be quicker when helmed by the official devs, ZoTTS will probably not receive any major updates going forward.

Thanks to everyone who used ZoTTS over the past two years for your kind words and encouragement, feature requests and bug reports, it's been amazing making this plugin for you all.

💜

  • Imperial_Squid, ZoTTS Dev

#Install :rocket:

The latest stable version is available here The full version list, including any prerelease versions is here

  1. Download the .xpi file from the latest release
    • If you're using firefox, right click and select "Save as..."
  2. In Zotero, go to Tools > Plugins
  3. Click the gear icon in the top right
  4. Select Install Add-on From File...
  5. Browse to the downloaded .xpi file and select it

The plugin should load straight away, and future updates will be downloaded automatically!

[!TIP] If you want some information about finding more voices for ZoTTS, please see this documentation.

[!NOTE] ZoTTS might fail to init the TTS engine for Linux users who use Zotero in sandboxed environments (flatpak/snap/etc) due to a long-standing non-trivial bug, a workaround might be possible but you might find it easier to use a non-sandboxed Zotero if you can, feel free to open a bug report for further assistance

#Features :sparkles:

#Shortcuts

  • Ctrl/Cmd + S will begin speaking (extra functionality is available with Ctrl/Cmd + Shift + S, discussed below)
  • Ctrl/Cmd + Shift + P will pause
  • Ctrl/Cmd + Shift + C will cancel
  • Ctrl/Cmd + Shift + Q will cycle to the next favourite, if set

In the Library tab, by default Ctrl/Cmd + S will speak a paper's title, Ctrl/Cmd + Shift + S will speak its abstract.

In Reader tabs:

  • If there's any text selected, Ctrl/Cmd + S will speak it, Ctrl/Cmd + Shift + S will speak from that selection to the end
  • If there's no text selected, but there are annotations selected, Ctrl/Cmd + S will speak their annotated text, Ctrl/Cmd + Shift + S will speak their comments (if any)
  • If there's no text and no annotations selected, Ctrl/Cmd (+ Shift) + S will default to reading the full text of the paper

You can swap the behaviour of Ctrl/Cmd + S and Ctrl/Cmd + Shift + S in the preferences.

#UI Elements

In the Library tab, right clicking an item will bring up a context menu, you can tell ZoTTS to speak the title or abstract from here.

In Reader tabs there's also buttons for playing/pausing/cancelling in the top right. These will act the same as using the speak/pause/cancel shortcuts in terms of speaking selected text/annotations/full text.

(Note that doing this ignores whatever Shift Modifier settings you have, and whether you're holding shift when the button is clicked).

On each annotation there are also buttons to speak the annotated text, and the comment if one exists.

#Preferences

In the preferences you can:

  • Enable/disable queueing
    • If you want to speak a new item, should ZoTTS add it to a queue, or cancel the current item and speak the new one?
  • Adjust the current voice and related settings
    • Voices used are the ones built in to your computer
    • You can also adjust the rate/pitch/volume
  • Tweak shortcuts
    • Rebind the speak, pause and cancel shortcuts to use other letters
    • Change what happens when you're holding Ctrl/Cmd vs Ctrl/Cmd + Shift
  • Specify substitutions
    • A lot of TTS engines don't pronounce things how you might want, you can tell ZoTTS text to look out for and what to replace it with
    • Patterns to be replaced can be either raw text or regex patterns
  • Create favourites
    • Create a set of favourites with specific voices and other settings
    • You can quickly cycle between favourites with the shortcut
    • Especially useful for users who might read in multiple languages

#Contributing :wrench:

#Code and Translations :computer:

If you want to contribute bug fixes/features/etc or translate the plugin into another language, please refer to the contribution guide for details on setting up your environment and places to start.

#Funding :money_with_wings:

If you want to support me financially, please follow this link:

Sponsor on GitHub

Don't worry if you can't, ZoTTS is and always will be absolutely free. However, if you do want to send some money, I'd be very grateful!

Neue Version verfügbar.