lisadma/arr-dl-tracker repository overview

Repository Overview: Sonarr/Radarr Download Tracker Discord Bot

This repository contains the Docker image for a Discord bot designed to track and report the download progress of your media content managed by Sonarr and Radarr. It provides real-time updates directly to your Discord channel, allowing you to monitor your downloads at a glance.

Features:

• Sonarr Integration: Tracks TV show downloads and their progress.
• Radarr Integration: Tracks movie downloads and their progress.
• Discord Notifications: Sends formatted messages to a specified Discord channel, displaying current download statuses, estimated times, and progress bars.
• Automatic Updates: Periodically refreshes download status (configurable interval).
• Configurable: All API keys, IP addresses, ports, Discord channel IDs, and display titles are configurable via environment variables.

How to Use (Docker):

To run this bot, you'll need Docker installed.

1. Pull the Docker Image:

   docker pull lisadma/arr-dl-tracker:latest
   

   Copy

2. Run the Container: You must provide the necessary configuration details as environment variables when running the container. These include your Discord bot token, Discord channel ID, and Sonarr/Radarr API details.

   Example docker run command:

   docker run -d \
     --name sonarr-radarr-tracker-bot \
     -e DISCORD_TOKEN="YOUR_DISCORD_BOT_TOKEN" \
     -e DISCORD_CHANNEL_ID="YOUR_DISCORD_CHANNEL_ID" \
     -e SONARR_IP="YOUR_SONARR_IP" \
     -e SONARR_PORT="YOUR_SONARR_PORT" \
     -e SONARR_API_KEY="YOUR_SONARR_API_KEY" \
     -e SONARR_TITLE="My Sonarr" \
     -e RADARR_IP="YOUR_RADARR_IP" \
     -e RADARR_PORT="YOUR_RADARR_PORT" \
     -e RADARR_API_KEY="YOUR_RADARR_API_KEY" \
     -e RADARR_TITLE="My Radarr" \
     -e TIME_NUMERIC=15 \
     -e TIME_FORMAT=minutes \
     lisadma/arr-dl-tracker:latest
   

   Copy

   Note: Replace all placeholder values (e.g., YOUR_DISCORD_BOT_TOKEN) with your actual configuration. Ensure string values with spaces are enclosed in double quotes.

3. Verify (Optional): To check if the bot is running and view its logs:

   docker logs sonarr-radarr-tracker-bot
   

   Copy

Configuration Environment Variables:

The following environment variables are required for the bot to function correctly:

• DISCORD_TOKEN: Your Discord bot's authentication token.
• DISCORD_CHANNEL_ID: The Discord channel ID where the bot will post updates.
• SONARR_IP: IP address or hostname of your Sonarr instance.
• SONARR_PORT: Port number for your Sonarr instance.
• SONARR_API_KEY: API key for your Sonarr instance.
• SONARR_TITLE (Optional, Default: "Sonarr"): Title to display for Sonarr updates.
• RADARR_IP: IP address or hostname of your Radarr instance.
• RADARR_PORT: Port number for your Radarr instance.
• RADARR_API_KEY: API key for your Radarr instance.
• RADARR_TITLE (Optional, Default: "Radarr"): Title to display for Radarr updates.
• TIME_NUMERIC (Optional, Default: 15): Numeric value for the update interval.
• TIME_FORMAT (Optional, Default: "minutes"): Unit for the update interval (seconds, minutes, hours).

Development / Contribution:

If you wish to contribute or modify the bot, please refer to the GitHub repository⁠ for the source code and development instructions.

⁠Credit to DinoHorvat96⁠