Skip to content

Repository files navigation

Ez Manga

Fast, Modern, Standalone Comic & Manga Reader for Windows 10 & 11

.NET 8.0 WinUI 3 Windows 10/11 MIT License Latest Release


⚑ Try It Now / Download

Get up and running immediately β€” zero installer or administrative privileges required!

πŸ“₯ Download Latest Standalone Release (Portable .zip)

  1. Download EzManga-v*-win-x64.zip.
  2. Extract the archive to any folder or run directly from a USB flash drive.
  3. Launch EzManga.exe and start reading your favorite manga and comics instantly!

πŸ“Έ Screenshot

App Screenshot


πŸš€ Key Features

πŸ“– Multi-Format Comic & Archive Engine

  • Full Archive Support: Read manga and comics directly from .cbz, .cbr, .zip, .rar, and .7z archives without manual decompression.
  • Image Folder Support: Open and read folders containing loose image files (.jpg, .jpeg, .png, .webp, .bmp, .gif).
  • Natural Numeric Sorting: Built-in natural page comparer ensures pages load in true reading order (Page 1, Page 2 ... Page 10).

πŸ‘“ Dynamic Reading Experience

  • Three Reading Modes:
    • Single Page Mode: Clean, immersive focused viewing.
    • Double Spread Mode: Authentic two-page spread simulation for manga double splashes.
    • Webtoon Mode: Continuous vertical scroll layout tailored for modern webtoons and manhwa.
  • Reading Directions: Switch between Right-to-Left (RTL) for authentic Japanese manga and Left-to-Right (LTR) for Western comics and webtoons.
  • Fit & Zoom Modes: Toggle between Fit Page and Fit Width, with granular zoom levels from 50% to 300%.
  • Distraction-Free Fullscreen: Immersive full-screen reading mode with auto-hiding navigation bars.

πŸ“š Library Management & USB Drive Scanner

  • Auto USB Drive Detection: Automatically detects plug-and-play USB drives and external hard drives containing manga archives.
  • Pin Custom Folders: Pin any local folder or external drive to your sidebar for persistent one-click access.
  • Instant Search & Filtering: Filter library by archives, image folders, or search by title in real-time.
  • Manga Cover Generation: Automatically extracts and displays first-page covers in the library grid.

πŸ“Š Reading Progress & Statistics Tracker

  • Smart Progress Memory: Remembers exactly what page you were reading across every manga and archive.
  • Continue Reading Hero Card: Quick-resume your last read title right from the home screen.
  • Favorites & Bookmarks: One-click favorite tagging (X or ❀️) to keep track of your top series.
  • Reading Statistics: Live counters for total titles, pages read, in-progress series, and favorites.

⌨️ Ergonomic Keyboard Navigation

  • One-Handed Reading: Fast page flipping with arrow keys or Page Up / Page Down.
  • Instant Fullscreen: Toggle immersive fullscreen mode with F11 or Y.
  • Quick Bookmarking: Favorite or bookmark any title with a single keypress (X).

πŸ’» 100% Standalone & Portable

  • Pure Unpackaged WinUI 3: No MSIX or Windows Store dependencies required.
  • Self-Contained Deployment: Runs on any 64-bit Windows 10/11 system right out of the box.

⌨️ Keyboard Shortcuts Reference

Shortcut Action
← / Page Up Previous Page (RTL aware)
β†’ / Page Down Next Page (RTL aware)
F11 / Y Toggle Fullscreen Reader
Esc / Back Exit Fullscreen / Back to Library
Enter Open Selected Manga
X Toggle Favorite Bookmark
+ / = Zoom In (+25%)
- Zoom Out (-25%)
0 Reset Zoom (100%)

πŸ—οΈ Architecture & Technology Stack

