{"id":13826773,"url":"https://github.com/undrcrxwn/hide-this-bot","last_synced_at":"2025-07-09T01:31:20.466Z","repository":{"id":41143721,"uuid":"373063223","full_name":"undrcrxwn/hide-this-bot","owner":"undrcrxwn","description":"An inline Telegram bot to keep your private messages hidden from prying eyes.","archived":false,"fork":false,"pushed_at":"2024-11-10T15:08:02.000Z","size":73,"stargazers_count":56,"open_issues_count":0,"forks_count":34,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-11-10T16:19:49.638Z","etag":null,"topics":["aiogram","aiogram-bot","bot","database","heroku","inline-bots","peewee","peewee-orm","postgresql","python","python-telegram-bot","python3","telegram","telegram-api","telegram-bot"],"latest_commit_sha":null,"homepage":"https://t.me/hidethisbot","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/undrcrxwn.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}},"created_at":"2021-06-02T06:28:55.000Z","updated_at":"2024-11-10T15:08:06.000Z","dependencies_parsed_at":"2024-01-15T16:35:04.021Z","dependency_job_id":"d99501db-4072-4633-a60b-3bcdbcb7a949","html_url":"https://github.com/undrcrxwn/hide-this-bot","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/undrcrxwn%2Fhide-this-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/undrcrxwn%2Fhide-this-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/undrcrxwn%2Fhide-this-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/undrcrxwn%2Fhide-this-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/undrcrxwn","download_url":"https://codeload.github.com/undrcrxwn/hide-this-bot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225476383,"owners_count":17480215,"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":["aiogram","aiogram-bot","bot","database","heroku","inline-bots","peewee","peewee-orm","postgresql","python","python-telegram-bot","python3","telegram","telegram-api","telegram-bot"],"created_at":"2024-08-04T09:01:43.935Z","updated_at":"2024-11-20T05:31:06.705Z","avatar_url":"https://github.com/undrcrxwn.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# Hide This Bot\n[Hide This Bot](https://t.me/hidethisbot) is an inline Telegram bot to keep your private messages hidden from prying eyes.\n\n[![](https://www.codefactor.io/repository/github/undrcrxwn/hide-this-bot/badge/master)](https://www.codefactor.io/repository/github/undrcrxwn/hide-this-bot/overview/master) \n[![](https://img.shields.io/badge/telegram-@hidethisbot-blue)](https://t.me/hidethisbot) \n[![](https://img.shields.io/badge/community-@hidethisbot__chat-blue)](https://t.me/hidethisbot_chat)\n[![](https://i.imgur.com/gYCmw0k.png)](#)\n\n### How do I host it?\nHere is a brief guide you can follow to host your own Hide This Bot in case you are afraid of data leaks or for any other reason.\n1. Create a new bot via [Botfather](https://t.me/botfather).\n2. Make your bot inline at Bot → Bot Settings → Inline Mode → Turn inline mode on.\n3. Optionally set up your custom inline placeholder (e. g. \u003ci\u003esample text @user\u003c/i\u003e) at Bot → Bot Settings → Inline Mode → Edit inline placeholder.\n5. [Fork](https://github.com/undrcrxwn/hidethisbot/fork) this repo.\n6. [Deploy](https://heroku.com/deploy?template=https://github.com/undrcrxwn/hidethisbot) it to Heroku (recomended) or some other hosting.\n7. Set up all required environment variables (aka config vars) at Heroku → Pipeline → App → Settings → Config Vars.\n\n### Environment variables\n- `API_TOKEN` – Telegram API bot token\n- `LOG_PATH` – path to the log-file (e. g. **logs/session_{time}.log**)\n- `DATABASE_URL` – connection URL of the database (see [examples](https://www.prisma.io/docs/reference/database-reference/connection-urls))\n\n### Telegram input template\n\u003e @hidethisbot sample text @user1 @user2 @user3\n- `@hidethisbot` – inline mention of the bot\n- `sample text` – text to be hidden\n- `@user1 @user2 @user3` – list of users in scope\n\n### Available modes\n- `spoiler` – hidden content can be seen by everyone\n- `for` – hidden content can only be seen by the author and users in scope\n- `except` – hidden content can be seen by everyone except users in scope\n\n### Placeholders\nCan be used in messages to be replaced with user-related values. For instance, you can send the following message to a public chat to make everyone see his own `full_name` instead of `{name}` placeholder:\n\u003e @hidethisbot I guess its time to kick {name} from this chat. cant stand this clown anymore\n- `{username}` – viewer's username (e. g. **@undrcrxwn**)\n- `{uid}` – viewer's UID (e. g. **id837151456**)\n- `{lang}` – viewer's language code (e. g. **en** or **pt-br**)\n- `{pid}` – post (DB row) ID (e. g. **#32400360**)\n- `{created}` – post creation timestamp (e. g. **2077-07-05 19:53:17.864156**)\n- `{queries}` – total count of inline queries sent by viewer (e. g. **42**)\n- `{first_interaction}` – precise UTC timestamp of when viewer was saved to the database for the first time (e. g. **2077-07-05 19:53:17.864156**)\n- `{dialog}` – indicates whether viewer has ever written to the bot in private chat (e. g. **Yes**)\n- `{utc}` – precise UTC timestamp (e. g. **2077-07-05 19:53:17.864156**)\n- `{date}` – current UTC date (e. g. **2077-07-05**)\n- `{time}` – current UTC time (e. g. **19:53**)\n- `{name}` – viewer's full name (e. g. **Big Floppa**)\n- `{first_name}` – viewer's first name (e. g. **Big**)\n- `{last_name}` – viewer's last name (e. g. **Floppa**)\n\nAll datetime-related placeholders adhere to the UTC timezone with +00:00 shift.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fundrcrxwn%2Fhide-this-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fundrcrxwn%2Fhide-this-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fundrcrxwn%2Fhide-this-bot/lists"}