Manga Tracker: Your Personal Chapter Notifier 📢
A personalized, command-line tool for tracking your favorite manga and manhwa updates from user-specified scanlation sites.
Tired of checking multiple sites for new chapters? Manga Tracker keeps an eye on your reading list for you. This tool runs locally on your computer and notifies you of new releases, linking you directly to the original source to support the scanlation teams.
✨ Key Features
Customizable Tracking: You decide which series to track from which sites.
Lightweight & Fast: A simple command-line interface that runs efficiently.
Direct-to-Source Links: All update notifications link you directly to the original chapter on the scanlation team's website.
Modular Design: Easily add support for new scanlation sites by following a simple template.
⚙️ How It Works
Manga Tracker is not a piracy tool. It does not download or store any comic or manga content. Instead, it acts as an intelligent web scraper that periodically checks the series pages you've specified. It looks for the latest chapter number and compares it to the last one it recorded. If it finds a newer chapter, it notifies you and updates its local data file. This ensures all traffic and support go directly to the original scanlation teams.
🚀 Installation
Follow these simple steps to get started:
Step 1:- Clone the Repository:
Open your terminal or command prompt and run the following command to get a copy of the project.
git clone https://github.com/Van-der/manga_tracker.git
Step 2:- Navigate to the Directory:
cd Manga-tracker
Step 3:- Install Dependencies: The tool requires a few Python libraries. Install them using pip.
pip install -r requirements.txt
📚 Usage
To run the application, use these commands from your terminal, starting in the manga-tracker directory.
# Activate the virtual environment
# For Windows:
venv\Scripts\activate
# For macOS / Linux:
source venv/bin/activate
# Run the application
python3 main.py
You will be greeted with a simple menu:
--- Manga Tracker Menu ---
1. Add a new series to track
2. Check for updates
3. Show currently tracked series
4. Exit
Option 1: Add a new series: You will be prompted to enter the name of the site (e.g., asuracomic, flame) and the full URL of the series page.
Option 2: Check for updates: The tool will check all your tracked series and print notifications for any new chapters found.
Option 3: Show tracked series: Displays a list of all the series you are currently tracking.
🤝 Contributing
This project thrives on community contributions. If you want to add support for a new scanlation site, it's easy!
1. Fork the Repository: Create your own copy of this project on GitHub.
2. Create a New Scraper: Inside the scrapers/ directory, create a new file named after the site (e.g., scrapers/newsite.py).
3. Use the Template: Copy the code from scrapers/template.py into your new file. The template contains detailed instructions on how to find the correct HTML elements for a given site.
4. Submit a Pull Request: Once your scraper is working, submit a pull request to the main repository. We will review it and merge it.
Thank you for your support! Happy reading!