{"id":31337567,"url":"https://github.com/chatman-media/telegram-badge","last_synced_at":"2025-09-26T03:35:27.872Z","repository":{"id":305622432,"uuid":"1023381122","full_name":"chatman-media/telegram-badge","owner":"chatman-media","description":"Telegram Group/Channel Badge Generator - generates SVG badges with the current member count of your Telegram group.","archived":false,"fork":false,"pushed_at":"2025-09-21T22:15:29.000Z","size":1591,"stargazers_count":16,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-22T00:12:53.609Z","etag":null,"topics":["badge","badge-generator","github-badges","readme-badge","readme-badges","serverless","telegram","telegramgroups","typescript","vercel"],"latest_commit_sha":null,"homepage":"https://telegram-badge.vercel.app","language":"HTML","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/chatman-media.png","metadata":{"files":{"readme":"README.ar.md","changelog":"CHANGELOG.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-21T04:51:51.000Z","updated_at":"2025-09-21T22:15:32.000Z","dependencies_parsed_at":"2025-07-21T07:12:27.158Z","dependency_job_id":"6095f8ce-8037-4146-aa35-402d40816b2b","html_url":"https://github.com/chatman-media/telegram-badge","commit_stats":null,"previous_names":["chatman-media/telegram-badge"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/chatman-media/telegram-badge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chatman-media%2Ftelegram-badge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chatman-media%2Ftelegram-badge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chatman-media%2Ftelegram-badge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chatman-media%2Ftelegram-badge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chatman-media","download_url":"https://codeload.github.com/chatman-media/telegram-badge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chatman-media%2Ftelegram-badge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":277015224,"owners_count":25745553,"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-09-26T02:00:09.010Z","response_time":78,"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":["badge","badge-generator","github-badges","readme-badge","readme-badges","serverless","telegram","telegramgroups","typescript","vercel"],"created_at":"2025-09-26T03:35:26.012Z","updated_at":"2025-09-26T03:35:27.864Z","avatar_url":"https://github.com/chatman-media.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# مولد شارات تيليجرام\n\n[🇺🇸 English](README.md) | [🇷🇺 Русский](README.ru.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇪🇸 Español](README.es.md) | [🇵🇹 Português](README.pt.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇹🇭 ไทย](README.th.md) | [🇨🇳 中文](README.zh.md)\n\n[![Build Status](https://github.com/chatman-media/telegram-badge/workflows/CI/badge.svg)](https://github.com/chatman-media/telegram-badge/actions)\n[![Release](https://github.com/chatman-media/telegram-badge/workflows/Release/badge.svg)](https://github.com/chatman-media/telegram-badge/actions)\n[![npm version](https://img.shields.io/npm/v/telegram-badge.svg)](https://www.npmjs.com/package/telegram-badge)\n[![JSR](https://jsr.io/badges/@chatman-media/telegram-badge)](https://jsr.io/@chatman-media/telegram-badge)\n[![npm bundle size](https://img.shields.io/bundlephobia/minzip/telegram-badge)](https://bundlephobia.com/package/telegram-badge)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.5-blue.svg)](https://www.typescriptlang.org/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n[![GitHub stars](https://img.shields.io/github/stars/chatman-media/telegram-badge?style=social)](https://github.com/chatman-media/telegram-badge)\n[![dev.to](https://img.shields.io/badge/dev.to-Article-0A0A0A.svg?style=flat\u0026logo=dev.to)](https://dev.to/chatman-media/show-your-telegram-group-member-count-in-github-readme-46pl)\n[![X (Twitter)](https://img.shields.io/badge/Tweet-1DA1F2.svg?style=flat\u0026logo=x\u0026logoColor=white)](https://x.com/chatman_media/status/1947399700795244694)\n\nهذا المشروع ينشئ شارات SVG بعدد أعضاء مجموعات وقنوات التيليجرام الحالي الخاص بك. مثالي لعرض نشاط المجتمع في ملفات README على GitHub أو على المواقع.\n\n## البدء السريع\n\nفقط استخدم معلمات URL لإنشاء شارات لأي مجموعة أو قناة تيليجرام:\n\n```\nhttps://telegram-badge.vercel.app/api/telegram-badge?channelId=@your_channel_or_group\n```\n\n![Telegram Group Members](https://telegram-badge.vercel.app/api/telegram-badge?channelId=@timelinestudiochat)\n\n---\n\n## المكدس التكنولوجي\n\n- Node.js / TypeScript\n- Telegram Bot API\n- Vercel (Serverless API)\n- Jest للاختبار\n\n---\n\n## الاستخدام\n\n### الطريقة الأساسية: معلمات URL (لا يتطلب إعداد!)\n\nفقط أضف معرف مجموعة/قناة التيليجرام الخاص بك إلى URL:\n\n```markdown\n![Telegram Badge](https://telegram-badge.vercel.app/api/telegram-badge?channelId=@your_channel_or_group)\n```\n\n**الكيانات المدعومة:**\n- القنوات العامة (مثال: `@your_channel`)\n- المجموعات العامة (مثال: `@your_group`)\n- المجموعات/القنوات الخاصة (استخدم المعرف الرقمي مثل `-1001234567890`)\n\nهذا كل شيء! لا حاجة للنشر، لا حاجة لرمز البوت للقنوات والمجموعات العامة.\n\n### الطريقة البديلة: الاستضافة الذاتية\n\nللمستخدمين المتقدمين الذين يرغبون في استضافة نسختهم الخاصة:\n\n#### 1. المتطلبات الأساسية\n- رمز بوت التيليجرام (أنشئه عبر [@BotFather](https://t.me/botfather))\n- حساب Vercel (أو أي استضافة Node.js)\n\n#### 2. النشر على Vercel\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fchatman-media%2Ftelegram-badge)\n\nقم بتعيين متغيرات البيئة:\n- `BOT_TOKEN`: رمز بوت التيليجرام الخاص بك\n- `CHAT_ID`: معرف الدردشة الافتراضي (اختياري إذا كنت تستخدم معلمات URL)\n\n#### 3. التطوير المحلي\n\n```bash\ngit clone https://github.com/chatman-media/telegram-badge.git\ncd telegram-badge\nnpm install\n\n# إنشاء ملف .env\necho \"BOT_TOKEN=your_bot_token\" \u003e .env\necho \"CHAT_ID=@your_channel\" \u003e\u003e .env\n\nnpm run dev\n```\n\n### معلمات التنسيق\n\nيمكنك تخصيص مظهر الشارة باستخدام المعلمات التالية:\n\n| المعلمة | الوصف | القيمة الافتراضية |\n|-----------|-------------|------------------------|\n| `channelId` | معرف أو اسم مستخدم دردشة التيليجرام (مثال: `@timelinestudiochat`) | من البيئة |\n| `style` | نمط الشارة | `flat` |\n| `label` | نص التسمية | `Telegram` |\n| `color` | لون الشارة الرئيسي | `2AABEE` (لون التيليجرام) |\n| `labelColor` | لون التسمية | `555555` |\n| `logo` | إظهار شعار التيليجرام | `true` |\n\n#### الأنماط المتاحة:\n\n- `flat` - نمط مسطح (افتراضي)\n- `plastic` - نمط بلاستيكي مع تدرج\n- `flat-square` - نمط مسطح مربع بدون زوايا مستديرة\n- `for-the-badge` - نمط عريض مع أحرف كبيرة\n- `social` - نمط اجتماعي GitHub\n\n#### أمثلة:\n\nالشارة القياسية (نمط flat):\n```\nhttps://telegram-badge.vercel.app/api/telegram-badge?channelId=@your_channel\n```\n![Flat](https://telegram-badge.vercel.app/api/telegram-badge?channelId=@timelinestudiochat)\n\nشارة بنمط plastic:\n```\nhttps://telegram-badge.vercel.app/api/telegram-badge?channelId=@your_channel\u0026style=plastic\n```\n![Plastic](https://telegram-badge.vercel.app/api/telegram-badge?channelId=@timelinestudiochat\u0026style=plastic)\n\nشارة بنمط flat-square:\n```\nhttps://telegram-badge.vercel.app/api/telegram-badge?channelId=@your_channel\u0026style=flat-square\n```\n![Flat-Square](https://telegram-badge.vercel.app/api/telegram-badge?channelId=@timelinestudiochat\u0026style=flat-square)\n\nشارة بنمط for-the-badge:\n```\nhttps://telegram-badge.vercel.app/api/telegram-badge?channelId=@your_channel\u0026style=for-the-badge\n```\n![For-The-Badge](https://telegram-badge.vercel.app/api/telegram-badge?channelId=@timelinestudiochat\u0026style=for-the-badge)\n\nشارة بنمط social:\n```\nhttps://telegram-badge.vercel.app/api/telegram-badge?channelId=@your_channel\u0026style=social\n```\n![Social](https://telegram-badge.vercel.app/api/telegram-badge?channelId=@timelinestudiochat\u0026style=social)\n\nشارة بتسمية ولون مخصصين:\n```\nhttps://telegram-badge.vercel.app/api/telegram-badge?channelId=@your_channel\u0026label=انضم%20للدردشة\u0026color=00FF00\n```\n![Custom](https://telegram-badge.vercel.app/api/telegram-badge?channelId=@timelinestudiochat\u0026label=انضم%20للدردشة\u0026color=00FF00)\n\nشارة مخصصة بالكامل:\n```\nhttps://telegram-badge.vercel.app/api/telegram-badge?channelId=@your_channel\u0026style=for-the-badge\u0026label=المجتمع\u0026color=FF5733\u0026labelColor=1A1A1A\n```\n![Full Custom](https://telegram-badge.vercel.app/api/telegram-badge?channelId=@timelinestudiochat\u0026style=for-the-badge\u0026label=المجتمع\u0026color=FF5733\u0026labelColor=1A1A1A)\n\nشارة بدون شعار:\n```\nhttps://telegram-badge.vercel.app/api/telegram-badge?channelId=@your_channel\u0026logo=false\n```\n![No Logo](https://telegram-badge.vercel.app/api/telegram-badge?channelId=@timelinestudiochat\u0026logo=false)\n\nشارة لقناة محددة:\n```\nhttps://telegram-badge.vercel.app/api/telegram-badge?channelId=@your_channel\n```\n\nشارة بتنسيق مخصص:\n```\nhttps://telegram-badge.vercel.app/api/telegram-badge?channelId=@your_channel\u0026style=for-the-badge\u0026color=FF5733\n```\n\n## المميزات\n\n- 👥 عرض عدد الأعضاء في الوقت الفعلي\n- 🔗 معلمات URL المباشرة - لا يتطلب إعداد!\n- 🎨 تخصيص كامل لمظهر الشارة\n- 🔒 الاستضافة الذاتية الاختيارية مع تخزين آمن للرموز\n- ⚡ التخزين المؤقت المحسّن للتحميل السريع\n- 🛡️ معالجة الأخطاء مع رسائل إعلامية\n- 🆓 مجاني الاستخدام\n- 📡 يمكن توسيعه لعرض النشاط/عدد الرسائل\n- 🧪 مجموعة اختبار شاملة مع TypeScript\n\n## استخدام API\n\n### كحزمة npm:\n\n```bash\nnpm install telegram-badge\n```\n\n```typescript\nimport badgeHandler from 'telegram-badge';\n\n// استخدم في دالة الخادم الخاصة بك\nexport default badgeHandler;\n```\n\n### مكالمات API المباشرة:\n\n```typescript\nGET /api/telegram-badge?style=flat\u0026label=الأعضاء\u0026color=2AABEE\u0026labelColor=555555\n```\n\n## الاختبار\n\nتشغيل مجموعة الاختبارات:\n\n```bash\nnpm test\n```\n\n## المساهمة\n\n1. قم بعمل Fork للمستودع\n2. أنشئ فرع ميزة (`git checkout -b feature/amazing-feature`)\n3. قم بتثبيت تغييراتك (`git commit -m 'Add some amazing feature'`)\n4. ادفع الفرع (`git push origin feature/amazing-feature`)\n5. افتح طلب سحب (Pull Request)\n\n## اشترك\n\n[![TikTok](https://img.shields.io/badge/TikTok-000000?logo=tiktok\u0026logoColor=white\u0026labelColor=1c1917)](https://www.tiktok.com/@chatman.media)\n[![twitch](https://img.shields.io/badge/Twitch-9146FF?logo=twitch\u0026logoColor=white\u0026labelColor=1c1917)](https://www.twitch.tv/chatman1984)\n[![YouTube](https://img.shields.io/badge/YouTube-FF0000?logo=youtube\u0026logoColor=white\u0026labelColor=1c1917)](https://www.youtube.com/@chatman-media)\n[![Telegram](https://img.shields.io/badge/Telegram-2CA5E0?logo=telegram\u0026logoColor=white\u0026labelColor=1c1917)](https://t.me/alexanderkireyev)\n[![X](https://img.shields.io/badge/Twitter-000000?logo=x\u0026logoColor=white\u0026labelColor=1c1917)](https://x.com/chatman_media)\n\n## الدعم 💝🚀\n\n- **BTC:** 14s9Y9Rb2CUWHSAatiQMhfkpx1MWXofUzw\n- **TON:** UQD1M80nPyzph5ZW1vfp_r19XI5MaerNhDq4dWXbXCo96WFj\n- **NOT:** UQD1M80nPyzph5ZW1vfp_r19XI5MaerNhDq4dWXbXCo96WFj\n- **ETH:** 0x286D65151b622dCC16624cEd8463FDa45585fd60\n\n\u003cdiv align=\"center\"\u003e\n  \u003ctable\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\u003cimg src=\"public/btc.png\" alt=\"BTC\" height=\"185\" /\u003e\u003c/td\u003e\n      \u003ctd\u003e\u003cimg src=\"public/ton.png\" alt=\"TON\" height=\"185\" /\u003e\u003c/td\u003e\n      \u003ctd\u003e\u003cimg src=\"public/not.png\" alt=\"NOT\" height=\"185\" /\u003e\u003c/td\u003e\n      \u003ctd\u003e\u003cimg src=\"public/eth.png\" alt=\"ETH\" height=\"185\" /\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/table\u003e\n\u003c/div\u003e\n\n## تاريخ النجوم\n\n\u003ca href=\"https://www.star-history.com/#chatman-media/telegram-badge\u0026Date\"\u003e\n \u003cpicture\u003e\n   \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=chatman-media/telegram-badge\u0026type=Date\u0026theme=dark\" /\u003e\n   \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=chatman-media/telegram-badge\u0026type=Date\" /\u003e\n   \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=chatman-media/telegram-badge\u0026type=Date\" /\u003e\n \u003c/picture\u003e\n\u003c/a\u003e\n\n## نشاط المستودع\n\n![Alt](https://repobeats.axiom.co/api/embed/74975e0da934ce1756e69f04fe68f2b026a77aee.svg \"Repobeats analytics image\")\n\n## الرخصة\n\nهذا المشروع مرخّص بموجب رخصة MIT - راجع ملف [LICENSE](LICENSE) لمزيد من التفاصيل.\n\n---\n\nصنع بحب من قبل [Chatman Media](https://github.com/chatman-media)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchatman-media%2Ftelegram-badge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchatman-media%2Ftelegram-badge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchatman-media%2Ftelegram-badge/lists"}