mangadex-sync 2.0.3__tar.gz

mangadex_sync-2.0.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Your Name
+
+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.

mangadex_sync-2.0.3/PKG-INFO

@@ -0,0 +1,218 @@
+Metadata-Version: 2.4
+Name: mangadex-sync
+Version: 2.0.3
+Summary: Export and import your MangaDex library to/from MyAnimeList and AniList — with scores, statuses, and chapter progress
+Author-email: Spider2742 <mail@spidey.in>
+License: MIT
+Project-URL: Homepage, https://github.com/spider2742/mangadex-sync
+Project-URL: Bug Tracker, https://github.com/spider2742/mangadex-sync/issues
+Keywords: mangadex,myanimelist,anilist,manga,export,import,sync,mal
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pywebview>=5.0.0
+Requires-Dist: PyQt6>=6.4.0
+Requires-Dist: PyQt6-WebEngine>=6.4.0
+Requires-Dist: qtpy>=2.4.0
+Requires-Dist: flask>=3.0.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: openpyxl>=3.1.0
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# MangaDex Sync
+
+Export **and import** your MangaDex library to/from **MyAnimeList** and **AniList** — with scores, statuses, and optional chapter progress — all from a single clean app.
+
+![Python](https://img.shields.io/badge/Python-3.10%2B-blue?style=flat-square)
+![Flask](https://img.shields.io/badge/Flask-3.0-lightgrey?style=flat-square)
+![License](https://img.shields.io/badge/License-MIT-green?style=flat-square)
+![PyPI](https://img.shields.io/pypi/v/mangadex-sync?style=flat-square)
+![Downloads](https://img.shields.io/pypi/dm/mangadex-sync?style=flat-square)
+
+---
+
+## Features
+
+- **Single app** — Export, Import, and Convert in one place, no switching between scripts
+- **Import** — Restore your library from a MangaDex JSON backup or a MAL/AniList XML file
+- **Fast mode** — Exports titles + status in minutes (recommended)
+- **Deep mode** — Also fetches your last read chapter per manga (slower)
+- **MAL XML** — Ready to import at `myanimelist.net/import.php` (includes `.gz`)
+- **AniList XML** — Same format, ready to import at AniList
+- **JSON backup** — Full local backup of your library data
+- **Scores** — Fetches your MangaDex ratings and carries them over
+- **Resume** — Saves a checkpoint so it can pick up if interrupted
+- **Skipped list** — Shows exactly which manga had no MAL ID
+- **Export history** — Logs every export with timestamp and file list
+- **Dry run mode** — Simulate without writing any files
+- **Native window** — Opens as a desktop app via pywebview (or falls back to browser)
+
+---
+
+## Requirements
+
+- Python 3.10 or newer
+- A MangaDex account
+- A [MangaDex API Personal Client](https://mangadex.org/settings) (free to create)
+
+---
+
+## Installation
+
+```bash
+pip install mangadex-sync
+```
+
+Everything including the native desktop window is included — no extra steps needed.
+
+---
+
+## Usage
+
+```bash
+mangadex-sync
+```
+
+This opens a native desktop window. You can also open `http://localhost:7337` in any browser — useful for accessing it from another device on the same network.
+
+---
+
+## Step-by-step Guide
+
+### 1. Get your MangaDex API credentials
+
+1. Go to [mangadex.org/settings](https://mangadex.org/settings)
+2. Scroll to **API Clients** → click **Create**
+3. Give it any name, set type to **Personal**
+4. Copy your **Client ID** and **Client Secret**
+
+### 2. Export your library
+
+1. Open the app and go to the **Export** tab
+2. Fill in:
+   - **Client ID** and **Client Secret** (from step 1)
+   - **Username** and **Password** (your MangaDex login)
+   - **Save folder** — where to save the output files
+3. Choose **Fast** or **Deep** mode (Fast is recommended)
+4. Click **⚡ Extract Entire Library**
+
+> **MAL User ID and MAL Username are optional.** You do not need to fill them in to generate a working XML file. MAL identifies you by your login session when you upload — the ID and username fields in the XML header are just metadata and are ignored during import. Leave them blank if you don't know them.
+
+### 3. Convert to XML
+
+After export finishes, the **Convert** tab auto-fills with your exported files. Just:
+
+1. Click **⚡ Generate XML Files**
+2. Files are saved to your chosen folder
+
+### 4. Import to MAL / AniList
+
+- **MAL:** Go to [myanimelist.net/import.php](https://myanimelist.net/import.php) and upload the `mal_*.xml` file
+- **AniList:** Go to [anilist.co/settings/import](https://anilist.co/settings/import) and upload the `anilist_*.xml` file
+
+### 5. Import back to MangaDex
+
+Use the **Import** tab to restore your library from:
+- A `mdex_*.json` backup file (exported by this app)
+- A MAL XML file (`mal_*.xml`)
+- An AniList XML file (`anilist_*.xml`)
+
+1. Browse or paste the path to your file
+2. Optionally enable **Import Scores** to restore your ratings
+3. Click **Start Import**
+
+---
+
+## Fast vs Deep Mode
+
+| | Fast | Deep |
+|---|---|---|
+| Speed | ⚡ Minutes | 🐢 15–60+ min |
+| Titles & status | ✓ | ✓ |
+| Ratings/scores | ✓ | ✓ |
+| Last read chapter | ✗ | ✓ |
+| Recommended | ✓ | Only if you need progress |
+
+Deep mode fetches every individual chapter you've ever read to find your last one per manga. This can mean 5,000–10,000+ API calls for a large library, which is why Fast mode exists.
+
+---
+
+## Output Files
+
+For each status group (reading, completed, etc.) the app creates:
+
+| File | Description |
+|---|---|
+| `mdex_{status}_{timestamp}.xlsx` | Raw export data — used by Convert tab |
+| `mdex_{status}_{timestamp}.json` | Full JSON backup — used by Import tab |
+| `mal_{status}_{timestamp}.xml` | MAL import file |
+| `mal_{status}_{timestamp}.xml.gz` | Compressed version (also accepted by MAL) |
+| `anilist_{status}_{timestamp}.xml` | AniList import file |
+
+---
+
+## Resume
+
+If the export is interrupted (crash, network error, you stopped it), the app saves a checkpoint after each completed status group. Click **▶ Resume** on the Export tab to continue from where it left off.
+
+To start fresh, go to **Settings → Clear Checkpoint**.
+
+---
+
+## Troubleshooting
+
+**"Authentication failed"**
+- Double-check your Client ID, Client Secret, username, and password
+- Make sure your API client is set to **Personal** type and is **approved** on MangaDex
+- Try the **✓ Test Credentials** button first
+
+**"Failed to set status" during import**
+- Make sure your API client exists and is approved at [mangadex.org/settings](https://mangadex.org/settings)
+- Check that your credentials are correct
+
+**Native window doesn't open**
+- The app will fall back to your browser automatically with instructions on how to fix it
+- On Linux you may need to install a GTK system package — the app will tell you the exact command for your distro
+
+**Manga missing from MAL after import**
+- Those titles are listed in the **Skipped Manga** section — they have no MAL ID on MangaDex
+- Add them manually on MAL
+
+**Slow export speed**
+- The API enforces rate limits — the app already waits the minimum required between requests
+- Deep mode is inherently slow for large libraries — use Fast mode if chapter progress isn't critical
+
+---
+
+## Dependencies
+
+| Package | Purpose |
+|---|---|
+| `flask` | Local web server |
+| `requests` | MangaDex API calls |
+| `pandas` | Excel file read/write |
+| `openpyxl` | Excel engine for pandas |
+| `pywebview` | Native desktop window |
+| `PyQt6` + `PyQt6-WebEngine` | Qt backend for pywebview |
+| `qtpy` | Qt abstraction layer |
+
+---
+
+## Credits
+
+Based on the original export scripts by [Seriousattempts](https://github.com/Seriousattempts/MangaDex). Rewritten and extended with a web UI, Fast/Deep mode, import support, resume, score export, and AniList output.

mangadex_sync-2.0.3/README.md

@@ -0,0 +1,182 @@
+# MangaDex Sync
+
+Export **and import** your MangaDex library to/from **MyAnimeList** and **AniList** — with scores, statuses, and optional chapter progress — all from a single clean app.
+
+![Python](https://img.shields.io/badge/Python-3.10%2B-blue?style=flat-square)
+![Flask](https://img.shields.io/badge/Flask-3.0-lightgrey?style=flat-square)
+![License](https://img.shields.io/badge/License-MIT-green?style=flat-square)
+![PyPI](https://img.shields.io/pypi/v/mangadex-sync?style=flat-square)
+![Downloads](https://img.shields.io/pypi/dm/mangadex-sync?style=flat-square)
+
+---
+
+## Features
+
+- **Single app** — Export, Import, and Convert in one place, no switching between scripts
+- **Import** — Restore your library from a MangaDex JSON backup or a MAL/AniList XML file
+- **Fast mode** — Exports titles + status in minutes (recommended)
+- **Deep mode** — Also fetches your last read chapter per manga (slower)
+- **MAL XML** — Ready to import at `myanimelist.net/import.php` (includes `.gz`)
+- **AniList XML** — Same format, ready to import at AniList
+- **JSON backup** — Full local backup of your library data
+- **Scores** — Fetches your MangaDex ratings and carries them over
+- **Resume** — Saves a checkpoint so it can pick up if interrupted
+- **Skipped list** — Shows exactly which manga had no MAL ID
+- **Export history** — Logs every export with timestamp and file list
+- **Dry run mode** — Simulate without writing any files
+- **Native window** — Opens as a desktop app via pywebview (or falls back to browser)
+
+---
+
+## Requirements
+
+- Python 3.10 or newer
+- A MangaDex account
+- A [MangaDex API Personal Client](https://mangadex.org/settings) (free to create)
+
+---
+
+## Installation
+
+```bash
+pip install mangadex-sync
+```
+
+Everything including the native desktop window is included — no extra steps needed.
+
+---
+
+## Usage
+
+```bash
+mangadex-sync
+```
+
+This opens a native desktop window. You can also open `http://localhost:7337` in any browser — useful for accessing it from another device on the same network.
+
+---
+
+## Step-by-step Guide
+
+### 1. Get your MangaDex API credentials
+
+1. Go to [mangadex.org/settings](https://mangadex.org/settings)
+2. Scroll to **API Clients** → click **Create**
+3. Give it any name, set type to **Personal**
+4. Copy your **Client ID** and **Client Secret**
+
+### 2. Export your library
+
+1. Open the app and go to the **Export** tab
+2. Fill in:
+   - **Client ID** and **Client Secret** (from step 1)
+   - **Username** and **Password** (your MangaDex login)
+   - **Save folder** — where to save the output files
+3. Choose **Fast** or **Deep** mode (Fast is recommended)
+4. Click **⚡ Extract Entire Library**
+
+> **MAL User ID and MAL Username are optional.** You do not need to fill them in to generate a working XML file. MAL identifies you by your login session when you upload — the ID and username fields in the XML header are just metadata and are ignored during import. Leave them blank if you don't know them.
+
+### 3. Convert to XML
+
+After export finishes, the **Convert** tab auto-fills with your exported files. Just:
+
+1. Click **⚡ Generate XML Files**
+2. Files are saved to your chosen folder
+
+### 4. Import to MAL / AniList
+
+- **MAL:** Go to [myanimelist.net/import.php](https://myanimelist.net/import.php) and upload the `mal_*.xml` file
+- **AniList:** Go to [anilist.co/settings/import](https://anilist.co/settings/import) and upload the `anilist_*.xml` file
+
+### 5. Import back to MangaDex
+
+Use the **Import** tab to restore your library from:
+- A `mdex_*.json` backup file (exported by this app)
+- A MAL XML file (`mal_*.xml`)
+- An AniList XML file (`anilist_*.xml`)
+
+1. Browse or paste the path to your file
+2. Optionally enable **Import Scores** to restore your ratings
+3. Click **Start Import**
+
+---
+
+## Fast vs Deep Mode
+
+| | Fast | Deep |
+|---|---|---|
+| Speed | ⚡ Minutes | 🐢 15–60+ min |
+| Titles & status | ✓ | ✓ |
+| Ratings/scores | ✓ | ✓ |
+| Last read chapter | ✗ | ✓ |
+| Recommended | ✓ | Only if you need progress |
+
+Deep mode fetches every individual chapter you've ever read to find your last one per manga. This can mean 5,000–10,000+ API calls for a large library, which is why Fast mode exists.
+
+---
+
+## Output Files
+
+For each status group (reading, completed, etc.) the app creates:
+
+| File | Description |
+|---|---|
+| `mdex_{status}_{timestamp}.xlsx` | Raw export data — used by Convert tab |
+| `mdex_{status}_{timestamp}.json` | Full JSON backup — used by Import tab |
+| `mal_{status}_{timestamp}.xml` | MAL import file |
+| `mal_{status}_{timestamp}.xml.gz` | Compressed version (also accepted by MAL) |
+| `anilist_{status}_{timestamp}.xml` | AniList import file |
+
+---
+
+## Resume
+
+If the export is interrupted (crash, network error, you stopped it), the app saves a checkpoint after each completed status group. Click **▶ Resume** on the Export tab to continue from where it left off.
+
+To start fresh, go to **Settings → Clear Checkpoint**.
+
+---
+
+## Troubleshooting
+
+**"Authentication failed"**
+- Double-check your Client ID, Client Secret, username, and password
+- Make sure your API client is set to **Personal** type and is **approved** on MangaDex
+- Try the **✓ Test Credentials** button first
+
+**"Failed to set status" during import**
+- Make sure your API client exists and is approved at [mangadex.org/settings](https://mangadex.org/settings)
+- Check that your credentials are correct
+
+**Native window doesn't open**
+- The app will fall back to your browser automatically with instructions on how to fix it
+- On Linux you may need to install a GTK system package — the app will tell you the exact command for your distro
+
+**Manga missing from MAL after import**
+- Those titles are listed in the **Skipped Manga** section — they have no MAL ID on MangaDex
+- Add them manually on MAL
+
+**Slow export speed**
+- The API enforces rate limits — the app already waits the minimum required between requests
+- Deep mode is inherently slow for large libraries — use Fast mode if chapter progress isn't critical
+
+---
+
+## Dependencies
+
+| Package | Purpose |
+|---|---|
+| `flask` | Local web server |
+| `requests` | MangaDex API calls |
+| `pandas` | Excel file read/write |
+| `openpyxl` | Excel engine for pandas |
+| `pywebview` | Native desktop window |
+| `PyQt6` + `PyQt6-WebEngine` | Qt backend for pywebview |
+| `qtpy` | Qt abstraction layer |
+
+---
+
+## Credits
+
+Based on the original export scripts by [Seriousattempts](https://github.com/Seriousattempts/MangaDex). Rewritten and extended with a web UI, Fast/Deep mode, import support, resume, score export, and AniList output.

mangadex_sync-2.0.3/mangadex_sync/__init__.py

@@ -0,0 +1,158 @@
+"""
+MangaDex Sync
+Export and import your MangaDex library to/from MyAnimeList and AniList.
+"""
+
+__version__ = "2.0.1"
+__author__ = "Spider2742"
+
+from .app import app  # noqa: F401
+
+
+def _webview_fix_hint():
+    """Return a distro/OS-aware fix message for missing pywebview GUI backends."""
+    import platform
+
+    system = platform.system()
+
+    if system == "Windows":
+        return (
+            "  On Windows, install Qt support:\n"
+            "    pip install PyQt6 qtpy\n"
+            "  Or reinstall pywebview:\n"
+            "    pip install --upgrade pywebview"
+        )
+
+    if system == "Darwin":
+        return (
+            "  On macOS, pywebview uses WebKit which should work out of the box.\n"
+            "  Try upgrading pywebview:\n"
+            "    pip install --upgrade pywebview\n"
+            "  If that doesn't help, install Qt as a fallback:\n"
+            "    brew install pyqt  (requires Homebrew: brew.sh)\n"
+            "    pip install PyQt6 qtpy"
+        )
+
+    if system == "Linux":
+        distro_id   = ""
+        distro_like = ""
+        try:
+            info = platform.freedesktop_os_release()  # Python 3.10+
+            distro_id   = info.get("ID", "").lower()
+            distro_like = info.get("ID_LIKE", "").lower()
+        except Exception:
+            pass
+
+        combined = f"{distro_id} {distro_like}"
+        is_debian = any(x in combined for x in ("debian", "ubuntu", "mint", "pop", "elementary", "kali", "zorin", "raspbian"))
+        is_fedora = any(x in combined for x in ("fedora", "rhel", "centos", "rocky", "alma", "nobara"))
+        is_arch   = any(x in combined for x in ("arch", "manjaro", "endeavour", "garuda", "artix"))
+        is_suse   = any(x in combined for x in ("suse", "opensuse"))
+        is_void   = "void" in combined
+
+        if is_debian:
+            gtk_hint = "    sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-3.0 gir1.2-webkit2-4.0"
+        elif is_fedora:
+            gtk_hint = "    sudo dnf install python3-gobject python3-gobject-base webkit2gtk4.1"
+        elif is_arch:
+            gtk_hint = "    sudo pacman -S python-gobject webkit2gtk-4.1"
+        elif is_suse:
+            gtk_hint = "    sudo zypper install python3-gobject python3-gobject-Gdk typelib-1_0-WebKit2-4_1"
+        elif is_void:
+            gtk_hint = "    sudo xbps-install python3-gobject webkit2gtk"
+        else:
+            gtk_hint = "    Install python3-gobject and webkit2gtk via your package manager"
+
+        return (
+            f"  Fix with GTK (recommended):\n"
+            f"{gtk_hint}\n\n"
+            f"  Or use Qt instead:\n"
+            f"    pip install PyQt6 qtpy"
+        )
+
+    return (
+        "  Try installing Qt support:\n"
+        "    pip install PyQt6 qtpy\n"
+        "  Or GTK via your system package manager (python3-gobject + webkit2gtk)"
+    )
+
+
+def main():
+    """CLI entry point: runs the Flask app with optional pywebview."""
+    import sys
+    import time
+    import webbrowser
+    import threading
+    import requests as req_lib
+
+    missing = []
+    for pkg in ["requests", "pandas", "openpyxl", "flask"]:
+        try:
+            __import__(pkg)
+        except ImportError:
+            missing.append(pkg)
+    if missing:
+        print(f"Missing packages. Run:  pip install {' '.join(missing)}")
+        sys.exit(1)
+
+    PORT = 7337
+
+    flask_thread = threading.Thread(
+        target=lambda: app.run(host="127.0.0.1", port=PORT, debug=False, threaded=True),
+        daemon=True,
+    )
+    flask_thread.start()
+
+    for _ in range(20):
+        try:
+            req_lib.get(f"http://127.0.0.1:{PORT}/", timeout=1)
+            break
+        except Exception:
+            time.sleep(0.3)
+
+    try:
+        import webview
+
+        print(f"\n  MangaDex Sync v{__version__}")
+        print(f"  Opening native window...")
+        print(f"  (Also accessible at http://localhost:{PORT})\n")
+        webview.create_window(
+            title=f"MangaDex Sync v{__version__}",
+            url=f"http://127.0.0.1:{PORT}",
+            width=1200,
+            height=800,
+            min_size=(900, 600),
+            background_color="#0c0e14",
+        )
+        import os, sys
+        with open(os.devnull, 'w') as devnull:
+            old_stderr = sys.stderr
+            sys.stderr = devnull
+            try:
+                webview.start()
+            finally:
+                sys.stderr = old_stderr
+
+    except ImportError:
+        print(f"\n  pywebview not installed - opening in browser instead.")
+        print(f"  To get the native window:  pip install 'mangadex-sync[desktop]'\n")
+        print(f"  MangaDex Sync v{__version__}")
+        print(f"  Open in browser:  http://localhost:{PORT}\n")
+        webbrowser.open(f"http://localhost:{PORT}")
+        try:
+            while True:
+                time.sleep(1)
+        except KeyboardInterrupt:
+            print("\nShutting down.")
+
+    except Exception:
+        print(f"\n  pywebview is installed but couldn't find a GUI backend.")
+        print(f"\n{_webview_fix_hint()}")
+        print(f"\n  Falling back to browser...")
+        print(f"  Open in browser:  http://localhost:{PORT}\n")
+        webbrowser.open(f"http://localhost:{PORT}")
+        try:
+            while True:
+                time.sleep(1)
+        except KeyboardInterrupt:
+            print("\nShutting down.")