Free Shipping on all orders · Priority Mail Shipping with fee of $8.00
🎬
Divine Tribe Software · Open Source

studio-record

Mac screen recorder with a local API — pair it with Claude Code for record-and-send pipelines.

PythonOpen source
⭐ View on GitHub 💖 Sponsor the work
💻 Python
Primary Language
📅 April 2026
Last Updated
What it is

A little recording app that plays nicely with your AI.

Studio Record does one thing well: records your screen, your face, or both — with a virtual background if you want. Nothing crazy, except it exposes a local HTTP API on port 17494, which means any AI tool on your machine can start and stop recordings programmatically.

Pair it with Claude Code Local, and you can tell Claude 'record this demo and text it to my phone.' The AI starts the recording, does the work, stops, grabs the file, and ships it off.

Why it's different

What makes studio-record special

🎥

Three modes

Screen only, face only, or screen + face picture-in-picture.

🎭

Virtual backgrounds

Clean backdrops without a green screen.

🔌

Local API

Start, stop, check status via HTTP on localhost. Scriptable.

🍎

Mac-native

Built for macOS. Fast, clean, minimal.

Who it's for

Is this for you?

  • Creators who record tutorials and demos
  • Developers building AI workflows that need screen capture
  • Anyone tired of bloated recording apps
How to get it

Getting started in minutes

1

Clone and set up the venv

Python 3, one pip install.

2

Launch the app

It starts the local server automatically.

3

Hit start/stop

Click the UI, or call the HTTP API from your script.

Ready to try studio-record?

It's free, open source, and runs on the hardware you already own. Head to GitHub to get started, or drop a star to help us keep building in public.

⭐ Get it on GitHub ← All Divine Tribe Software
Stay in the tribe

More from Divine Tribe

🧠

claude-code-local

Run Claude Code on your own Mac — no cloud, no subscriptions, no internet required.

🎤

NarrateClaude

Talk to your Mac hands-free — and hear it reply in your own cloned voice.

🌐

browser-agent

A local AI that drives a real browser — iframes, Shadow DOM, modern web apps.

📱

claude-screen-to-phone

Control Claude Code from your iPhone — via iMessage.

Full technical docs

The complete README

Open the GitHub README — every detail, every benchmark, every code block

Studio Record

A modern macOS screen + facecam recording app with virtual backgrounds, sound control, and a local HTTP API so any tool (Claude Code, scripts, agents) can drive it.

What it does

  • Screen recording — full screen capture
  • Face recording — webcam with optional virtual background (MediaPipe segmentation)
  • Picture-in-picture — screen + facecam overlay in one recording
  • Liquid Glass UI — built with customtkinter
  • HTTP API — POST /start, POST /stop, GET /status on localhost:17494 so any agent can control it

Requirements

  • Apple Silicon Mac (M1 or later)
  • Python 3.10+
  • ffmpeg (brew install ffmpeg)

Setup

git clone https://github.com/nicedreamzapp/studio-record
cd studio-record
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Run

.venv/bin/python studio_record.py

The window opens AND a Flask API starts on http://127.0.0.1:17494.

HTTP API

# Start a recording
curl -X POST "http://127.0.0.1:17494/start?mode=screen"
# Modes: screen | face | screen_face

# Stop
curl -X POST "http://127.0.0.1:17494/stop"

# Status
curl "http://127.0.0.1:17494/status"

Recordings are saved to ~/Desktop/Screen Recordings/.

Pairing with Claude Code

Studio Record was built to be driven by claude-screen-to-phone — when paired, you can say things like "record this and send it to me" and Claude will start the recording, do the task, stop the recording, and ship the video to your phone via iMessage.

Backgrounds

The backgrounds/ folder contains the virtual background images (Apple wallpapers + abstract gradients) the face-mode segmentation overlays. Drop any .jpg or .png in there to add your own.