ComiSync is a next-generation manga aggregation and synchronization platform designed to unify your digital collection across devices, archives, and sources. Unlike single-source downloaders, ComiSync acts as a universal bridge between your local library and multiple web archives, cloud storage services, and reader applications.

Built for collectors who manage hundreds of series across folders, tablets, phones, and PCs, ComiSync eliminates fragmentation. It automatically identifies, deduplicates, normalizes metadata, and syncs your entire manga library to any destination with a single workflow.

Managing a manga library across multiple devices and archives feels like herding cats. Series get scattered between your tablet, phone, laptop, and cloud folders. Chapter numbering conflicts appear after bulk transfers. Metadata inconsistencies make search a nightmare.

ComiSync solves this by introducing the library bridge paradigm: instead of manually moving files, you define collection points (local folders, web sources, cloud drives) and synchronization targets (reader apps, archive directories, media servers). ComiSync resolves conflicts intelligently, applies consistent naming conventions, and ensures every device sees the same library state.

Think of it as git for manga — with automatic conflict resolution, version history, and cross-platform sync built in.

• Cross-device collector – Automatically sync manga from your desktop download folder to your tablet reader app
• Archive curator – Normalize metadata across 10,000+ manga files from different sources
• Multi-user household – Each family member accesses the same library from their own device with personal reading progress
• Backup & migration – Transfer entire collections between platforms (e.g., Windows → Linux) without losing chapter progress
• Web archive mirroring – Aggregate series from multiple web sources into one local repository with unified naming

┌─────────────────────────────────────────────────┐
│                     ComiSync                    │
│  ┌─────────────┐  ┌─────────────┐  ┌────────┐  │
│  │  Aggregation  │  │  Resolution  │  │  Sync  │  │
│  │    Engine     │  │    Engine    │  │ Engine │  │
│  └──────┬──────┘  └──────┬──────┘  └───┬────┘  │
│         │                │              │        │
│  ┌──────┴────────────────┴──────────────┴──────┐ │
│  │              Metadata Database              │ │
│  │     (SQLite + embedded hash index)          │ │
│  └─────────────────────────────────────────────┘ │
│  ┌─────────────┐  ┌─────────────┐  ┌────────┐  │
│  │  GUI Layer   │  │  CLI Layer  │  │  API   │  │
│  │  (Qt6/Web)   │  │  (Rich CLI) │  │ (REST) │  │
│  └─────────────┘  └─────────────┘  └────────┘  │
└─────────────────────────────────────────────────┘

On first run, ComiSync presents a guided setup that walks you through:

1. Selecting your library root – Where your manga files live or will be stored
2. Adding collection sources – Local folders, network shares, web archive tokens
3. Configuring sync targets – Reader apps, cloud drives, backup destinations
4. Setting conflict resolution rules – How to handle duplicate chapters, differing metadata
5. Choosing interface – GUI (recommended for most users) or CLI (advanced)

After setup, ComiSync performs a metadata extraction scan of all files in your defined library. It reads:

• Embedded metadata (ComicInfo.xml, EPUB metadata)
• File naming patterns (volume/chapter numbers)
• Directory structures (series/volume/chapter)
• Cover art (for hash-based dedup)

A typical scan of 5,000 files takes under 30 seconds on modern hardware.

The graphical interface is designed around a three-panel layout:

• Left Panel – Library tree (series → volumes → chapters) with real-time search
• Center Panel – File preview, metadata editor, and conflict viewer
• Right Panel – Sync status, pending actions, and activity log

Drag-and-drop support for adding new sources or reorganizing collections.

For power users and automation:

comisync scan --library /mnt/manga --output status.json
comisync sync --source /mnt/manga --target tachiyomi://local
comisync dedup --library /mnt/manga --dry-run
comisync export --format portable --output /backup/manga-2026.json

CLI supports JSON output for piping to other tools, YAML configuration files, and incremental operations.

ComiSync features a plugin architecture for extending functionality:

Plugins are written in Python and can be installed via the built-in plugin marketplace or manually.

• Zero-telemetry – No usage statistics, crash reports, or analytics are collected
• Local-first – All metadata processing occurs on your machine
• Optional encryption – Sync channels can use TLS 1.3 or WireGuard VPN
• Token management – Web archive credentials are stored in OS keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service)

Q: Does ComiSync modify my original files?
A: No. ComiSync creates hard links (same file, no copy) or symlinks (pointers) where possible. Actual modifications only occur when you explicitly use the "normalize" or "convert" commands.

Q: Can I use ComiSync offline?
A: Yes. All core features work offline. Cloud sync and web archive connections require network.

Q: How does conflict resolution work?
A: ComiSync uses a three-way merge model: your local state, the remote state, and the common ancestor. You can set automatic rules (newest wins, largest file wins, manual always) or review conflicts per-file.

Q: Does it support non-English series?
A: Yes. Metadata normalization supports 12 languages natively, plus custom language profiles.

Q: What about very large libraries (100k+ files)?
A: ComiSync uses memory-mapped I/O and incremental indexing. Libraries up to 500k files are handled with the recommended hardware.

• Documentation – Full user manual, API reference, and plugin dev guide
• Discussions – Community forums for sharing workflows, plugin requests, and troubleshooting
• Issue tracker – Submit reproducible bugs or feature suggestions
• 24/7 automated support – In-app help system with contextual documentation and searchable FAQ

MIT License

Copyright (c) 2026 ComiSync Project

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

ComiSync is a library management and synchronization tool designed for owners of legally obtained digital manga collections. The software does not host, distribute, or provide access to copyrighted content. Users are solely responsible for ensuring that their use of ComiSync complies with applicable copyright laws and terms of service of any third-party services integrated via plugins. The developers assume no liability for misuse of the software, including but not limited to unauthorized reproduction, distribution, or circumvention of digital rights management. ComiSync is provided "as is" without warranty of any kind, express or implied.

ComiSync – Your manga library, unified across every device. Built for collectors who demand coherence. 2026.