Skip to content

Eix0721/JMcomic-Downloader

Repository files navigation

JMComic Downloader

基于 Python 开发的命令行漫画下载工具,提供简洁易用的交互式界面,支持批量下载、历史记录管理及多主题切换。


Python Platform 开源许可 Latest Release Last Commit


✨ 特性

🚀 快速开始 🎮 交互友好 🎯 批量下载 🎨 多种主题
下载即用,无需配置 优雅的交互式菜单 支持多个漫画ID 内置 7 种界面风格
📜 历史记录 🌐 域名测试 ⚙️ 配置持久 🛠️ 异常处理
自动保存下载轨迹 智能检测可用域名 自动生成 yml 配置 详尽的报错提示

🚀 快速开始

  • 📦 推荐方式 - 即开即用

  1. 下载程序

    • 前往 Release页面
    • 在底部下载最新版本的可执行文件(.exe)
  2. 运行程序 下载完成后后双击运行 "JMcomic_Downloader.exe"

  • 🛠️ 源码运行

  1. 克隆项目

    git clone https://github.com/Eix0721/JMcomic-Downloader.git
  2. 安装依赖(使用 uv)

    uv sync
  3. 运行程序

    uv run jmcomic-downloader

    或通过 __main__ 运行:

    uv run python -m jmcomic_downloader

🎮 使用指南

  • 主菜单

    • 主菜单
    • 启动程序后,通过 ↑/↓ 选择功能,按 ENTER 键确认:
  • 下载漫画

    • 选择 下载漫画,输入禁漫车号(如:350234)。
    • 支持批量下载:多个车号用空格分隔(如:350234 114514)。
    • 下载完成后,漫画将保存至与漫画同名的文件夹内,记录会自动同步至history.yml
  • 设置选项

    • 下载日志输出:开启后可查看详细的下载进度条和网络请求日志。
    • 切换主题:内置“商务深蓝”、“粉红樱花”、“赛博霓虹”等多种配色。
    • 测试连接:自动获取并测试多个禁漫域名,寻找当前网络环境下最快的线路。
    • 恢复默认:一键重置所有配置文件。

📂 项目结构

Jmcomic-Downloader\
│  README.md            # 项目说明
│  .gitignore           # Git 忽略文件
│  Changelog            # 更新日志
│  LICENSE              # MIT许可证
│  pyproject.toml       # 项目配置与依赖
├─assets\
│   │ func_demo_1_20260219.png # 功能演示图
│   └─ icon.ico                 # 程序图标
└─src\
    │  run.py                 # 启动入口
    └─jmcomic_downloader\     # 核心包
        │  __init__.py        # 包入口
        │  __main__.py        # python -m 入口
        │  core.py            # 主下载逻辑与命令分发
        │  ui.py              # 基于 InquirerPy 的交互界面
        │  text.py            # 静态文本与多套主题配置
        │  config.py          # 配置管理
        │  history.py         # 历史记录管理
        │  test_domain.py     # 域名可用性检测工具

🛠️ 技术栈&鸣谢

感谢以下开源项目:

技术&模块 用途
JMComic Crawler Python 核心下载引擎
InquirerPy 交互式命令行 UI
SimpSave 极简 YAML 配置存取
curl_cffi 绕过网络指纹检测
  • 关爱禁漫娘,请不要一次性内下载过多本子!

🔔 其他事项

  • 本项目目前仍在初步开发阶段。欢迎您提交 IssuePR 参与改进!
  • 采用 MIT 许可证 开源。

版权所有 © 2025 Eix0721


Star History Chart
如果这个项目对你有帮助,给个 ⭐Star⭐ 支持一下吧!

About

基于 Python 开发的命令行漫画下载工具,提供简洁易用的交互式界面,支持批量下载漫画等功能。

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages