{"id":19832052,"url":"https://github.com/ail-project/ail-feeder-telegram","last_synced_at":"2025-05-01T16:32:52.524Z","repository":{"id":41876114,"uuid":"291074871","full_name":"ail-project/ail-feeder-telegram","owner":"ail-project","description":"External telegram feeder for AIL framework ","archived":false,"fork":false,"pushed_at":"2025-04-30T13:52:23.000Z","size":159,"stargazers_count":13,"open_issues_count":9,"forks_count":2,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-30T15:07:04.111Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ail-project.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,"zenodo":null}},"created_at":"2020-08-28T15:01:03.000Z","updated_at":"2025-04-30T13:52:26.000Z","dependencies_parsed_at":"2023-12-08T12:24:07.716Z","dependency_job_id":"6814eab9-fbf0-4d2b-8d9d-937f3a9372d2","html_url":"https://github.com/ail-project/ail-feeder-telegram","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ail-project%2Fail-feeder-telegram","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ail-project%2Fail-feeder-telegram/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ail-project%2Fail-feeder-telegram/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ail-project%2Fail-feeder-telegram/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ail-project","download_url":"https://codeload.github.com/ail-project/ail-feeder-telegram/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251907055,"owners_count":21663209,"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":[],"created_at":"2024-11-12T11:36:12.060Z","updated_at":"2025-05-01T16:32:52.518Z","avatar_url":"https://github.com/ail-project.png","language":"Python","readme":"# ail-feeder-telegram\nExternal telegram feeder for AIL framework (with an automated user account)\n\n- [x] Forum channels\n- [x] Replies Threads\n- [x] Images Download\n- [x] Users + channels meta and profile picture\n- [x] Files download (Saved on disk)\n\n## Install\n\n- Install python3 dependencies:\n```bash\npip3 install -U -r requirements.txt\n```\n\n- Install libmagic:\n```bash\nsudo apt-get install libmagic1\n```\n\n- Copy config file:\n```bash\ncp etc/conf.cfg.sample etc/conf.cfg\n```\n\n## Configuration\n\n### Telegram\n\nAdd your telegram account in `etc/conf.cfg`:\n  - Login in with your [telegram phone number](https://my.telegram.org/auth)\n  - Click under API Development tools.\n  - Create new application\n  - Fill `App title` and `Short name` in your application details\n  - Create application and retrieve your API ID and Hash\n  - Add your API ID and Hash in `etc/conf.cfg`\n\n\n :warning: **Telegram API hash is secret and can't be revoked** :warning:  \nYou can use this API ID and hash with any phone number or even for bot accounts\n\n### AIL\n\n- Add your AIL **URL** and **API key** in `etc/conf.cfg` to push messages to AIL\n- Sending Message to AIL is optional\n\n## Usage\n\nfeeder.py\n* chats ( List all joined chats_ )\n* join ( _Join a chat by its name or invite hash_ )\n  * --name [Chat name] ( _chat name/username_ )\n  * --invite [Invite Hash] ( _chat invite hash_ )\n* leave [Channel] ( _Leave a Chat_ )\n* check [Invite Hash] ( _Check an invite hash/chat without joining_ )\n* messages [Chat ID/username] ( _Get all messages from a chat_ )\n  * --min_id [Message ID] ( _Filter: Message Minimal ID_ )\n  * --max_id [Message ID] ( _Filter: Message Maximum ID_ )\n  * --replies ( _Get replies_ )\n  * --mark_as_read ( _Mark messages as read_ )\n  * --media ( _Download medias_ )\n  * --save_dir ( _Directory to save downloaded medias_ )\n* message [Chat ID/username] [Message ID] ( _Get a message from a chat_ )\n  * --replies ( _Get replies_ )\n  * --mark_as_read ( _Mark message as read_ )\n  * --media ( _Download medias_ )\n  * --save_dir ( _Directory to save downloaded medias_ )\n* monitor ( _Monitor all joined chats_ )\n* unread ( _Get all unread messages from all chats and mark them as read_ )\n* chat [Chat ID/username] (  _Get a chat metadata, list of users/admins, ..._ )\n  * --users ( _Get a list of all the users of a chat_ )\n  * --admins ( _Get a list of all the admin users of a chat_ )\n  * --similar ( _Get a list of similar/recommended chats_ )\n* entity [Entity ID/username] ( _Get chat or user metadata_ )\n* search [to_search] ( _Search for public Chats/Users_ )\n\n## Joining Channels\n```bash\npython3 bin/feeder.py join -n CHANNEL_USERNAME \n```\n```bash\npython3 bin/feeder.py join -i INVITE_HASH \n```\nChannels can also be joined from the mobile application on Apple or Android.\nOnce the script is re-run, the newly joined channel will be added to the messages queue.\n\n## Leaving Channels\n```bash\npython3 bin/feeder.py leave CHANNEL_USERNAME/CHANNEL_ID \n```\nChannels can also be left from the mobile application on Apple or Android.\nIf you leave a channel whilst the script is running there will likely be an exception error.\n\n## Get all Channels\n```bash\npython3 bin/feeder.py chats \n```\nRunning this action will export a python list of channel IDs your Telegram account has joined.\n\nIf you join too many channels, too quickly, you might experience a waiting period before you can join a new one.\n\n## Get Channel Messages\n```bash\npython3 bin/feeder.py messages CHANNEL_USERNAME/CHANNEL_ID\n```\n\n## MONITOR Messages from all Joined Channels\n```bash\npython3 bin/feeder.py monitor\n```\n","funding_links":[],"categories":["Pentesting"],"sub_categories":["OSINT - Open Source INTelligence"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fail-project%2Fail-feeder-telegram","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fail-project%2Fail-feeder-telegram","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fail-project%2Fail-feeder-telegram/lists"}