Sound Copilot — Windows installation
====================================

Requirements
------------
- Windows 10 or later (64-bit)
- REAPER 7.x (64-bit)

Install
-------
1. Quit REAPER completely. Restart REAPER after installing or updating the extension.

2. Copy the extension file from this archive into REAPER's UserPlugins folder:

     reaper_sound_copilot.dll

   The chat UI is embedded inside this file (no separate HTML to install).

   Default location:

     %APPDATA%\REAPER\UserPlugins\

   Example:

     C:\Users\YourName\AppData\Roaming\REAPER\UserPlugins\

   Create the UserPlugins folder if it does not exist.

3. Start REAPER.

Open Sound Copilot
------------------
- Actions → search "Sound Copilot: Show chat window" → Run
- Or View → Dockers → Sound Copilot

30-day demo
-----------
Official release builds include a trial if they were built with license CI variables set.
If you see "Demo unavailable" and missing license keys in the REAPER console:

  1. Rebuild locally with .env (copy .env.example), then:
       .\scripts\win\build-windows.ps1 -BuildType Release -Install
     Or set environment variables before starting REAPER:
       SOUND_COPILOT_LICENSE_TRIAL_URL
       SOUND_COPILOT_LICENSE_API_KEY

  2. Or download a newer release zip built after GitHub Actions secrets/variables
     were configured (see README "Build And Publish Release Zips").

Verify
------
- First launch: follow the welcome screen to add an API key (Settings → AI token).

Uninstall
---------
Quit REAPER, then delete:

  %APPDATA%\REAPER\UserPlugins\reaper_sound_copilot.dll

Settings are stored in REAPER extended state (section sound_copilot).
