# Connect Emby

Add Emby to Kochab with an API key and default port 8096.

Canonical: https://kochab.io/docs/services/emby/

Emby is a media server. Kochab uses its API (Emby/Jellyfin-compatible token) for session and activity data.

## What Kochab exposes through Emby

- **Activity tab:** now playing streams and server reachability, with pause/resume/stop per session
- **Detail surface:** live stream count and link to Activity
- **Push:** newly added media notifications. Kochab registers the webhook in Emby for you when you add the service

## Not exposed through Emby

Server administration, user management, and finer remote control (skip, volume, cast) stay in Emby's UI. Library tab deep-link targets Sonarr/Radarr, not Emby's own catalog.

## Before you start

In Emby: **Dashboard -> Advanced -> API Keys**. Create a key and copy it.

## Default connection

| Field | Typical value |
|---|---|
| Port | **8096** |
| Scheme | `http` on LAN, `https` behind a reverse proxy |
| Auth | API key sent as `Authorization: MediaBrowser Token=...` |

## Add in Kochab

1. Open **Services -> Add service** and choose **Emby**.
2. Enter your **host**.
3. Set port **8096** unless you use a custom port or proxy.
4. Paste the **API key**.
5. Tap **Test and add**.
6. Choose which libraries Kochab should include when prompted (you can change this later).

## TLS

See [Certificate trust](/docs/cert-trust) for self-signed certificates.

## Official docs

[Emby developer documentation](https://dev.emby.media/)