Skip to content
Loco-CTOPublic

About

No description or website provided.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2,064 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Logo

ZenStream Web

A web client for ZenStream.

Submit Issues · Releases

GitHub Forks GitHub Stars License Github Watchers

How it fits together

ZenStream has one Orchestrator backend and two clients:

Demo screenshots

Home

ZenStream Web home page

Catalog

ZenStream Web catalog

Series details

ZenStream Web series details

Episode details

ZenStream Web episode details

Video player

ZenStream Web video player

Album details

ZenStream Web album details

Configuration

For local development, copy .env.example to .env.local and set ZENSTREAM_ORCHESTRATOR_URL to the Orchestrator address reachable from your browser.

  • ZENSTREAM_ORCHESTRATOR_URL: Runtime URL of the Orchestrator. It may include a path prefix and is read when the web server starts.
  • ZENSTREAM_PORT: Docker host port. It defaults to 9086.
  • ZENSTREAM_IMAGE: Docker image to run. It defaults to ghcr.io/loco-cto/zenstream:latest.

The container exposes the runtime Orchestrator URL to the browser before the app initializes and applies a Content Security Policy restricted to that configured origin. Artwork capability URLs remain direct requests to the Orchestrator.

Quick start

Start the Orchestrator first. Requires Node.js and pnpm.

pnpm install
pnpm dev

Deployment

For Docker Compose deployment, copy .env.example to .env, set ZENSTREAM_ORCHESTRATOR_URL, and start the published image:

docker compose pull
docker compose up -d

The web client is available at http://localhost:9086 by default. Stop it with docker compose down.

To pin a version, set ZENSTREAM_IMAGE=ghcr.io/loco-cto/zenstream:vX.Y.Z. Images are also published by full candidate SHA as ghcr.io/loco-cto/zenstream:sha-<full-commit-sha>.

The Compose file keeps its local source build. Run docker compose up -d --build to build the checked-out source instead of pulling the configured image. Changing the Orchestrator URL does not require rebuilding.

Development checks

pnpm format:check
pnpm lint
pnpm test
pnpm build

Developer documentation

Troubleshooting

  • If the web client cannot reach the Orchestrator, check that ZENSTREAM_ORCHESTRATOR_URL is reachable from the browser and allowed by the Orchestrator's CORS configuration. Restart the container after changing the URL; no image rebuild is needed.
  • For browser or CORS errors, configure the Orchestrator's ZENSTREAM_PUBLIC_WEB_URL or CORS_ORIGINS for the web origin.

Releases

Tagged web releases are available on GitHub Releases.

License

AGPL-3.0-or-later. See LICENSE.

About

No description or website provided.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages