• 🎯 Simple Interface - Clean, intuitive design with dark/light theme support
• ⚡ Fast Downloads - Multi-threaded downloading for optimal speed
• 📊 Real-Time Progress - Live updates via WebSocket connection
• 🎨 Dual Themes - Beautiful dark mode and professional light theme
• 📦 Batch Downloads - Download single chapters or custom ranges
• 💾 Smart Organization - Automatically organized folder structure
• 🔗 URL Parsing - Intelligent URL and chapter number detection
• ⏱️ Time Estimation - Accurate download time predictions
• 📱 Responsive Design - Works perfectly on all devices
• 🎭 Professional Icons - Font Awesome integration throughout

• Python 3.8 or higher
• pip (Python package manager)
• Git (optional, for cloning)

git clone https://github.com/yourusername/hiManga.git
cd hiManga

Or download and extract the ZIP file.

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On Linux/Mac:
source venv/bin/activate

# On Windows:
venv\Scripts\activate

pip install -r requirements.txt

The required packages are:

• Flask==3.0.0
• Flask-SocketIO==5.3.5
• beautifulsoup4==4.12.2
• lxml==4.9.3
• requests==2.31.0
• python-socketio==5.10.0

python app.py

Or use the included launcher script:

chmod +x run.sh
./run.sh

The application will start on http://localhost:5000

1. Open the Application

   • Navigate to http://localhost:5000 in your browser

2. Enter Manga URL

   • Paste the manga chapter URL from readonepiece-manga.net
   • Example: https://ww8.readonepiece.com/manga/manga-name-chapter-123/

3. Select Download Option

   • This Chapter Only: Downloads the single chapter from the URL
   • Custom Range: Downloads multiple chapters (specify start and end)

4. Start Download

   • Click the "Start Download" button
   • Watch real-time progress with live updates

5. Access Downloaded Files

   • Files are saved in downloads/MangaName_Chapter_XXX/
   • Each chapter gets its own organized folder
   • Images are numbered sequentially

The application accepts URLs in the format:

https://ww8.readonepiece.com/manga/manga-name-chapter-123/

The chapter number is automatically extracted from the URL.

Click the moon/sun icon in the top-right corner to toggle between:

• Dark Theme: Modern dark blue with bright accents
• Light Theme: Clean white with green accents

Your theme preference is automatically saved.

• Flask: Lightweight web framework for Python
• Flask-SocketIO: WebSocket support for real-time communication
• BeautifulSoup4: HTML parsing and web scraping
• Requests: HTTP library for downloading content
• lxml: Fast XML and HTML parsing

• HTML5: Semantic markup structure
• CSS3: Modern styling with animations and transitions
• JavaScript: Dynamic UI updates and WebSocket client
• Socket.IO: Real-time bidirectional event-based communication
• Font Awesome 6: Professional icon library
• Google Fonts (Inter): Clean, modern typography

• Threading Mode: Asynchronous background processing
• WebSocket Protocol: Real-time progress streaming
• MVC Pattern: Organized code structure
• Responsive Design: Mobile-first approach

hiManga/
├── app.py                 # Flask application and routes
├── manga_scraper.py       # Web scraping logic with progress tracking
├── manga_downloader.py    # Original CLI version
├── requirements.txt       # Python dependencies
├── run.sh                # Launch script
├── .gitignore            # Git ignore patterns
├── README.md             # Project documentation
├── templates/
│   ├── index.html        # Main download interface
│   └── about.html        # About page
├── static/
│   ├── style.css         # Application styling
│   └── script.js         # Frontend JavaScript
├── downloads/            # Downloaded manga (auto-created)
└── venv/                 # Virtual environment (auto-created)

The default dark theme features a modern blue color scheme with smooth gradients and professional styling.

The light theme provides a clean, bright interface with green accents for a fresh, professional look.

Live progress tracking shows overall completion, current chapter, and per-chapter download status.

Edit app.py and modify:

socketio.run(app, host='0.0.0.0', port=5000, debug=True)

Edit manga_scraper.py and change:

self.download_dir = "downloads"  # Change to your preferred directory

# Kill the existing process
pkill -f "python app.py"

# Or use a different port in app.py

# Ensure virtual environment is activated
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows

# Reinstall dependencies
pip install -r requirements.txt

• Check if the Flask server is running
• Verify firewall settings allow connections to port 5000
• Check browser console for WebSocket errors

• Verify the manga URL is correct and accessible
• Check your internet connection
• Some manga pages may have changed their structure

Contributions are welcome! Feel free to:

• Report bugs
• Suggest new features
• Submit pull requests
• Improve documentation

This project is licensed under the MIT License - see the LICENSE file for details.

This tool is for educational purposes only. Please respect copyright laws and the terms of service of the websites you download from. Always support manga creators by purchasing official releases when available.

• Built with Flask and Socket.IO
• Icons by Font Awesome
• Typography by Google Fonts (Inter)
• Inspired by the manga community