Some updates to the notifier document

pull/34/head
Austin Best 4 years ago
parent cdee71ad4b
commit 6392d9b1f2

@ -1,3 +1,11 @@
<style>
.indent-L1 {
margin-left: 1em;
}
.indent-B1 {
margin-bottom: 1em;
}
</style>
# Discord Notifier Basic Setup # Discord Notifier Basic Setup
Here you will see a basic setup for Discord Notifier. Here you will see a basic setup for Discord Notifier.
@ -6,15 +14,15 @@ Here you will see a basic setup for Discord Notifier.
## Login ## Login
First we're going to visit the [Discord Notifier](https://discordnotifier.com/index.php){:target="_blank"} site, if you don't have a account yet signup First we're going to visit the [Discord Notifier](https://discordnotifier.com/index.php){:target="_blank"} site, if you don't have an account yet, click the link to signup.
![image-20201107173234502](images/image-20201107173234502.png) ![image-20201107173234502](images/image-20201107173234502.png)
1. Your Email address you used during signup. 1. Your Email address you used during signup.
1. Your Password you created during signup. 1. Your Password you created during signup.
1. Login to the settings and setup. 1. Login to the site and setup.
1. Password reset if you forgot your password. 1. Password reset if you forgot your password.
1. Signup if you don't have a account. 1. Signup if you don't have an account.
1. Link to Discord Notifier Discord support channel. 1. Link to Discord Notifier Discord support channel.
------ ------
@ -37,37 +45,51 @@ After you logged in you will be redirected to your profile screen where you need
Here you will be able to setup the following things: Here you will be able to setup the following things:
- Notifications Settings => Setup which notifications you want to receive from the *arr. - Notifications Settings => Setup which notifications you want to receive.
- Discord Settings => Setup your discord channels and your reactions and invite the bot in to your channel. - Discord Settings => Setup your discord channels and your reactions and invite the bot into your channel.
### Notification Settings ### Notification Settings
Setup which notifications you want to to receive from the *arr. Setup which notifications you want to to receive from each option.
![image-20201107190759062](images/image-20201107190759062.png) ![image-20201107190759062](images/image-20201107190759062.png)
Click on the cog(settings) icon to configure what will be in your notification. 1. Click on the cog (settings) icon to configure what will be in your notification.
### Discord Settings #### Notification Settings Configuration
![image-20201117-121530](images/image-20201117-121530.png)
1. Enable/Disable notification trigger
1. Change color bar for notification trigger
1. Expand trigger to enable/disable message fields
1. Customize the layout for the notification (drag/drop editor to the right in the image)
Setup your discord channels and your reactions and invite the bot in to your channel. ### Discord Settings
<div class="indent-L1 indent-B1">
Setup your discord channels and your reactions and invite the bot into your channel.
</div>
#### Setup the channels #### Create the channels
<div class="indent-L1 indent-B1">
First thing to do is create a few channels where you receive your notifications. First thing to do is create a few channels where you receive your notifications.
!!! note !!! note:
I won't be explaining how to setup a discord channel/server/permissions that's up to you and your responsibility !!! 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 if you want, in this example I will do a basic setup of 3 channels. You can do it all from one channel or separate the notifications (granular) for each trigger if you want.
</div>
`#mediabot` => *arr channel - All the `*arr` notifications you setup in [Notification Settings](#notification-settings). #### Simple channel setup
<div class="indent-L1">
`#error-channel` => Error channel- Health check, network errors, etc. `#media` => All the `*arr` notifications you setup in [Notification Settings](#notification-settings).
`#plex` => Media channel - Play state and info of Plex. `#errors` => Health checks, network errors, etc.
After you created the needed channels it's time to add them to the `Setup the channels` `#plex` => Play, resume, etc. for Plex.
</div>
After you create the needed channels, it's time to add them to the `Setup the channels`
First we need to get the channel ID's from your server/channel First we need to get the channel ID's from your server/channel
@ -83,11 +105,13 @@ Paste the channel ID in the corresponding boxes.
![image-20201107201822743](images/image-20201107201822743.png) ![image-20201107201822743](images/image-20201107201822743.png)
1. Add the Channel ID for the `#mediabot` channel. 1. Add the channel ID for the `#media` channel.
1. Add the Channel ID for the `#error-channel` channel. 1. Add the channel ID for the `#errors` channel.
1. Add the Channel ID for the `#plex` channel. 1. Add the channel ID for the `#plex` channel.
1. Use this option if you want to use separate Channels for the notifications. 1. Use this option if you want to use separate channels for the notifications (see below).
1. Use this option if you want to use separate Channels for the notifications. 1. Use this option if you want to use separate channels for the notifications.
![Image-20201117-145908](images/Image-20201117-145908.png)
### Invite the bot ### Invite the bot
@ -102,7 +126,7 @@ You will get a screen that looks like the following screenshot.
1. Select the server the bot should join. 1. Select the server the bot should join.
1. Click on `Authorize` to approve. 1. Click on `Authorize` to approve.
!!! note !!! note:
You have to be an administrator of the Discord channel to invite bots. Make sure the bot has permissions to post. You have to be an administrator of the Discord channel to invite bots. Make sure the bot has permissions to post.
??? summary "Bot Setup Help" ??? summary "Bot Setup Help"
@ -211,7 +235,7 @@ Radarr, Readarr and Lidarr supports Discord Notifier native so that's a easy one
### Sonarr ### Sonarr
Sonarr doesn't have native support & will not get one per their devs. Sonarr doesn't have native support & will not get one per their devs.
that's why we're going to use the webhook method. That's why we're going to use the webhook method.
![image-20201108175840774](images/image-20201108175840774.png) ![image-20201108175840774](images/image-20201108175840774.png)
@ -281,7 +305,7 @@ Scroll up and save
### Plex ### Plex
For Plex we're going to use the Webhook method. #### URL Webhook
![image-20201108191708582](images/image-20201108191708582.png) ![image-20201108191708582](images/image-20201108191708582.png)
@ -299,9 +323,33 @@ For Plex we're going to use the Webhook method.
1. Add the URL that you can copy/paste from the integrations page. 1. Add the URL that you can copy/paste from the integrations page.
2. Click on `SAVE CHANGES` 2. Click on `SAVE CHANGES`
#### Python Webhook
<div class="indent-L1 indent-B1">
Python is required for this to work. Make sure your docker solution has it available if running docker.
</div>
##### All implementations
- Open the file and change the variables accordingly.
- There are links in the file comments to help as well
- You can test the script by typing python /path/to/script in your CLI. If the file has a shebang in it (#!python) then you do not need to specify python on the CLI.
##### Docker
- Cloudbox - Has python installed
- Hotio - Has python installed
- LSIO - Does not have python installed
##### Linux
##### Unraid
##### Windows
<div class="indent-L1 indent-B1">
Run the python file so it listens on the specific port.
</div>
### Testing ### Testing
On the top of the integrations page you will have now the ability to test your settings. On the top of the integrations page you will now have the ability to test your settings. This only tests the connection between the notifier and your discord. You can use the Test in each *arr and that will test the everything (connection wise).
![image-20201108195808555](images/image-20201108195808555.png) ![image-20201108195808555](images/image-20201108195808555.png)

Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 97 KiB

Loading…
Cancel
Save