Informrr

(name suggested by u/DaJorsh on Reddit)

A simple aggregator for notification from Sonarr, Radarr and Lidarr.

(Theme song: Informer by Snow - Youtube Link)

What can it do:

• Configurable pause (in hours)
• Customizable movie, episode and song entries
• Notification to Telegram
• Notification to Discord

Screenshots

Logs	Telegram	Discord

(click on screenshot to enlarge)

Install with Docker

I mainly chose to create this to be used with Docker.

Made with the wonderful lsiobase/alpine as a base image.

You can find the image on Docker Hub here

1. Here's the docker run command needed to start it up:

   docker run -d \
     --name notificator \
     --restart=always \
     -e PGID=1000 -e PUID=1000 \
     -p 5445:5445 \
     -v /some/folder/to/store/your/data:/data \
   bonny1992/informrr:latest

   At the first run it will create the database and the config needed in the folder /data (I suggest you to mount it as a volume in the docker run command). Plus, at the very first start, it will generate a random string which you will need to access the "notificator webhook".

2. Then, I suggest you to stop the container so you can start editing the config.yml file needed.

   docker stop notificator 

   You can find it in your chosen folder during the container run (/some/folder/to/store/your/data).

   The config.yml explaination can be found later.

3. Now you can start the container again:

   docker start notificator

4. That's it, you can configure the webhook in Sonarr and Radarr with the url you will find in the /some/folder/to/store/your/data folder in the file url.txt, in the Connect tab under Settings, as On Import and On Upgrade.

Config file

Custom TV entry keys

Let's say we write a custom entry like this:

{TIME} - {SERIES} S{SEASON}E{EPISODE} - {TITLE} - {QUALITY}

Using the same examples as above, we get:

08:30 - Lucifer S01E02 - Lucifer, Stay. Good Devil. - HDTV-1080

You can also customize it with Markdown syntax (please refer to Telegram and Discord documentation).

Custom movie entry keys

Let's say we write a custom entry like this:

{TIME} - {TITLE} ({YEAR}) - {QUALITY} - {IMDB_LINK}

Using the same examples as above, we get:

08:30 - The Godfather (1972) - Blueray-1008p - [IMDB Link](https://www.imdb.com/title/tt0068646/)

Which, will result like this, in Telegram and Discord:

08:30 - The Godfather (1972) - Blueray-1008p - IMDB Link

You can also customize it with Markdown syntax (please refer to Telegram and Discord documentation).

Custom track entry keys

| {QUALITY} | Quality of the track. | FLAC | | {TIME} | Time (hh:mm) of the received notification | 08:30 |

Let's say we write a custom entry like this:

{TIME} - {ARTIST} - {TRACK_NUMBER} - {TITLE} | {QUALITY}

Using the same examples as above, we get:

08:30 - Red Hot Chili Peppers - A1 - Around the World - FLAC

You can also customize it with Markdown syntax (please refer to Telegram and Discord documentation).

Install without Dockerfile

You can, however, install this without the use of Docker (though I did not test it, also I'm not an expert).

Prerequisites

I'm assuming you will use Linux - I used Fedora Remix on Windows' WSL

• Python 3 (I used 3.8 but I believe any recent version of 3 would work)
• Pip
• Knowledge with systemd or
• Tmux or similar software
• Some way to reverse proxy it, I personally use nginx-proxy with Letsencrypt on Docker, but you could use Caddy or whatever you want.

Steps

1. Clone this repository

   git clone https://github.com/bonny1992/informrr.git ~/notificator

2. Go into the repository folder and in the /app folder

   cd ~/notificator/app

3. Install dependencies

   pip install -r requirements.txt

4. Edit this line in ~/notificator/app/utils/__init__.py file:

   DATA_PATH = '/data'

   with whatever folder you want (will be created on first start, be sure you have permissions to do that)

5. Now you will have to see how you want to start the programs, if as services or manually, for example with tmux

   • With systemd:
     • Sorry, not so much experience here, create two files to run python ~/notificator/app/main.py and python ~/notificator/app/notifiator.py for systemd; reload the daemon and enable them.
   • With tmux:
     1. Run tmux new -s notificator_webhook
     2. Run python ~/notificator/app/main.py
     3. Press your detach key combination (Default should be CTRL + B then D)
     4. Run tmux new -s notificator_notify
     5. Run python ~/notificator/app/notificator.py
     6. Press your detach key combination (Default should be CTRL + B then D)
     7. Enjoy!
     8. But not that much because you will have to redo this process everytime you reboot the system.

I ultimately suggest you to run this with Docker, or at the very least with systemd.

Contribution

I have a very little experience with git or GitHub, as I use this majorly as a "cloud" for my (very crappy) code when I go from a PC to another.

So feel like to contribute as you like!

Vagrant

I still haven't tested this with Vagrant, sorry.

To do

• Eh honestly a better error handling, right now it's pretty large.
• Lidarr support
• More entry customization
• Maybe a web page for customizing things?
• I'm accepting suggestions :D

  ---

Final thoughs

I wrote this as I grew tired of the too many notifications I received when using Sonarr and Radarr, I hope you will find this useful too, even if it's not exactly polished or even... Good!