https://github.com/cycneuramus/agoreuein
Python script to reach out to Russian civilians on Telegram
https://github.com/cycneuramus/agoreuein
python telegram telegram-api telethon-based ukraine ukraine-invasion ukrainewar
Last synced: 3 months ago
JSON representation
Python script to reach out to Russian civilians on Telegram
- Host: GitHub
- URL: https://github.com/cycneuramus/agoreuein
- Owner: cycneuramus
- License: gpl-3.0
- Created: 2022-03-19T22:31:56.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-02-27T14:23:51.000Z (over 1 year ago)
- Last Synced: 2025-01-03T00:35:00.054Z (5 months ago)
- Topics: python, telegram, telegram-api, telethon-based, ukraine, ukraine-invasion, ukrainewar
- Language: Python
- Homepage:
- Size: 23.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: .github/README.md
- License: LICENSE
Awesome Lists containing this project
README
# Agoreuein
> "The first casualty, when war comes, is truth."
This is a Python script that periodically tries to send a message, pre-defined by you, to a random Russian phone number over Telegram. I wrote this as a proof-of-concept for trying to break the barrier of Russian state propaganda concerning the invasion of Ukraine. The inspiration comes from https://1920.in, developed by [squad303](https://github.com/squad303/squad303app).
Note that not all selected phone numbers will be associated with a Telegram account. As such, error messages are to be expected.
## WARNING
This program is not a bot, but uses the Telegram API to send its messages directly from an account that you control. In order for this to work, the program must first add the intended recipient to your contacts. **Contacting people you don't know en-masse is considered to be spam.** It is highly likely that your account will be reported as such and limited for a time. Repeated offences may impose further limits and, ultimately, block your account altogether. For more information, see Telegram's [Spam FAQ](https://telegram.org/faq_spam).
## Note on messages
The point of this program is not to harass people, but to engage in civil discourse with those who may be victims of state-sponsored disinformation and propaganda. As such, I would encourage you to refrain from sending inflammatory or unnecessarily polarizing messages.
## Usage
### Docker
Clone this repo:
```
git clone https://github.com/cycneuramus/agoreuein
```
Create and populate the `.env` file (see `.env_example` for details):
```
cd agoreuein
vim .env
```
Build the container and authorize your Telegram account on first run:
```
docker-compose build
docker-compose run agoreuein
```
Now, either keep the container running, or cancel the foreground process and start it in the background:
```
docker-compose up -d
```
### Bare metal
Yes, I've made this tiny script run in Docker. There is technically no need for this, of course, but it's what I do to keep my environment clean and reproducible, and I provide this repo as-is. If you prefer bare metal, you would need to:
+ `pip install names requests telethon`
+ `export API_ID=`
+ `export API_HASH=`
+ `export MY_PHONE_NUMBER=`
+ `export MSG=`
Alternatively, instead of setting environment variables, you may edit `agoreuein.py` directly to add the appropriate values.