patetig

Introduction

Building

PAThetic tElegram To Irc Gateway is a trivial IRC <-> telegram gateway.

Dependency

Of course a Common lisp compiler is mandatory, the compilation has been tested only with SBCL version 1.3.14 on Debian GNU/Linux (testing).

Software

• screen;
• git;
• gpg;
• bash;
• wget
• A common lisp compiler with thread support (tested with SBCL);
• GNU autotools toolchain.

Libraries

• alexandria;
• cl-ppcre-unicode;
• log4cl;
• bordeaux-threads;
• birch;
• cl-telegram-bot.

cl-telegram-bot is not yet in quicklisp you should clone the repository from:

https://github.com/sovietspaceship/cl-telegram-bot

Other

Of course a telegram bot is needed see: https://core.telegram.org/bots/

to actually build software run

• $ autoreconf -fiv
• $ ./configure
• $ bash ./quick_quicklisp.sh
• $ make

Configuration

Edit file config.lisp

Starting the software

• $ echo "telegram-api-key" | ./patetig

(warning: lot of debug output is printed on standard output)

Important note

This software will fetch photo and documents from the telegram bot and will cache in the directory specified by:

+image-output-dir+
+document-output-dir+

on your computer with a file name corrisponding to a base64-like hashed file-content of the image. Because the hash function is not perfect collisions will occurs . The software will create the file with this name if it does not exists and will not overwrite a file with the same name if it does exists.

Moreover the program will forward an http URL with your hostname (as got by a syscall) to the IRC channel.

Fetching photo and document is disabled by default, to enable uncomment the line:

(add-telegram->irc-hook #'image->irc-hook)

in image-irc-hook.lisp

and

(add-telegram->irc-hook #'document->irc-hook)

in

document-irc-hook.lisp

BUGS

Many. Please send bug report to cage-dev at twistfold dot it or file a bug report on the issue tracker

License

This program is released under GNU General Public license version 3 or later (see COPYING file).

The program use data and code from other sources, please see LICENSES.org for credits.

Altough any efforts has been put to make the list of credits exaustive, errors are always possible. Please send correction to cage-dev at twistfold dot it.

Contributing

NO WARRANTY

Any help is appreciated. If you intend to contribute please send a message to cage-dev at twistfold dot it

patetig: irc <-> telegram gateway Copyright (C) 2017 cage

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Thanks

• All the peoples listed in LICENSES.org file;