Doudesu

A powerful manga downloader and Python wrapper for doujindesu.tv with both CLI and GUI interfaces.

Features

• 🔍 Search manga by title with pagination
• 📱 Modern GUI interface with dark/light theme
• 💻 Feature-rich CLI interface
• 📖 Download single or multiple chapters
• 📑 Automatic PDF conversion
• 🌙 Dark/Light theme support
• 🎨 Beautiful and intuitive interface

Installation

Basic Installation

pip install doudesu

With GUI Support

[!NOTE] GUI support requires flet to be installed. Currently tested on Windows only.

pip install doudesu[gui]

Command-Line Usage

Available Commands

# Launch GUI interface (requires GUI support)
doudesu --gui

# Launch GUI in browser mode on localhost:6969
doudesu --browser

# Launch API interface
doudesu --api

# Launch API with custom port
doudesu --api --port 6969

# Launch interactive CLI interface
doudesu --cli

# Search manga by keyword
doudesu --search "manga name"

# Search manga by keyword with pagination
doudesu --search "manga name" --page 2

# Download manga directly by URL
doudesu --url "https://doujindesu.tv/manga/your-manga-url"

# Show help message
doudesu --help

Command Options

Options:
  --gui          Run in GUI mode (requires doudesu[gui] installation)
  --browser      Run GUI in browser mode on localhost:6969
  --api          Run doudesu in API mode using FastAPI
  --port INT     Run API on custom port (default: 6969)
  --search TEXT  Search manga by keyword
  --page INT     Page number for search results (default: 1)
  --url TEXT     Download manga by URL
  --cli          Run in interactive CLI mode

CLI Features

• 🎨 Colorful and intuitive interface
• 📄 Detailed manga information
• 📚 Chapter selection options:
  • Download all chapters
  • Download specific chapter
  • Download range of chapters
• 🔄 Pagination support for search results
• ✨ Progress indicators
• 🎯 Smart single-chapter handling

GUI Features

• 🎨 Modern and responsive design
• 🌓 Dark/Light theme toggle
• 🖼️ Thumbnail previews
• 📊 Download progress tracking
• 🔍 Advanced search capabilities
• 📚 Chapter selection options
  • Download all chapters
  • Download specific chapter
  • Download range of chapters
• 🔄 Pagination support for search results

API Features

• 📄 JSON response
• 🔍 Search manga by keyword
• 📚 Get manga details

Python API Usage

from doudesu import Doujindesu

# Search for manga
results = Doujindesu.search("manga name")
for manga in results.results:
    print(f"Title: {manga.name}")
    print(f"URL: {manga.url}")

manga = Doujindesu("https://doujindesu.tv/manga/your-manga-url")
details = manga.get_details()
chapters = manga.get_all_chapters()

# Get chapter images
manga.url = chapters[0]  # Set to specific chapter
images = manga.get_all_images()

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

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