EzManga/
β”œβ”€β”€ EzManga.csproj               β€” Standalone unpackaged WinUI 3 project (.NET 8)
β”œβ”€β”€ EzManga.sln                  β€” Visual Studio 2022 solution
β”œβ”€β”€ app.manifest                 β€” PerMonitorV2 DPI awareness & Windows 10/11 compatibility
β”œβ”€β”€ App.xaml(.cs)                β€” Application entry point & theme initialization
β”œβ”€β”€ MainWindow.xaml(.cs)         β€” Win32 window hosting, DPI scaling & custom icon setup
β”œβ”€β”€ MainPage.xaml(.cs)           β€” Main UI: Library grid, reader view, sidebar & settings
β”œβ”€β”€ Helpers/
β”‚   └── FileManagerHelper.cs     β€” File type normalization, validation & path safety
β”œβ”€β”€ Models/
β”‚   β”œβ”€β”€ FileEntry.cs             β€” File browser representation
β”‚   β”œβ”€β”€ MangaItem.cs             β€” Manga entity with cover, page count & progress
β”‚   β”œβ”€β”€ MangaPageItem.cs         β€” Individual page item with lazy image source
β”‚   β”œβ”€β”€ PinnedFolderEntry.cs     β€” Pinned sidebar folder / USB drive model
β”‚   └── ReadingProgressEntry.cs  β€” Serialized progress history record
β”œβ”€β”€ Services/
β”‚   β”œβ”€β”€ ArchiveExtractionService.cs β€” Low-level multi-format archive extractor
β”‚   β”œβ”€β”€ MangaArchiveService.cs      β€” In-memory stream reader & cover extractor
β”‚   β”œβ”€β”€ MangaProgressStorage.cs     β€” LocalApplicationData progress persistence
β”‚   β”œβ”€β”€ PinnedFolderStorage.cs      β€” Pinned folder list persistence
β”‚   β”œβ”€β”€ RemovableDriveService.cs    β€” DriveInfo USB drive detection & scanner
β”‚   └── StorageFolderService.cs     β€” File and folder management utility
└── Assets/                      β€” App icons, splash screens, and visual branding
  • Framework: WinUI 3 (Windows App SDK 2.4.0)
  • Runtime: .NET 8.0 (x64)
  • Decompression: SharpCompress (ZIP, RAR, 7Z, TAR, GZ)
  • Design Language: Fluent Design Dark Theme

πŸ› οΈ Prerequisites & Building

Prerequisites

  • Windows 10 (version 1809 or higher) or Windows 11
  • .NET 8.0 SDK or later
  • Visual Studio 2022 (v17.8+) with the .NET Desktop Development workload

Build and Run

Clone the repository and open a terminal in the project directory:

# Build the project
dotnet build EzManga.csproj -p:Platform=x64

# Run the project
dotnet run --project EzManga.csproj -p:Platform=x64

Publish Standalone Portable Package

To generate the standalone zero-dependency portable .zip:

dotnet publish "EzManga.csproj" -c Release -p:Platform=x64 -o "publish/EzManga_Portable"

πŸ—ΊοΈ Roadmap

  • WinUI 3 pure unpackaged desktop architecture
  • CBZ, CBR, ZIP, RAR, 7Z archive support
  • Loose image folder manga reading
  • Single, Spread, and Webtoon continuous vertical reading modes
  • RTL (Right-to-Left) and LTR (Left-to-Right) reading orientation
  • Automatic USB drive scanner & folder pinning
  • Persistent reading progress & statistics tracker
  • Ergonomic desktop keyboard navigation
  • Multi-tab reader (read multiple series simultaneously)
  • PDF comic book format support
  • Custom keybinding configuration dialog
  • Manga metadata scraping (AniList / MangaUpdates integration)

🀝 Contributing & Community

Contributions are warmly welcomed! Whether you want to fix a bug, suggest an enhancement, or add a new reading feature:

  1. Fork the repo and create a feature branch (git checkout -b feature/my-feature).
  2. Commit your changes (git commit -m "Add new feature").
  3. Push to the branch (git push origin feature/my-feature).
  4. Open a Pull Request.

See CONTRIBUTING.md for detailed guidelines.


πŸ“„ License

This project is licensed under the MIT License.

About

Fast, modern, standalone manga & comic reader for Windows 10 & 11. Unpackaged WinUI 3, reads CBZ, CBR, ZIP, RAR, 7Z and image folders.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages