================================================================
  SUNOVID — Score to Picture in Suno Studio
  v0.4.0
  https://sunovid.com
================================================================

WHAT IS THIS?
-------------
SunoVid is a Chrome extension that lets you score music to 
picture directly inside Suno Studio. Load a local video file, 
sync it to Suno's timeline, and compose with your film playing 
right alongside your music.


INSTALLATION
------------
1. Unzip this folder somewhere permanent (like your Desktop 
   or Documents). Don't delete it after installing — Chrome 
   needs the folder to stay.

2. Open Chrome and go to: chrome://extensions

3. Turn on "Developer mode" (toggle in the top-right corner)

4. Click "Load unpacked"

5. Select this unzipped folder

6. You should see "Suno Scoring Companion" appear in your 
   extensions list

7. Navigate to https://suno.com/studio — the SunoVid panel 
   will appear on the right side of the screen


FIRST PROJECT SETUP
-------------------
1. OPEN SUNO STUDIO
   Go to https://suno.com/studio and open or create a project.

2. SET YOUR BPM
   At the top of the SunoVid panel, enter your project's BPM.
   This is required for playhead seeking to work correctly.
   Suno's internal timeline runs in beats, not seconds — the 
   BPM tells SunoVid how to convert between the two.
   
   To find your BPM: check your Suno project settings or the 
   song metadata.

3. LOAD YOUR VIDEO
   Click "Choose File" and select your video file (MP4, MOV, 
   WebM, etc.). The video loads locally — nothing is uploaded.

4. HIT PLAY
   Press spacebar or click Suno's play button. Your video and 
   Suno's audio will play together in sync.

That's it! SunoVid auto-detects Suno's transport controls.
If auto-detect ever fails, see the Troubleshooting section.


THE PANEL
---------
MOVING THE PANEL
  Click and drag the panel header to reposition it anywhere 
  on screen. Place it wherever works best for your workflow.

COLLAPSING THE PANEL
  Click "Collapse" in the header to minimize the panel when 
  it's in the way. Your video, undocked windows, and 
  Picture-in-Picture are NOT affected — only the main panel 
  hides. Click "Expand" to bring it back.


FEATURES
--------
NUDGE (±25ms / ±50ms)
  Fine-tune the sync between your video and Suno's playhead. 
  Tap the nudge buttons to move both video and Suno's timeline 
  in precise increments. Perfect for lining up a hit point 
  with a specific frame.

RE-ZERO
  Jump everything (video + Suno playhead) back to the start 
  position. Use this to reset and replay from the beginning.

RESYNC
  If video and audio drift apart, hit Resync to realign the 
  video to Suno's current position.

MARKERS
  Drop timestamped markers with notes to remember key moments 
  in your score — hit points, scene changes, dialogue cues. 
  Click a marker to jump to that position.
  
  IMPORTANT: When typing marker notes, use underscores (_) 
  instead of spaces to separate words. The spacebar is Suno's 
  play/pause shortcut, and pressing it while typing in a 
  marker field will toggle playback. 
  Example: "Scene_change_to_forest" not "Scene change to forest"

PICTURE-IN-PICTURE
  Pop the video out into a floating window so you can watch 
  your film while working in Suno's full interface.

UNDOCKABLE PANELS
  The Nudge and Markers sections can be "undocked" into 
  floating windows. Click "Undock nudge" or "Undock markers" 
  to pop them out, then drag them wherever you want. Click 
  the X or "Dock" to put them back.
  
  Undocked windows stay visible even when the main panel is 
  collapsed. Same goes for Picture-in-Picture.

WAVEFORM
  Shows the audio waveform of your loaded video with a 
  playhead indicator. Can also be undocked. Includes volume 
  control for your video's audio track.


LICENSE & TRIAL
---------------
SunoVid includes a 7-day free trial with full functionality. 
After the trial ends, you'll need a license key to continue.

Purchase a license at: https://sunovid.com

To activate: paste your license key into the License field 
in the panel and click "Activate."


TROUBLESHOOTING
---------------
PANEL DOESN'T APPEAR
  - Make sure you're on https://suno.com/studio (not the 
    homepage or a song page)
  - Check chrome://extensions — is the extension enabled?
  - Try refreshing the page

PLAYHEAD SEEKING DOESN'T WORK
  - Make sure BPM is set (top of the panel)
  - BPM must match your Suno project's actual tempo
  - Check the browser console (F12) for [SSC] messages

VIDEO AND AUDIO OUT OF SYNC
  - Use the Nudge buttons to fine-tune alignment
  - Hit Resync to re-align to Suno's current position
  - Re-zero to start fresh from the beginning

TRANSPORT CONTROLS NOT DETECTED
  SunoVid auto-detects Suno's play button and timecode 
  display. If detection fails (status badges show warnings), 
  open the Fix-It drawer at the bottom of the panel:
  
  - Click "Pick play button" then click Suno's actual 
    play/pause button on the page
  - Click "Pick timecode" then click the time display in 
    Suno's player
  
  These selections are saved per project.

VIDEO WON'T LOAD
  - Supported formats: MP4, MOV, WebM, MKV
  - Very large files (>1GB) may take time to decode
  - Check that the file isn't corrupted

SPACEBAR TOGGLES PLAYBACK WHILE TYPING
  This is Suno's native behavior — spacebar always controls 
  play/pause. When typing in marker notes or other fields, 
  use underscores (_) instead of spaces.


KEYBOARD SHORTCUTS
------------------
Spacebar    Play/pause (Suno's native shortcut — SunoVid 
            syncs automatically)


SUPPORT
-------
Questions or issues? Visit https://sunovid.com

================================================================
  Made for composers, filmmakers, and music creators.
  (c) 2026 SunoVid
================================================================