FanFicFare

JimmXinu活跃维护

把同人小说网站上的连载故事抓取下来,自动整理成 EPUB 等电子书格式,支持命令行和 Calibre 插件两种用法。

FanFicFare is a tool for making eBooks from stories on fanfiction and other web sites.

v4.63.0发布于 2026-11-02 14:21 UTC1,136star +5 / 7 天230fork同步于 2026-11-10 23:51 UTC

怎么上手

由 README 提炼,执行前请确认
pip install FanFicFare
硬件要求按 README 说明

README 未说明硬件要求,未提及显存、CPU 或 GPU 限制

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

把同人小说网站上的故事抓下来做成电子书的下载工具

把同人小说网站上的连载故事抓取下来,自动整理成 EPUB 等电子书格式,支持命令行和 Calibre 插件两种用法。

核心能力

  • 支持从 100 多个同人小说站点下载故事并生成电子书
  • 更新已下载的 EPUB 时只抓取新增章节
  • 可从网页批量提取故事 URL
  • 支持下载正文内嵌图片与封面(仅 EPUB/HTML)
  • 可选保留历次更新的更新日志(仅 EPUB)

容易踩的坑

需要图片处理功能时要改用 pip install FanFicFare[image_processing] 安装 Pillow 依赖;图片和封面仅 EPUB/HTML 支持,Kindle 需先下 EPUB 再转 AZW3;原 Web 服务版已于 2019 年底关停,只能走 Calibre 插件或 CLI

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v4.63.0
  1. v4.63.0FanFicFare 4.63.0最新正式版2026-11-02 · 2026-11-02 14:21 UTC

    Installation instructions:

    Calibre Plugin:

    Install attached plugin zip file, or use Calibre's 'Get plugins' feature.

    Command line interface:

    FanFicFare is delivered as a pip Python package.

    pip install FanFicFare or pip install --upgrade FanFicFare ...to update.

    (pip will automatically install dependencies.)

    Run fanficfare -h from command-line.

    Changes:

    • Update translations.
    • Plugin only: use_camoufox option using Calibre recipes.py Browser. #1444
    • Add do_camoufox_warmup optional feature
    • Fix continue_on_chapter_error with fff_chapter_data
    • adapter_royalroadcom: Take Legacy dateUpdated/datePublished from oldest/newest chapter dates. See also #1445
    • Update bundled certifi to 2026.10.23
    • adapter_royalroadcom: Fix for dateUpdated in new UI, thanks VictorVow(#1445)
    • adapter_royalroadcom: Increase default sleep time.
    • Plugin: Show book title in BG job title when only one.
    • Add use_series_page_metadata option, defaults false.
    • Add QuitDecorator to fetches to allow plugin prog bar quit to work better.
    • adapter_storiesonlinenet: Fix for site login change.
    • Change how chapter metadata is stored in chapter files
    • Fix mark new/unnew works with preserved chapters
    • Add first_chapter/last_chapter to valid settings list.
    • Fix numChapters for update_preserve_deleted_chapters
    • Don't skip equal-count chapter swaps when preserving deleted chapters - #1428, thanks kitoma!
    • Fixing Unnew for #1434.
    • RoyalRoad: Handle email-click URLs in geturls, not adapter. For reasons. #1429
    • adapter_fanficsme: Fix word count for site change. Closes #1433
    • Plugin: avoid blocking the event loop #1430, thanks, logologist
    • Plugin: Add modal dialog for imap/urls from page/series page fetches to allow safe threading re:#1430
    • Plugin: Fix Anthology update for ad-hoc(no series URL) anthologies(broken by ini_snippets)
    • adapter_sofurrycom: Fix for login, closes #1426, thanks dbhmw
    • adapter_royalroadcom: isUnlocked flag isn't accurate, but null or empty subscriptionTiers is?
    • adapter_royalroadcom: Fix for older py3 versions, reported in #1428
  2. v4.62.0FanFicFare 4.62.02026-10-01 · 2026-10-01 14:29 UTC
    查看更新说明

    Installation instructions:

    Calibre Plugin:

    Install attached plugin zip file, or use Calibre's 'Get plugins' feature.

    Command line interface:

    FanFicFare is delivered as a pip Python package.

    pip install FanFicFare or pip install --upgrade FanFicFare ...to update.

    (pip will automatically install dependencies.)

    Run fanficfare -h from command-line.

    Changes:

    • Update translations.
    • base_otw_adapter: chaptersummary can suddenly be a div instead of blockquote sometimes.
    • adapter_royalroadcom: Updates for RR's Redesign. Supports both for the moment.
    • Plugin: Remove user/pass from ini snippets before logging, same as 'safe' personal.ini.
    • base_otw_adapter: More robust bookmark handling
    • Add 525 errors to list of codes to retry, on by default, set retry_http_525_failures:False to disable.
    • New option max_request_retries to set connection retry limit. From #1418
    • Plugin: Apply INI Snippet to Get URLs from Web Page and anthology update.
    • New update_preserve_deleted_chapters feature, see #1414, thanks, kitoma
    • New update_check_recent_chapters feature, see #1414, thanks, kitoma
    • adapter_sofurrycom: Fixes for login, closes #1416
    • Document ffnet only try_shortened_title_urls setting
    • Increase default image_max_size to 2500, 2500
    • epub update: Don't strip h2/h3 tags that aren't chapter titles. Thanks, kitoma (#1412)
    • adapter_literotica: Fix for pagination links change, thanks akshayrangnekar(#1411)
    • adapter_ficbooknet: Fix author for site change
  3. v4.61.0FanFicFare 4.61.02026-09-01 · 2026-09-01 13:33 UTC
    查看更新说明

    Installation instructions:

    Calibre Plugin:

    Install attached plugin zip file, or use Calibre's 'Get plugins' feature.

    Command line interface:

    FanFicFare is delivered as a pip Python package.

    pip install FanFicFare or pip install --upgrade FanFicFare ...to update.

    (pip will automatically install dependencies.)

    Run fanficfare -h from command-line.

    Changes:

    • Update translations.
    • Don't confuse usecache with referer - position vs named params.
    • adapter_potionsandsnitches: http->https Closes #1404
    • Clear INI Snippet setting between Add URL dialog calls.
    • base_xenforo2forum_adapter: Fix non-first post TOC stories using BrowserCache
    • base_xenforo2forum_adapter: Reader mode--don't try pages < 1
    • Remove python2 support code
    • Update included plugin dependencies to Python 3.8 (Calibre 5)
  4. v4.60.0FanFicFare 4.60.02026-08-01 · 2026-08-01 13:55 UTC
    查看更新说明

    Installation instructions:

    Calibre Plugin:

    Install attached plugin zip file, or use Calibre's 'Get plugins' feature.

    Command line interface:

    FanFicFare is delivered as a pip Python package.

    pip install FanFicFare or pip install --upgrade FanFicFare ...to update.

    (pip will automatically install dependencies.)

    Run fanficfare -h from command-line.

    Changes:

    • Update translations.
    • base_xenforo2forum_adapter: When capitalize_forumtags don't capitaloize right after numbers. 1990s 1st, 2nd, etc
    • base_otw_adapter: Save and use if served full work initially
    • base_otw_adapter: Save a network req if need to login.
    • adapter_asianfanficscom: Fixes for major site changes
    • base_otw_adapter: Don't require open_pages_in_browser to skip login.
    • base_xenforo2forum_adapter: Look both forward and backward when post not found in reader page. #1395
    • adapter_sofurrycom: Revisit login url after 404, thanks dbhmw #1385
    • Add option keep_img_tags - keep tags when include_images:false
    • adapter_sofurrycom: More fixes for site change, thanks, dbhmw #1386
    • adapter_sofurrycom: Fixes for site change, thanks, dbhmw #1384 and #600
    • adapter_test1: Handle bool settings in [teststory:] better
    • INI Snippet: Repopulate the combobox in AddNewDialog() when shown in case of library change.
    • adapter_pmdfanfiction: Fix downloading chapters for stories with chapter groups - Thanks, BlizzardBricks
    • Better error message for open_pages_in_browser_tries_limit exceeded
    • Add avif image type to image processing.
  5. v4.59.0FanFicFare 4.59.02026-07-01 · 2026-07-01 12:41 UTC
    查看更新说明

    Installation instructions:

    Calibre Plugin:

    Install attached plugin zip file, or use Calibre's 'Get plugins' feature.

    Command line interface:

    FanFicFare is delivered as a pip Python package.

    pip install FanFicFare or pip install --upgrade FanFicFare ...to update.

    (pip will automatically install dependencies.)

    Run fanficfare -h from command-line.

    Changes:

    • Change urlunparse() to urljoin() #1377
    • browsercache_firefox2: Fix for Firefox 1.53.0b2 Beta Change
    • base_otw_adapter: Fix Series name masked using flaresolverr #1370
    • base_xenforo2forum_adapter: Change \n\n in forum tags to ' ' like like 'Worm\n\n(Wildbow (Author))'
    • base_otw_adapter: Better reporting of get token failure #1370
    • fetcher_flaresolverr_proxy: Strip wrapper HTML from JSON responses. See #1370
    • adapter_ficbooknet: enable replace_text_formatting for epub output #1368, thanks trousev!
    • Fix for PI's 'pass calibre columns into FanficFare' broken by 270e01c
    • adapter_literotica: Raise StoryDoesNotExist when redirected to home page. Closes #1365
    • adapter_literotica: Fix for site changes #1364, #1360, #1372, #1374, #1378 -- Many thanks dbhmw!
    • New site: sofurry.com, thanks dbhmw!
    • New site: pmdfanfiction.com, thanks ndpereyra!
    • adapter_ficbooknet: Fixes for site changes.
    • Add retry_failedtoload_images option
    • PI: Don't throw notifications when doing show_message()
    • PI: INI Snippets
    • PI: Prefill Add Reject URLs dialog from clipboard and allow ctrl-enter
    • Add OTW story note labels config #1347
    • Improve continue_on_chapter_error_try_limit exceeded reporting
    • Chrome browsercache_sqldb added, but cannot read cache while browser is open. See #1341
    • adapter_fanficauthorsnet: Domains changed from .nsns to -nsns
    • Include genre/category in defaults.ini when include_in_X for extragenres/extracategories

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    FanFicFare

    FanFicFare makes reading stories from various websites much easier by helping you download them to EBook files.

    FanFicFare was previously known as FanFictionDownLoader (AKA FFDL, AKA fanficdownloader).

    Main features:

    • Download FanFiction stories from over 100 different sites. into ebooks.

    • Update previously downloaded EPUB format ebooks, downloading only new chapters.

    • Get Story URLs from Web Pages.

    • Support for downloading images in the story text. (EPUB and HTML only -- download EPUB and convert to AZW3 for Kindle) More details on configuring images in stories and cover images can be found in the FAQs or this post in the old FFDL thread.

    • Support for cover image. (EPUB only)

    • Optionally keep an Update Log of past updates (EPUB only).

    There's additional info in the project wiki pages.

    There's also a FanFicFare maillist for discussion and announcements and a discussion thread for the Calibre plugin.

    Getting FanFicFare

    Official Releases

    This program is available as:

    • A Calibre plugin from within Calibre or directly from the plugin discussion thread, or;
    • A Command Line Interface (CLI) Python package that you can install with:
    pip install FanFicFare
    

    Image processing uses Pillow. Install with:

    pip install FanFicFare[image_processing]
    
    • As of late November 2019, the web service version is shutdown. See the Wiki Home page for details.

    Test Versions

    FanFicFare is released roughly every month, but new test versions are posted more frequently as changes are made.

    Test versions are available at:

    • The test plugin is posted at MobileRead.
    • The test version of CLI for pip install is uploaded to the testpypi repository and can be installed with:
    pip install --extra-index-url https://test.pypi.org/simple/ --upgrade FanFicFare
    

    Other Releases

    Other versions may be available depending on your OS. I(JimmXinu) don't directly support these:

    • Arch Linux: The latest CLI release can be obtained from the fanficfare AUR package. It will install the calibre plugin, if calibre is installed.