Version 1.3

This is the third official update for the ZOIA Librarian! Thanks to all of your beta testers and contributors - with this update, we are continuing to support Windows and Mac machines with 32/64-bit architecture. Linux is no longer officially supported, but can be built from source. See the patch notes below for more detail on what has changed.

If you encounter any issues, please reach out though via Discord (#librarian channel) or by submitting an issue. We ask that you include the steps to reproduce the issue if they are known - see the issue templates for more context. Executable files may be moved from the Downloads folder to anywhere on your machine.

Mac - Compiled on Mac OS 12.3 (Monterey) with an M1 Pro MBP. Requires macOS >= 11.0. I created versions for both chipsets used in Apple machines, ARM and Intel. ARM development will be the default going forward, though I will do my best to continue supporting Intel Macs.

1. Depending on the processor your Mac has, choose the appropriate download.
2. Unzip the compressed file.
3. Double click the "ZOIA Librarian.app" file to launch the application.
   Apple's security may require you to right-click and select "Open" to run the app the first time to verify it. Subsequent starts will only require a double-click.
   If it still does not allow you to open it and displays "ZOIA Librarian is damaged and can't be opened", try the following command in a terminal:
   xattr -d com.apple.quarantine /Users/<USERNAME>/Downloads/ZOIA\ Librarian.app
   Then double click to open.

Windows - Compiled on Windows 10 22H2, OS build 19045.3930. Windows 11 support is untested, please reach out if you run into problems.

1. Download the ZOIALibrarian-Windows-1.3.zip file.
2. Unzip the compressed file.
3. Double click the "ZOIA Librarian.exe" file to launch the application.

Version 1.2

This is the second official update for the ZOIA Librarian! Thanks to all of your beta testers and contributors - with this update, we are continuing to support Windows, Mac, and Ubuntu machines with 32/64-bit architecture. See the patch notes below for more detail on what has changed.

If you encounter any issues, please reach out though via Discord (#librarian channel) or by submitting an issue. We ask that you include the steps to reproduce the issue if they are known - see the issue templates for more context. Executable files may be moved from the Downloads folder to anywhere on your machine.

Windows - Compiled on Windows 10 (version 21H1), confirmed to work on Windows 11.

• Download the ZOIALibrarian-Windows-1.2.zip file and unzip the compressed file.
• Double click the ZOIA Librarian.exe file to launch the application.

Mac - Compiled on Mac OS 10.15 (Catlina), confirmed to work on versions dated back to 10.14 (Mojave) and up to 11.6 (BigSur). Monterey (12.0+) support is not guaranteed, but will be worked on in the future.

• Download the ZOIALibrarian-Mac-1.2.zip and unzip the compressed file.
• Double click the ZOIALibrarian.app file to launch the application (Mac's security may require you to right-click and select "Open" to run the app the first time to verify it. Subsequent starts will only require a double-click).

Linux - Compiled on 20.04 (Ubuntu).

• Download the ZOIALibrarian-Ubuntu-1.2.zip and unzip the compressed file.
• Double click the ZOIALibrarian file to launch the application.

Version 1.1

This is the first official update for the ZOIA Librarian! Thanks to all of your beta testers and contributors - with this update, we are continuing to support Windows, Mac, and Ubuntu machines with 32/64-bit architecture. See the patch notes below for more detail on what has changed.

If you encounter any issues, please reach out though via Discord (#librarian channel) or by submitting an issue. We ask that you include the steps to reproduce the issue if they are known - see the issue templates for more context. Executable files may be moved from the Downloads folder to anywhere on your machine.

Windows - Compiled on Windows 10 (version 21H1).

• Download the ZOIALibrarian-Windows-1.1.zip file and unzip the compressed file.
• Double click the ZOIA Librarian.exe file to launch the application.

Mac - Compiled on Mac OS 10.15 (Catlina), confirmed to work on versions dated back to 10.14 (Mojave) and up to 11.5 (BigSur).

• Download the ZOIALibrarian-Mac-1.1.zip and unzip the compressed file.
• Double click the ZOIALibrarian.app file to launch the application.

Linux - Compiled on 20.04 (Ubuntu).

• Download the ZOIALibrarian-Ubuntu-1.1.zip file and unzip the compressed file.
• Do not remove any files from the downloaded directory after it has been unzipped.
• Double click the ZOIALibrarian file to launch the application // open from the command line.

Version 1.0

This is the first official ZOIA Librarian release! Thanks to all of your beta testers and contributors - as of today we are proud to be supporting Windows, Mac, and Linux (Ubuntu) machines with 32/64-bit architecture.

If you encounter any issues, please let a developer know either via Discord (#librarian channel) or by submitting an issue. We ask that you include the steps to reproduce the issue if they are known - see the issue templates for more context.

Known issue: if you used a previous beta version of the application, you will have to delete your saved preferences file from the local backend due to the edits made. See each platform's notes for how to perform this operation.

Windows: Navigate to C:\Users\user\AppData\Roaming\.ZoiaLibraryApp and delete the pref.json file (if it exists). Download the ZOIALibrarian-Windows-1.0.zip file and unzip the compressed file. Do not remove any files from the downloaded directory after it has been unzipped. Double click the ZOIALibrarian.exe file to launch the application.

Mac: Navigate to /Users/user/.Library/Application Support/.ZoiaLibraryApp and delete the pref.json file (if it exists). Download the ZOIALibrarian-Mac-1.0.zip and unzip the compressed file. Do not remove any files from the directory after it has been unzipped. Double click the ZOIALibrarian.app file to launch the application.

Linux: Navigate to /home/.local/share/.ZoiaLibraryApp and delete the pref.json file (if it exists). Download the ZOIALibrarian-Linux-1.0.zip file and unzip the compressed file. Do not remove any files from the downloaded directory after it has been unzipped.

If issues arise, the application can also be launched from the command line. Open up a terminal and run the following:

cd Downloads
./ZOIALibrarian.app/Contents/MacOS/startup

Beta 3

This third beta candidate is a demonstration of features and capabilities that are to be provided in a future polished release of the ZOIA Librarian. It has only been tested to work on Windows for both 32-bit and 64-bit architecture and Mac devices.

As this is a beta release, feedback is welcomed and appreciated. If you encountered any issues, please let a developer know. Better yet, if you have a GitHub account, feel free to create an issue. We only ask that you include the steps to reproduce the issue if they are known.

Windows: Download the ZOIALibrarian - Beta 3 Windows zip and unzip the compressed file. Do not remove any files from the downloaded directory after it has been unzipped. You may remove the shortcut from the folder and launch the application from the shortcut from anywhere on your Windows PC.

Mac: (Requires some Terminal commands. If you would like to compile from source, see #59). Download the ZOIALibrarian - Beta 3 Mac zip and unzip the compressed file. Do not remove any files from the directory after it has been unzipped. Run the following commands from a local terminal (found in Applications/Utilities/Terminal) in order to open the application:

# Navigate to the directory in which you unzipped the compressed file
cd Downloads/ZOIALibrarian
# Execute the application (you may have to run with sudo to bypass the Apple developer check)
./ZOIALibrarian.app/Contents/MacOS/ZOIALibrarian

Beta 2

This second beta candidate is a demonstration of features and capabilities that are to be provided in a future polished release of the ZOIA Librarian. It has only been tested to work on Windows and Mac devices for both 32-bit and 64-bit architecture.

As this is a beta release, feedback is welcomed and appreciated. If you encountered any issues, please let a developer know. Better yet, if you have a GitHub account, feel free to create an issue. We only ask that you include the steps to reproduce the issue if they are known.

Windows: In order to run the application, please double click the ZOIALibrarian - Beta 2.exe file. Do not remove any files from the downloaded directory after it has been unzipped. You may remove the shortcut from the folder and launch the application from the shortcut from anywhere on your Windows PC.

Mac: Sorry. See Beta-3 release for a new version.

ZOIA Librarian - Beta 1

This initial beta candidate is an early demonstration of features and capabilities that are to be provided in a future polished release of the ZOIA Librarian. It has only been tested to work on Windows and Mac devices for both 32-bit and 64-bit architecture.

As this is a beta release, feedback is welcomed and appreciated. If you encountered any issues, please let a developer know. Better yet, if you have a GitHub account, feel free to create an issue. We only ask that you include the steps to reproduce the issue if they are known.

Windows: In order to run the application, please double click the ZOIALibrarian.exe file. Do not remove any files from the downloaded directory after it has been unzipped.

Mac: In order to run the application, please double click the ZOIALibrarian.app file. Do not remove any files from the downloaded directory after it has been unzipped.