Merge pull request #481 from TRaSH-/Maintenance-Release-20220122
Removed: Notifiarr Instructions from the guidepull/483/head
@ -1,5 +0,0 @@
|
||||
nav:
|
||||
- Quick Start: Quick-Start.md
|
||||
|
||||
|
||||
|
@ -1,330 +0,0 @@
|
||||
# Quick Start
|
||||
|
||||
Here we're going to explain the basic setup for Notifiarr to get it working with Sonarr, Radarr, Bazarr.
|
||||
|
||||
If you want to make use of the other options I suggest to looking at the [Notifiarr Wiki](https://notifiarr.wiki){:target="_blank" rel="noopener noreferrer"}.
|
||||
|
||||
------
|
||||
|
||||
## Login
|
||||
|
||||
First we're going to visit the [Notifiarr](https://notifiarr.com/index.php){:target="_blank" rel="noopener noreferrer"} site, if you don't have an account yet, click the link to signup.
|
||||
|
||||
![!dn-login](images/dn-login.png)
|
||||
|
||||
1. Your Email address you used during signup.
|
||||
1. Your Password you created during signup.
|
||||
1. Login to the site and setup.
|
||||
1. Password reset if you forgot your password.
|
||||
1. Signup if you don't have an account.
|
||||
1. Link to Notifiarr Discord support channel.
|
||||
|
||||
------
|
||||
|
||||
## Profile
|
||||
|
||||
After you have logged in, you will be redirected to your profile screen.
|
||||
|
||||
![!profile](images/profile.png)
|
||||
|
||||
1. Click on `Generate API Key` (This needs to be done)
|
||||
1. Select your `Country`
|
||||
1. Select your `Timezone`
|
||||
1. Change your `Time Format` to your liking
|
||||
1. Select your `Site Theme`
|
||||
1. Select your `Notification Language`
|
||||
1. If you decide to delete your account, check the box
|
||||
1. Don't forget to `Save` your changes
|
||||
|
||||
------
|
||||
|
||||
## Integration Setup
|
||||
|
||||
- Enable the integrations you want to use
|
||||
- Setup your discord server (required), invite the bot (required) and reactions (optional).
|
||||
|
||||
### Integration Settings
|
||||
|
||||
![!open-integrations](images/open-integrations.png)
|
||||
|
||||
First, click on `Manage Integrations` so you can enable what you want to receive notifications for.
|
||||
|
||||
![!integration-list](images/integration-list.png)
|
||||
|
||||
A screen will popup and here you're able to select from which application/services you receive a notification.
|
||||
|
||||
When you enabled the ones you want click on `Save`
|
||||
|
||||
Setup which notifications you want to to receive from each option.
|
||||
|
||||
![!notification-settings](images/notification-settings.png)
|
||||
|
||||
1. Cog wheel, this opens the integration settings
|
||||
1. External link, this opens the website for the integration
|
||||
1. WIKI link, this opens any extra wiki information available for the integration
|
||||
1. Triggers, this enables/disables a specific trigger for the integration
|
||||
1. Channels, this sets the channel in your server to post to for the integration
|
||||
|
||||
### Discord Settings
|
||||
|
||||
Here we will cover the following
|
||||
|
||||
- Setup the server & shared error channel
|
||||
- Invite the bot into your server
|
||||
- Setup reactions
|
||||
- Setup indexer reactions
|
||||
|
||||
#### Create the channels
|
||||
|
||||
First thing to do is create a few channels (in your discord server) where you receive your notifications.
|
||||
|
||||
!!! note
|
||||
I won't be explaining how to setup a discord channel, that's up to you but google has plenty of references.
|
||||
|
||||
You can do it all from one channel or separate the notifications (granular) for each trigger if you want.
|
||||
|
||||
#### Simple channel setup
|
||||
|
||||
`#media` => All the `*arr` notifications you setup in [Integration Settings](#integration-settings).
|
||||
|
||||
`#errors` => Health checks, network errors, etc.
|
||||
|
||||
`#plex` => Play, resume, etc. for Plex.
|
||||
|
||||
After you create the needed channels, it's time to add them to the `Setup the channels`
|
||||
|
||||
First we need to get the server ID
|
||||
|
||||
Open your User Settings -> Appearance -> Enable Developer Mode.
|
||||
|
||||
![!dn-discord-dev-mode](images/dn-discord-dev-mode.png)
|
||||
|
||||
Right click on your server name and select "Copy ID"
|
||||
|
||||
??? example "Example right click - [CLICK TO EXPAND]"
|
||||
![!dn-discord-copyid](images/dn-discord-copyid.png)
|
||||
|
||||
Paste the server ID in box `[1]`
|
||||
|
||||
![!discord-server](images/discord-server.png)
|
||||
|
||||
1. Add your server ID
|
||||
1. Select the channel for the `#errors` channel.
|
||||
|
||||
### Invite the bot
|
||||
|
||||
It's time to invite the bot in to your Server/Channels by clicking on the following link.
|
||||
|
||||
![!dn-invite-bot-here](images/dn-invite-bot-here.png)
|
||||
|
||||
You will get a screen that looks like the following screenshot.
|
||||
|
||||
![!dn-invite-bot-discord](images/dn-invite-bot-discord.png)
|
||||
|
||||
1. Select the server the bot should join.
|
||||
1. Click on `Continue` to approve.
|
||||
|
||||
!!! note
|
||||
Check [Discord Permissions](https://notifiarr.wiki/en/Website/Discord/Permissions){:target="_blank" rel="noopener noreferrer"} for information which permissions the bot needs.
|
||||
|
||||
#### Reactions
|
||||
|
||||
Here we will setup the Notifiarr reactions(emoji's) that will be shown during a playback in plex, or during a download/import in Sonarr/Radarr.
|
||||
|
||||
![dn-reaction-1](images/dn-reaction-1.png)![dn-reaction-2](images/dn-reaction-2.png)
|
||||
|
||||
This section exist of 2 parts.
|
||||
|
||||
1. *arr state (grab/failed) and play state of plex.
|
||||
1. The Trackers/Indexers.
|
||||
|
||||
First we're going to download the emoji's and you can do that in 2 ways.
|
||||
|
||||
1. 1 at a time - Right click -> Save As... - for these emoji images to some location on your computer.
|
||||
1. Pack Download - Click [here](https://notifiarr.com/setup.php?grab=reactions){:target="_blank" rel="noopener noreferrer"} to download a zip of all the current reaction images.
|
||||
|
||||
!!! attention
|
||||
|
||||
To download the Emoji Pack from the link in this Guide you will need to be logged in to [Notifiarr](https://notifiarr.com/index.php){:target="_blank" rel="noopener noreferrer"} site !!!
|
||||
|
||||
Else you can find it on the main Notifiarr site in the `Integration Setup` Category at the bottom right
|
||||
|
||||
![!dn-pack-download](images/dn-pack-download.png)
|
||||
|
||||
For this example, we will be using Pack Download. You'll need download the file and then unpack it somewhere on your computer. After which, you can then add the emoji's to your Discord Server easily.
|
||||
|
||||
How to add your own Emoji's => [LINK](https://support.discord.com/hc/en-us/articles/360036479811-Custom-Emojis){:target="_blank" rel="noopener noreferrer"}
|
||||
|
||||
After you've added them to your Discord Server it's time to get the ID's from your emoji's, to do this go in to one of your channels and type:
|
||||
|
||||
```bash
|
||||
\:emoji_name:
|
||||
```
|
||||
|
||||
??? example "Example - [CLICK TO EXPAND]"
|
||||
![!dn-emoji-example](images/dn-emoji-example.png)
|
||||
|
||||
What results in to.
|
||||
|
||||
![!dn-emoji-result](images/dn-emoji-result.png)
|
||||
|
||||
So your ID would be `:grab:706535455876710461`.
|
||||
|
||||
Paste the ID results from your channel in to the corresponding boxes.
|
||||
|
||||
![!dn-reaction-paste](images/dn-reaction-paste.png)
|
||||
|
||||
Do this for all the other boxes also including your Trackers/Indexers.
|
||||
|
||||
#### Trackers and Indexers
|
||||
|
||||
![!dn-reaction-indexers](images/dn-reaction-indexers.png)
|
||||
|
||||
1. Paste here the the emoji ID.
|
||||
1. The actual indexer name you're using in Sonarr/Radarr.
|
||||
|
||||
??? example "Example - [CLICK TO EXPAND]"
|
||||
|
||||
![!dn-indexer-torznab](images/dn-indexer-torznab.png)
|
||||
|
||||
What will result in to.
|
||||
|
||||
![!dn-indexer-torznab-result](images/dn-indexer-torznab-result.png)
|
||||
|
||||
If you use a different name in Sonarr and Radarr just add them with a comma `BeyondHD - Jackett,BHD`.
|
||||
|
||||
Don't forget to click on `Save Changes` !!!
|
||||
|
||||
!!! note
|
||||
After pasting the Emoji's ID in to the box you will notice that the leading colon will disappear nothing to worry about that's per design
|
||||
|
||||
------
|
||||
|
||||
## How to add notifiarr to your applications
|
||||
|
||||
Here we will explain how to we add notifiarr to your *arr and Plex.
|
||||
|
||||
When you click on the cogwheel of the enabled Integration you will see on the top `Instructions`
|
||||
|
||||
![!dn-integration-settings-link](images/dn-integration-settings-link.png)
|
||||
|
||||
It will show you a short description where and how to add what.
|
||||
|
||||
??? example "Example" - [CLICK TO EXPAND]
|
||||
|
||||
![!dn-radarr-integration-instructions](images/dn-radarr-integration-instructions.png)
|
||||
|
||||
### Radarr, Readarr and Lidarr
|
||||
|
||||
Radarr, Readarr and Lidarr supports Notifiarr natively so that's an easy one to add.
|
||||
|
||||
`Settings` => `Connect` => click on the ![dn-arr-add-plus.png](images/dn-arr-add-plus.png) `plus` icon and select `Notifiarr` add your API key and you're done.
|
||||
|
||||
??? example "Radarr Example - [CLICK TO EXPAND]"
|
||||
In Radarr go to `Settings` => `Connect` => Click on the ![dn-arr-add-plus](images/dn-arr-add-plus.png) `plus` icon and select `notifiarr`.
|
||||
|
||||
![!dn-arr-add-notification](images/dn-arr-add-notification.png)
|
||||
|
||||
Then add the following info.
|
||||
|
||||
![!dn-arr-settings-notification](images/dn-arr-settings-notification.png)
|
||||
|
||||
1. The name you want to use for the notification.
|
||||
1. Enable `On Grab`, `On Import`, `On Upgrade`, `On Health Issue` & `Include Health Warnings`.
|
||||
1. Add here you API key from Notifiarr.
|
||||
1. Click on `Test` to see if it works.
|
||||
1. If everything is correct click on `Save`
|
||||
|
||||
### Sonarr
|
||||
|
||||
Sonarr doesn't have native support & will not get one per their devs.
|
||||
That's why we're going to use the webhook method.
|
||||
|
||||
![!dn-sonarr-instruction](images/dn-sonarr-instructions.png)
|
||||
|
||||
`Settings` => `Connect` > Click on the ![dn-arr-add-plus](images/dn-arr-add-plus.png) `plus` icon and select `Webhook`.
|
||||
|
||||
Add the following info:
|
||||
|
||||
**Name**: Notifiarr
|
||||
|
||||
**Enable:** `On Grab`, `On Import`, `On Upgrade`, `On Health Issue` & `Include Health Warnings`.
|
||||
|
||||
**URL:** The URL that you can copy/paste from the integrations page.
|
||||
|
||||
Click **Save**
|
||||
|
||||
??? example "Sonarr Example - [CLICK TO EXPAND]"
|
||||
|
||||
`Settings` => `Connect` > Click on the ![dn-arr-add-plus.png](images/dn-arr-add-plus.png) `plus` icon and select `Webhook`.
|
||||
|
||||
![!dn-sonarr-add-webhook](images/dn-sonarr-add-webhook.png)
|
||||
|
||||
Add the following info.
|
||||
|
||||
![!dn-sonarr-settings-webhook](images/dn-sonarr-settings-webhook.png)
|
||||
|
||||
1. The name you want to use for the notification.
|
||||
1. Enable `On Grab`, `On Import`, `On Upgrade`, `On Health Issue` & `Include Health Warnings`.
|
||||
1. Add the URL that you can copy/paste from the integrations page.
|
||||
1. Make sure this is on `POST`.
|
||||
1. Click on `Test` to see if it works.
|
||||
1. If everything is correct click on `Save`
|
||||
|
||||
### Bazarr
|
||||
|
||||
For Bazarr you need to make use of JSON method.
|
||||
|
||||
![!dn-bazarr-instruction](images/dn-bazarr-instruction.png)
|
||||
|
||||
`Settings` => `Notifications` => and select`JSON`
|
||||
|
||||
On the top click on the ![dn-bazarr-edit-icon](images/dn-bazarr-edit-icon.png) `Edit` icon and Enable the notification type.
|
||||
|
||||
Add the JSON URL that you copy/pasted from the integrations page.
|
||||
|
||||
Scroll up and save
|
||||
|
||||
??? example "Bazarr Example - [CLICK TO EXPAND]"
|
||||
|
||||
`Settings` => `Notifications` => and select`JSON`
|
||||
|
||||
![!dn-bazarr-add-json](images/dn-bazarr-add-json.png)
|
||||
|
||||
On the top click on the ![dn-bazarr-edit-icon](images/dn-bazarr-edit-icon.png) `Edit` icon and Enable the notification type.
|
||||
|
||||
Add the following info.
|
||||
|
||||
![!dn-bazarr-settings-json](images/dn-bazarr-settings-json.png)
|
||||
|
||||
1. Enable the JSON Notification.
|
||||
1. Add the JSON URL that you copy/pasted from the integrations page.
|
||||
1. Click on `Test` to see if it works.
|
||||
1. If everything is correct click on `Ok`
|
||||
|
||||
Don't forget to click on Save on the top of the Bazarr screen.
|
||||
|
||||
![!dn-bazarr-save-json](images/dn-bazarr-save-json.png)
|
||||
|
||||
### Plex
|
||||
|
||||
![!dn-plex-instructions](images/dn-plex-instructions.png)
|
||||
|
||||
`Settings` => `Webhooks` => click on `ADD WEBHOOK` and add the URL that you can copy/paste from the integrations page and click on `SAVE CHANGES`
|
||||
|
||||
??? example "Plex Example - [CLICK TO EXPAND]"
|
||||
|
||||
`Settings` => `Webhooks` => click on `ADD WEBHOOK`
|
||||
|
||||
On the top right click on the ![dn-plex-settings-icon](images/dn-plex-settings-icon.png) `Settings` icon, and on the left sidebar select `Webhooks`
|
||||
Click on the middle of the screen on ![dn-plex-webhook-icon](images/dn-plex-webhook-icon.png) and add the following info.
|
||||
|
||||
![!dn-plex-settings-webhook](images/dn-plex-settings-webhook.png)
|
||||
|
||||
1. Add the URL that you can copy/paste from the integrations page.
|
||||
2. Click on `SAVE CHANGES`
|
||||
|
||||
If you want to show more advanced info like Transcode, CPU & Ram take a look at [Plex Integration](https://notifiarr.wiki/en/Website/Integrations/Plex){:target="_blank" rel="noopener noreferrer"}
|
||||
|
||||
!!! note
|
||||
If there is still an issue, try asking in the Notifiarr [discord channel](https://discord.gg/AURf8Yz){:target="_blank" rel="noopener noreferrer"} for additional support.
|
Before Width: | Height: | Size: 18 KiB |
Before Width: | Height: | Size: 16 KiB |
Before Width: | Height: | Size: 570 B |
Before Width: | Height: | Size: 29 KiB |
Before Width: | Height: | Size: 2.4 KiB |
Before Width: | Height: | Size: 980 B |
Before Width: | Height: | Size: 6.9 KiB |
Before Width: | Height: | Size: 3.8 KiB |
Before Width: | Height: | Size: 14 KiB |
Before Width: | Height: | Size: 22 KiB |
Before Width: | Height: | Size: 20 KiB |
Before Width: | Height: | Size: 15 KiB |
Before Width: | Height: | Size: 1.4 KiB |
Before Width: | Height: | Size: 8.6 KiB |
Before Width: | Height: | Size: 6.1 KiB |
Before Width: | Height: | Size: 4.5 KiB |
Before Width: | Height: | Size: 574 B |
Before Width: | Height: | Size: 34 KiB |
Before Width: | Height: | Size: 11 KiB |
Before Width: | Height: | Size: 13 KiB |
Before Width: | Height: | Size: 4.2 KiB |
Before Width: | Height: | Size: 8.9 KiB |
Before Width: | Height: | Size: 32 KiB |
Before Width: | Height: | Size: 22 KiB |
Before Width: | Height: | Size: 3.9 KiB |
Before Width: | Height: | Size: 535 B |
Before Width: | Height: | Size: 111 KiB |
Before Width: | Height: | Size: 1.5 KiB |
Before Width: | Height: | Size: 41 KiB |
Before Width: | Height: | Size: 6.0 KiB |
Before Width: | Height: | Size: 2.0 KiB |
Before Width: | Height: | Size: 614 B |
Before Width: | Height: | Size: 9.1 KiB |
Before Width: | Height: | Size: 26 KiB |
Before Width: | Height: | Size: 6.6 KiB |
Before Width: | Height: | Size: 6.3 KiB |
Before Width: | Height: | Size: 45 KiB |
Before Width: | Height: | Size: 52 KiB |
Before Width: | Height: | Size: 66 KiB |
Before Width: | Height: | Size: 6.1 KiB |
Before Width: | Height: | Size: 49 KiB |