{"id":15107839,"url":"https://github.com/qbject/autoreply","last_synced_at":"2026-01-28T09:37:38.966Z","repository":{"id":250747676,"uuid":"835356554","full_name":"Qbject/autoreply","owner":"Qbject","description":"A cross-platform PyQt5 app for auto-responding to Telegram and VK messages, with multi-account support, tray functionality, Google Sheets logging and more","archived":false,"fork":false,"pushed_at":"2024-11-29T17:07:43.000Z","size":42,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-30T17:12:20.229Z","etag":null,"topics":["google-sheets","gui","messaging","pyinstaller","pyqt5","python","python3","telegram","vk"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Qbject.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-29T17:03:21.000Z","updated_at":"2025-01-03T21:52:19.000Z","dependencies_parsed_at":"2024-07-29T23:15:14.031Z","dependency_job_id":null,"html_url":"https://github.com/Qbject/autoreply","commit_stats":null,"previous_names":["qbject/autoreply"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Qbject%2Fautoreply","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Qbject%2Fautoreply/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Qbject%2Fautoreply/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Qbject%2Fautoreply/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Qbject","download_url":"https://codeload.github.com/Qbject/autoreply/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237769067,"owners_count":19363250,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["google-sheets","gui","messaging","pyinstaller","pyqt5","python","python3","telegram","vk"],"created_at":"2024-09-25T21:41:53.739Z","updated_at":"2025-10-23T02:31:31.878Z","avatar_url":"https://github.com/Qbject.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Autoreply\n\nAutoreply is a cross-platform desktop application built on PyQt5 that allows users to connect their Telegram and VK accounts and automatically respond to incoming messages. The app offers a rich set of features, a verbose user-friendly GUI, and flexible configuration options.\n\nhttps://github.com/user-attachments/assets/fad6bb6d-3c09-484e-bbc3-f9fd3f124def\n\n## Table of Contents\n\n1. [Features](#features)\n2. [Prerequisites](#prerequisites)\n3. [Installation](#installation)\n4. [Usage](#usage)\n5. [Configuration](#configuration)\n   - [Telegram Setup](#telegram-setup)\n   - [VK Setup](#vk-setup)\n   - [Google Sheets Logging](#google-sheets-logging)\n   - [Telegram Bot for Logging](#telegram-bot-for-logging)\n6. [Technical Details](#technical-details)\n\n## Features\n\n- **Verbose GUI:** The app provides detailed explanations of all actions and settings within the GUI.\n- **Multi-Account Support:** Connect multiple Telegram and VK accounts, each running on separate threads.\n- **Tray Functionality:** Minimize the app to the system tray and close it entirely from the tray icon.\n- **Enable/Disable Accounts:** Enable or disable specific accounts at any time.\n- **First Message Response:** Option to respond only to the first message in a chat.\n- **Automatic Chat Deletion:** Automatically delete the chat after sending a response.\n- **Attachment Support:** Add attachments, such as images, to reply messages.\n- **Proxy Configuration:** Support for HTTP, SOCKS4, SOCKS5, and MTPROTO (Telegram only) proxies.\n- **Logging:** Logs all actions and errors to separate log files.\n- **Google Sheets Logging:** Send logs to Google Sheets for each automatic reply.\n- **Telegram Bot Reporting:** Use a Telegram bot to send reports about autoresponses to specified chats or channels at configurable intervals.\n- **Multithreading:** Efficiently handles tasks in parallel while maintaining a responsive GUI.\n- **Cross-Platform Compatibility:** Runs on any platform.\n\n## Prerequisites\n\n- Python 3.6+\n- Git\n\n## Installation\n\n1. **Clone the repository:**\n   ```sh\n   git clone https://github.com/Qbject/autoreply.git\n   cd autoreply\n   ```\n\n2. **Create a virtual environment:**\n   ```sh\n   python -m venv .venv\n   ```\n\n3. **Activate the virtual environment:**\n   - On Windows:\n     ```sh\n     .venv\\Scripts\\activate\n     ```\n   - On macOS/Linux:\n     ```sh\n     source .venv/bin/activate\n     ```\n\n4. **Install dependencies:**\n   ```sh\n   pip install -r requirements.txt\n   ```\n\n5. **Build the application using PyInstaller:**\n   ```sh\n   # On Windows\n   build.bat\n\n   # On macOS/Linux\n   ./build.sh\n   ```\n\n6. **The built app will be located in the `dist/Autoreply` directory. This directory is portable and contains all necessary data.**\n\n## Usage\n\n1. **Run the App:**\n   ```sh\n   python src/autoreply.py\n   ```\n\n2. **Tray Functionality:**\n   - Minimize the main window to the system tray.\n   - Close the app entirely using the tray icon.\n\n3. **Data Directory:**\n   - All app data, including Telegram sessions, Google API credentials, logs, and settings, are stored in the `data` directory.\n\n## Configuration\n\n### Telegram Setup\n\n1. Register your application on Telegram:\n   - Go to [my.telegram.org](https://my.telegram.org/).\n   - Log in with any Telegram account (preferably one you won't lose access to).\n   - Navigate to \"API Development Tools\" and create a new application.\n   - Choose \"Desktop\" as the platform and fill in the required fields.\n   - Copy the `api_id` and `api_hash` provided.\n\n2. In the Autoreply app, input the `api_id` and `api_hash` in the corresponding fields and save the settings.\n\n### VK Setup\n\n1. VK does not require additional setup beyond providing the VK App ID. The default is set to Kate Mobile's App ID, but you can change it if needed.\n\n### Google Sheets Logging\n\n1. Create a new project in the [Google Developers Console](https://console.developers.google.com/).\n2. Enable the Google Sheets API and Drive API for the project.\n3. Create a new Service Account, generate a JSON key file, and download it.\n4. Rename the file to `google.json` and place it in the `data` directory.\n5. Share two Google Sheets named \"Autoreply TG\" and \"Autoreply VK\" with write access to the service account.\n\n### Telegram Bot for Logging\n\n1. Create a new bot using [BotFather](https://t.me/BotFather).\n2. Copy the bot token and input it into the Autoreply app.\n3. Specify the IDs of users or channels to receive reports, which can be obtained using [@myidbot](https://t.me/myidbot) and [@raw_data_bot](https://t.me/raw_data_bot).\n\n## Technical Details\n\n- **Telethon Library:** Used for interfacing with the Telegram API.\n- **PyQt5:** Provides the graphical user interface.\n- **Multithreading:** Ensures efficient handling of multiple accounts and tasks.\n- **Cross-Platform:** Can be run on Windows, macOS, and Linux.\n- **Qt Designer and UI Compilation:**\n  - The app includes 2 UI files that can be edited using Qt Designer.\n  - These UI files can be compiled into Python files using the provided `compile-ui.bat` (for Windows) or `compile-ui.sh` (for macOS/Linux) scripts.\n\n## License\n\nThis project is licensed under the MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqbject%2Fautoreply","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqbject%2Fautoreply","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqbject%2Fautoreply/lists"}