Package: jabbergram
Contents1 jabbergram1.1 English1.1.1 About1.1.2 Installation1.1.3 Configuration1.1.4 Usage1.1.5 License1.2 Castellano1.2.1 Acerca de1.2.2 Instalación1.2.3 Configuración1.2.4 Uso1.2.5 Licencia1 jabbergram1.1 English1.1.1 AboutWith this program, it’s possible to use a MuCXMPProom to talk to a group onTelegramand vice versa. The aim of this program is to be just a simple gateway, just pass text from one way to the other. Once it’s stable, it probably won’t have more improvements, since I don’t need them.Since version 0.1.6, Jabbergram has HTTP Upload support. If the server supports it, it will automatically upload all the files sent to the Telegram group.1.1.2 InstallationAs with any program that uses python, it should be used a virtual environment (virtualenv), but that is user selectable. It’s possible to use one of the next installation methods:Install via pip:0$su-c"pip3 install jabbergram"Clone the repository:0$gitclonehttps://git.daemons.it/drymer/jabbergram1$cdjabbergram2$su-c"pip3 install -r requirements.txt"3$su-c"python3 setup.py install"1.1.3 ConfigurationThis program is simple, it even doesn’t have ahelpmenu. First thing you need to do is to createTelegramBot. To do so, you must have a telegram account and talk toBotFather. Then, execute:0/start1/newbot2YourNameBot# ended in bot, always3# then it will show your bot token, save it4/setprivacy5YourNameBot6# now press DisableThe/setprivacyoption is to make the bot read all what it’s said to him, not only when using commands. It’s necessary to makejabbergramwork. More info on creatingTelegrambots at theirwebpage.Then, you will have to create a config file. We’ll call itconfig.ini. In that file, enter the next parameters:0[config]1jid = exampleJid@nope.org2password = difficultPassword3muc_room = exampleMuc@muc.nope.org4nick = jabbergram5token = jabbergramBotTokken6group = -10293943920The only thing worth mentioning is thetokensection, which is said to you when creating the bot, and thegroup, that is theTelegramgroup ID.There’s no easy way to see this from telegram, so you can use the separate utility calledseeIdGroups.py. To execute it, you only need to set thetokenparameter in the config file. You will need that somebody invite the bot to the group. Also, people on that group must send some messages, so the utility can grab it’s id. It may take a couple. When you have the group ID you want, just press Ctrl-c, copy it to the config file (even the minus symbol), and the configuration will be done.1.1.4 UsageThere only can be one configuration file. This is because it can only be one bot connection, when there’s more than one, message are lost. Therefore, for linking more rooms you must “link” them in the configuration. This is done simply by hooking jabber rooms with Telegram:0[Config]1JID=exampleJid@nope.org2password=difficultPassword3muc_room=exampleMuc@muc.nope.orgsegunda@muc.sip.org4nick=jabbergram5token=jabbergramBotTokken6group=-10293943920120301203Thus, the example’s muc “exampleMuc@muc.nope.org” syncs with the group “-10293943920” and “segunda@muc.sip.org” with “120 301203”.1.1.5 License0This program is free software: you can redistribute it and / or modify1it under the terms of the GNU General Public License as published by2the Free Software Foundation, Either version 3 of the License, or3(At your option) any later version.45This program is distributed in the hope That it will be useful,6but WITHOUT ANY WARRANTY; without even the implied warranty of7MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the8GNU General Public License for more details.910You should have received a copy of the GNU General Public License11Along With This Program. If not, see <http://www.gnu.org/licenses/>.1.2 Castellano1.2.1 Acerca deCon este programa es posible utilizar una salaXMPPpara hablar con un grupo deTelegramy viceversa. El objetivo de este programa es el de ser sólo una pasarela sencilla, sólo tiene que pasar el texto de un lado al otro. Una vez que sea estable, probablemente no tendrá más mejoras, ya que yo no las necesito.Desde la versión 0.1.6, Jabbergram tiene soporte HTTP Upload. Si el servidor lo soporta, subirá automáticamente todos los archivos enviados desde el grupo de Telegram.1.2.2 InstalaciónComo con cualquier programa escrito enPython, deberia ser usado en un entorno virtual (virtualenv), pero eso queda a la elección del usuario. Es posible utilizar uno de los siguientes métodos de instalación:Instalar a través depip:0$su-c"pip3 instalar jabbergram"Clonar el repositorio:0$gitclonehttps://git.daemons.it/drymer/jabbergram1$cdjabbergram2$su-c"pip3 instalar -r requirements.txt"3$su-c"python3 setup.py install"1.2.3 ConfiguraciónEste programa es simple, no tiene ni un menú deayuda. Lo primero que hay que hacer es crear el bot deTelegram. Para ello, hay que tener una cuenta deTelegramy hablar conBotFather. A continuación, ejecuta:0/start1/newbot2NombreDelBot# terminado en bot, siempre3# A continuación, se mostrará el token del bot, hay que guardarlo4/setprivacy5NombreDelBot6# Ahora hay que pulsar desactivarLa opción/setprivacyes para hacer que el robot pueda leer todo lo que se dice en el grupo, no sólo cuando se utilizan los comandos. Es necesario para hacer quejabbergramfuncione. Más información sobre la creación los bots deTelegramaen supágina web.A continuación, hay que crear un archivo de configuración, que llamaremosconfig.ini. En ese archivo, introduce los siguientes parámetros:0[Config]1JID = exampleJid@nope.org2password = difficultPassword3muc_room = exampleMuc@muc.nope.org4nick = jabbergram5token = jabbergramBotTokken6group = -10,293,943,920La única cosa que vale la pena mencionar es la sección deltoken(que es la que nos da cuando se crea el robot) y elgroup, que es ID del grupo deTelegram.No hay manera fácil de ver el ID desdeTelegram, por lo que se puede utilizar el programa llamadoseeIdGroups.py. Para ejecutarlo sólo es necesario establecer el parámetrotokendel archivo de configuración. Necesitarás que alguien invite al bot al grupo. Además, las personas de ese grupo deben enviar algunos mensajes, para que el programa pueda coger su ID. Puede llevar unos segundos el que aparezcan los mensajes. Cuando se tenga el ID de grupo que se quiere, sólo hay que pulsar Ctrl-c, copiarlo en el archivo de configuración (incluido el simbolo menos), y la configuración estará terminada.1.2.4 UsoSólo puede haber un archivo de configuración. Esto es debido a que sólo puede haber una conexión del bot, cuando hay más de una se pierden mensajes. Por lo tanto, para linkear más salas hay que “linkearlas” en la configuración. Esto se hace, simplemente, enganchando las salas de jabber con las de telegram:0[Config]1JID = exampleJid@nope.org2password = difficultPassword3muc_room = exampleMuc@muc.nope.org segunda@muc.sip.org4nick = jabbergram5token = jabbergramBotTokken6group = -10293943920 120301203De este modo, el muc “exampleMuc@muc.nope.org” se sincronizará con el grupo “-10293943920”, y “segunda@muc.sip.org” con “120301203”.1.2.5 Licencia0This program is free software: you can redistribute it and / or modify1it under the terms of the GNU General Public License as published by2the Free Software Foundation, Either version 3 of the License, or3(At your option) any later version.45This program is distributed in the hope That it will be useful,6but WITHOUT ANY WARRANTY; without even the implied warranty of7MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the8GNU General Public License for more details.910You should have received a copy of the GNU General Public License11Along With This Program. If not, see <http://www.gnu.org/licenses/>.