2021-09-13 20:26:32 +02:00
<!--
N.B.: This README was automatically generated by https://github.com/YunoHost/apps/tree/master/tools/README-generator
It shall NOT be edited by hand.
-->
# Matrix-Telegram bridge for YunoHost
2021-03-24 22:49:07 +01:00
2023-02-24 00:30:53 +01:00
[![Integration level ](https://dash.yunohost.org/integration/mautrix_telegram.svg )](https://dash.yunohost.org/appci/app/mautrix_telegram) ![Working status ](https://ci-apps.yunohost.org/ci/badges/mautrix_telegram.status.svg ) ![Maintenance status ](https://ci-apps.yunohost.org/ci/badges/mautrix_telegram.maintain.svg )
2021-09-13 20:26:32 +02:00
[![Install Matrix-Telegram bridge with YunoHost ](https://install-app.yunohost.org/install-with-yunohost.svg )](https://install-app.yunohost.org/?app=mautrix_telegram)
2021-03-24 22:49:07 +01:00
*[Lire ce readme en français.](./README_fr.md)*
2021-09-13 20:26:32 +02:00
> *This package allows you to install Matrix-Telegram bridge quickly and simply on a YunoHost server.
2021-03-24 22:49:07 +01:00
If you don't have YunoHost, please consult [the guide ](https://yunohost.org/#/install ) to learn how to install it.*
## Overview
2021-09-13 20:26:32 +02:00
A puppeting bridge between Matrix and Telegram packaged as a YunoHost service. Messages, notifications (and sometimes media) are bridged between a Telegram user and a Matrix user. Currently the Matrix user can NOT invite other Matrix user in a bridged Telegram room, so only someone with a Telegram account can participate to Telegram group conversations. The ["Mautrix-Telegram" ](https://docs.mau.fi/bridges/python/telegram/index.html ) bridge is a Synapse App Service and relies on postgresql. Therefore, [Synapse for YunoHost ](https://github.com/YunoHost-Apps/synapse_ynh ) should be installed beforehand.
2021-03-24 22:49:07 +01:00
2022-09-04 23:58:52 +02:00
2023-09-22 12:53:16 +02:00
**Shipped version:** 0.14.2~ynh1
2021-09-13 20:26:32 +02:00
## Documentation and resources
2021-03-24 22:49:07 +01:00
2022-05-29 17:44:59 +02:00
* Official app website: < https: // docs . mau . fi / bridges / python / telegram / index . html >
* Official user documentation: < https: // docs . mau . fi / bridges / python / telegram / management-commands . html >
* Official admin documentation: < https: // github . com / YunoHost-Apps / mautrix_telegram_ynh >
* Upstream app code repository: < https: // github . com / mautrix / telegram >
2023-10-26 18:51:13 +02:00
* YunoHost Store: < https: // apps . yunohost . org / app / mautrix_telegram >
2022-05-29 17:44:59 +02:00
* Report a bug: < https: // github . com / YunoHost-Apps / mautrix_telegram_ynh / issues >
2021-03-24 22:49:07 +01:00
## Developer info
2021-02-22 13:21:58 +01:00
Please send your pull request to the [testing branch ](https://github.com/YunoHost-Apps/mautrix_telegram_ynh/tree/testing ).
2021-03-24 22:49:07 +01:00
To try the testing branch, please proceed like that.
2022-05-29 17:44:59 +02:00
``` bash
2021-02-22 13:21:58 +01:00
sudo yunohost app install https://github.com/YunoHost-Apps/mautrix_telegram_ynh/tree/testing --debug
2021-03-24 22:49:07 +01:00
or
2021-02-22 13:21:58 +01:00
sudo yunohost app upgrade mautrix_telegram -u https://github.com/YunoHost-Apps/mautrix_telegram_ynh/tree/testing --debug
2021-03-24 22:49:07 +01:00
```
2022-05-29 17:44:59 +02:00
**More info regarding app packaging:** < https: / / yunohost . org / packaging_apps >