Metadata-Version: 2.4
Name: telebulk
Version: 0.1.0
Summary: Execute actions on multiple Telegram users or groups
License: EUPL-1.2
Author: Stefano Pigozzi
Author-email: me@steffo.eu
Requires-Python: >=3.13,<4.0
Classifier: License :: OSI Approved :: European Union Public Licence 1.2 (EUPL 1.2)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: click (>=8.3.0,<9.0.0)
Requires-Dist: telethon (>=1.41.2,<2.0.0)
Description-Content-Type: text/markdown

<div align="center">

![](.media/icon-128x128_round.png)

# Telebulk

Execute actions on multiple Telegram users or groups

</div>

> [!Warning]
>
> New actions are added to this tool as needed.
>
> Because of that, functionality is very limited at the moment.
>
> Feel free to request any new features though!

## Links

[![Available on PyPI](https://img.shields.io/pypi/v/telebulk)](https://pypi.org/project/telebulk/)

## Actions available

- Kick (and Unban)

## Usage examples

<details>
<summary>Kick a single user from a single group</summary>

```fish
telebulk --user='12345' --group='67890' --kick
```

</details>

<details>
<summary>Unban a user from all group IDs contained in a file</summary>

```fish
#!/usr/bin/env fish
telebulk --user='12345' --group=(cat unban_groups.txt) --kick
```

</details>

