How to: Receive in-app notifications

Notifications are a crucial aspect of staying updated and informed about new content added to your media library. Phyn allows you to receive notifications from Jellyfin and Jellyseerr. In this walkthrough, we'll guide you through the process of configuring notifications from both Jellyfin and Jellyseerr.

Notify all devices: This will give you a URL that can be used to notify all the devices you own that have Phyn installed. This may be useful if you use Phyn on multiple devices.

Notify this device: This will give you a URL that can be used to notify only the current device the URL was copied from. This is useful if you do not want to be getting notifications on multiple devices.

Configuring Jellyfin Notifications

Phyn uses webhooks to receive notifications from Jellyfin. You can use any plugin that supports webhooks so far you use it with the default notification template. This tutorial uses the Jellyfin webhook plugin to receive in-app notifications. The notifications are instant and non-intrusive. Follow these steps to configure the Jellyfin webhook plugin to receive notifications in Phyn:

Right now, only item added and generic notifications are supported. Custom templates are not supported.

While technically, you can use Phyn with any plugin that supports webhook notifications, Phyn was only tested with the Jellyfin webhook plugin so it is the only one that is guaranteed to work. The others may or may not work correctly.

Getting the webhook URL

1. Open the Phyn app and navigate to settings.

2. Under the notifications section, select either Notify all devices or Notify this device. A URL will be copied for you. We will use this URL to configure the webhook plugin on Jellyfin.

Configuring the webhook plugin on Jellyfin

If you haven't already, you should install the Jellyfin webhook plugin for the next steps.

To perform these actions, you need admin access to your server. If you do not have admin access, reach out to an admin to help you out.

1. Login into your Jellyfin server on the web

2. Go to plugins -> my plugins

3. Find the Webhook plugin and click on it

4. Click on Add generic destination

5. Enter the Phyn (or any name you want) in the webhook name.

6. Paste the URL copied from the Phyn app in the webhook URL.

7. Select all the notification types you want to receive. For now, it is only the Item added and Generic notification types are supported. If you would like a particular type to be added, please send an email to [e-mail] or use the Report issue feature in the app.

8. Select the user under the User filter. You will only get notifications from the user you select

9. Under Item type, select the items you are interested in receiving notifications for.

10. Make sure you select Send All Properties (ignores template). Phyn currently does not support custom notification templates.

11. Click on save

Congratulations! You have successfully configured notifications from Jellyfin to Phyn.

Configuring Notifications from Jellyseerr

Jellyseerr is another platform that you can integrate with Phyn to receive notifications effectively. Follow these steps to configure notifications from Jellyseerr:

Getting the webhook URL

1. Open the Phyn app and navigate to settings.

2. Link your Jellyseerr account to Phyn under Linked services

3. Under the Jellyseerr settings section, select either Notify all devices or Notify this device. A URL will be copied for you. We will use this URL to configure the webhook notifications Jellyseerr.

Configuring the webhook notifications on Jellyseerr

To perform these actions, you need admin access to your server. If you do not have admin access, reach out to an admin to help you out.

1. Login into your Jellyseerr server on the web

2. Go to settings -> notifications

3. On the notifications page, click on the Webhook item. It should be the last on the list. Now, this is where will will be configuring the webhook URL we got in the previous step to receive notifications.

4. Select Enable Agent.

5. Paste the copied URL in the Webhook URL

6. Leave JSON Payload as it is. If you have previously modified it, you can use the reset button below to reset it. Phyn only works with the default payload, tampering with it may make it not work properly.

7. Select the notification types you want to receive. All notification types are supported.

8. Click on Test to test the notifications. You should receive a test notification. If you don't check that the webhook URL is correct or reset the payload to default.

9. Click on save.

You have now successfully configured notifications from Jellyseerr to Phyn.

With notifications configured from both Jellyfin and Jellyseerr, you'll receive timely updates and stay informed about relevant activities within Phyn. Enjoy your enhanced user experience!