Editing Buddy is a lightweight, desktop screen recorder built for video editors and content creators who use Adobe Premiere Pro. It captures your screen and system audio, then drops the finished clip straight into your Premiere project — no manual import, no folder hunting.
Think of it as the missing "record + import" button for your editing workflow.
| Feature | Description |
|---|---|
| 🎥 Screen + Audio Recording | Capture your full primary monitor with system audio (WASAPI loopback) into a clean H.264 MP4. |
| 📸 Timed Screenshots | Full-screen PNG capture with a configurable countdown timer. Same auto-import path as video. |
| 🚀 One-Click Premiere Import | Recordings and screenshots automatically appear in your Premiere Pro project bin. |
| ⚙️ Configurable Quality | Adjust FPS, CRF, FFmpeg preset, and audio bitrate on the fly via the Settings dialog. |
| ⌨️ Spacebar Toggle | Hit the spacebar to start/stop recording — no mouse needed. |
| 🪶 Lightweight | Pure Python + tkinter. No bloated Electron wrapper. No phantom background processes. |
| 🔒 Clean History | No sensitive files committed. Single-commit repo history ready for public sharing. |
Main Window
|
Settings Dialog
|
Premiere Pro Bin
|
Screenshot Countdown
|
- Windows 10/11
- Python 3.11+
- FFmpeg in your system PATH
- Adobe Premiere Pro (for auto-import feature)
git clone https://github.com/GrimNej/Editing-Buddy.git
cd Editing-Buddy
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt🔗 See the full Installation Guide for step-by-step setup, FFmpeg installation, and desktop shortcut creation.
python runner.pyOr use the Desktop Shortcut (recommended) — a VBScript launcher that starts the app silently without any console windows.
- Launch Editing Buddy.
- Click ⚙️ Settings to set your output folder and preferred quality.
- Click ⏺️ Record (or press Space) to start capturing.
- Click ⏹️ Stop to finish. The MP4 appears in your output folder and in Premiere Pro's Project panel.
🔗 See the Usage Guide for detailed walkthroughs of every feature.
| Layer | Technology |
|---|---|
| Backend | FastAPI + Uvicorn |
| GUI | tkinter (native Windows look) |
| Screen Capture | mss (high-performance, thread-safe) |
| Audio Capture | pyaudiowpatch (WASAPI loopback) |
| Video Encoding | FFmpeg (H.264, hardware-agnostic) |
| Premiere Integration | ExtendScript (JSX) via HTTP bridge |
Editing-Buddy/
├── assets/ # Screenshots & branding images
│ ├── banner.png
│ ├── logo.png
│ ├── screenshot-main.png
│ ├── screenshot-settings.png
│ ├── screenshot-premiere.png
│ └── screenshot-countdown.png
│
├── backend/ # FastAPI server + recording engine
│ ├── main.py # REST API endpoints
│ ├── recorder.py # Screen/audio capture + FFmpeg muxing
│ ├── config.py # Config loader with safe defaults
│ └── __init__.py
│
├── premiere_scripts/ # Adobe ExtendScript (JSX)
│ ├── ImportLastRecording.jsx
│ ├── OpenSettingsDialog.jsx
│ └── host.jsx
│
├── .vscode/ # VS Code workspace settings
│
├── gui_app.py # tkinter GUI application
├── runner.py # Single launcher (backend + GUI)
├── config.json # User settings (created on first run)
│
├── requirements.txt # Python dependencies
├── README.md # ← You are here
├── INSTALLATION_GUIDE.md # Detailed setup instructions
├── USAGE_GUIDE.md # Feature walkthroughs
├── WORKFLOW.md # Developer workflow & architecture
└── AGENTS.md # Agent context for AI contributors
| Document | What's Inside |
|---|---|
| INSTALLATION_GUIDE.md | Prerequisites, FFmpeg setup, virtual environment, desktop shortcut, troubleshooting |
| USAGE_GUIDE.md | Recording, screenshots, settings, Premiere Pro integration, keyboard shortcuts |
| WORKFLOW.md | Architecture overview, file structure, how the backend and GUI communicate, developer tips |
| AGENTS.md | Context and conventions for AI coding assistants working on this project |
| Key | Action |
|---|---|
Space |
Toggle Record / Stop |
Most screen recorders are either too heavy (OBS, heavy NLEs) or too disconnected (Xbox Game Bar, Snipping Tool). Editing Buddy fills the gap: lightweight, fast, and tightly integrated with Premiere Pro — so you can capture reference footage, record tutorials, or grab quick screen grabs without breaking your editing flow.
This project is in active development. If you'd like to contribute:
- Fork the repo
- Create a feature branch (
git checkout -b feature/amazing-thing) - Commit your changes (
git commit -am 'Add amazing thing') - Push to the branch (
git push origin feature/amazing-thing) - Open a Pull Request
Please read WORKFLOW.md for architecture context before making changes.
MIT — see the repository for full license text.
Built with 🎬 for editors, by an editor.