Skip to content

Egg Shen BotYour Discord Movie & TV Companion

Search movies, TV shows, games, and host watch parties with comprehensive ratings, links, and moderation tools

Egg Shen Bot

Quick Start

bash
# Clone the repository
git clone https://github.com/r3volution11/Egg-Shen-Bot.git

# Install dependencies
npm install

# Configure your bot
cp config/config.example.json config/config.json
# Edit config.json with your tokens

# Start the bot
npm start

Features at a Glance

Search Commands

  • /movie - Search movies with ratings and streaming links
  • /tv - Search TV shows with ratings
  • /episode - Search specific episodes
  • /game - Search video games and board games

Watch Party Tools

  • /timer - Channel timers that auto-detect Discord events
  • /watched - Server-level watch history tracking
  • /random - Random content picker with filters

Moderation & Admin

  • /eggshen-config - Comprehensive server configuration
  • Rate limiting with guild-wide limits
  • Pattern detection for coordinated abuse
  • Temporary cooldowns and whitelist mode
  • Auto-ban threshold notifications

Community Features

  • /similar - Find similar content recommendations
  • /stats - View server statistics
  • Watch history with channel tracking

Why Egg Shen Bot?

Perfect for movie/TV/gaming Discord communities:

All-in-One - Movies, TV, games, and board games in one bot
Watch Parties - Built-in timers and history tracking
Anti-Abuse - Comprehensive rate limiting and moderation
Configurable - Per-server customization of everything
Open Source - Self-host and customize as needed

  • Movie Night Servers - Track what you watch together
  • Gaming Communities - Search games and track playtime
  • Review Servers - Share ratings and recommendations
  • Watch Party Groups - Coordinate viewing with timers
  • General Entertainment - One bot for all media lookups

Support & Development

Built with ❤️ for Discord communities

A Discord bot for movie, TV, and gaming communities.