# IBM Notifier

![License](https://img.shields.io/badge/license-Apache%202-1984E5)

![Swift version](https://img.shields.io/badge/swift-5.9.0-1984E5?logo=swift)
![Project version](https://img.shields.io/badge/version-3.2.4-1984E5)
![macOS](https://img.shields.io/badge/macOS-11+-bright%20green)

[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/5823/badge)](https://bestpractices.coreinfrastructure.org/projects/5823)
[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=IBM_mac-ibm-notifications&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=IBM_mac-ibm-notifications)
[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=IBM_mac-ibm-notifications&metric=reliability_rating)](https://sonarcloud.io/summary/new_code?id=IBM_mac-ibm-notifications)  

![GitHub Downloads (all assets, latest release)](https://img.shields.io/github/downloads/ibm/Mac-ibm-notifications/latest/total?logo=Github&label=Latest%20Release%20Downloads)
![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/ibm/Mac-ibm-notifications/total?logo=Github&label=Total%20Release%20Downloads)

## Scope

The purpose of this project is to provide an useful tool to system administrators to trigger interactive popups and notification banners to the end user.
<img alt="Cover Image" src="https://github.com/IBM/mac-ibm-notifications/blob/main/Images/Home/cover.png" width="700">

## Usage

To contribute to this repo please see [CONTRIBUTING.md](CONTRIBUTING.md)

Here you can find the updated changelog [CHANGELOG.md](CHANGELOG.md)

For detailed usage of this tool please refer to the [official wiki](https://github.com/IBM/mac-ibm-notifications/wiki/Usage)

## As seen on

[JNUC 2021 Session 1167](https://www.youtube.com/watch?v=Cn5wIuB90t8&list=PLlxHm_Px-Ie1EIRlDHG2lW5H7c2UYvops&index=14)  
[JNUC 2021 Session 1171](https://www.youtube.com/watch?v=BOPAa8QZw0o&list=PLlxHm_Px-Ie1EIRlDHG2lW5H7c2UYvops&index=17)  
[JNUC 2022 Session 1174](https://www.youtube.com/watch?v=oTeJZnh2cZ0&list=PLlxHm_Px-Ie2uIFiar6_3JejiOnObiujM&index=107)  
[JNUC 2022 Session 1175](https://www.youtube.com/watch?v=9ZsZaSmWwIo&list=PLlxHm_Px-Ie2uIFiar6_3JejiOnObiujM&index=108)  
[JNUC 2023 Session 1327](https://youtu.be/aCkbOL2YYaw?si=rWGy4Cy2Qoki9Mm1)  
[JNUC 2023 Session 1168](https://youtu.be/Lj26nuCH1jA?si=I-tkL18rU-rLFlIz)  

## Notes

If you have any questions or issues you can create a new issue [here](https://github.com/IBM/mac-ibm-notifications/issues/new/choose).

You can also find a list of the maintainers of this repo [here](MAINTAINERS.md).

Don't forget to join the community in the `#mac-ibm-open-source` channel in the [MacAdmins Slack Workspace](https://www.macadmins.org).

Pull requests are very welcome! Make sure your patches are well tested.
Ideally create a topic branch for every separate change you make. For
example:

1. Fork the repo
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Added some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request

## License

All source files must include a Copyright and License header. The SPDX license header is 
preferred because it can be easily scanned.

If you would like to see the detailed LICENSE click [here](LICENSE).

```text
#
# Copyright 2020- IBM Inc. All rights reserved
# SPDX-License-Identifier: Apache2.0
#
```