teleout's Introduction

Teleout

Pipe stdout and files to telegram
This software uses telegram bots
Powered with love
Go version: https://github.com/teadove/goteleout

Examples

ls -la | teleout -u 418878871 -c - send output of ls -la to chat 418878871 with monospace font
teleout -u 418878871 -f main.py "<b>This is main.py!</b>" --html - send file main.py, with bolded text "This is main.py!"

Features

Send files, text messages directly to telegram
Pipe to teleout(ls | teleout will work)
HTML parse mode supported
Easy install and use
Captions for files

Manual

usage: main.py [-h] [-u USER] [-f FILE] [-c] [-F] [-t TOKEN] [-n] [-q] [--html] [--ansi-colors] [message [message ...]]

Pipe stdout and files to telegram(via bots).

positional arguments:
  message               specify text of message to send, overwrites pipes.

optional arguments:
  -h, --help            show this help message and exit
  -u USER, --user USER  specify user with chat_id to send
  -f FILE, --file FILE  send file, text will be sent as caption.
  -c, --code            send text with <code> text to make it monospace, apply tags escaping and send as html
  -F, --force-file      send text in file even if it is shorter than 4096 symbols
  -t TOKEN, --token TOKEN
                        specify telegram api token. if not set will use default
  -n, --new             use with --token or --user to set new default
  -q, --quite           send message without notifications, default is false
  --html                parse as html and apply <b>, <i> etc. tags
  --ansi-colors         don't remove ANSI escape codes from piped strings

Installation

From pip as package
pip install teleout
or from git as script

wget https://raw.githubusercontent.com/TeaDove/teleout/master/teleout/main.py -O teleout.py && chmod u+x teleout.py

Get bot token from @BotFather
Start teleout with teleout, enter your token, default chat id. All data will be saved in ~/.config/teleout.json
Enjoy!
Works fine on Linux and Mac OS.