First run
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:
- The
ZN_DBorZN_LIBRARYenvironment variable. - The path saved in
library.jsonin the settings folder (see Folders). - 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. - The default library file (see Folders), if it exists.
- 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.