https://github.com/lumaa-dev/seerrapn
Seerr webhook for Apple Push Notifications (APN)
https://github.com/lumaa-dev/seerrapn
apn jellyseerr overseerr push-notifications seerr
Last synced: about 1 month ago
JSON representation
Seerr webhook for Apple Push Notifications (APN)
- Host: GitHub
- URL: https://github.com/lumaa-dev/seerrapn
- Owner: lumaa-dev
- License: mit
- Created: 2025-11-18T15:13:36.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-05-01T06:59:50.000Z (2 months ago)
- Last Synced: 2026-05-01T08:30:48.500Z (2 months ago)
- Topics: apn, jellyseerr, overseerr, push-notifications, seerr
- Language: TypeScript
- Homepage:
- Size: 103 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
SeerrAPN
SeerrAPN is an [APN](https://d.lumaa.fr/AosqMi) (Apple Push Notification) service using [Seerr](https://github.com/seerr-team/seerr)'s webhooks.
## Features
### Events supported
- New Request
- Request Denied
- Movie/Show Available
- Request Automatically Approved
### Filters
You can make it so that users have only specific notifications:
- None: `0`
- New Request: `1`
- Request Denied: `2`
- Movie/Show Available: `4`
- Request Automatically Approved: `8`
To filter multiple notifications, simply add the number matching the notification like so:
```
- Request Denied: 2
- Request Automatically Approved: 8
2 + 8 = 10
```
You cannot filter out the `TEST_NOTIFICATION`, accessible by a Seerr administrator.
## Running
To make SeerrAPN work follow these steps:
1. Rename the `EXAMPLE.env` file to `.env` file
2. Generate an APN [Certificate](https://developer.apple.com/account/resources/certificates/list)
3. Change the `.env` file to your wish
4. Run `node server/index.js` or use Docker Compose with `docker-compose.yml`
5. Set the Seerr webhook URL as `http://localhost:3000/apn` (or with your chosen port/URL) and fill in the _Authorization Header_ with the one you chose
## Subscribe using [Swiftseerr](https://apps.lumaa.fr/app/swiftseerr)
If you have a running SeerrAPN instance, or if your administrator set up one. You can subscribe to the Seerr notifications using the steps below:
_Requirements_:
- An iOS device running [Swiftseerr](https://apps.lumaa.fr/app/swiftseerr)
- The _SeerrAPN URL_ for your [Seerr](https://github.com/seerr-team/seerr) instance and the _Authorization Header_
1. Allow notifications in the Settings app for Swiftseerr
2. Tap the settings icon in the top right corner, and select "_Notifications_"
3. Type the _SeerrAPN URL_ in the text field with the same name and the _Authorization Header_ in the text field below
4. Tap the purple paperplane button
If the informations written are invalid, or if the SeerrAPN instance has issues, an error on-screen should appear.
---
© Lumaa 2025-2026