Skip to content
ZincGitHubDownload

First run

View as Markdown

The first time you start Zinc on a machine, no library is configured. Instead of an empty window you see a first-run screen with three choices. Nothing is opened or written until you choose.

Choice What it does
Import from Zotero Looks for the Zotero data folder (the one your Zotero desktop program uses) and copies the library into a new Zinc library, with a progress bar. Your Zotero data is only read. If it is not found, or is somewhere unusual, you can pick the folder yourself.
Open an existing library Pick a Zinc library file (.sqlite). The file is checked first; a file that is not a Zinc library is refused with a reason.
Start an empty library Creates a new, empty library. You can add items, or import files later.

A new library is created at the default location for your system (see Folders). If that name is taken, library-2.sqlite, library-3.sqlite and so on are used; an existing library is never overwritten.

The screen also appears if a library you set earlier has gone (for example it was on a drive that is unplugged). It then says why.

Where the library is found

On every start the app picks its library in this order:

  1. The ZN_DB or ZN_LIBRARY environment variable.
  2. The path saved in library.json in the settings folder (see Folders).
  3. A library left in the older location <home>\zotero-next\data\library.sqlite. It is adopted, which means its path is saved to the file above, so it keeps opening from there.
  4. The default library file (see Folders), if it exists.
  5. None of these: the first-run screen.

To use another library later, go to Settings > Files and folders > Library location > Change…. The new library is used the next time the app starts. See the Settings reference.

Folders

Zinc keeps its files in these places. On Linux, $XDG_CONFIG_HOME and $XDG_DATA_HOME replace ~/.config and ~/.local/share when they are set.

What Windows macOS Linux
Settings, logs and interface state (logs are in the logs subfolder) %APPDATA%\zotero-next-gpui ~/Library/Application Support/zotero-next-gpui ~/.config/zotero-next-gpui
Default library %APPDATA%\zotero-next\library.sqlite ~/Library/Application Support/zotero-next/library.sqlite ~/.local/share/zotero-next/library.sqlite
Zotero’s profile (where Zinc finds Zotero’s data folder) %APPDATA%\Zotero\Zotero\Profiles ~/Library/Application Support/Zotero/Profiles ~/.zotero/zotero
Mendeley Desktop data %LOCALAPPDATA%\Mendeley Ltd\Mendeley Desktop ~/Library/Application Support/Mendeley Desktop ~/.local/share/data/Mendeley Ltd./Mendeley Desktop

Other pages call the first row “the settings folder”.

After importing

  • Zotero and Zinc can both be installed. How changes flow between them is described in Sync.
  • Newer versions of the app migrate the library file’s schema on opening. A backup copy is made first. See Updates and, for details, Database and migrations.