Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

CoverTele - A private covert channel over the Telegram

A tool and a library to provide a simple way of exchanging private text messages through the covert channel based on blacklising users written in Python.


  • Clone this repo: git clone;
  • Acquire Telegram api_id and api_hash by following this manual;
  • Edit set your new values to api_id and api_hash in the file header;
  • You're done.


Python 3 is required. You will also need Telethon as it's used to call Telegram API methods. You may install it with pip: pip install telethon


If nothing is happening on the connection (no output), try setting a proxy in file.

Command-line tool

python3 [-s/-r] [your username] [other username] [message]

To get message as user @mark from @tommy you call:

python3 -r mark tommy

And to send "OH, HI MARK!..." from @tommy to @mark do this after mark has started listening with the command above:

python3 -s tommy mark oh, hi mark!..


Here is a basic usage example:

from covertele import TelegramBlockingAPI
from cochannel import CovertChannel

# For channel to use telegram you need to create a suitable interface
# By default, standard IO used to authorize you, 
# but you can do it programmatically if you want to (see the source code)
id = input("Enter your id")
api = TelegramBlockingAPI(id)

# Now you can create channel object
friend = input("Enter your friend's id:")
channel = CovertChannel(api, friend)

# Use channel.receive() and channel.send() to transmit data between the users
channel.send("Bork, bork!")

# If you want to send and receive raw codes, you can call functions with '_raw' suffix
codes = channel.receive_raw()
for code in codes:
channel.send_raw([19, 24, 24, 13])


Simplified BSD, see LICENSE file.