2023-12-12 12:21:26 +01:00
<!--
2024-03-26 16:24:24 +01:00
N.B.: This README was automatically generated by < https: / / github . com / YunoHost / apps / tree / master / tools / readme_generator >
2023-12-12 12:21:26 +01:00
It shall NOT be edited by hand.
-->
# Matrix-Telegram bridge for YunoHost
[![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 )
[![Install Matrix-Telegram bridge with YunoHost ](https://install-app.yunohost.org/install-with-yunohost.svg )](https://install-app.yunohost.org/?app=mautrix_telegram)
2024-03-26 16:24:24 +01:00
*[Read this README is other languages.](./ALL_README.md)*
2023-12-12 12:21:26 +01:00
2024-03-26 16:24:24 +01:00
> *This package allows you to install Matrix-Telegram bridge quickly and simply on a YunoHost server.*
> *If you don't have YunoHost, please consult [the guide](https://yunohost.org/install) to learn how to install it.*
2023-12-12 12:21:26 +01:00
## Overview
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.
2024-02-28 20:23:19 +01:00
**Shipped version:** 0.15.1~ynh2
2021-09-13 20:26:32 +02:00
## Documentation and resources
2021-03-24 22:49:07 +01:00
2024-03-26 16:24:24 +01: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 >
- YunoHost Store: < https: // apps . yunohost . org / app / mautrix_telegram >
- Report a bug: < https: // github . com / YunoHost-Apps / mautrix_telegram_ynh / issues >
2021-03-24 22:49:07 +01:00
## Developer info
2024-03-26 16:24:24 +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
2024-03-26 16:24:24 +01:00
To try the `testing` branch, please proceed like that:
2022-05-29 17:44:59 +02:00
2024-03-26 16:24:24 +01: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
```
2024-03-26 16:24:24 +01:00
**More info regarding app packaging:** < https: / / yunohost . org / packaging_apps >