You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: README.md
+20-3
Original file line number
Diff line number
Diff line change
@@ -3,15 +3,28 @@ Notifikator
3
3
4
4
This is an Android application that catches every notification and forwards them to an HTTP endpoint.
5
5
6
-
It natively supports talking to the [Kodi](https://kodi.tv/) JSON-RPC interface, [Notifications for Android TV](https://play.google.com/store/apps/details?id=de.cyberdream.androidtv.notifications.google), as well as sending plain JSON.
6
+
It natively supports talking to the [Kodi](https://kodi.tv/) JSON-RPC interface, [Notifications for Android TV](https://play.google.com/store/apps/details?id=de.cyberdream.androidtv.notifications.google), [Gotify](https://gotify.net/), as well as sending plain JSON.
7
7
8
8
How to Use
9
9
----------
10
10
11
11
1. Install the application.
12
12
2. Enable notification access (a shortcut is provided within).
13
13
3. Configure the HTTP endpoint, protocol and authentication if necessary (see next section).
14
-
4.*(Optional)* Send a test notification.
14
+
4.*(Optional)* Configure the package denylist to silence noisy packages
15
+
5.*(Optional)* Send a test notification.
16
+
17
+
Package Denylist
18
+
---------
19
+
In order to deny specific applications from having their notifications forwarded, first get a list of your packages. This is simply obtained from running `adb shell pm list packages`. Applications' package names are also shown under the application's settings in the system settings application.
20
+
21
+
Format your package names in a text file with one package name per line. Remove the `package:` prefix if copy-pasting from the output of `pm list packages`. If generating this on a computer, `adb push` can be used to send this text file to your android device.
22
+
23
+
Click `Package Denylist File` in the app and select your denylist file.
24
+
25
+
Changes to the content of this file won't be automatically detected by the app - you must reload the file for any changes to take effect.
26
+
27
+
The packages specified in the denylist need not be installed on the device - they simply won't do anything if the given package never sends a notification.
15
28
16
29
Protocols
17
30
---------
@@ -40,6 +53,10 @@ This protocol forwards the notification to the server part of the [Notifications
40
53
41
54
The endpoint URL should look like `http://hostname:7676/`, and authentication should not be enabled.
42
55
56
+
### Gotify
57
+
58
+
This protocol simply POSTs a formatted JSON to the supplied URL. It expects a Gotify server's URL in this format: `https://gotify.example.com/message?token=$APP_TOKEN`. As of now, the `title` parameter is hard-coded to `Notifikator`, and `priority` to `5`.
59
+
43
60
### JSON
44
61
45
62
This protocol will simply `POST` a JSON containing the notification title, text, small and large icons to an arbitrary endpoint. This is designed for people who want to write their own server code to handle it.
@@ -57,4 +74,4 @@ Here is an example JSON, note that any of the fields not present in the original
0 commit comments