docs: update all documentation for overlay-only Quick Setup

Files updated:
- docs/getting-started.md: Complete rewrite — reflects overlay-only
  Quick Setup (ring + bar + infrastructure), removes references to
  auto-created text sources, adds bar overlay step, updated diagrams
- docs/architecture.md: Section 21 description updated
- docs/automation-guide.md: Status/AFK section — no longer references
  SP Status as auto-created, documents overlay-native status display
- docs/faq.md: AFK status answer updated — SP Status is manual-only,
  status appears automatically in overlays and dock

All docs now accurately reflect the current codebase where:
- Quick Setup creates 8 items (2 overlays + 6 infrastructure)
- Text sources are optional, manually created, documented in
  overlay-customization.md#manual-text-sources-advanced

Author: bhaskarjha-dev

docs/architecture.md

@@ -70,7 +70,7 @@ The script is divided into exactly 23 sections, labeled with standard `---` comm
 18. **Hotkey Callbacks**: Thin integration layer to the Controls.
 19. **Frontend Events**: Hooks for stream/recording toggles.
 20. **Source/Scene Enumeration**: OBS SDK dropdown population logic.
-21. **Quick Setup Wizard**: Automated source-and-overlay generator that places the text sources, `SP Status`, overlay, background image/video/music sources, and alert source into the active scene.
+21. **Quick Setup Wizard**: Automated overlay-and-source generator that creates the ring overlay (`SP Overlay`), bar overlay (`SP Overlay Bar`), background image/video sources (with auto-fit-to-canvas), background music, and alert sound in the active scene. Text sources (SP Timer, SP Session, etc.) are no longer auto-created — they remain functional when manually assigned via the script settings.
 22. **OBS Script Interface**: Standard OBS `script_properties` and `script_update`.
 23. **Lifecycle**: OBS `script_load`, `script_save`, `script_unload`.
 

docs/automation-guide.md

@@ -1,4 +1,4 @@
-# Automation Guide
+# Automation Guide
 
 SessionPulse can automate nearly every aspect of your OBS setup based on your session state. This guide covers each automation feature with step-by-step setup.
 
@@ -273,18 +273,18 @@ Show a manual `BRB`, `AFK`, or custom note on stream without stopping the timer.
 
 ### Setup
 
-1. Use Quick Setup so it creates `SP Status` and places it in your active scene
-2. In the script panel:
+1. In the script panel:
    - Type your message into **Status Message**
    - Set **Duration (minutes)** to `0` to keep it visible until cleared, or a positive number to auto-clear it
    - Click **Show Status**
-3. Click **Clear Status** when you want to remove it
+2. Click **Clear Status** when you want to remove it
 
 ### Behavior
 
-- The message is written into the `SP Status` text source
+- The status message appears automatically in the **ring overlay**, **bar overlay**, and **control dock**
+- If you've manually created an `SP Status` text source (see [Manual Text Sources](overlay-customization.md#manual-text-sources-advanced)), it will also update there
 - The timer keeps running normally underneath it
-- Active status state is exposed in `session_state.json`, so the dock can surface it too
+- Active status state is exposed in `session_state.json`, so external tools can surface it too
 
 ---
 

docs/faq.md

@@ -125,10 +125,11 @@ Quick Setup creates `SP Alert Sound` automatically, so in most cases you only ne
 
 ### How do I show an AFK / BRB / custom status message?
 
