{"id":13988868,"url":"https://github.com/zeshuaro/telegram-pdf-bot","last_synced_at":"2025-04-12T16:36:33.848Z","repository":{"id":36972437,"uuid":"97448967","full_name":"zeshuaro/telegram-pdf-bot","owner":"zeshuaro","description":"A Telegram bot that can do a lot of things related to PDF files","archived":false,"fork":false,"pushed_at":"2025-04-11T10:17:20.000Z","size":48365,"stargazers_count":203,"open_issues_count":3,"forks_count":99,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-11T11:58:34.796Z","etag":null,"topics":["bot","pdf-manipulation","python","python-telegram-bot","telegram","telegram-bot","telegram-pdf-bot"],"latest_commit_sha":null,"homepage":"https://t.me/pdfbot","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/zeshuaro.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":["zeshuaro"],"ko_fi":"zeshuaro","liberapay":"zeshuaro","patreon":"zeshuaro","custom":["https://www.buymeacoffee.com/zeshuaro","https://paypal.me/JoshuaTang"]}},"created_at":"2017-07-17T07:44:07.000Z","updated_at":"2025-04-11T10:17:23.000Z","dependencies_parsed_at":"2023-10-14T20:05:02.957Z","dependency_job_id":"2ab24f81-d7a0-43c2-a084-f6288ca52fe4","html_url":"https://github.com/zeshuaro/telegram-pdf-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/zeshuaro%2Ftelegram-pdf-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeshuaro%2Ftelegram-pdf-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeshuaro%2Ftelegram-pdf-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeshuaro%2Ftelegram-pdf-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zeshuaro","download_url":"https://codeload.github.com/zeshuaro/telegram-pdf-bot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248597387,"owners_count":21130867,"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":["bot","pdf-manipulation","python","python-telegram-bot","telegram","telegram-bot","telegram-pdf-bot"],"created_at":"2024-08-09T13:01:24.674Z","updated_at":"2025-04-12T16:36:33.807Z","avatar_url":"https://github.com/zeshuaro.png","language":"Python","funding_links":["https://github.com/sponsors/zeshuaro","https://ko-fi.com/zeshuaro","https://liberapay.com/zeshuaro","https://patreon.com/zeshuaro","https://www.buymeacoffee.com/zeshuaro","https://paypal.me/JoshuaTang","https://liberapay.com/zeshuaro/"],"categories":["Python"],"sub_categories":[],"readme":"# Telegram PDF Bot\n\n[![Telegram Bot](https://img.shields.io/badge/Telegram-Bot-blue.svg)](https://t.me/pdfbot)\n[![MIT License](https://img.shields.io/github/license/zeshuaro/telegram-pdf-bot.svg)](https://github.com/zeshuaro/telegram-pdf-bot/blob/master/LICENSE)\n[![GitHub Actions](https://github.com/zeshuaro/telegram-pdf-bot/actions/workflows/github-actions.yml/badge.svg)](https://github.com/zeshuaro/telegram-pdf-bot/actions/workflows/github-actions.yml)\n[![codecov](https://codecov.io/github/zeshuaro/telegram-pdf-bot/graph/badge.svg?token=6JAciEl1i7)](https://codecov.io/github/zeshuaro/telegram-pdf-bot)\n[![Codacy Badge](https://app.codacy.com/project/badge/Grade/71c277e105c74d9fb99c37db6b23c8ca)](https://app.codacy.com/gh/zeshuaro/telegram-pdf-bot/dashboard?utm_source=gh\u0026utm_medium=referral\u0026utm_content=\u0026utm_campaign=Badge_grade)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n[![Crowdin](https://badges.crowdin.net/telegram-pdf-bot/localized.svg)](https://crowdin.com/project/telegram-pdf-bot)\n[![Telegram Channel](https://img.shields.io/badge/Telegram-Channel-blue.svg)](https://t.me/pdf2botdev)\n[![Mentioned in Awesome Telegram](https://awesome.re/mentioned-badge.svg)](https://github.com/ebertti/awesome-telegram)\n\n[![Github-sponsors](https://img.shields.io/badge/sponsor-30363D?style=for-the-badge\u0026logo=GitHub-Sponsors\u0026logoColor=#EA4AAA)](https://github.com/sponsors/zeshuaro)\n[![BuyMeACoffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge\u0026logo=buy-me-a-coffee\u0026logoColor=black)](https://www.buymeacoffee.com/zeshuaro)\n[![Ko-Fi](https://img.shields.io/badge/Ko--fi-F16061?style=for-the-badge\u0026logo=ko-fi\u0026logoColor=white)](https://ko-fi.com/zeshuaro)\n[![LiberaPay](https://img.shields.io/badge/Liberapay-F6C915?style=for-the-badge\u0026logo=liberapay\u0026logoColor=black)](https://liberapay.com/zeshuaro/)\n[![Patreon](https://img.shields.io/badge/Patreon-F96854?style=for-the-badge\u0026logo=patreon\u0026logoColor=white)](https://patreon.com/zeshuaro)\n[![PayPal](https://img.shields.io/badge/PayPal-00457C?style=for-the-badge\u0026logo=paypal\u0026logoColor=white)](https://paypal.me/JoshuaTang)\n\nA Telegram bot that can:\n\n- Compress, crop, decrypt, encrypt, merge, preview, rename, rotate, scale and split PDF files\n- Compare text differences between two PDF files\n- Create PDF files from text messages\n- Add watermark to PDF files\n- Add text layers to PDF files to make them searchable with text\n- Extract images and text from PDF files\n- Convert PDF files into images\n- Beautify handwritten notes images into PDF files\n- Convert webpages and images into PDF files\n\n[![DigitalOcean Referral Badge](https://web-platforms.sfo2.cdn.digitaloceanspaces.com/WWW/Badge%201.svg)](https://www.digitalocean.com/?refcode=4991e58bfd21\u0026utm_campaign=Referral_Invite\u0026utm_medium=Referral_Program\u0026utm_source=badge)\n\n## Getting Started\n\nThese instructions will get you a copy of the project up and running on your local machine for development and testing purposes\n\n### Setup Database\n\nThe bot uses [Datastore](https://cloud.google.com/datastore) on Google Cloud Platform (GCP). Create a new project on GCP and enabble Datastore in the project. Install the [gcloud CLI](https://cloud.google.com/sdk/) and run `gcloud init` to initialise it with your project.\n\n### OS Requirements\n\nUbuntu\n\n```sh\napt-get install poppler-utils libcairo2 libpango-1.0-0 libpangocairo-1.0-0 libgdk-pixbuf2.0-0 libffi-dev shared-mime-info\n```\n\nmacOS\n\n```sh\nbrew install libxml2 libxslt poppler cairo pango gdk-pixbuf libffi\n```\n\n### Install dependencies\n\nThis project uses [Poetry](https://python-poetry.org/) as the dependency manager, run the following command to install the dependencies:\n\n```sh\npoetry install --no-root\n```\n\n### Compile the translation files\n\nRun the following command to compile all the translation files:\n\n```sh\npybabel compile -D pdf_bot -d locale/\n```\n\n### Setup Your Environment Variables\n\nCopy the `.env` example file and edit the variables within the file:\n\n```sh\ncp .env.example .env\n```\n\n### Running The Bot\n\nYou can then start the bot with the following command:\n\n```bash\npython -m pdf_bot\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzeshuaro%2Ftelegram-pdf-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzeshuaro%2Ftelegram-pdf-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzeshuaro%2Ftelegram-pdf-bot/lists"}