Skip to content

Latest commit

 

History

History
81 lines (53 loc) · 5.11 KB

README.md

File metadata and controls

81 lines (53 loc) · 5.11 KB

ZoteroQuickLook

This open source project implements QuickLook in Zotero.

Status

This plugin is not currently being actively maintained. It may not work with current or beta versions of Zotero. If someone is interested in taking over maintenance of the plugin, please contact @bwiernik.

Installing

To install ZoteroQuickLook, download the latest version of zoteroquicklook.zoteroplugin from the Releases section of this GitHub repo. In Zotero (not in Firefox), open Tools -> Add-ons. Then drag the zoteroquicklook.zoteroplugin file onto the Zotero Add-ons window.

Installing on Mac

On Mac, ZoteroQuickLook uses macOS's native QuickLook functionality. No additional steps are needed.

Installing on Linux

On Linux, you must install Gloobus-Preview, a QuickLook-like preview software. On Ubuntu you can do this by running the following commands in terminal:

sudo add-apt-repository ppa:gloobus-dev/gloobus-preview
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install gloobus-preview

For other distributions and versions the installation might be different.

If you do not like Gloobus, you can define a custom QuickLook command:

  1. Install the software you want to use for previewing files. The software must be able to take a file name as a command line parameter.
  2. Open the Config Editor in Zotero's Advanced preferences pane.
  3. Search for extensions.zoteroquicklook.customviewcommand. Set the value for this config to the full path of the executable that you want to use to show the files.

Installing on Windows

On Windows, you must first install a QuickLook tool. By default, ZoteroQuickLook is set up to work with QuickLook. Note that you must install QuickLook using either the .msi installer or through the Windows Store. If you use the .zip version of QuickLook, you must also set up a custom view command.

Alternative QuickLook tools for Windows include Seer, WinQuickLook, and the paid software MaComfort. In my experience, the default option, QuickLook, is the most stable and powerful and least resource intensive option. You can choose another QuickLook program if you like. The software must be able to take a file name as a command line parameter.

After installing a QuickLook program, set ZoteroQuickLook to use this program:

  1. Open the Config Editor in Zotero's Advanced preferences pane.
  2. Search for extensions.zoteroquicklook.customviewcommand. Set the value for this config to the full path of the executable that you want to use to show the files.

Alternative build for Windows

Installing the extension on Windows sometimes fails with the error message: "ZoteroQuickLook cannot be installed because Zotero cannot modify the needed file." This is a Windows specific problem caused by the 256 character filename length limitation. This limit is reached during unpacking the xpi archive when installing the extension. Mozilla has fixed the issue by eliminating unpacking of extensions by default and running them directly from the xpi archive. However, this solution does not work for ZoteroQuickLook because on Mac and Linux, the extension uses executable files that need to be unpacked so that they can be run. These files are not used on Windows and there is a parallel version of ZoteroQuickLook that supports running directly from the xpi file. This version is called zoteroquicklook-windows.xpi and is available from the Releases section of this GitHub repo.

You can read more about the problem on Stack Overflow and the pages linked to from there.

Getting support

Please post any questions or bugs to the Zotero forums. Include "ZoteroQuickLook" in the thread title. Also include the following information:

  • Operating system and version (e.g., macOS 10.13.2)
  • Zotero version
  • ZoteroQuickLook version
  • Detailed description of your problem
  • A link to a log file (see the next section)
  • If on windows, whether loading the alternative Windows build fixes the issue

Log files

Log file will sometimes be helpful in diagnosing possible issues, so you need to submit a log file when asking for support.

To create a log file, in Zotero, follow these steps:

  1. Click Help -> Debug Output Logging -> Restart with Logging Enabled….
  2. After Zotero restarts, click Help -> View Output.
  3. Copy the content of the log that appears and paste it to (gist.github.com).
  4. Click "Create secret gist", then copy paste the URL of the gist to your thread on the Zotero forums.

The important information is in the beginning of the log. Here are example lines from the beginning of a log file. Make sure that your log file starts with similar lines to ensure that the log is complete.

zotero(3): Using data directory /Users/user/Zotero/

zotero(3): IPC: Initializing pipe at /Users/user/Zotero/pipes/1376326753918

zotero(3): Loading in full mode

zotero(3): Opening database 'zotero'