🔍 Eoogle

The open-source Discord bot that doesn't hide behind closed doors. :3 You can also add Eoogle to your Discord server!

Welcome to Eoogle – a Discord bot built with transparency and community at its core. While most bots keep their code locked away, we believe in doing things differently. Every line of code, every feature, and every update is here for you to explore, learn from, and contribute to.

🌟 Why Eoogle?

Transparency First - No black boxes, no secrets. See exactly how everything works.

Community Driven - Built by developers, for developers. Your contributions shape the future of Eoogle.

GitHub Integration - Seamlessly connect your Discord server with GitHub repositories, issues, and more.

Always Evolving - Regular updates, new features, and constant improvements driven by community feedback.

✨ Features

• 🔗 Seamless GitHub repository integration
• 📊 Real-time repository statistics and updates
• 🎯 Comprehensive command system
• 🚀 Fast and reliable performance
• 🛠️ Easy to customize and extend

🚀 Quick Start

Prerequisites

Before you begin, make sure you have:

• Node.js (v16 or higher) - Download here
• Git - Installation guide
• Discord Bot Token - Create a bot
• GitHub Personal Access Token - Generate token

Installation Guide

Choose your operating system below:

🪟 Windows

1. Open Command Prompt or PowerShell

   • Press Win + R, type cmd, and hit Enter

2. Clone the repository

   git clone https://github.com/RevivalSearch/Eoogle.git
   cd Eoogle

3. Set up environment variables

   copy .env.example .env

4. Configure your tokens

   • Right-click .env → Open with Notepad
   • Add your credentials:

   DISCORD_TOKEN=your_discord_bot_token_here
   GITHUB_TOKEN=your_github_token_here

5. Install dependencies

   npm install

6. Launch Eoogle

   npm start

🍎 macOS

1. Open Terminal

   • Press Cmd + Space, type terminal, and hit Enter

2. Clone the repository

   git clone https://github.com/RevivalSearch/Eoogle.git
   cd Eoogle

3. Set up environment variables

   cp .env.example .env

4. Configure your tokens

   nano .env

   Or use TextEdit:

   open -a TextEdit .env

   Add your credentials:

   DISCORD_TOKEN=your_discord_bot_token_here
   GITHUB_TOKEN=your_github_token_here

   Save and exit (in nano: Ctrl + X, then Y, then Enter)

5. Install dependencies

   npm install

6. Launch Eoogle

   npm start

🐧 Linux

1. Open Terminal

   • Usually Ctrl + Alt + T

2. Clone the repository

   git clone https://github.com/RevivalSearch/Eoogle.git
   cd Eoogle

3. Set up environment variables

   cp .env.example .env

4. Configure your tokens

   nano .env

   Or use your preferred editor (vim, gedit, etc.)

   Add your credentials:

   DISCORD_TOKEN=your_discord_bot_token_here
   GITHUB_TOKEN=your_github_token_here

   Save and exit (in nano: Ctrl + X, then Y, then Enter)

5. Install dependencies

   npm install

6. Launch Eoogle

   npm start

✅ Verification

If everything is set up correctly, you'll see Eoogle come online in your Discord server! 🎉

📖 Usage

Get started by running the help command in any server where Eoogle is installed:

e-help

This displays all available commands with descriptions and usage examples.

🐛 Troubleshooting

Bot won't start?

• Verify Node.js is installed: node --version
• Double-check your tokens in the .env file
• Ensure you ran npm install before starting
• Check for error messages in the console

Dependency issues?

• Delete the node_modules folder and package-lock.json
• Run npm install again
• Try clearing npm cache: npm cache clean --force

Bot is offline in Discord?

• Make sure your Discord bot token is valid
• Check that the bot has been invited to your server with proper permissions
• Verify your internet connection is stable

Still stuck?

Open an issue on GitHub and we'll help you out!

🤝 Contributing

We love contributions! Here's how you can help make Eoogle better:

• 🐛 Found a bug? Report it
• 💡 Have an idea? Share your feature suggestions
• 🔧 Want to code? Submit a pull request
• 📖 Improve docs? Documentation PRs are always welcome

Check out our Contributing Guidelines to get started.

📄 License

This project is open source. See the LICENSE file for details.

🔗 Important Links

• 📦 GitHub Repository
• 🐛 Report Issues
• 💬 Discussions

⭐ Show Your Support

If you find Eoogle useful, give it a star on GitHub! It helps others discover the project and motivates us to keep improving.

---

Made with ❤️ by RevivalSearch

Because the best bots are the ones everyone can learn from.