A distribution built for trust.

Every network boundary is defined, every directory use is explicit, and you can edit it for your requirements.

1

Open Terminal

Press the Start Menu, type cmd or PowerShell, and press Enter.

Open your terminal application.

2

Check Prerequisites

Confirm that Docker and the Compose plugin are installed and active:

docker compose version
Get Docker | Missing Compose?

Docker Desktop for Mac usually includes Compose. If you see "command not found", you can install it via Homebrew: 

brew install docker-compose
Install Compose Plugin
3

Maximize Performance

To get the fastest transcriptions on Apple Silicon, we recommend using Podman. It runs natively and is fully compatible with Docker.

brew install podman

Launch the Application

Paste this into your terminal to download and start in one go:

1. Create a folder (e.g., ~/stream2vids)
2. Save the configuration below as docker-compose.yml inside it.
3. Run command: 

docker compose up -d

App will be live at http://localhost:5000

Keep your tool sharp.

Updating pulls the latest security patches, LLM handlers, and performance fixes.

The Atomic Command

docker compose pull && docker compose up -d
State Safe Docker preserves your database, processed clips, and transcripts automatically by separating application code from your data storage.

Full Deployment Transparency

Review the complete execution recipe below. This is exactly what runs on your machine. No hidden scripts or heavy background services—just clear, containerized code. Feel free to edit to your needs.

Windows Tip: Docker prefers forward slashes (/) in paths to avoid escape character errors.

Ready to launch?

Run this command in your folder to start the stack.

docker compose up -d

Network Accountability

Software Updates stream2vids-850cb8.gitlab.io

Verifies version safety and checks for mission-critical patches.

AI Processing openai.com, anthropic.com...

Communication with your chosen LLM providers for transcript analysis.

Health Monitoring us.i.posthog.com

Anonymized crash reporting that help us fix issues before you even report them.

Why Docker?

Traditional apps scatter files everywhere. **Docker keeps your system clean.** It is verifiable, isolated, and ensures that the app only sees what you explicitly allow.

The Proxy

Powered by Squid

Squid is the industry gold standard for network security. Since 1996, it has been the trusted gatekeeper for high-integrity servers. Official Squid introduction

Proactive Support or Total Privacy - your choice.

By default, we collect anonymized data to improve the software. We strive to find the perfect balance between protecting your privacy and gathering the insights needed to make Stream2Vids better for everyone. If you have any concerns or specific privacy needs, feel free to get in touch.

First Level Support

Allows us to identify issues specific to your setup, resolve them, and notify you as soon as they are fixed.

Complete Anonymity

Prefer a ghost run? No problem. You can run completely anonymous, and your private videos never leave your local host.