{"id":28627427,"url":"https://github.com/alex5402/telegram-cli","last_synced_at":"2025-10-28T23:02:04.021Z","repository":{"id":270346620,"uuid":"910057954","full_name":"ALEX5402/telegram-cli","owner":"ALEX5402","description":"A telegram cli tool to upload files and send message on telegram using telegram id","archived":false,"fork":false,"pushed_at":"2024-12-30T12:46:29.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-12T09:53:11.326Z","etag":null,"topics":["telegram","telegram-api","telegram-cli"],"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/ALEX5402.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"alex5402","buy_me_a_coffee":"alex5402","custom":["https://www.binance.com/en-IN/my/wallet/account/main/withdrawal/crypto/USDT","Binance__749326513"]}},"created_at":"2024-12-30T11:44:38.000Z","updated_at":"2024-12-30T12:46:32.000Z","dependencies_parsed_at":"2024-12-31T14:46:48.182Z","dependency_job_id":null,"html_url":"https://github.com/ALEX5402/telegram-cli","commit_stats":null,"previous_names":["alex5402/telegram-cli"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ALEX5402/telegram-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ALEX5402%2Ftelegram-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ALEX5402%2Ftelegram-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ALEX5402%2Ftelegram-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ALEX5402%2Ftelegram-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ALEX5402","download_url":"https://codeload.github.com/ALEX5402/telegram-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ALEX5402%2Ftelegram-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281527379,"owners_count":26516845,"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","status":"online","status_checked_at":"2025-10-28T02:00:06.022Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["telegram","telegram-api","telegram-cli"],"created_at":"2025-06-12T09:41:34.940Z","updated_at":"2025-10-28T23:02:04.004Z","avatar_url":"https://github.com/ALEX5402.png","language":"Python","readme":"# 🚀 Telegram CLI Tool\n\nA simple and efficient command-line interface (CLI) tool for interacting with Telegram. This project is built using Python and packaged into a standalone executable using PyInstaller.\n\n---\n\n## 📋 Features\n\n- 📤 Send text messages\n- 📁 Send files with optional descriptions\n- 🌐 Works with private chats, groups, and channels\n- 🔒 Secure and lightweight executable\n\n---\n\n## 🛠️ Build Instructions\n\nFollow these steps to build the project into a standalone executable:\n\n### Prerequisites\n\n1. 🐍 **Python 3.8+**\n2. 📦 Required dependencies (install via `requirements.txt`):\n   ```bash\n   pip install -r requirements.txt\n   ```\n3. 🛠️ **PyInstaller**:\n   ```bash\n   pip install pyinstaller\n   ```\n\n### Building the Executable\n\n1. Clone the repository and navigate to the project directory.\n2. Run the following command to build the executable:\n   ```bash\n   make\n   ```\n\n### Cleaning Up\n\nTo remove build artifacts and temporary files:\n```bash\nmake clean\n```\n\n---\n\n## 📦 Generated Executable\n\n- The standalone executable will be located in the `dist` folder after the build process.\n- Run the executable using:\n  ```bash\n  ./dist/telegram-cli\n  ```\n\n---\n\n## 🔧 Usage\n\nHere’s how to use the CLI tool:\n\n### Sending a Text Message\n```bash\n./dist/telegram-cli -p \u003cuser_id\u003e -t \"Hello, this is a test message!\"\n```\n\n### Sending a File with Description\n```bash\n./dist/telegram-cli -g \u003cgroup_id\u003e -F /path/to/file.txt -d \"File description here.\"\n```\n\n### Available Options\n\n| Option           | Description                       |\n|------------------|-----------------------------------|\n| `-p \u003cuser_id\u003e`   | Send to a private user            |\n| `-g \u003cgroup_id\u003e`  | Send to a group                  |\n| `-c \u003cchannel_id\u003e`| Send to a channel                |\n| `-t \u003cmessage\u003e`   | Text message to send             |\n| `-F \u003cfile\u003e`      | File path to send                |\n| `-d \u003cdescription\u003e`| Description for the file (optional)|\n\n---\n\n## 📂 File Structure\n\n```plaintext\n├── telegram-cli.py       # Main script\n├── requirements.txt      # Dependencies\n├── Makefile              # Build automation\n├── dist/                 # Generated executables\n└── README.md             # Project documentation\n```\n\n---\n\n## 🌟 Contributions\n\nContributions are welcome! Feel free to open issues or submit pull requests. 😊\n\n---\n\n## 📜 License\n\nThis project is licensed under the MIT License. See `LICENSE` for details.\n\n---\n\n## 🤝 Acknowledgments\n\n- Built with ❤️ using [Telethon](https://docs.telethon.dev/)\n- Packaged with 🛠️ [PyInstaller](https://www.pyinstaller.org/)\n\n---\n\n## 🚀 Let's Build Together!\n\nIf you find this project helpful, please ⭐ it and share it with others! 💖\n","funding_links":["https://github.com/sponsors/alex5402","https://buymeacoffee.com/alex5402","https://www.binance.com/en-IN/my/wallet/account/main/withdrawal/crypto/USDT","Binance__749326513"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falex5402%2Ftelegram-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falex5402%2Ftelegram-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falex5402%2Ftelegram-cli/lists"}