đŸ•šī¸ Custom Plugins (beta) - jordanlambrecht/modular-tdarr-flows GitHub Wiki

Introduction

Before you can use these flows, you will need to install a few custom plugins that I've written. There are currently pending pull requests for these plugins in the tdarr-plugins repo, but until they are merged, you will need to create custom plugins in your Tdarr instance manually.

This is a breaking change that was introduced in v2.0.0, so if you are upgrading from a previous version, you will need to create these custom plugins. Do not upgrade your flows if you do not have these plugins installed, as they will not work properly.

Plugin Details

There are three plugins that our flows depend on:

  • jordy_filter_by_audio_codec_and_channels: This plugin filters audio tracks based on both codec and channel count simultaneously, allowing for more granular control over audio streams
  • jordy_Remove_Audio_By_Codec_Channels: This plugin will remove audio tracks from a file based on the codec, channel configuration, and language. It will only remove audio tracks that match the specified codec and channel configuration.\n\nFor example, if you specify 'aac' and '5.1', it will remove all audio tracks that are AAC and have 6 channels
  • jordy_Upmix_Mono_to_Stereo: This plugin converts mono audio tracks to stereo format using a high-quality upmixing algorithm. Mono tracks are unwanted in our flows

Plugin Setup Steps

There are two ways to install the plugins:

1. Via the Tdarr UI (Easier, but less safe)

  1. Navigate to Classic Plugins > Create Plugin > Create Plugin. Nothing will visibly happen
  2. Click on the Local tab. You'll see a blank box. Select the Edit button on that box
  3. A code editor will appear. Copy/Paste the code from the links above. Repeat this for each plugin
  4. Click Save and then Close
  5. Navigate to the Community tab and select Sync Node Plugins

2. Via the plugins folder (Recommended, but more complex)

There's less room for error with this method, but it requires a bit of coding knowledge and access to your server's install location.

  1. Download the plugin files from the links above
  2. Within your Tdarr installation directory, navigate to the server/Tdarr/Plugins/Local/ folder
  3. Either drag/drop the downloaded files or create a new file for each plugin and copy/paste (i.e. jordy_filter_by_audio_codec_and_channels.js, etc.) and paste the corresponding code into each file
  4. Restart your Tdarr server to load the new plugins
  5. Navigate to the Classic Plugins > Community tab and select Sync Node Plugins