Metadata-Version: 2.1
Name: bygeon
Version: 0.0.9
Summary: A simple tool for syncing messages between multiple IMs
Author-email: dummyx <pygeon@gmx.com>
License: AGPL-3.0-only
Project-URL: Homepage, https://github.com/dummyx/bygeon
Project-URL: Bug Tracker, https://github.com/dummyx/bygeon/issues
Classifier: Programming Language :: Python :: 3.10
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Operating System :: Unix
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: colorlog (>=6.6.0)
Requires-Dist: requests (>=2.28.1)
Requires-Dist: tomli (>=2.0.1)
Requires-Dist: websocket-client (>=1.3.3)
Requires-Dist: PyPika (>=0.48.9)
Requires-Dist: orjson (>=3.7.7)
Requires-Dist: typing-extensions (>=4.3.0)

# bygeon


![GitHub](https://img.shields.io/github/license/dummyx/bygeon)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/bygeon)
![PyPI](https://img.shields.io/pypi/v/bygeon)

A simple tool for syncing messages between multiple IMs.

# Installation
It is recommended to use pipx to install bygeon.

```
pipx install bygeon
```

Python 3.10 or higher is required.

# Configuration

## Configuration file

The configuration file should be named bygeon.toml and placed in the working directory.

An [example](https://github.com/dummyx/bygeon/blob/main/bygeon.example.toml) is provided in the project.

## Slack

NOTE: Slack support is kind of broken now, use with caution.

Because bygeon is using WebSocket to receive events, app-level token is required alongside the normal bot token.

For more information, refer to [Slack's documentation](https://api.slack.com/apis/connections/socket).

## CQHttp

A running [go-cqhttp](https://github.com/Mrs4s/go-cqhttp) instance is needed to enable CQHttp. Make sure to enable WebSocket and HTTP in go-cqhttp's configuration and configure bygeon accordingly.

For how to setup go-cqhttp, refer to [their documentation](https://docs.go-cqhttp.org).
