Website GitHub

What is it?

What it is

FreeFrame is a self‑hostable, open‑source media review platform that offers frame‑accurate commenting, annotations, and approval workflows for video, image, and audio assets. It serves as a collaborative alternative to commercial services like Frame.io, keeping all media and data on the user’s own infrastructure.

Why it exists

The platform was created to give production houses and creative teams a secure, on‑premises solution for reviewing media. It eliminates reliance on third‑party cloud services, provides granular control over permissions and sharing, and integrates tightly with NLEs by exporting comments as timeline markers. FreeFrame fills the gap for teams that need a feature‑rich, cost‑effective, and privacy‑preserving review workflow.

Who should use it

Production housesCreative teamsVideo editorsPost-production studiosMedia agenciesContent creators

Who should avoid it

Users requiring SaaS-only solutions (this is self-hosted)Users without Docker knowledge (for deployment)Individuals looking for a simple file storage solution without review tools

How it works

A quick walkthrough in plain English

How freeframe works

Step 1 of 3

You interact with it

Open freeframe, send a request, or connect it to your stack.

Features

Video review with HLS adaptive streaming and frame‑accurate timecoded comments
Export comments to NLE (DaVinci Resolve, Final Cut Pro, Premiere Pro, CSV)
Image and audio review with annotations and waveform visualization
Drawing annotations on any frame using canvas tools
Threaded comments with mentions, reactions, and attachments
Approval workflows with per‑reviewer status tracking
Version compare – side‑by‑side or wipe slider with per‑version comments
Folder organization within projects
Team collaboration with role‑based permissions (org, team, project levels)
Share links for external reviewers (password‑protected, expiring)
Guest commenting via share links (no account required)
Due date tracking with email reminders
Real‑time updates via Server‑Sent Events
Self‑hosted with Docker Compose – runs on any server or cloud VM

Advantages

  • Open source (MIT)
  • Active TypeScript ecosystem
  • Self-hosted deployment options

Disadvantages

  • Requires operational ownership for self-hosted setups
  • Community support varies by project maturity

Installation

docker

git clone -b stable https://github.com/Techiebutler/freeframe.git
cd freeframe
cp.env.example.env.prod
# Edit.env.prod — set your credentials, S3, email config
# For SSL: also set DOMAIN and ACME_EMAIL (Traefik auto-provisions Let's Encrypt certs)
docker compose --env-file.env.prod -f docker-compose.prod.yml up -d --build

compose

git clone -b stable https://github.com/Techiebutler/freeframe.git
cd freeframe
cp.env.example.env.prod
# Edit.env.prod — set your credentials, S3, email config
# For SSL: also set DOMAIN and ACME_EMAIL (Traefik auto-provisions Let's Encrypt certs)
docker compose --env-file.env.prod -f docker-compose.prod.yml up -d --build

FAQ

What is freeframe?

freeframe is an open-source project licensed under MIT.

What language is freeframe built with?

Primary language: TypeScript.

Is it free to use?

Yes. Licensed under MIT. Check the license for commercial use.

Loading documentation…
View on GitHub

Featured in Videos

YouTube tutorials and walkthroughs for FreeFrame

Alternatives

Similar projects ranked by category, topics, and text overlap.

Compare
FreeFrame | MushyBook