OpenCut
OpenCut is an open-source video editing and audio processing platform.
Prerequisites
- Visit FreeSound.org and create an account
- Create an API application in your account settings
- Get your client ID and API key
Initialization
-
Copy the example environment file:
cp .env.example .env -
Configure the required environment variables (especially FreeSound API configuration)
-
Start the service:
docker compose up -d -
Access the web interface at http://localhost:3100
Services
opencut: The OpenCut web application.postgres: The PostgreSQL database.redis: The Redis cache.
Configuration
- Web Application: Port 3100
- PostgreSQL Database: Port 5432
- Redis Cache: Port 6379
- Redis HTTP Service: Port 8079
| Variable | Description | Required |
|---|---|---|
FREESOUND_CLIENT_ID |
FreeSound client ID | Yes |
FREESOUND_API_KEY |
FreeSound API key | Yes |
CLOUDFLARE_ACCOUNT_ID |
Cloudflare account ID | No* |
R2_ACCESS_KEY_ID |
R2 access key ID | No* |
R2_SECRET_ACCESS_KEY |
R2 secret key | No* |
R2_BUCKET_NAME |
R2 bucket name | No* |
MODAL_TRANSCRIPTION_URL |
Modal transcription service URL | No* |
*Required for transcription features. Leave blank if auto-captioning is not needed.
4. Add these values to your .env file
Data Persistence
- PostgreSQL data is stored in the
postgres_datavolume - Redis data is in-memory and will be lost on restart
Security Notes
- Change the default database password in production
- Update
BETTER_AUTH_SECRETto a secure random string - Consider setting up a reverse proxy for external access
Reference
License
Please refer to the official OpenCut project for license information.