## niotify

Cross platform notifications for [Gio](https://gioui.org) applications.

## Status

This repo is experimental, and does not have a stable interface. Currently niotify
only supports the following OSes:

- linux (x11/wayland doesn't matter so long as dbus is used for notifications)
- android

Contributions of support for other platforms are welcome! Send inquiries and patches
to [my public inbox](https://lists.sr.ht/~whereswaldon/public-inbox) for now.

## Use

niotify requires a `replace` directive in your `go.mod` to add features to an underlying
JNI library. This should be temporary.

For now, add:

```
replace git.wow.st/gmp/jni => git.wow.st/whereswaldon/jni v0.0.0-20200620152723-b380472956a0
```

Additionally, this package requires a helper JAR archive to function on Android. You can
generate this jar file with:

```
javac -target 1.8 -source 1.8 -bootclasspath $ANDROID_HOME/platforms/android-29/android.jar ./android/NotificationHelper.java
jar cf NotificationHelper.jar ./android/NotificationHelper.class
```

Place this JAR file in the main package of your Gio application so that it will automatically
be bundled into your APKs.

See the package documentation of `./notification_manager.go` for usage information.

## Name

go => gio

notify => niotify