{"id":22794422,"url":"https://github.com/imaun/telegram-contacts-export","last_synced_at":"2026-03-05T22:08:36.787Z","repository":{"id":168568655,"uuid":"644307363","full_name":"imaun/telegram-contacts-export","owner":"imaun","description":"Export Telegram Contacts to CSV and JSON formats","archived":false,"fork":false,"pushed_at":"2023-08-22T11:58:19.000Z","size":25,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-01T18:41:57.574Z","etag":null,"topics":["oauth2","telegram","telegram-contact","telegram-contact-exporter","telegram-contacts-export","telegram-export","telethon"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/imaun.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":"2023-05-23T08:49:57.000Z","updated_at":"2024-10-21T15:54:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"846db479-fb1d-45e0-adda-a5494a6c3c32","html_url":"https://github.com/imaun/telegram-contacts-export","commit_stats":null,"previous_names":["imaun/telegram-contacts-export"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/imaun/telegram-contacts-export","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imaun%2Ftelegram-contacts-export","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imaun%2Ftelegram-contacts-export/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imaun%2Ftelegram-contacts-export/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imaun%2Ftelegram-contacts-export/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/imaun","download_url":"https://codeload.github.com/imaun/telegram-contacts-export/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imaun%2Ftelegram-contacts-export/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30152089,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T21:15:50.531Z","status":"ssl_error","status_checked_at":"2026-03-05T21:15:11.173Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["oauth2","telegram","telegram-contact","telegram-contact-exporter","telegram-contacts-export","telegram-export","telethon"],"created_at":"2024-12-12T04:08:51.618Z","updated_at":"2026-03-05T22:08:36.764Z","avatar_url":"https://github.com/imaun.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"#  Telegram Contacts Export\nExport Telegram Contacts to CSV and JSON formats\n\n---\n## Farsi\nبرای گرفتن خروجی از **لیست کانتکت های تلگرام** باید api id و api hash از [اینجا](https://my.telegram.org/apps) \nدر سایت تلگرام بگیرید. بعد از کلون کردن این مخزن، فایل `example.env` در یک ادیتور مناسب باز کنید و مقادیری که از سایت تلگرام برداشتین در جای مناسب کانفیگ کنید و در نهایت این فایل تغییر نام بدین به `.env` یعنی فقط پسوند فایل نگهدارید و اسم رو پاک کنید.\nحواس تون باشه که برای ران کردن این برنامه به `python` نیاز دارید. اگر پایتون نصب ندارید از سایت رسمی ش برای سیستم عامل خودتون دانلود و نصب کنید.\n\n## راهنمای استفاده\nپس از اطمینان از نصب بودن پایتون، ترمینال را باز کنید و پیش نیازهای برنامه را نصب کنید :\n```commandline\npip install requirements.txt\n```\nاین برنامه برای برقراری امن با تلگرام از کتابخانه **telethon** استفاده می کند. سپس :\n```commandline\npython app.py\n```\nاجرا کنید. پس از اجرای برنامه **telethon** سعی در ایجاد یک ارتباط امن با تلگرام می کند. \nابتدا از شما می خواهد شماره موبایل خود را وارد کنید. در مرحله بعد تلگرام یک کد برای شما ارسال می کند (شبیه به زمانی که می خواهید از یک دستگاه جدید به تلگرام وارد شوید)\nکه بعد از وارد کردن این کد، در صورت فعال بودن احراز هویت دو مرحله ای تلگرام، از شما کلمه عبورتان را می خواهد. \nپس از وارد کردن موارد گفته شده، لیستی از کانتکت های شما در خروجی ترمینال چاپ می شود و بعد از آن شما یک فایل به نام \n`contacts.csv` در مسیر جاری برنامه خواهید یافت که شامل تمام موارد چاپ شده روی ترمینال خواهد بود.\n\n## خطای TakeoutInitDelayError\nدر صورت مشاهده این خطا بعد از اجرای برنامه، سعی کنید یک بار دیگر برنامه را اجرا کنید. اگر باز هم این خطا را \nردیافت کردید، بهتر است بعد از چند دقیقه دوباره سعی کنید.\n\n\n## English\nFirst clone this repo. Make sure you have `python` installed on your system. \nNavigate to the repository directory and run :\n```commandline\npip install requirements.txt\n```\nThis application uses `telethon` to securely connect to Telegram via OAuth2. \nTne run :\n```commandline\npython app.py\n```\nAfter that, you must see all your Telegram's contacts on your terminal. \nAlso, all of your contacts will be saved on a csv file in the current directory named :\n `contacts.csv`.\nIf you get error message `TakeoutInitDelayError` please re run the app or wait \na few minutes then retry.\n\n### Contact\nEmail : **imun22** on gmail.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimaun%2Ftelegram-contacts-export","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimaun%2Ftelegram-contacts-export","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimaun%2Ftelegram-contacts-export/lists"}