https://github.com/nayandas69/animemanga-release-tracker
AnimeManga Release Tracker is a smart automation tool that keeps you updated on the latest anime episodes & manga chapters from MyAnimeList, delivering real-time Discord notifications with rich embeds. 🎭📖🔔
https://github.com/nayandas69/animemanga-release-tracker
anime-tracking automation discord-bot github-actions manga-updates myanimelist-api python
Last synced: 2 months ago
JSON representation
AnimeManga Release Tracker is a smart automation tool that keeps you updated on the latest anime episodes & manga chapters from MyAnimeList, delivering real-time Discord notifications with rich embeds. 🎭📖🔔
- Host: GitHub
- URL: https://github.com/nayandas69/animemanga-release-tracker
- Owner: nayandas69
- Created: 2025-03-22T13:24:24.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-03-29T18:12:55.000Z (2 months ago)
- Last Synced: 2025-03-29T19:21:57.829Z (2 months ago)
- Topics: anime-tracking, automation, discord-bot, github-actions, manga-updates, myanimelist-api, python
- Language: Python
- Homepage:
- Size: 123 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# **AnimeManga Release Tracker**
🫠 **AnimeManga Release Tracker** is a Python-based automation tool that **fetches new anime episode and manga chapter releases** from **MyAnimeList** and **sends rich notifications** to a Discord webhook.
## 🔹 **Features:**
✅ **Tracks both Anime & Manga** 📖📺
✅ **Anime Genres & Type** (TV, Movie, OVA) 📌
✅ **Next Episode Countdown** (Time left until release) ⏳
✅ **Localized Time Conversion** (UTC → Local Time) 🌍
✅ **Popularity Stats** (Score, Rank, Members) 📊
✅ **Sends Rich Discord Messages** with **random embed colors** 🎨
✅ **Avoids Duplicate Notifications** 🫷
## Setup & Installation
### Clone the Repository
```bash
git clone https://github.com/nayandas69/AnimeManga-Release-Tracker.git
cd AnimeManga-Release-Tracker
```
### Install Dependencies
```bash
pip install -r requirements.txt
```
## Setting Up Repository Secrets in GitHub
Instead of using a `.env` file locally, you can store **API keys securely** in **GitHub Secrets**.
### Go to Your GitHub Repository
- Open your **GitHub repository**
- Click on **Settings**
- Scroll down to **"Secrets and variables" → "Actions"**
### Add Secrets
Click **"New repository secret"** and add the following:
| Secret Name | Value (Example) |
|----------------------|----------------------------|
| `MAL_CLIENT_ID` | `your_mal_client_id_here` |
| `DISCORD_WEBHOOK` | `your_discord_webhook_url` |
### Use Secrets in GitHub Actions
The workflow **automatically loads** these secrets:
```yaml
env:
MAL_CLIENT_ID: ${{ secrets.MAL_CLIENT_ID }}
DISCORD_WEBHOOK: ${{ secrets.DISCORD_WEBHOOK }}
```
🔹 **How to get `MAL_CLIENT_ID`?**
- Go to [MyAnimeList API](https://myanimelist.net/apiconfig)
- Create an **application**
- Copy your **Client ID**
🔹 **How to get `DISCORD_WEBHOOK`?**
- Go to your **Discord server settings**
- Create a **new webhook** in a channel
- Copy the **Webhook URL**
## Running the Script
```bash
python src/tracker.py
```
This will fetch **new anime episodes & manga chapters** and send notifications to **Discord**.
💖 **Enjoy & Star ⭐ this project if you find it useful!**
## Example Discord Notification
