From b2eb9d723bde94f5d8fe5b463a9a031d21ec2339 Mon Sep 17 00:00:00 2001
From: dataprolet <1+dataprolet@noreply.localhost>
Date: Mon, 11 May 2026 12:55:20 +0200
Subject: [PATCH] Update README.md

---
 README.md | 34 +++++++++++++++++++++++++++++-----
 1 file changed, 29 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index e08703e..6352999 100644
--- a/README.md
+++ b/README.md
@@ -6,18 +6,42 @@ This is a simple Python script to automatically unfollow inactive users on Blues
 
 ## Getting started
 
+### Installation
+
 1. Clone the repository:  
    ```git clone https://git.dataprolet.de/dataprolet/Bluesky-Unfollow-Inactive.git```
 2. Install Python modules:  
     ```python -m pip install atproto python-telegram-bot```
 3. Fill in the variables
-4. Create a Telegram bot
-5. Run the script using ```--dry``` or ```--prod``` and ```--days {amount of days}```
+4. Create a Telegram bot using the [BotFather](https://t.me/botfather)
 
-### Variables
-```handle```: Your Bluesky handle like _user.bsky.social_  
+#### Variables
+```handle```: Your Bluesky handle e. g. _user.bsky.social_  
 ```password```: Your [Bluesky app password](https://bsky.app/settings/app-passwords)  
 ```BOT_TOKEN```: Your Telegram bot BOT_TOKEN  
 ```CHAT_ID```: Your Telegram bot's chat ID  
 
-The chat ID can be retrieved by opening https://api.telegram.org/bot{BOT_TOKEN}/getUpdates in a browser, send a message to the bot and get chat.id from the returning JSON.
\ No newline at end of file
+The chat ID can be retrieved by opening https://api.telegram.org/bot{BOT_TOKEN}/getUpdates in a browser, send a message to the bot and get ```chat.id``` from the returning JSON.
+
+### Usage
+
+Run the script with the following arguments:  
+```python unfollow_inactive.py --dry --days 30```
+
+#### Arguments
+
+| Argument | Description                                                                     |
+| -------- | -------------------------------------------------------------------------------- |
+| `--dry`  | Dry run: Shows which users would be unfollowed without making any changes. |
+| `--prod` | Production mode: Actually unfollows the inactive users.|
+| `--days` | Number of days after which a user is considered inactive (default: 15).          |
+
+#### Examples:
+
+```
+# Dry run: Show users inactive for 60 days
+python unfollow_inactive.py --dry --days 60
+
+# Production run: Unfollow users inactive for 30 days
+python unfollow_inactive.py --prod --days 30
+```
\ No newline at end of file