Skip to content

README.md

Latest commit

 

History

History
151 lines (120 loc) · 3.83 KB

README.md

File metadata and controls

151 lines (120 loc) · 3.83 KB

Telegram Channel Scraper

A powerful GUI application for monitoring and filtering Telegram channels with advanced features like regex pattern matching, user filtering, and DexScreener verification.

Features

  • 🔍 Monitor multiple Telegram channels simultaneously
  • 🎯 Forward messages to target channels based on custom filters
  • 👥 Filter messages by user type (all users, admins only, or custom users)
  • 📝 Use preset or custom regex patterns to match content
  • ✅ Optional DexScreener paid verification
  • 💬 Secondary forwarding to user/bot accounts
  • 📊 Real-time activity monitoring and message history
  • ⚙️ Persistent configuration saving

Prerequisites

  • Python 3.7 or higher
  • Telegram API credentials (api_id and api_hash)
  • PyQt5
  • Telethon

Installation

  1. Clone the repository (if you haven't already):
git clone https://github.com/yourusername/scraper.git
cd scraper
  1. Set up a virtual environment (recommended):
# Create virtual environment
python3 -m venv venv

# Activate virtual environment
# On macOS/Linux:
source venv/bin/activate
# On Windows:
.\venv\Scripts\activate

# If you encounter pip issues in the virtual environment, reinstall pip:
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python3 get-pip.py
  1. Install required dependencies:
# Make sure pip is up to date
python3 -m pip install --upgrade pip

# Install dependencies
pip install -r requirements.txt
  1. Create a .env file in the project root with your Telegram API credentials:
API_ID=your_api_id
API_HASH=your_api_hash

To obtain your API credentials:

  1. Visit https://my.telegram.org/auth
  2. Log in with your phone number
  3. Go to 'API development tools'
  4. Create a new application
  5. Copy the api_id and api_hash values

Troubleshooting

Common Issues

  1. ModuleNotFoundError: No module named 'pip'

    curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python3 get-pip.py

  2. PyQt5 Installation Issues

    • On macOS:
    brew install qt5
    • On Ubuntu/Debian:
    sudo apt-get install python3-pyqt5
    • On Windows:
    pip install PyQt5

  3. Virtual Environment Issues If you encounter problems with the virtual environment:

    # Delete existing venv
rm -rf venv
# Create new venv
python3 -m venv venv
# Activate and reinstall dependencies
source venv/bin/activate  # or .\venv\Scripts\activate on Windows
python3 -m pip install --upgrade pip
pip install -r requirements.txt

Usage

  1. Run the application:
python main.py

  1. Log in with your Telegram phone number when prompted

  2. Set up monitors:

    • Click "Add New Monitor"
    • Select source and target channels
    • Configure filters and patterns
    • Enable/disable DexScreener verification
    • Toggle the "Active" checkbox to start monitoring

  3. The application will save your settings automatically when closed

Configuration Options

Channel Monitor Settings

  • Source: The channel to monitor for messages
  • Target: The channel where filtered messages will be forwarded
  • Secondary Target: Optional user/bot to receive simplified forwards
  • User Filter:
    • All Users: Monitor messages from everyone
    • Admins Only: Only monitor admin messages
    • Custom Users: Select specific users to monitor
  • Content Filter:
    • Solana Contract Address
    • All Text
    • URLs
    • Custom Regex Pattern
  • DexScreener Verification: Verify if contracts are paid before forwarding

Global Settings

  • Bot Channel: Channel for DexScreener bot commands
  • Wait Time: Seconds to wait for bot responses

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

MIT