This project is an automated tool for scheduling messages on Telegram. It uses computer vision and GUI automation to set dates, times, and send messages according to a predefined schedule. The current version only works for dark mode of Telegram
-
Clone the repository:
git clone https://github.com/MaroB05/Telegram-Message-Scheduler.git cd Telegram-Message-Scheduler -
Install the required dependencies:
pip install opencv-python pyautogui pandas -
Ensure you have the necessary image files in the
Figures,Months, andStatesdirectories. They are already provided in the repo
-
Prepare your message schedule:
- Create an Excel file named
messages.xlsxin the project root directory. - The Excel file should have three columns: Sentence, Date, and Time.
- Fill in your messages, dates, and times in the respective columns.
- The Excel file should look like this:

- Ensure that the Date column is formatted as a date in Excel.
- The Time column should be formatted as time in Excel.
- Create an Excel file named
-
Open Telegram on your computer and navigate to the chat where you want to schedule messages.
-
Open the "Scheduled Messages" section in the chat
-
Run the script:
python telegram.py -
The script will:
- Read the messages from the Excel file.
- For each message:
- Type the message in the Telegram chat.
- Set the date and time for scheduling.
- Send the scheduled message.
-
Do not interfere with your mouse or keyboard while the script is running.
Note: This script uses screen capture and image recognition. Ensure your Telegram window is visible and not obstructed during execution.