# binhex-trimarr

binhex-trimarr is a self-hosted media applications app. trimarr is a Docker container that removes (trims) unwanted audio and subtitles from Matroska container format video files using mkvmerge. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2201/binhex-trimarr

## Description

trimarr is a Docker container that removes (trims) unwanted audio and subtitles from Matroska container format video files using mkvmerge. Features recursive scanning, smart skip via SQLite tracking, commentary track safety, multi-language support, auto-managed mkvmerge binary, and space savings reporting. Supports one-shot or cron-scheduled operation.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

50/100 (Fair), based on 3 of 4 factors.
- Maintained: 82 (last commit 9 days ago)
- Popular: 10 (2 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/binhex/arch-trimarr
- GitHub: https://github.com/binhex/arch-trimarr
- Unraid: https://ca.unraid.net/apps/binhex-trimarr-1stq2dr0zn3tpf?q=binhex-trimarr

## Common questions

### Where should I store trimarr's database and logs?

Store them under the /config volume; by default the SQLite database is /config/trimarr/trimarr.db and the log is /config/trimarr/trimarr.log. Back up that config directory to preserve processed-file tracking.

### How can I run trimarr on a schedule instead of only once?

Set TRIMARR_SCHEDULE to a cron expression, such as 0 2 * * *, and use TRIMARR_RUN_ON_START=yes if you also want it to run when the container starts. TRIMARR_DRY_RUN=yes can be used for a test pass.

### How do I tell trimarr which folders and language tracks to process?

Set TRIMARR_MEDIA_PATH to container paths, using pipe-separated values for multiple directories. Set TRIMARR_LANGUAGE to the audio/subtitle language tracks you want to keep.

### What should I do if container-created files have permission problems?

Set PUID and PGID to the user and group IDs you want trimarr to run as. You can find those IDs on the host with the id command.

### Can I strip only specific subtitle tracks?

Set TRIMARR_STRIP_SUBTITLE_REGEX to a regular expression that matches the subtitles you want removed. For example, the notes show a case-insensitive pattern targeting song and signs subtitles.

### How do I keep native or undefined audio tracks?

Set TRIMARR_KEEP_NATIVE_AUDIO=yes to keep native audio tracks. Set TRIMARR_KEEP_UNDEFINED_AUDIO=yes to keep undefined audio tracks.

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