From 18a540b7e28aef117fc5a2d801b2f6fd08c93fc8 Mon Sep 17 00:00:00 2001 From: Antoine Martin Date: Sat, 10 Apr 2021 02:28:28 +0200 Subject: [PATCH] README: switch to markdown format Better compatibility with various forges --- README.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++ README.org | 43 ------------------------------------------- 2 files changed, 50 insertions(+), 43 deletions(-) create mode 100644 README.md delete mode 100644 README.org diff --git a/README.md b/README.md new file mode 100644 index 0000000..21ae0da --- /dev/null +++ b/README.md @@ -0,0 +1,50 @@ +# BadNews: Matrix Bot, Bringer of Bad News + +## What is this? + +`BadNews` is a [Matrix](https://matrix.org) bot, watching your systemd/journald +logs, and reporting bad news to you. + +## Why? + +A mix of wanting to toy around with the [matrix_sdk +crate](https://github.com/matrix-org/matrix-rust-sdk) and getting some simple +alerts from my hosted services. + +## Setup + +Write up a configuration file at `config.yaml`: + +```yaml +homeserver: "https://matrix.example.net" +username: "bad-news" +password: "matrix password for user bad-news" +state_dir: "state/" +room_id: "!DeaDbEef:example.net" +units: + - name: nginx.service + filter: "\\[warn\\] .*" +``` + +Then run the bot: + +``` sh +cargo run -- --config config.yaml +``` + +## Contributing + +I accept contributions via [GitHub](https://github.com/alarsyo/bad-news) Pull +Requests and [GitLab](https://gitlab.com/alarsyo/bad-news) Merge Requests. + +### Sending patches by mail +You can also send patches to +[~alarsyo/patches@lists.sr.ht](https://lists.sr.ht/~alarsyo/patches) with the +prefix `PATCH bad-news`. + +You can use the following commands to set up `git` appropriately; + +``` sh +git config sendemail.to '~alarsyo/patches@lists.sr.ht' +git config format.subjectPrefix 'PATCH bad-news' +``` diff --git a/README.org b/README.org deleted file mode 100644 index 013cffd..0000000 --- a/README.org +++ /dev/null @@ -1,43 +0,0 @@ -#+title: BadNews: Matrix Bot, Bringer of Bad News - -* What is this? - -=BadNews= is a [[https://matrix.org][Matrix]] bot, watching your systemd/journald logs, and reporting -bad news to you. - -* Why? - -A mix of wanting to toy around with the [[https://github.com/matrix-org/matrix-rust-sdk][matrix_sdk crate]] and getting some -simple alerts from my hosted services. - -* Setup - -Write up a configuration file at =config.yaml=: - -#+begin_src yaml -homeserver: "https://matrix.example.net" -username: "bad-news" -password: "matrix password for user bad-news" -state_dir: "state/" -room_id: "!DeaDbEef:example.net" -units: - - nginx.service -#+end_src - -Then run the bot: - -#+begin_src sh -cargo run -- --config config.yaml -#+end_src - -* Contributing - -Please send patches to [[~alarsyo/patches@lists.sr.ht]] with the prefix =PATCH -bad-news=. - -You can use the following commands to set up =git= appropriately; - -#+begin_src shell -git config sendemail.to '~alarsyo/patches@lists.sr.ht' -git config format.subjectPrefix 'PATCH bad-news' -#+end_src