Get started
For: anyone installing Loomarr for the first time. You’ll get: Loomarr running, and one channel of your own playing in your media server’s Live TV guide. It takes about 10 minutes.
Before you start
You need three things running or ready:
- Emby or Jellyfin, with an admin API key.
- A TMDB API key. It’s free: get one from TMDB.
- An LLM that supports tool calling. A local Ollama works, and so does any OpenAI-compatible provider.
You also need Docker, on Linux or on Docker Desktop for macOS.
1. Start Loomarr
Download the release you want to run and start it. This example uses 0.2.0-beta.8; check
Releases for a newer one, and keep the version
you choose pinned.
VERSION=0.2.0-beta.8git clone --branch "v${VERSION}" --depth 1 https://github.com/loomarr/loomarrcd loomarrcp .env.example .envOpen .env and set one value: the address your media server will use to reach Loomarr.
SERVER_PUBLIC_URL=http://192.168.1.10:8080Use your computer’s LAN address, not localhost. Inside Docker, localhost means the
container itself, so your media server couldn’t reach it.
Then start it:
LOOMARR_VERSION="$VERSION" docker compose -f docker/compose.yaml --profile sqlite up -dWhen this prints ready, Loomarr is up:
curl -fsS http://localhost:8080/v1/readyz && echo readyWant Postgres instead of SQLite, or a different port? See Install with Docker.
2. Run the setup wizard
Open the address you set in SERVER_PUBLIC_URL. The wizard walks you through six steps:
- Admin: create your admin account.
- Playout: choose who streams your channels. Keep Loomarr, the default.
- Location: pick the country where you watch. Loomarr uses it for channels and commercials.
- Connections: enter your media server, TMDB and LLM. Each one is tested as you go.
- Users (optional): choose who else can sign in.
- First channel: go on to the next step of this guide.
3. Describe your first channel
Type what you want to watch, as you’d say it to a friend:
90s Saturday morning cartoons for the kids
Loomarr searches your library and TMDB, then shows a proposal: the lineup it would play, and anything you don’t have yet. Every title in it is real. The model can’t invent one.
Choose Approve. That creates the channel.
4. Watch it
Open your media server’s Live TV guide. Your channel appears within a minute. Pick it, and it starts playing.
Loomarr encodes a channel only while someone is watching it, so the first picture takes a few seconds.
Loomarr’s own Guide shows every channel and what’s on now. Pick a channel there, then Watch, to play it in the browser.
What’s next
- Back up before you upgrade: migrations only run forward.
- Add hardware encoding to run more channels at once.
- Add commercials between shows.
- How Loomarr works: channels, proposals and curation.