Skip to content

Abudidayo/Verifee

Repository files navigation

Verifee - Discord Email Verification Bot

Verifee is a Discord bot that securely fetches the latest verification codes (2FA / OTP) from a connected Gmail account and displays them directly in your Discord channel. It's designed to streamline login processes for shared accounts or teams.

image

Features

  • Gmail Fetching: Scans the inbox for the latest emails within the last 15 minutes.
  • Keyword Filtering: Specify a keyword (e.g., !code steam) to find codes from specific services.
  • Smart Parsing: Automatically extracts 6-digit verification codes from email bodies.
  • Security: Ignores "password reset" emails to prevent accidental account compromises.
  • Docker Ready: Includes a Dockerfile and docker-compose.yml.

Prerequisites

  • Python 3.9+
  • Discord Bot Token: Create one at the Discord Developer Portal.
  • Gmail Account:
    • 2-Step Verification must be enabled.
    • An App Password must be generated (use this instead of your real password).

Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/Verifee.git
    cd Verifee
  2. Create a virtual environment (optional):

    python -m venv venv
    source venv/bin/activate  # On Windows: venv\Scripts\activate
  3. Install dependencies:

    pip install -r requirements.txt
  4. Configure Environment Variables: Create a file named .env in the root directory and add your credentials:

    DISCORD_TOKEN=your_discord_bot_token
    EMAIL_ADDRESS=your_email@gmail.com
    EMAIL_PASSWORD=your_gmail_app_password

Usage

  1. Run the bot:

    python bot.py
  2. Discord Commands:

    • !code: Searches the inbox for any recent verification code.
    • !code [service]: Searches for a code from a specific service (e.g., !code Amazon).

Docker Deployment

Run locally with Docker Compose:

  1. Configure: Ensure .env is created.
  2. Run:
    docker-compose up -d --build

Cloud Deployment (AWS EC2)

For a step-by-step guide on deploying this bot to an Amazon EC2 instance, see EC2_INSTRUCTIONS.md.

License

MIT License

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors