Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/TheCatLady/dockermod-strip-tracks
Docker Mod to strip unwanted tracks from media files upon import to Radarr or Sonarr (compatible with linuxserver/radarr and linuxserver/sonarr) ✂️
https://github.com/TheCatLady/dockermod-strip-tracks
docker docker-mod dockermod mkvmerge mkvtoolnix mod radarr sonarr strip-tracks
Last synced: 10 days ago
JSON representation
Docker Mod to strip unwanted tracks from media files upon import to Radarr or Sonarr (compatible with linuxserver/radarr and linuxserver/sonarr) ✂️
- Host: GitHub
- URL: https://github.com/TheCatLady/dockermod-strip-tracks
- Owner: TheCatLady
- License: mit
- Created: 2021-03-15T04:58:30.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-09-13T04:46:56.000Z (about 1 year ago)
- Last Synced: 2024-10-31T21:03:14.440Z (13 days ago)
- Topics: docker, docker-mod, dockermod, mkvmerge, mkvtoolnix, mod, radarr, sonarr, strip-tracks
- Language: Python
- Homepage: https://hub.docker.com/r/thecatlady/dockermod-strip-tracks
- Size: 44.9 KB
- Stars: 15
- Watchers: 2
- Forks: 1
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# `dockermod-strip-tracks` ✂️
[](https://hub.docker.com/r/thecatlady/dockermod-strip-tracks)
[](https://github.com/TheCatLady/dockermod-strip-tracks)
[](https://github.com/TheCatLady/dockermod-strip-tracks)
[](https://github.com/TheCatLady/dockermod-strip-tracks)
[](https://lgtm.com/projects/g/TheCatLady/dockermod-strip-tracks/)
[](https://github.com/sponsors/TheCatLady)
[Docker Mod](https://github.com/linuxserver/docker-mods) to strip unwanted tracks from media files upon import to Radarr or Sonarr (compatible with [`linuxserver/radarr`](https://github.com/linuxserver/docker-radarr) and [`linuxserver/sonarr`](https://github.com/linuxserver/docker-sonarr))
Also fetches [hotio](https://github.com/hotio)'s _awesome_ [Arr Discord Notifier script](https://github.com/hotio/arr-discord-notifier) for pretty Discord notifications! ✨
## Behavior
This [Docker Mod](https://github.com/linuxserver/docker-mods) was created for my own personal use, but it is still somewhat configurable to suit your own personal preferences. 🐱
### Initialization
On each container start, the `strip-tracks-init.sh` script will:
1. Fetch, `chmod`, and `chown` [hotio](https://github.com/hotio)'s [Arr Discord Notifier](https://github.com/hotio/arr-discord-notifier) script (have I mentioned yet that it is awesome?)
2. Install [MKVToolNix](https://mkvtoolnix.download/)
3. Install required Python dependencies for, `chmod`, and `chown` the `strip-tracks.py` script
### Media Processing
When added for the **On Import** and/or **On Upgrade** triggers in Radarr and/or Sonarr, the `strip-tracks.py` script will:
1. Query [The Movie Database (TMDb)](https://www.themoviedb.org/) to determine the original language of the movie or TV show
2. Use [`mkvmerge`](https://mkvtoolnix.download/doc/mkvmerge.html) to remove unwanted tracks from the video file, keeping only:
- the first video track
- the first audio track matching the original language which does not contain any excluded keywords
- any subtitle tracks matching a provided [ISO 639-2 language code](https://www.loc.gov/standards/iso639-2/php/code_list.php) which do not contain any excluded keywords
(If there is not at least one video track and one audio track based on this logic, the file will not be modified.)
3. Call the Radarr/Sonarr `command` API endpoint to refresh the movie or TV show
4. Run [hotio](https://github.com/hotio)'s super awesome [Arr Discord Notifier](https://github.com/hotio/arr-discord-notifier) script if the `DISCORD_WEBHOOK` environment variable was configured
## Usage
This [Docker Mod](https://github.com/linuxserver/docker-mods) is configured by defining the following environment variables for your [`linuxserver/radarr`](https://github.com/linuxserver/docker-radarr) and/or [`linuxserver/sonarr`](https://github.com/linuxserver/docker-sonarr) containers:
| Parameter | Function | Required? |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
| `DOCKER_MODS` | `thecatlady/dockermod-strip-tracks` (or `ghcr.io/thecatlady/dockermod-strip-tracks`) | yes |
| `TMDB_API_KEY` | Your TMDb API key | yes |
| `SUBTITLE_LANGUAGES` | Comma-delimited list of [ISO 639-2 language codes](https://www.loc.gov/standards/iso639-2/php/code_list.php) for which subtitle tracks should be kept (if not specified, no subtitles will be kept) | no |
| `EXCLUDED_KEYWORDS` | Comma-delimited list of keywords for which subtitle tracks should be excluded | no |
Please refer to [hotio](https://github.com/hotio)'s [Arr Discord Notifier](https://hotio.dev/arr-discord-notifier/) documentation for details on how to configure and customize the pretty Discord notifications.
Then, simply add a **Custom Script** connection in Radarr and/or Sonarr in **Settings → Connect**. Enter `/usr/local/bin/strip-tracks.py` for the path, select the **On Import** and/or **On Upgrade** triggers, and you're all set!
Note that you should _not_ add [hotio](https://github.com/hotio)'s [Arr Discord Notifier](https://hotio.dev/arr-discord-notifier/) script as a separate connection, since `strip-tracks.py` will execute it for you after it has finished processing the media file.
## How to Contribute
Show your support by starring this project! 🌟 Pull requests, bug reports, and feature requests are also welcome!
You can also support me by [becoming a GitHub sponsor](https://github.com/sponsors/TheCatLady) or [making a one-time donation](https://github.com/sponsors/TheCatLady?frequency=one-time) 💖
Additionally, don't forget to show your support for both [hotio](https://github.com/hotio) and the wonderful folks over at [LinuxServer.io](https://github.com/linuxserver)!