Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fuchs-fabian/simbashlog-matrix-notifier
simbashlog-notifier for matrix.org
https://github.com/fuchs-fabian/simbashlog-matrix-notifier
element-io linux logging logging-framework matrix-org notifier simbashlog simbashlog-notifier
Last synced: 12 days ago
JSON representation
simbashlog-notifier for matrix.org
- Host: GitHub
- URL: https://github.com/fuchs-fabian/simbashlog-matrix-notifier
- Owner: fuchs-fabian
- License: gpl-3.0
- Created: 2024-09-29T20:15:19.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-11-24T15:02:34.000Z (3 months ago)
- Last Synced: 2024-11-24T15:33:59.639Z (3 months ago)
- Topics: element-io, linux, logging, logging-framework, matrix-org, notifier, simbashlog, simbashlog-notifier
- Language: Python
- Homepage: https://github.com/fuchs-fabian/simbashlog/wiki
- Size: 71.3 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# `simbashlog-matrix-notifier`: `simbashlog`-notifier for [matrix.org](https://matrix.org/)
## Description
This is a `simbashlog`-notifier for [Matrix](https://matrix.org/).
It summarizes the log messages and sends them to a Matrix room.\
End-to-end encryption is supported.
### Example message
## Getting Started
> It is possible that `pip` is not yet installed. If this is not the case, you will be prompted to install it. Confirm the installation.
### Installation with `pip` (GitHub)
```bash
pip install git+https://github.com/fuchs-fabian/simbashlog-matrix-notifier
```
### Installation with `pip` (Local)
Download the repository and navigate to the directory containing the [`setup.py`](setup.py) file.
```bash
pip install .
```
### Check Installation
```bash
pip list
```
```bash
pip show simbashlog-matrix-notifier
```
### Configuration
After installation, you will find the configuration file under:
```plain
~/.config/simbashlog-notifier/simbashlog-matrix-notifier/config.json
```
This configuration file is used by default if no other custom configuration file is specified.
It looks as follows:
```json
{
"min_required_log_level": "6",
"show_in_console_sent_message": "true",
"show_in_header_pid": "false",
"show_in_body_log_file_result": "false",
"show_in_body_log_file_content": "false",
"show_in_body_summary_for_pid": "false",
"show_in_body_summary_for_log_file": "false",
"show_in_footer_log_file_names": "false",
"show_in_footer_host": "false",
"show_in_footer_notifier_name": "true",
"use_e2e": "true",
"room_id": "!xyz:matrix.org",
"access_token": "your_access_token_here",
"homeserver_url": "https://matrix-client.matrix.org"
}
```
### Usage
```plain
usage: simbashlog-matrix-notifier [-h] [--config CONFIG] [--pid PID] [--log-level LOG_LEVEL] [--message MESSAGE]
[--log-file LOG_FILE] [--json-log-file JSON_LOG_FILE]
Notifier for simbashlog.
options:
-h, --help show this help message and exit
--config CONFIG Path to a custom config file.
--pid PID The used process ID.
--log-level LOG_LEVEL
The used log level (sourced simbashlog) / severity number (simbashlog called with arguments).
--message MESSAGE The logged message (simbashlog called with arguments).
--log-file LOG_FILE The created *.log file.
--json-log-file JSON_LOG_FILE
The created *_log.json file.
```
### Uninstallation
```bash
pip uninstall simbashlog-matrix-notifier
```
## Bugs, Suggestions, Feedback, and Needed Support
> If you have any bugs, suggestions or feedback, feel free to create an issue or create a pull request with your changes.
## Support `simbashlog`
If you like `simbashlog`'s ecosystem, you think it is useful and saves you a lot of work and nerves and lets you sleep better, please give it a star and consider donating.
---
> This script is a component of [`simbashlog`](https://github.com/fuchs-fabian/simbashlog) ([LICENSE](https://github.com/fuchs-fabian/simbashlog/blob/main/LICENSE)).
>
> The core of this notifier is [`simbashlog-notify-helper-py`](https://github.com/fuchs-fabian/simbashlog-notify-helper-py) ([LICENSE](https://github.com/fuchs-fabian/simbashlog-notify-helper-py/blob/main/LICENSE)).
>
> *Copyright (C) 2024 Fabian Fuchs*