Documentation Index
Fetch the complete documentation index at: https://docs.blindcast.dev/llms.txt
Use this file to discover all available pages before exploring further.
The BlindCast CLI handles the server-side workflow: generate keys, encrypt video, upload to storage, and run a local key server for development. One tool, five subcommands.
Install
npm install -g @blindcast/cli
npx @blindcast/cli <command>
Subcommands
| Command | What it does |
|---|
blindcast init | Create a sample project with HLS segments and a player page |
blindcast keygen | Generate a master key and salt |
blindcast encrypt | Encrypt HLS segments and rewrite the manifest |
blindcast upload | Upload encrypted segments to S3 |
blindcast serve | Start a local development key server |
Environment variables
All subcommands accept keys via flags or environment variables. Set these in a .env file or export them in your shell:
| Variable | Used by | Description |
|---|
BLINDCAST_MASTER_KEY | encrypt, serve | Master key as hex string (from keygen) |
BLINDCAST_SALT | encrypt, serve | Salt as hex string (from keygen) |
AWS_ACCESS_KEY_ID | upload | AWS credentials (standard SDK chain) |
AWS_SECRET_ACCESS_KEY | upload | AWS credentials (standard SDK chain) |
AWS_REGION | upload | AWS region (default: us-east-1) |
Error handling
The CLI uses Unix exit codes:
| Exit code | Meaning |
|---|
0 | Success |
1 | User error (invalid flags, missing input, bad config) |
2 | Runtime error (encryption failed, upload failed, network error) |
--json to any subcommand for machine-readable JSON errors on stderr.
Quick start
See the Quick Start for a complete walkthrough: init, keygen, encrypt, serve, and play — all in ~10 minutes.
