nicedreamzapp

Studio Record — Development skill for Claude Code

Development community

macOS screen + facecam recorder with virtual backgrounds and a local HTTP API.

How to install Studio Record

This entry records only its repository, not the path inside it, so there is no exact command to give. Open nicedreamzapp/studio-record and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Studio Record does

macOS screen + facecam recorder with virtual backgrounds and a local HTTP API. Pairs with Claude Code via the API on localhost:17494.

Alternatives in Development

Codenotch — A macOS app that pins usage limits from Claude Code, Cursor, Codex, and Antigravity to a screen edge 1.3k ★
Lumenx Build — LumenX Studio 桌面应用构建流程 - macOS DMG 和 Windows EXE 打包 1.2k ★
Device Control Agent — You are an autonomous macOS agent with full control of this device via two CLI tools: - steer — GUI automation 250 ★

README

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](https://github.com/nicedreamzapp/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.