{"id":48566848,"url":"https://github.com/bitsocialnet/bitsocial-telegram-bots","last_synced_at":"2026-05-06T18:34:30.832Z","repository":{"id":298488735,"uuid":"835109704","full_name":"bitsocialnet/bitsocial-telegram-bots","owner":"bitsocialnet","description":"Telegram bots forwarding posts from Bitsocial apps","archived":false,"fork":false,"pushed_at":"2026-03-09T09:24:31.000Z","size":322,"stargazers_count":0,"open_issues_count":4,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-03-09T14:06:40.151Z","etag":null,"topics":["5chan","bitsocial","decentralized","decentralized-social","decentralized-social-networks","gossipsub","ipfs","ipns","libp2p","message-board","p2p","p2p-network","p2p-node","pkc-js","pubsub","seedit","telegram","telegram-bot","telegram-bot-api"],"latest_commit_sha":null,"homepage":"https://t.me/plebbitfeed","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bitsocialnet.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,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2024-07-29T07:18:31.000Z","updated_at":"2026-03-09T09:24:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"3872e86d-80fe-4f99-a007-3b4097f448bc","html_url":"https://github.com/bitsocialnet/bitsocial-telegram-bots","commit_stats":null,"previous_names":["plebe1us/plebbitfeed","plebe1us/plebbitfeed-tg-bot","plebbit/plebbitfeed-telegram-bot","bitsocialhq/bitsocial-telegram-bots","bitsocialnet/bitsocial-telegram-bots"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bitsocialnet/bitsocial-telegram-bots","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitsocialnet%2Fbitsocial-telegram-bots","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitsocialnet%2Fbitsocial-telegram-bots/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitsocialnet%2Fbitsocial-telegram-bots/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitsocialnet%2Fbitsocial-telegram-bots/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bitsocialnet","download_url":"https://codeload.github.com/bitsocialnet/bitsocial-telegram-bots/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bitsocialnet%2Fbitsocial-telegram-bots/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31556247,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T10:21:54.569Z","status":"ssl_error","status_checked_at":"2026-04-08T10:21:38.171Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["5chan","bitsocial","decentralized","decentralized-social","decentralized-social-networks","gossipsub","ipfs","ipns","libp2p","message-board","p2p","p2p-network","p2p-node","pkc-js","pubsub","seedit","telegram","telegram-bot","telegram-bot-api"],"created_at":"2026-04-08T13:03:32.602Z","updated_at":"2026-04-08T13:03:33.202Z","avatar_url":"https://github.com/bitsocialnet.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bitsocial Telegram Bots\n\nTelegram feed bots for [Bitsocial](https://github.com/bitsocialnet) clients. Each bot monitors a specific client's community list and forwards new posts to Telegram channels/groups.\n\n## Available Bots\n\n### 5chan Feed\n\nMonitors all [5chan](https://github.com/bitsocialnet/5chan) directories (boards) from [`5chan-directories.json`](https://github.com/bitsocialnet/lists/blob/master/5chan-directories.json) and posts new content to Telegram. Each post includes buttons to view it on 5chan and Seedit.\n\n### Seedit Feed *(planned)*\n\nWill monitor [Seedit](https://github.com/bitsocialnet/seedit) communities and post new content to Telegram.\n\n## Setup\n\n1. **Clone the repository:**\n   ```bash\n   git clone https://github.com/bitsocialnet/bitsocial-telegram-bots.git\n   cd bitsocial-telegram-bots\n   ```\n\n2. **Install dependencies:**\n   ```bash\n   yarn install\n   ```\n\n3. **Create a `.env` file** in the root directory:\n   ```env\n   # Required: Telegram Bot Token from @BotFather\n   BOT_TOKEN=your_telegram_bot_token_here\n\n   # Which bot to run (defaults to 5chan-feed)\n   BOT_NAME=5chan-feed\n\n   # Required: At least one destination must be set\n   FEED_BOT_CHAT=-1001234567890\n   FEED_BOT_GROUP=-1001234567891\n   ```\n\n4. **Start the bot:**\n   ```bash\n   yarn start\n   ```\n\n   Or run a specific bot:\n   ```bash\n   yarn start:5chan-feed\n   ```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|---|---|---|\n| `BOT_TOKEN` | Yes | Telegram bot token from [@BotFather](https://t.me/botfather) |\n| `BOT_NAME` | No | Which bot config to use (default: `5chan-feed`) |\n| `FEED_BOT_CHAT` | Yes* | Primary Telegram chat/channel ID |\n| `FEED_BOT_GROUP` | No | Secondary Telegram group ID |\n\n\\* At least one of `FEED_BOT_CHAT` or `FEED_BOT_GROUP` must be set.\n\n## How It Works\n\n1. The bot fetches the community list for the configured client (e.g. `5chan-directories.json` for 5chan)\n2. It cycles through each community, checking for new posts via Plebbit\n3. New posts are formatted and sent to the configured Telegram destinations with inline buttons linking back to the client\n4. Processed post CIDs are tracked in `history.json` to avoid duplicates\n5. Cycles repeat every 30 seconds\n\n## Adding a New Bot\n\nTo add a bot for a different Bitsocial client:\n\n1. Add a new config in `src/bot-configs.ts` with the client's list URL, community parser, and URL templates\n2. Add a corresponding `start:` script in `package.json`\n3. Deploy with a separate `.env` pointing to a different `BOT_TOKEN` and `BOT_NAME`\n\n## License\n\nGPL-2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitsocialnet%2Fbitsocial-telegram-bots","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbitsocialnet%2Fbitsocial-telegram-bots","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitsocialnet%2Fbitsocial-telegram-bots/lists"}