Note: The instructions below are not aimed for general use by the everyday user of Zotero. Some of the information below may need to be updated to work with the current code. Please update the instructions as necessary.

• perl
• bash
• git

On most Linux distributions and on Mac OS X with Xcode, all but git are preinstalled.

To install git on OS X, install homebrew and run:

brew install git

(You may also use MacPorts or Fink instead of homebrew.)

To install git on Ubuntu or other dpkg-based Linux distributions:

apt-get install git

1. Get zotero-standalone-build and enter the directory

   git clone --recursive https://github.com/zotero/zotero-standalone-build
   cd zotero-standalone-build

2. Modify config.sh to build only for your desired platform(s) by changing the BUILD_MAC, BUILD_WIN32, and BUILD_LINUX variables at the top of the scripts. For example, if you intend to build only for Linux, change

   BUILD_MAC=1
   BUILD_WIN32=1
   BUILD_LINUX=1

   to

   BUILD_MAC=0
   BUILD_WIN32=0
   BUILD_LINUX=1

   Note: Because of the way Mozilla packages XULRunner, fetch_xulrunner.sh can only retrieve Mac builds on OS X.

3. Run fetch_xulrunner.sh

   ./fetch_xulrunner.sh

   This will add unpacked XULRunner builds to the xulrunner/ subdirectory of the zotero-standalone-build directory.

4. Run build.sh

   ./build.sh

   Your desired builds should now be available in uncompressed form in the staging/ subdirectory, or in distributable form in the dist/ subdirectory.

• Cygwin, with the following additional packages:
  • ca-certificates
  • curl
  • gettext
  • git
  • unzip
  • util-linux
  • zip
• Unicode NSIS and install the following (Unicode!) plugins by copying the .dll files to the plugins NSIS\Unicode\plugins-folder
  • AppAssocReg, ApplicationID, InvokeShellVerb, ShellLink, and UAC
• 7zip, Windows (not Cygwin) version
• upx, Windows (not Cygwin) version
• Windows SDK is needed for the included uuidgen.exe and signtool.exe utilities. Only .NET Development/Tools component is required. If you experience errors with the installer, try uninstalling Microsoft Visual C++ 2010 Redistributable from your computer first.

1. Open a Cygwin prompt, and navigate to a folder under which zotero project files should be stored.
2. Verify that git is set to check out files without modifying line-endings.

   $ git config --global core.autocrlf
   input

   This may not be the case if you've selected the default options while installing the Windows version of git. If so, temporarily change this with the following.

   $ git config --global core.autocrlf input

   See the git manual for details on this setting.

3. Check out zotero-standalone-build from its home on GitHub.

   git clone --recursive git://github.com/zotero/zotero-standalone-build.git
   cd zotero-standalone-build

4. Add executable privileges to ReplaceVistaIcon

   chmod 755 win/ReplaceVistaIcon/ReplaceVistaIcon.exe

5. Modify config.sh to build only for your desired platform(s) by changing the BUILD_MAC, BUILD_WIN32, and BUILD_LINUX variables at the top of the scripts. For example, if you intend to build only for Windows, change

   BUILD_MAC=1
   BUILD_WIN32=1
   BUILD_LINUX=1

   to

   BUILD_MAC=0
   BUILD_WIN32=1
   BUILD_LINUX=0

6. Also adapt the paths in config.sh to point to the correct executables of 7zip, UPX, NSIS, and the Windows SDK. You might want to set SIGN=1 to 0, to stop getting error messages
7. Fetch XULRunner and build Zotero Standalone:

   ./fetch_xulrunner.sh
   ./build.sh

Note: These instructions are not applicable on OS X, which handles protocol handler and MIME type registration through the bundled Info.plist file. Additionally, they are only applicable on Windows if, for some ungodly reason, you want to install Zotero Standalone without running the installer.

Zotero Standalone should be registered as the system's default protocol handler for the zotero:// protocol. This is necessary to make clicking the Zotero button in Firefox open Zotero Standalone when both are running simultaneously.

Zotero should be registered as a handler for the following file extensions and MIME types: