TRaSH Guides

https://trash-guides.info
Admin
TRaSH Guides provides comprehensive documentation and setup guides primarily for media management...
Tokens:477,748
Snippets:2,140
Trust Score:9.1
Update:1 week ago
Show doc for...
Tokens:
Raw
### Install qbittorrent-api via User Script

Source: https://trash-guides.info/Downloaders/qBittorrent/Tips/How-to-run-the-unRaid-mover-for-qBittorrent

User Script to install qbittorrent-api when the Array starts for the first time. Add this script in unRAID's User Scripts plugin and schedule it to run at 'At First Array Start Only'.

```bash
#!/bin/bash
pip3 install qbittorrent-api

```

--------------------------------

### Install qbittorrent-api via go file

Source: https://trash-guides.info/Downloaders/qBittorrent/Tips/How-to-run-the-unRaid-mover-for-qBittorrent

Command to add to the unRAID 'go' file to install qbittorrent-api when the server starts. Place this line in /boot/config/go and restart or run it manually.

```bash
pip3 install qbittorrent-api

```

--------------------------------

### Create Python venv and install qbittorrent-api

Source: https://trash-guides.info/Downloaders/qBittorrent/Tips/How-to-run-the-unRaid-mover-for-qBittorrent

Creates a Python virtual environment and installs the qbittorrent-api module. Run the first command to create the environment, then the second to activate it, install the dependency, and deactivate. Replace the path with your chosen location.

```bash
python3 -m venv --clear /mnt/user/appdata/scripts/.venv

```

```bash
source /mnt/user/appdata/scripts/.venv/bin/activate
pip3 install qbittorrent-api
deactivate # to exit the environment

```

--------------------------------

### Install fclones Binary Function

Source: https://trash-guides.info/Downloaders/qBittorrent/Tips/How-to-run-the-unRaid-mover-for-qBittorrent

Automates the installation or update of the fclones binary by checking for existing versions and fetching the latest release from GitHub.

```bash
install_fclones_binary() {
    log "Installing/updating fclones binary..."

    # fclones configuration
    local FCLONES_BIN="/usr/local/bin/fclones"
    local BOOT_DIR="/boot/config/plugins/fclones/usr/bin"
    local GO_FILE="/boot/config/go"
    local DEFAULT_VERSION="0.35.0"

    # Current installed version
    local CURRENT_VERSION=""
    if [[ -x "$FCLONES_BIN" ]]; then
        CURRENT_VERSION=$($FCLONES_BIN --version 2>/dev/null | awk '{print $2}') || true
        log "✓ Found fclones version $CURRENT_VERSION"
    else
        log "✗ fclones not found"
    fi

    # Check for curl or wget
    local GITHUB_API_CMD
    if command -v curl >/dev/null 2>&1; then
        GITHUB_API_CMD="curl -s https://api.github.com/repos/pkolaczk/fclones/releases/latest"
    elif command -v wget >/dev/null 2>&1; then
        GITHUB_API_CMD="wget -qO- https://api.github.com/repos/pkolaczk/fclones/releases/latest"
    else
        log "✗ Neither curl nor wget is available (continuing anyway)"
        return 0
    fi
```

--------------------------------

### Install requests module with User Scripts (deluge-mover)

Source: https://trash-guides.info/Downloaders/Deluge/Tips/Unraid-Mover

Use this bash script in an unRAID User Script to install the requests Python module when the Array starts for the first time. The script runs pip3 install requests. Configure the script to run at 'At First Array Start Only' and then run it in the background or restart the server.

```bash
#!/bin/bash
pip3 install requests

```

--------------------------------

### Installation Instructions for replace_for.py

Source: https://trash-guides.info/Downloaders/SABnzbd/scripts

Steps to install the script: copy to SABnzbd's script folder, make executable with chmod, convert line endings with dos2unix, and assign the script to required categories in SABnzbd settings.

```bash
1. Copy script to SABnzbd's script folder
2. Run: `sudo chmod +x replace_for.py`
3. Run: `dos2unix replace_for.py`
4. In SABnzbd go to `Settings` => `Categories`
5. Change script for required categories and select: `replace_for.py`

```

--------------------------------

### Docker Compose Example for Radarr and Sonarr

Source: https://trash-guides.info/File-and-Folder-Structure/How-to-set-up/Docker

A docker-compose example based on a default Ubuntu install. The storage location used for the host is the same as in the container to make it easier to understand in this case `/data`. The appdata (`/config`) will be stored on the host in the `/docker/appdata/{appname}`.

```yaml
version: "3.2"
services:
  radarr:
    container_name: radarr
    hostname: radarr.internal
    image: ghcr.io/hotio/radarr:latest
    restart: unless-stopped
    logging:
      driver: json-file
    ports:
      - 7878:7878
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Amsterdam
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - /docker/appdata/radarr:/config
      - /data:/data
  sonarr:
    container_name: sonarr
    hostname: sonarr.internal
    image: ghcr.io/hotio/sonarr:latest
    restart: unless-stopped
    logging:
      driver: json-file
    ports:
      - 8989:8989
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Amsterdam
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - /docker/appdata/radarr:/config
      - /data:/data
```json
{
  
```

--------------------------------

### Process qBittorrent instance with process_qbit_instance

Source: https://trash-guides.info/Downloaders/qBittorrent/Tips/How-to-run-the-unRaid-mover-for-qBittorrent

Processes a single qBittorrent instance by selecting the Python interpreter with qbittorrentapi and building mover arguments. Uses API key if provided, otherwise username/password; adds CA bundle if set.

```bash
process_qbit_instance() {
    local name="$1" host="$2" user="$3" password="$4" api_key="${5:-}" ca_bundle="${6:-}"

    log "Processing $name..."

    # Determine Python command
    local python_cmd
    if [[ -x "${VENV_PATH}/bin/python3" ]] && "${VENV_PATH}/bin/python3" -c "import qbittorrentapi" 2>/dev/null; then
        python_cmd="${VENV_PATH}/bin/python3"
        log "✓ Using virtual environment"
    elif python3 -c "import qbittorrentapi" 2>/dev/null; then
        python_cmd="python3"
        log "✓ Using system Python"
    else
        log "✗ qbittorrent-api not found for $name"
        return 1
    fi

    local mover_args=(
        --pause
        --host "$host"
        --cache-mount "$CACHE_MOUNT"
        --days_from "$DAYS_FROM"
        --days_to "$DAYS_TO"
    )

    if [[ -n "$api_key" ]]; then
        mover_args+=(--api-key "$api_key")
    else
        mover_args+=(--user "$user" --password "$password")
    fi

    if [[ -n "$ca_bundle" ]]; then
        mover_args+=(--ca-bundle "$ca_bundle")
    fi
}
```

--------------------------------

### Sonarr Remux + WEB 1080p Configuration

Source: https://trash-guides.info/Recyclarr/recyclarr-configs

Configuration for the TRaSH Guides Remux + WEB 1080p setup. It sets the base URL and API key for Sonarr, defines the quality definition type as series, and specifies the quality profile with the trash_id for Remux + WEB 1080p. The reset_unmatched_scores field is left empty, likely to be filled by the user.

```yaml
# yaml-language-server: $schema=https://schemas.recyclarr.dev/v8/config-schema.json  
################################################################################  
## TRaSH Guides: Remux + WEB 1080p  
################################################################################  

sonarr:  
  sonarr-remux-web-1080p:  
    base_url: Put your Sonarr URL here  
    api_key: Put your API key here  

    quality_definition:  
      type: series  

    quality_profiles:  
      - trash_id: fe9470e577c300a5ad9a3274f6d1cdf2  # Remux + WEB 1080p  
        reset_unmatched_scores:  
```

--------------------------------

### Create usenet folder structure with mkdir

Source: https://trash-guides.info/File-and-Folder-Structure/How-to-set-up/Synology

Creates the folder structure for a usenet-based download setup under /volume1/data, including incomplete and complete subfolders for tv, movies, and music, plus a media folder with the same subfolders. Run this if you use usenet.

```bash
mkdir -p /volume1/data/{usenet/{incomplete,complete}/{tv,movies,music},media/{tv,movies,music}}
```

--------------------------------

### Mover Tuning script: prepare virtual environment for qBittorrent mover

Source: https://trash-guides.info/Downloaders/qBittorrent/Tips/How-to-run-the-unRaid-mover-for-qBittorrent

This script checks the virtual environment Python, ensures pip is available, upgrades pip, and installs or upgrades qbittorrent-api. It includes fallback logic for missing pip and handles dry-run checks for pip >= 22.2. Use this as part of the unRaid mover setup for qBittorrent.

```bash
# Check if Python is available in the virtual environment
    local venv_python="${VENV_PATH}/bin/python3"
    [[ -x "$venv_python" ]] || error "Virtual environment Python is missing or not executable: $venv_python"

    log "Checking pip version..."
    # Ensure pip exists inside the virtual environment
    if ! "$venv_python" -m pip --version >/dev/null 2>&1; then
        log "⚠ pip not found in virtual environment; attempting to bootstrap with ensurepip..."
        if ! "$venv_python" -m ensurepip --upgrade; then
            if python3 -c "import qbittorrentapi" 2>/dev/null; then
                log "⚠ Warning: Failed to bootstrap pip in virtual environment; system Python has qbittorrent-api, continuing"
            else
                error "Failed to bootstrap pip in virtual environment and qbittorrent-api is not available in system Python"
            fi
        fi
    fi

    if "$venv_python" -m pip --version >/dev/null 2>&1; then
        # Upgrade pip. No --dry-run pre-check here: --dry-run itself was only
        # added in pip 22.2, so on an outdated pip the check fails silently
        # and the script would never be able to bootstrap its way to a
        # version that supports the flag. pip install --upgrade is idempotent,
        # so just always run it.
        log "Upgrading pip..."
        if "$venv_python" -m pip install --upgrade pip --quiet; then
            set_ownership "$VENV_PATH"
        else
            log "⚠ Warning: Failed to upgrade pip; continuing with existing version"
        fi

        # A successful upgrade command does NOT guarantee pip is now >= 22.2:
        # it exits 0 even when no newer pip was available (old interpreter,
        # pinned/private index, version constraints). Check the resulting
        # version explicitly rather than trusting the upgrade's exit status.
        local pip_version supports_dry_run lowest
        pip_version=$("$venv_python" -m pip --version 2>/dev/null | awk '{print $2}')
        supports_dry_run=false
        if [[ -n "$pip_version" ]]; then
            lowest=$(printf '%s\n' "$pip_version" "22.2" | sort -V | head -n1)
            [[ "$lowest" == "22.2" ]] && supports_dry_run=true
        fi
        log "✓ Pip is $pip_version"

        # Install/upgrade qbittorrent-api using the same Python that will run mover.py.
        # Only use the --dry-run pre-check when pip is confirmed >= 22.2. Even
        # then, capture the dry-run command's own exit status separately from
        # the grep match — a dry-run failure (e.g. index timeout) must not be
        # misread as "nothing to upgrade". Any doubt falls back to the actual
        # (idempotent, cheap-when-current) upgrade instead of skipping it.
        if "$venv_python" -c "import qbittorrentapi" 2>/dev/null; then
            log "✓ qbittorrent-api installed ($("$venv_python" -m pip show qbittorrent-api 2>/dev/null | awk '/Version:/ {print $2}'))"

            local api_upgrade_needed=true dry_run_output dry_run_status=0
            if [[ "$supports_dry_run" == true ]]; then
                dry_run_output=$("$venv_python" -m pip install --dry-run --upgrade qbittorrent-api 2>&1) || dry_run_status=$?
                if [[ $dry_run_status -eq 0 ]]; then
                    if echo "$dry_run_output" | grep -q "Would install"; then
                        api_upgrade_needed=true
                    else
                        api_upgrade_needed=false
                        log "✓ qbittorrent-api is up to date"
                    fi
                else
                    log "⚠ Warning: dry-run check failed — upgrading anyway to be safe"
                fi
            fi

            if [[ "$api_upgrade_needed" == true ]]; then
                log "Ensuring qbittorrent-api is up to date..."
                "$venv_python" -m pip install qbittorrent-api --upgrade --quiet || log "⚠ Warning: Failed to upgrade qbittorrent-api"
                set_ownership "$VENV_PATH"
            fi
        else
            log "Installing qbittorrent-api..."
            "$venv_python" -m pip install qbittorrent-api --quiet || error "Failed to install qbittorrent-api"
            set_ownership "$VENV_PATH"

            # Verify install with the same interpreter used by mover.py.
            "$venv_python" -c "import qbittorrentapi" 2>/dev/null || error "qbittorrent-api installed, but cannot be imported by venv Python"

            log "✓ qbittorrent-api installed"
        fi
    else
        log "⚠ Skipping virtual environment package setup because pip is unavailable"
    fi
```

--------------------------------

### Install Deluge via pip3

Source: https://trash-guides.info/Downloaders/Deluge/Installing

Install Deluge using pip3, which is included in the Python package. This method installs the latest version from PyPI.

```bash
pip3 install deluge

```
Tokens:
Raw