==================================================
 DUDE Sound Picker  v2.1
 by dude Studio  ·  https://4edit.ir
==================================================

A lightweight sound-effect browser that lives INSIDE Premiere Pro as a panel.
Browse your SFX library, preview instantly, and drop sounds onto the timeline
at the playhead with one click.

  © dude Studio · 4edit.ir — licensed source, not for redistribution or resale.


--------------------------------------------------
 SUPPORTED PREMIERE VERSIONS
--------------------------------------------------
Adobe Premiere Pro 2019 and newer — every current release:
  2019 (13.x), 2020 (14.x), 2021 (15.x), 2022 (22.x),
  2023 (23.x), 2024 (24.x), 2025 (25.x) and later.
Windows and macOS. One package works on both — run the installer for your
system. Requires the CEP runtime that ships with these Premiere versions.


--------------------------------------------------
 INSTALL  (one time)
--------------------------------------------------
--- WINDOWS ---------------------------------------

Easiest — run the installer:
  1. Double-click  install.bat   (run as administrator if it asks).
     • It enables Premiere's extension debug mode.
     • It copies the panel into your CEP extensions folder.
  2. Start / restart Premiere Pro.
  3. Open it from:  Window  >  Extensions  >  DUDE Sound Picker

Manual install (if you prefer):
  Copy this whole folder into:
     %APPDATA%\Adobe\CEP\extensions\ir.4edit.dudestudio.soundpicker
  …so that the CSXS, client and host folders sit directly inside it.
  Then set this registry value to 1 (for each of CSXS.9 … CSXS.12):
     HKEY_CURRENT_USER\Software\Adobe\CSXS.11 -> PlayerDebugMode = 1
  Restart Premiere.

To remove it:  run  uninstall.bat


--- macOS -----------------------------------------

  1. Unzip the archive first (do not run it from inside the zip).
  2. Open Terminal, then drag the unzipped folder onto the Terminal window
     after typing  cd   — so you get, for example:
         cd /Users/you/Downloads/DSP
  3. Run:
         bash install-mac.sh
     • It enables Premiere's extension debug mode for CSXS 9–12.
     • It copies the panel into your CEP extensions folder.
     • It clears Gatekeeper's quarantine flag — without that Premiere
       refuses to load the panel and shows no error at all.
  4. Fully quit Premiere Pro (Cmd+Q), then start it again.
  5. Open it from:  Window  >  Extensions  >  DUDE Sound Picker

  Run it with `bash` as shown — double-clicking may fail with "permission
  denied", because a zip built on Windows cannot carry the Unix execute bit.

Manual install (if you prefer):
  Copy this whole folder into:
     ~/Library/Application Support/Adobe/CEP/extensions/ir.4edit.dudestudio.soundpicker
  …so that the CSXS, client and host folders sit directly inside it.
  Then run, for each of 9 10 11 12:
     defaults write com.adobe.CSXS.11 PlayerDebugMode 1
     killall cfprefsd
     xattr -dr com.apple.quarantine ~/Library/Application\ Support/Adobe/CEP/extensions/ir.4edit.dudestudio.soundpicker
  Restart Premiere.

To remove it:  bash uninstall-mac.sh


--------------------------------------------------
 ACTIVATION
--------------------------------------------------
The panel asks for an activation key the first time you open it.

  1. Open the panel:  Window > Extensions > DUDE Sound Picker
  2. Click "Buy a license" — the purchase page opens in your browser.
     After payment your key is shown there (format: DSP-XXXX-XXXX-XXXX-XXXX).
  3. Paste the key into the panel and click Activate.

Notes:
  - The key is tied to ONE machine. Reinstalling Premiere or Windows is fine;
    moving to a new computer needs the seat released first — contact support.
  - Activation needs internet ONCE. After that the panel keeps working offline
    for as long as your connection is down; it re-checks whenever it can.
  - If it says the panel files do not match this release, reinstall the panel
    without editing any file inside it.


--------------------------------------------------
 HOW TO USE
--------------------------------------------------
- Add Folder ....... add one or more root folders to your library (unlimited).
                     Each appears in the Folders tab; hover a root to remove it.
- Search ........... searches WHERE YOU ARE, instantly (multi-word: "door slam"
                     matches names containing both). Inside a folder it searches
                     that folder only; on Favs / Top it searches that list; on
                     the All tab it searches the whole library. Clear the search
                     (or press the X) to go back to browsing.
- Tabs ............. All files / Folders (tree) / Favorites / Top.
- Top .............. "Most used" — sounds you've added to Premiere, sorted by
                     how often you used them (or switch the sort to "Recent").
- Back ............. inside a folder, use the Back button in the path bar, or
                     press Backspace / Alt+Left, or your mouse's back button.
- Click a sound .... preview it in the built-in player.
- Hover a sound .... quick auto-preview (toggle with the headphones button).
- + button ......... import the sound and place it on the ACTIVE sequence at
                     the current playhead, on the audio track you've TARGETED
                     (the highlighted A1/A2 header). If that track is busy it
                     uses the first free track so your voiceover is never
                     overwritten. No sequence open? It imports into a
                     "SoundPicker" bin in your project.
                     Tip: target the track you want + move the playhead, then +.
- Drag & drop ...... drag a sound straight from the panel onto the timeline and
                     drop it exactly where you want (track + time), just like
                     dragging from the Project panel.
- Double-click ..... import + place at the playhead (same as the + button).
- Right-click ...... Add to Premiere / Preview / Go to folder / Show in
                     Explorer / Favorite / Copy path.
- Star ............. favorite files or folders (saved between sessions).


--------------------------------------------------
 NOTES
--------------------------------------------------
- Supported formats: wav, mp3, ogg, flac, aif, aiff, m4a.
- Settings, favorites and usage stats live in:  %USERPROFILE%\.soundpicker\
- Theme: neutral dark with a red accent, tuned to sit beside Premiere's panels.
- The old standalone Electron app is gone — this is a pure Premiere extension.
  Any leftover node_modules/ or .zip in this folder are from the old build and
  can be safely deleted.


--------------------------------------------------
 TROUBLESHOOTING
--------------------------------------------------
- Panel blank / not listed:
    Restart Premiere AFTER running install.bat. Re-run install.bat as admin.
- "+" says "no active sequence":
    Open or create a sequence first, then the sound lands at the playhead.
- Nothing imports:
    A project must be open in Premiere.


--------------------------------------------------
 © dude Studio  ·  4edit.ir  ·  All rights reserved.
--------------------------------------------------
