TGScanner

A powerful Telegram scanning tool that finds newspapers (TOI/DC) and magazines using an OpenAI-compatible AI API.

Features

• TOI Search: Find "Times of India" Hyderabad edition links.
• DC Search: Find "Deccan Chronicle" Hyderabad edition links.
• Magazine Search: Find any English magazine by keywords using AI for smart classification.
• Deep Links: Results include direct clickable links to Telegram messages.
• Premium GUI: Built with customtkinter for a modern look.

Setup

1. Install UV: If you don't have it, install uv.
2. Setup Environment:
   • Create a .env file in the root directory.
   • Add your credentials:

     TG_API_ID=your_api_id
     TG_API_HASH=your_api_hash
     OPENAI_MODEL=gpt-4o-mini
     OPENAI_API_KEY=your_openai_api_key
     MAGAZINE_MAX_AGE_DAYS=90

   • For any OpenAI-compatible server (Ollama, LM Studio, vLLM, OpenRouter, etc.), set a base URL. OPENAI_API_KEY is optional for local servers that ignore auth:

     OPENAI_BASE_URL=http://127.0.0.1:11434/v1
     OPENAI_MODEL=llama3.2
     # OPENAI_API_KEY can be omitted; a placeholder is used automatically

   • OPENAI_MODEL is required whenever AI features run (magazine evaluation or TOI --ai-query).
3. Install Dependencies:

   uv sync

4. Telegram Session: Ensure you have a valid toi_session.session file in the root. (Log in through Telethon if needed).

Running the App

Simply run the batch file:

.\launch_toi_gui.bat

Or run via python directly:

uv run toi_gui.py

How to use Magazine Search

1. Type keywords (e.g., 'National Geographic' or 'finance') in the Keywords / AI Query field.
2. The search mode will automatically switch to Magazine Search.
3. Click Start Search.
4. Click on any result in the sidebar to copy the link and open it in Telegram.