Veloop

Instant video soundboard & loop pedal for Google Meet, Zoom, and WebRTC calls

---

✨ Why Veloop?

• Pedal-First Video Looping — Step on your pedal or hold a hotkey to record yourself nodding or listening, then release to loop immediately.
• Instant Soundboard Presets — Save in-meeting loops with custom titles (e.g., "Attentive Nodding", "Sipping Coffee", "Taking Notes") and trigger them on demand with a single click.
• Hardware Camera Power Management — When looping or playing a preset, physical webcam tracks are detached and released (releaseHardwareCamera()), turning your webcam's green indicator LED OFF.
• Seamless Seam Dissolves — Crossfade transitions ensure loops and returning-to-live blend smoothly without harsh visual cuts or freezing frames.
• 100% Private & Local — No external servers, no cloud uploads, zero telemetry. All video encoding (MediaRecorder WebM) and storage run entirely inside local browser IndexedDB.
• Zero Virtual Camera Drivers — Operates natively inside Chrome via browser canvas.captureStream() and getUserMedia interception without needing OBS or system-level kernel extensions.

---

📺 Demo Video

https://github.com/user-attachments/assets/e7c2297b-3fb2-44b7-981f-556eb217ce9d

▶️ Also on YouTube — Looping webcam feed during a live video call

---

Screenshot

---

📥 Installation

Chrome Web Store (Recommended)

Install Veloop with one click from the official Chrome Web Store:

👉 Get Veloop on the Chrome Web Store

---

Developer Mode (Local Install)

1. Clone or download this repository:

   git clone https://github.com/samirpatil2000/veloop.git
   cd veloop
   

2. Install dependencies and build:

   npm install
   npm run build
   

3. Open Chrome and navigate to chrome://extensions
4. Toggle Developer mode on (top-right corner)
5. Click Load unpacked and select the dist/ directory inside this repository

---

🚀 How it Works

Veloop turns your browser into a digital video loop pedal. It intercepts navigator.mediaDevices.getUserMedia at the page level and routes your webcam through an ultra-low-latency 2D canvas compositor:

1. Synthetic Video Stream: The meeting site receives a synthetic MediaStream originating from the compositor canvas.
2. Pedal Capture & Instant Loop: Holding Right Option / Alt captures uncompressed frames into memory while concurrently recording a compressed WebM stream via hardware-accelerated MediaRecorder.
3. Webcam LED Extinction: The moment you enter loop mode, the raw camera hardware tracks are terminated. Your laptop or external webcam indicator light clicks off.
4. Preset Soundboard: In the popup, name any active loop to store it permanently in IndexedDB. Whenever you are in a call, 1-tap any card on your soundboard to replay that clip seamlessly.
5. Seamless Dissolve to Live: Hitting Right Command or L re-acquires the physical camera in the background and executes an alpha-blended crossfade back to reality.

📖 For complete architecture diagrams, WebRTC interception details, and pipeline specifications, see TECH_DOC.md.

---

⌨️ Hardware & Keyboard Controls

Physical foot pedals sending standard keyboard keystrokes (like Right Alt or USB pedal switch) work out-of-the-box.

---

🖥️ UI & Controls

• Popup Soundboard — Accessible via extension icon or keyboard. Features active recording state badges (LIVE, REC, LOOP, PLAY), 1-tap preset triggers, and one-click preset labeling.
• Studio Options Control Center — Customize maximum recording length, minimum tap threshold (to prevent accidental triggers), crossfade dissolve duration, and preview opacity.

---

⏱️ Video Durations & Timing Limits

Configure recording durations, trigger thresholds, and transition times via Options (chrome-extension://<id>/options.html):

---

---

⚖️ Privacy & Security

• Zero Cloud & Zero Telemetry: Veloop does not transmit any video, audio, or analytics to any remote server.
• Pure Local Storage: All saved presets reside exclusively within your browser's private IndexedDB database on your device.
• Verified Scoped Permissions: Restricts script injection strictly to verified video calling domains (Google Meet, Zoom, Teams, Webex, Discord, Whereby).

---

📄 License

MIT License — feel free to contribute, build upon, or fork for your own setup.

---

Made with ❤️ for video meetings