An open API service indexing awesome lists of open source software.

https://github.com/sexfrance/github-repository-bot

A Discord bot that automatically announces new GitHub repositories and their updates in real-time.
https://github.com/sexfrance/github-repository-bot

discord discord-github discord-github-bot discord-github-repository-bot github github-bot github-discord github-repo-bot python repository repository-bot rrepo

Last synced: 2 months ago
JSON representation

A Discord bot that automatically announces new GitHub repositories and their updates in real-time.

Awesome Lists containing this project

README

        


GitHub Repository Bot



A Discord bot that automatically announces new GitHub repositories and their updates in real-time.




๐Ÿ’ฌ Discord
ยท
๐Ÿ“œ ChangeLog
ยท
โš ๏ธ Report Bug
ยท
๐Ÿ’ก Request Feature


---

### โš™๏ธ Installation

- Requires: `Python 3.7+`
- Make a python virtual environment: `python3 -m venv venv`
- Source the environment: `venv\Scripts\activate` (Windows) / `source venv/bin/activate` (macOS, Linux)
- Install the requirements: `pip install -r requirements.txt`

---

### ๐Ÿ”ฅ Features

- Real-time GitHub repository monitoring
- Beautiful embed messages with repository details
- Repository stats tracking (Stars, Forks, Watchers)
- Support for multiple bot owners
- Customizable embed appearance
- Repository preview images
- Detailed repository information
- Hex color support for embeds
- Owner-only command system

---

### ๐Ÿ“ Usage

1. **Configuration**:
Edit `config.toml`:

```toml
[BOT]
Token = "your-discord-bot-token"
Owner = [your-discord-id] # Can add multiple owner IDs

[SERVER]
Channel = channel-id-for-announcements
GitHub_Username = "your-github-username"

[Embed]
title = "New Repository Created!"
color = "#3498db"
thumbnail = "path-to-thumbnail"
footer_text = "Custom footer text"
show_timestamp = true
```

2. **Bot Commands**:

- `.set_channel ` - Set announcement channel
- `.set_username ` - Set GitHub username to monitor
- `.set_embed ` - Customize embed appearance
- `.show_embed_settings` - View current embed settings
- `.add_owner ` - Add a bot owner
- `.remove_owner ` - Remove a bot owner
- `.list_owners` - Show all bot owners

3. **Running the bot**:
```bash
python main.py
```

---

### ๐Ÿ“น Embed Preview

![Sex](https://i.imgur.com/MubOyuL.png)

---

### โ— Disclaimers

- This project is for educational purposes only
- Use responsibly and in accordance with Discord's terms of service
- Respect GitHub's API rate limits
- This script was made by copilot ๐Ÿค“

---

### ๐Ÿ“œ ChangeLog

```diff
v1.0.0 โ‹ฎ 12/26/2024
! Initial release

```