# Drone Ntfy plugin

[![Build Status](https://ci.cuzo.dev/api/badges/parra/drone-ntfy/status.svg)](https://ci.cuzo.dev/parra/drone-ntfy)

The Ntfy.sh plugin posts build status messages to your selected Ntfy server.

Example:
```yml
kind: pipeline
name: default

steps:
- name: send ntfy notification
  image: parrazam/drone-ntfy
  when:
      status: [success, failure]
  settings:
    url: https://ntfy.example.org
    topic: events
    priority: low
    tags: 
      - pipeline-status
      - dev
    username:
      from_secret: ntfy_user
    password:
      from_secret: ntfy_password
```

## Properties

`url` *string* [optional] \
Ntfy server.
> *Default: https://ntfy.sh*

`topic` *string* [**REQUIRED**] \
Topic to publish message.
> *Default: none*

`priority` *string* [optional] \
Priority of the notification. Values can be [min, low, default, high, max].
> *Default: default*

`tags` *string* [optional] \
Custom tags to include.
> *Default: none*

`username` *string* [optional] \
Username with publish permissions.
> *Default: none*

`password` *string* [optional] \
[***SECRET RECOMMENDED***] \
Password for username.

> *Default: none*