# CouchElephant

CouchElephant is a companion tool for Plex DVR that reads the same TV guide, picks the live broadcast itself, and pins the recording to that exact channel and start time so Plex has nothing left to choose. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2380/couchelephant

## Description

CouchElephant is a companion tool for Plex DVR that reads the same TV guide, picks the live broadcast itself, and pins the recording to that exact channel and start time so Plex has nothing left to choose. It sits beside Plex rather than replacing it, and recordings land in your Plex library exactly as they always did. It also adds recording passes Plex has no equivalent for: follow any of 1,300 professional and college teams to record every game they play, or build a smart filter from nested AND, OR and NOT conditions over genre, rating, channel, and time. Every standard Plex recording option, padding included, is on every pass, and a new sports pass arrives with sensible padding already filled in.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

48/100 (Fair), based on 3 of 4 factors.
- Maintained: 85 (last commit 46 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/datbird/couchelephant
- GitHub: https://github.com/datbird/couchelephant
- Unraid: https://ca.unraid.net/apps/couchelephant-1i6gc5y0zub8ea?q=CouchElephant

## Common questions

### Which container registry should I prefer for CouchElephant?

Use the GHCR image when you can. The same image is also available on Docker Hub, but Docker Hub allows only 100 anonymous pulls per address per six hours and that count is shared by everyone behind your router.

### Can I deploy CouchElephant with Docker Compose?

Yes, the repository includes a docker-compose.yml if you prefer to use that. The same image is also available on Docker Hub.

### Does CouchElephant replace Plex?

No, it sits beside Plex rather than replacing it. Recordings land in your Plex library exactly as they always did.

### Can it record every game for the teams I follow?

Yes, you can follow professional and college teams and have it record every game they play. It also supports smart filters with nested AND, OR, and NOT conditions over fields such as genre, rating, channel, and time.

---
Source: Our Local Host (https://ourlocalhost.com/app/2380/couchelephant), the self-hosted and open-source app directory.