-- Use the built-in `SP Status` text source created by Quick Setup.
+- You can create an `SP Status` text source manually (see [Manual Text Sources](overlay-customization.md#manual-text-sources-advanced)), or use the overlay's built-in status display.
 - In the script panel, type your message in **Status Message** and click **Show Status**.
 - Set **Duration (minutes)** to `0` to keep it visible until cleared, or a positive number to auto-clear it.
 - Click **Clear Status** when you return.
+- The status message also appears in the dock, ring overlay, and bar overlay automatically.
 
 ### Background image or video doesn't change
 

docs/getting-started.md

@@ -36,7 +36,6 @@ You should see the script appear in the scripts list. The Script Log (bottom pan
 
 ```
 [SessionPulse] Loaded v5.4.1
-[SessionPulse] State saved → session_state.json
 ```
 
 If you see errors instead, check the [FAQ](faq.md).
@@ -51,54 +50,25 @@ Click **one button** and SessionPulse creates everything for you:
 2. Done.
 
 This automatically:
-- ✅ Creates 5 text sources (`SP Timer`, `SP Session`, `SP Count`, `SP Progress`, `SP Status`)
+- ✅ Creates the **ring overlay** (`SP Overlay` — circular timer, 400×400)
+- ✅ Creates the **bar overlay** (`SP Overlay Bar` — horizontal status strip, 1920×48)
 - ✅ Creates the internal control source (`SP Control`) used by the dock and overlay controls
-- ✅ Creates a ring overlay Browser Source (`SP Overlay`)
-- ✅ Creates placeholder background sources (`SP Background Image`, `SP Background Video`, `SP Background Music`)
-- ✅ Creates an alert Media Source (`SP Alert Sound`)
-- ✅ Adds the visible sources to your currently active scene
-- ✅ Wires all sources to the script dropdowns
+- ✅ Creates background sources (`SP Background Image`, `SP Background Video`)
+- ✅ Creates a looping music source (`SP Background Music`)
+- ✅ Creates an alert sound source (`SP Alert Sound`)
+- ✅ Adds all sources to your currently active scene
+- ✅ Auto-fits background sources to your canvas (any resolution)
 
 Check the Script Log to confirm:
 ```
-[SessionPulse] Quick Setup: ✓ Complete! Created 11 items. Press Start to begin!
+[SessionPulse] Quick Setup: ✓ Complete! Created 8 items. Press Start to begin!
 ```
 
-> **Skip to [Step 4: Set Up Hotkeys](#step-4-set-up-hotkeys)** — sources, scenes, and overlay are ready.
+> **Skip to [Step 4: Set Up Hotkeys](#step-4-set-up-hotkeys)** — overlays and sources are ready.
 
 If OBS closes during a session, reopen OBS and use **Resume Previous Session** in the script panel to continue from the exact saved timer value and progress position.
 
----
-
-<details>
-<summary><strong>Alternative: Manual Setup</strong> (if you prefer to create sources yourself)</summary>
-
-### Create Text Sources
-
-Create these in your scene before configuring the script:
-
-| Source Name | Purpose | Required? |
-|------------|---------|-----------|
-| `Timer` | Shows countdown `24:59` | ✅ Yes |
-| `Session` | Shows `Focus Time`, `Short Break`, etc. | Recommended |
-| `Focus Count` | Shows `Done: 3/6` | Optional |
-| `Progress` | Shows `████░░░░` bar | Optional |
-
-1. In your **Scene**, click **+** (under Sources)
-2. Select **Text (GDI+)** (Windows) or **Text (FreeType 2)** (Mac/Linux)
-3. Name it and click **OK**
-4. Repeat for each source
-
-### Connect Sources to the Script
-
-1. Go to **Tools** → **Scripts** → select **SessionPulse**
-2. In the script settings panel, use the dropdown menus:
-   - **Timer Text Source** → select your timer source
-   - **Session Message Source** → select your session source
-   - **Focus Count Source** → select your count source
-   - **Progress Bar Source** → select your progress source
-
-</details>
+> 💡 **Need individual text sources?** Quick Setup creates overlays only (they display everything: timer, session type, progress, goals, next-up info). If you prefer separate text elements for custom positioning, see [Manual Text Sources](overlay-customization.md#manual-text-sources-advanced).
 
 ---
 
@@ -123,6 +93,7 @@ Optional but useful:
 | Add Time | `Ctrl+F9` | Add 5 minutes to current session |
 | Subtract Time | `Ctrl+F10` | Remove 5 minutes from current session |
 | Reset All | `Ctrl+F11` | Clear all progress and start fresh |
+| Resume Previous | `Ctrl+F12` | Restore a session interrupted by crash/close |
 
 4. Click **Apply** → **OK**
 
@@ -131,8 +102,8 @@ Optional but useful:
 ## Step 5: Start Your First Session
 
 1. Press your **Start/Pause** hotkey (e.g., `F9`)
-2. Watch: your `Timer` source should start counting down from `25:00`
-3. Your `Session` source should show `Focus Time`
+2. Watch: the **ring overlay** starts counting down from `25:00`
+3. The **bar overlay** at the top shows session type, timer, progress, and goal count
 4. When it hits `0:00`, it will automatically switch to a **Short Break** (5 minutes)
 5. After the break, it auto-starts the next Focus session
 
@@ -145,21 +116,22 @@ Focus (25 min) → Short Break (5 min) → Focus → Short Break → Focus → S
 
 ---
 
-## Step 6: Add the Overlay (Optional)
+## Step 6: Customize Your Overlays
 
-The ring overlay adds a beautiful visual timer to your stream:
+Both overlays are highly customizable via the **Custom CSS** field in OBS Browser Source properties.
 
-1. In your scene, click **+** (add source) → **Browser**
-2. Name it `Timer Overlay`
-3. Check **✅ Local file**
-4. Click **Browse** → navigate to your SessionPulse folder → select **`timer_overlay.html`**
-5. Set **Width: 220**, **Height: 220**
-6. Click **OK**
-7. Position the overlay where you want it on your stream
+### Ring Overlay
+- Created by Quick Setup as `SP Overlay` (400×400)
+- Scale it down in OBS to your preferred size (e.g., 150px for gaming, 280px for study streams)
+- Themes: Neon, Minimal, Glassmorphism, or default
 
-You should see a circular ring with the countdown timer. It will be green during Focus, blue during Short Break, and purple during Long Break.
+### Bar Overlay
+- Created by Quick Setup as `SP Overlay Bar` (1920×48)
+- Sits at the top edge of your canvas
+- Shows: session icon, label, timer, progress bar, goal count, next-up info
+- Auto-hides when the timer is idle
 
-> For customization (themes, colors, sizes), see the [Overlay Customization Guide](overlay-customization.md).
+> For full theme presets, CSS variables, and color customization, see the [Overlay Customization Guide](overlay-customization.md).
 
 ---
 
@@ -179,7 +151,7 @@ The dock gives you clickable buttons inside OBS instead of using hotkeys:
 
 3. Click **Apply**
 
-A new dock panel appears with Start/Pause, Skip, Stop buttons, a timer display, session stats, and the live `SP Status` / AFK message when one is active.
+A new dock panel appears with Start/Pause, Skip, Stop buttons, a timer display, session stats, and the live status message when one is active.
 
 **For control buttons to work**, you need WebSocket enabled:
 1. Go to **Tools** → **WebSocket Server Settings**
@@ -197,18 +169,18 @@ Your setup should now look like this:
 flowchart TB
     subgraph OBS["OBS Studio"]
         Script["session_pulse.lua\n(engine)"]
-        Timer["Timer: 24:59"]
-        Session["Session: Focus Time"]
-        Overlay["Ring Overlay\n(Browser Source)"]
+        Ring["SP Overlay\n(Ring — 400×400)"]
+        Bar["SP Overlay Bar\n(Bar — 1920×48)"]
+        BG["SP Background\nImage / Video"]
         Dock["Control Dock\n(Custom Browser Dock)"]
     end
     
-    Script -->|updates| Timer
-    Script -->|updates| Session
     Script -->|writes| State["session_state.json"]
-    State -->|reads| Overlay
+    State -->|reads| Ring
+    State -->|reads| Bar
     State -->|reads| Dock
     Dock -->|WebSocket| Script
+    Script -->|updates| BG
 ```
 
 ---
@@ -218,7 +190,8 @@ flowchart TB
 | Want to... | Read... |
 |-----------|---------|
 | Customize overlay colors and themes | [Overlay Customization](overlay-customization.md) |
-| Auto-switch scenes, duck music, control mic | [Automation Guide](automation-guide.md) |
+| Auto-duck music, control mic, toggle filters | [Automation Guide](automation-guide.md) |
 | Set up Nightbot or Stream Deck | [Integrations](integrations.md) |
 | Control from your phone | [Mobile Remote](mobile-remote.md) |
+| Use individual text sources instead of overlays | [Manual Text Sources](overlay-customization.md#manual-text-sources-advanced) |
 | Something isn't working | [FAQ & Troubleshooting](faq.md) |

session_pulse.lua

@@ -2807,7 +2807,7 @@ function populate_scene(scene, overlay_source, bar_source, background_sources, m
 
     -- Add ring overlay at top-left
     if overlay_source then
-        add_source_obj_to_scene(scene, overlay_source, 30, 30)
+        add_source_obj_to_scene(scene, overlay_source, 60, 60)
     end
 
     -- Add bar overlay at top edge (full width)