Skip to content

Latest commit

 

History

21 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Keepit — Telegram Bot

A multi-feature Telegram bot built with Python. Handles productivity and document conversion, deployed on Render with 24/7 uptime.

Python python-telegram-bot License Deploy


✨ Features

🍅 Pomodoro Timer

  • Customizable work and break durations
  • Live countdown updated every second
  • Cancel anytime with /stop

📄 Image → PDF

  • Send multiple photos → receive one combined PDF
  • Downloads photos in parallel for speed
  • Works with 50–80 photos reliably

🖼 PDF → Image

  • Send a PDF → receive pages as images
  • Up to 20 pages → individual photos
  • 21–200 pages → single ZIP file
  • Cancel mid-conversion with /stopconvert

🚀 Commands

Command Description
/start Show the help menu
/pomodoro Start 25 min work / 5 min break
/pomodoro 50 10 Custom work/break duration
/stop Cancel a running Pomodoro timer
/pdf Combine collected photos into one PDF
/clearpdf Clear collected photos
/stopconvert Cancel an ongoing conversion

🛠 Tech Stack

  • Python 3 — core language
  • python-telegram-bot — Telegram API wrapper
  • img2pdf — Image → PDF conversion
  • PyMuPDF — PDF → Image conversion
  • aiohttp — Web server for Render + self-ping keep-alive
  • Render — free 24/7 cloud hosting

📦 Local Setup

# 1. Clone the repo
git clone https://github.com/YOUR_USERNAME/keepit-telegram-bot.git
cd keepit-telegram-bot

# 2. Install dependencies
pip install -r requirements.txt

# 3. Set your bot token (get one from @BotFather on Telegram)
# Windows:
set TOKEN=your_bot_token_here
# Linux/Mac:
export TOKEN=your_bot_token_here

# 4. Run the bot
python bot.py
☁️ Deployment (Render)
This bot is deployed on Render free tier.

Fork or clone this repo

Create a new Web Service on Render and connect this repo

Build Command: pip install -r requirements.txt

Start Command: python bot.py

Add environment variable: TOKEN = your_bot_token

Deploy 🚀 
Limitations (Free Tier)
Max 200 pages per PDF (larger files are rejected politely)

Max 20 MB PDF file size

~80 photos per Image → PDF conversion (memory limit)

2–3 concurrent users doing heavy conversions

Free Render tier has 512 MB RAM and 750 hours/month