ASAD FX - After Effects CEP Panel
=================================

INSTALL
-------
1. Copy this whole folder to:
   Windows: C:\Users\<you>\AppData\Roaming\Adobe\CEP\extensions\CaptionForge
   macOS:   ~/Library/Application Support/Adobe/CEP/extensions/CaptionForge
   (If you are updating, replace the OLD folder completely and close After Effects first.)

2. Enable unsigned extensions (one time):
   Windows (regedit) -> HKEY_CURRENT_USER\Software\Adobe\CSXS.11
       add String value  PlayerDebugMode = 1
       (also add it to CSXS.9 / CSXS.10 / CSXS.12 if present)
   macOS (Terminal):  defaults write com.adobe.CSXS.11 PlayerDebugMode 1

3. Restart After Effects -> Window > Extensions > Asad FX


TABS
----
Captions         AI Transcriber (Groq / Whisper), SRT import, 50+ animated caption styles,
                 Style Pack, Dynamic Engine, Auto Sound Design on Build.
Text Animations  Apply your own .ffx text-animation presets (presets/text-animations).
AI Sound Design  SFX library, keyword rules, AI Sound Director, preview plan, re-roll.
Counter          Count Up / Count Down text layers with slider controls.
Color Grading    Match a raw clip to a graded reference (Levels / Color Balance / Saturation).
                 Requires After Effects 2022 (v22) or newer.
Build Carousel   Carousel Pro: 77 styles, 12 ratios (see carousel/README.txt).
Motion Graphics  Your own .aep library; add the active comp with one click.
Liquid Glass     Applies the Liquid Glass effect to the selected layers
                 (plugin required: Effect > ToolsForMotion > Liquid Glass).
Anchor Point     Nine-point anchor changer that keeps the layer in place
                 (see ANCHOR_POINT_README.txt).


TIPS
----
- Force a hero / keyword word in most caption styles by writing *word* in the caption text.
- Use | in a caption line to force the split between the two parts of a style.
- Put SFX files in the sfx folder and press Reload in the AI Sound Design tab.
- Put .ffx presets in presets/text-animations and press Reload in the Text Animations tab.
- Fonts: type the exact After Effects PostScript name (or pick it from the drop-down).
  Safe fonts: Arial-BoldMT, Verdana-Bold, Tahoma-Bold, Helvetica-Bold.
- The folder name CaptionForge is kept on purpose so existing installs keep working.


LICENSE (v2.26)
---------------
Free without a key:  Anchor Point (unlimited), Counter (5 Count Up + 5 Count Down),
                     Ali Abdaal style captions (3 builds). Simple Word By Word and everything else can be PREVIEWED but not used.
                     Every caption style stays visible with a live preview (sample text until you import an SRT);
                     the settings and Build button appear only after a valid license key is activated.
Click "FREE - Unlock" (top right) and enter your key. Buy: WhatsApp +92 325 6811402 - PKR 3,000 (Pakistan) / $20 (International).
Server: "AsadFX License Manager" WordPress plugin. Settings: js/license-config.js (API_BASE, FREE_LIMITS).

v2.26 additions
---------------
Color Grading match engine improved: two Levels stages per channel (toe + shoulder / S-curve and clipped highlights),
saturation now adapts its own step size, and a pass that makes the match worse is rolled back automatically.
The match adds CM Levels, CM Levels 2, CM Color Balance and CM Saturation to the target layer.
Text Animations, AI Sound Design, Color Grading and Build Carousel are visible without a key (view-only, with an Unlock banner);
they become usable after a valid license key. Motion Graphics and Liquid Glass still show the locked placeholder.
Free caption style is now Ali Abdaal (3 builds, then it locks). Simple Word By Word is licensed.
Locked caption styles stay visible with a live preview (sample text when no SRT is loaded).
Buy window: Pakistan / International price cards are now clickable; WhatsApp message and button follow your choice.

v2.25 additions
---------------
AI Transcriber: all 99 Whisper languages + Auto detect, with a search box (type "urdu", "es", "spanish"...).
AI Sound Design > SFX Library: search box to filter the sound list; "+ Use at playhead" adds the selected sound(s)
at the playhead of the active comp (double-click a sound = preview).
