System requirements

For Windows: Windows 10/11, Python 3.11 or 3.12
For Linux: Ubuntu 20.04+, Python 3.11 or 3.12
For the one-time package install you need an internet connection.

How to install Libiry

Windows

Option A

Download LibirySetup.exe from https://github.com/Sappelen/Libiry/releasesand run it

Tips:

  1. Windows may show a warning. Click ‘More info’ → ‘Run anyway’. This is normal for new software without a commercial certificate
  2. In Settings → Apps → Advanced app settings, set “Where to get apps” to “Anywhere” (or “Anywhere, but let me know if there’s a comparable app in the Store”)
  3. Right-click on LibirySetup.exe. Go to Properties. At the bottom of the General tab: check Unblock
  4. On corporate machines with strict policies, Windows may block the app completely. In that case, you can use Option B

Option B

  1. Download Python from python.org/downloads. During installation, check “Add Python to PATH”. If needed, 1.7 Troubleshooting gives a more detailed instruction
  2. Download the latest Libiry zip file from https://github.com/Sappelen/Libiry/releases
  3. Right-click the ZIP → Extract All. The location doesn’t matter. The downloads folder is fine
  4. Open the extracted folder in File Explorer. Click the address bar at the top, type cmd, press Enter. A Command Prompt opens in that folder
  5. Type exactly: powershell -ExecutionPolicy Bypass -File install.ps1
  6. Press Enter. The installation takes about two minutes
  7. A Libiry shortcut appears on your desktop
  8. You can now delete the extracted folder

Linux

Option A

Download Libiry-0.5.0-Linux-x86_64.AppImage from the Releases page (https://github.com/Sappelen/Libiry/releases).

type chmod +x Libiry-0.5.0-Linux-x86_64.AppImage in your terminal
Run it (double-click it or type ./Libiry-0.5.0-Linux-x86_64.AppImage in your terminal)

Option B

curl -O https://raw.githubusercontent.com/sappelen/Libiry/master/linux/install.sh
chmod +x install.sh
./install.sh

How to uninstall Libiry

The script asks three questions:

  1. Confirm removal of the app, symlink and desktop shortcut
  2. Whether to also remove settings (~/.config/Libiry, %APPDATA%\Libiry)
  3. Whether to also remove your cache data (~/.cache/Libiry)

Windows

Via Windows Settings > Apps > Libiry > Uninstall

Linux

Option A

To uninstall: delete the .AppImage file To also remove your settings: rm -rf ~/.config/Libiry ~/.cache/Libiry

Option B

cd /opt/Libiry
chmod +x linux/uninstall.sh
./linux/uninstall.sh