KROMA

Your next movie starts here

Get KROMA.

Your personal cinema. On every screen.

KROMA for macOS

Desktop app · Automatic updates

Free and open source.

Download for Apple silicon.dmg · 50.4 MB

Intel · No build in this channel yet.

Installation help

Choose Apple silicon for M1 or newer, or Intel for older Macs. Check Apple menu → About This Mac. Open the DMG and drag KROMA into Applications.

Detailed steps →
v0.1.38Release notes

Open the app and connect to your KROMA server.

Every build
First time here? Set up your server.Your server holds your library. Install it once with Docker or on your NAS.

Docker / Docker Compose

Recommended

The image is multi-architecture (linux/amd64 + linux/arm64) : it runs just as well on x86 as on a Raspberry Pi 4/5 with a 64-bit OS. Save this file, then bring the stack up.

A released version

ghcr.io/kromatv/kroma:0.1.38

The image built for that release tag. It never changes under you.

Canary

ghcr.io/kromatv/kroma:latest

Rebuilt on every push to main, so a pull gets the current state of the code. Public, multi-architecture, no token.

docker-compose.yml
services:
  kroma:
    image: ghcr.io/kromatv/kroma:latest
    restart: unless-stopped
    ports:
      - "4040:4040"
    environment:
      # Library roots INSIDE the container (must match the bind-mount below).
      KROMA_MEDIA_DIRS: /media
    volumes:
      - kroma-data:/data
      - /volume1/video:/media
volumes:
  kroma-data:
bash
docker compose up -d

MediaKROMA_MEDIA_DIRS points at your media inside the container; mount the folder read-write if you use the built-in requests / downloads.

Synology (.spk)

The package is self-signed, not Synology-certified: you have to allow it once.

  1. 1Package Center → Settings → Trust Level : allow Any publisher.
  2. 2Package Center → Manual Install, pick the .spk, follow the wizard.
  3. 3Open KROMA; configure the media folders in its admin console.

From source (cargo)

A single Rust binary: build it yourself. SQLite and TLS are bundled; ffmpeg/ffprobe are still required for metadata and HLS audio.

bash
# Rust ≥ 1.86 + ffprobe. From the repo:
cd server
KROMA_MEDIA_DIRS=/mnt/media cargo run --release
Server options (server/README) →

Need a hand getting started?

Installation guideTV demoNeed help?