Installation on MacOS

⚠️ Known Issues

• No binaries yet (you can download artifacts from each commit/PR tests)
• App won't ever be sandboxed, hardened, notarized or signed.
  • If you don't trust the binaries please build from source. You still need to convince Apple you want to run the binary you just built.

Installation

1. Choose a release from the releases page
2. Click on the release tag

3. View workflows for the latest commit and select details for any macOS release

4. Select summary on the side and download the artifact appropriate for your device. Apple Silicon macs use arm64.
5. Decompress the zip file, then decompress the 7z file using Keka or The Unarchiver.
6. Move the application somewhere outside ~/Downloads
7. Right click and open the application to bypass gatekeeper. You only need to do this for the first launch.

CLI interface

If you want to access koreader using the commandline don't do a symlink. Just export the PATH.

For example: for /Applications/KOReader.app do export PATH=$PATH:/Applications/KOReader.app/Contents/MacOS