GET COMFORTABLE

A place to start.

NeroNook is currently a direct-download beta for Apple silicon Macs running macOS 14 or later. Intel, Windows and Linux builds are not included.

Install NeroNook

1. Download the Mac beta and open the ZIP.
2. Move NeroNook.app to Applications, then open it normally. macOS checks its Developer ID signature and notarization.
3. Use the menu-bar icon to open Settings. Choose your monitors, appearance and hover behavior.
4. Try the Nook, Tray and Automations before adding plugins. The core app does not require an online activation service.

If macOS reports damaged or unverified software, stop and download a fresh copy. No security override is part of the installation.

Add your first plugin

1. Open Plugin Library from the menu-bar menu, Nook toolbar, or Settings → Modules.
2. Choose a plugin. Read its access requirements, companion applications and supported versions.
3. Choose Download & Review. Downloading and verifying the package does not install or start it.
4. Review the publisher and capabilities, then choose Install Plugin. The plugin owns its sign-in and macOS permission prompts.

For a manual native installation, unzip the downloaded plugin and choose Settings → Modules → Install or Update Plugin. A lightweight .neronookmodule file uses Install Module instead.

Updates, stopping and recovery

The library’s Updates view lists newer available releases. Updates are explicit; there is no silent background installation. Native plugin settings and monitor placement are retained. Previous executables can be restored under Settings → Modules → Previous versions. This does not rewind plugin-owned data or undo actions performed in other services.

Disable a plugin to stop it, or remove it from Modules settings. Native plugins retain their own settings and credentials for reinstallation; manage or forget them in that plugin’s settings. Removing a lightweight module removes its saved module data.

Build something of your own

The creator kit includes the versioned SDK, a lightweight example, a native Swift starter, protocol checks and packaging tools. Plugins build independently of NeroNook.

Unzip the kit and open its README. Native authoring requires full Xcode, Swift 6 and the tools listed in the kit. Running NeroNook and installing a released plugin do not require Xcode.

The SDK, tools and examples are MIT-licensed. This does not relicense NeroNook or independent plugins. Keep license notices with redistributed SDK code.

Preparing a library submission

Prepare a versioned release with a clear publisher, source/license notices, capabilities, dependencies and minimum host/macOS versions. Native releases need Developer ID signing, notarization and an independent clean-install test. Include screenshots with sample content and release notes. Private plugins and credentials do not belong in submissions.

Submissions are manually curated during this beta. Self-service publishing and paid-plugin sales are not available yet.

Testing & feedback

Try a normal day of use: dictation, display changes, sleep/wake, reconnecting a device and updating a plugin. Include the app/plugin version, Mac chip, macOS version, what you expected and what happened. Never include access codes, API keys, meeting recordings or account tokens.

Feedback stays on your machine until you choose to share it with the person who provided the beta. There is no automatic upload or submission.