anime-organizer

轻量级、跨平台命令行工具，专为动漫收藏者批量整理视频文件，支持硬链接模式实现零额外空间占用。

English | 中文

中文

📖 项目描述

anime-organizer（简称 aniorg）是一款专为动漫收藏者设计的命令行工具，旨在自动化整理下载目录中的动漫视频文件。

核心功能：

自动解析文件名，识别动漫名称、集数、发布组等信息
支持硬链接模式，整理后不占用额外磁盘空间
自动生成 Kodi 兼容的 NFO 元数据文件
下载封面海报和背景图
支持 RSS 订阅和 115 网盘同步（需启用 clouddrive feature）

适用场景：

整理下载目录中的动漫文件
自动化管理动漫媒体库
为 Kodi/Jellyfin/Plex 等媒体中心生成元数据

🚀 功能特性

智能解析: 自动识别 [发布组] 动漫名 - 集数 [标签].ext 格式
灵活整理: 重构为 动漫名/Season N/集数 [标签].ext 结构
多种模式: 支持移动、复制、硬链接三种操作模式
元数据刮削: 基于 Bangumi 生成 Kodi 兼容的 NFO 文件
封面下载: 优先通过 Bangumi 下载海报，TMDB 作为备选并补充背景图，AniDB 作为最终海报兜底
别名匹配: 支持本地 bangumi.db 别名库和自定义 JSON 覆盖，缺失时回退到 Bangumi 名称/搜索匹配
RSS 订阅: 支持 RSS 自动订阅和 115 网盘同步（需 clouddrive feature）
跨平台: 支持 Windows、Linux、macOS
零依赖运行: 单文件部署，无需外部配置
高性能: Rust 原生实现，极速处理

📥 安装方式

方式一：下载预编译二进制

从 GitHub Releases 下载对应平台的二进制文件：

平台	文件
Windows x64	`aniorg-x86_64-pc-windows-msvc.zip`
Windows ARM64	`aniorg-aarch64-pc-windows-msvc.zip`
Linux x64	`aniorg-x86_64-unknown-linux-gnu.tar.gz`
Linux x64 (musl)	`aniorg-x86_64-unknown-linux-musl.tar.gz`
Linux ARM64	`aniorg-aarch64-unknown-linux-gnu.tar.gz`
macOS x64	`aniorg-x86_64-apple-darwin.tar.gz`
macOS ARM64	`aniorg-aarch64-apple-darwin.tar.gz`

方式二：从源码构建

git clone https://github.com/ModerRAS/anime-organizer.git
cd anime-organizer

# 默认构建（启用 metadata feature）
cargo build --release

# 全功能构建
cargo build --release --features "scraper clouddrive torrent-scraper"

# 启用嵌入式 AniFileBERT ONNX 文件名解析器（CPU）
cargo build --release --features "anifilebert"

# 启用 AniFileBERT + Windows DirectML（GPU；NPU 可显式选择）
cargo build --release --features "anifilebert-directml"

编译后的二进制文件位于 target/release/aniorg。ANIORG_BERT_PROVIDER=cpu|auto|directml-gpu|directml-npu|directml-any 控制 ONNX Runtime provider；ANIORG_DIRECTML_DEVICE_ID=0 可指定 DirectML 设备。未启用 anifilebert-directml 时默认 CPU；启用后默认 auto，会先尝试 DirectML GPU，失败则回退 CPU。CPU 线程数可用 ANIORG_ORT_INTRA_THREADS 和 ANIORG_ORT_INTER_THREADS 调整，默认均为 1。anifilebert-amd-npu 仍可用，是 anifilebert-directml 的兼容别名；VitisAI 需要额外的 ONNX Runtime provider 包，未放入默认构建。

如果本机默认是 GNU Rust 工具链，Windows 上验证 AniFileBERT/DirectML 时请显式指定 MSVC rustc。若 ONNX Runtime 在本地链接阶段报错，可将 ORT_LIB_LOCATION 指向解压后的 ORT 目录，并设置 ORT_PREFER_DYNAMIC_LINK=1 改走 import-lib/dll 路线。

🎯 快速开始

基本用法

# 硬链接模式（默认，零额外空间）
aniorg --source="/path/to/downloads"

# 复制模式
aniorg --source="/path/to/downloads" --mode=copy --target="/path/to/anime"

# 启用硬链接失败回退为复制
aniorg --source="/path/to/downloads" --fallback-on-link-failure=copy

# 启用分季目录结构
aniorg --source="/path/to/downloads" --season-mode --target="/path/to/anime"

# 生成 NFO 和海报
aniorg --source="/path/to/downloads" --scrape-metadata

# 生成/更新目标目录根部的 MLIP 媒体库索引
aniorg --source="/path/to/downloads" --target="/path/to/anime" --library-index

# 生成 MiruPlay 可直接导入的 MLIP 媒体库（含 Bangumi 元数据和海报）
aniorg --source="/path/to/downloads" --target="/path/to/anime" --mlip

# 强制重新扫描目标目录并重建媒体库索引
aniorg --source="/path/to/downloads" --target="/path/to/anime" --library-index --rebuild-library-index

预览模式

在实际操作前先预览变更：

aniorg --source="/path/to/downloads" --dry-run --verbose

📋 参数说明

参数	缩写	类型	必填	默认值	说明
`--source`	`-s`	string	✅	-	源目录路径
`--target`	`-t`	string	❌	source	目标根目录
`--mode`	`-m`	enum	❌	link	操作模式：move/copy/link
`--dry-run`		bool	❌	false	仅预览不执行
`--include-ext`		string	❌	mp4,mkv,...	处理的扩展名（逗号分隔）
`--filename-parser`		enum	❌	rules	文件名解析器：`rules`、`anifilebert`、`auto`（规则失败后回退 AniFileBERT）
`--verbose`	`-v`	bool	❌	false	显示详细日志
`--fallback-on-link-failure`		enum	❌	-	硬链接失败时回退模式：move 或 copy（默认不回退）
`--season-mode` / `--分季`		bool	❌	false	按 `番名/Season N/` 结构整理多季作品
`--scrape-metadata` / `--刮削`		bool	❌	false	启用 Bangumi 元数据刮削（TMDB 可选补图）
`--tmdb-api-key`		string	❌	-	TMDB API Key，用于备选海报和背景图
`--alias-file`		string	❌	-	自定义别名 JSON 文件，覆盖本地 `bangumi.db` 中的同名项
`--no-images`		bool	❌	false	只生成 NFO，不下载图片
`--no-episode-metadata`		bool	❌	false	跳过 Bangumi 分集标题、简介和时长查询
`--force-overwrite`		bool	❌	false	覆盖已有的 NFO 和图片文件
`--bangumi-cache`		string	❌	系统缓存目录	Bangumi 缓存目录
`--metadata-source`		string	❌	-	指定本地 `subject.jsonlines` 或其所在目录
`--library-index`		bool	❌	false	生成/更新目标目录根部的 `library.db`
`--mlip`		bool	❌	false	生成 MiruPlay 可直接导入的 MLIP 媒体库，自动启用 `library.db` 并写入 Bangumi 元数据
`--rebuild-library-index`		bool	❌	false	与 `--library-index` 或 `--mlip` 一起使用，强制全量重扫目标目录并重建索引
`--probe-runtime`		bool	❌	false	使用 `ffprobe` 探测视频时长并写入 `episode.runtime`（秒）
`--help`	`-h`	bool	❌	false	显示帮助
`--version`	`-V`	bool	❌	false	显示版本

🧾 元数据刮削

启用 --scrape-metadata 后，程序会：

优先使用 --alias-file JSON 和本地别名库匹配 Bangumi 条目；若未提供本地 animeatlas.sqlite/bangumi.db，会自动下载 AnimeAtlas latest release 的 animeatlas.sqlite 到缓存目录，失败时回退到 Bangumi 名称/搜索匹配
在动画根目录生成 tvshow.nfo
在 Season N/ 目录下生成与视频同名的 *.nfo
优先从 Bangumi 下载 poster.jpg 和 seasonXX-poster.jpg；如果提供了 TMDB API Key，则 TMDB 作为海报备选并补充 fanart.jpg

--alias-file 可直接复用 extract-aliases 导出的 JSON 对象格式，例如：

{
  "芙莉莲": {
    "bangumi_id": 444444,
    "name": "葬送のフリーレン",
    "tmdb_id": 209867,
    "anidb_id": 18597
  }
}

🗃️ MLIP 媒体库索引

启用 --library-index 后，程序会固定管理目标目录根部的 library.db：

如果 library.db 不存在：整理完成后扫描整个 target，初始化建库。
如果 library.db 已存在：默认只把本次整理成功的新文件增量更新进去。
如果同时传入 --rebuild-library-index：整理完成后重新扫描整个 target 并重建数据库。
--dry-run 下只打印将执行的模式和统计，不创建或修改数据库。

--library-index 只写文件索引，不主动联网补元数据。给 MiruPlay 使用时推荐 --mlip：它会自动生成 library.db，并把 Bangumi 作品元数据、分集标题/简介、Bangumi 海报写入索引；如果提供 TMDB API Key，TMDB 会作为备选海报来源并补充背景图。Bangumi 分集数据有 duration_seconds 时会写入 episode.runtime；如需以本地视频为准，可额外传入 --probe-runtime 使用 ffprobe 探测实际时长。

本数据库是只读协议。任何播放器不得修改本数据库；播放历史、收藏、继续播放等数据必须保存在播放器自己的数据库。

使用方式

首次启用时，library.db 不存在，程序会先完成本次整理，再扫描整个 target 目录建立索引：

aniorg \
  --source="/path/to/downloads" \
  --target="/path/to/anime" \
  --library-index

生成结果固定放在目标目录根部：

/path/to/anime/
├── library.db
├── Bocchi the Rock!/
│   └── 01 [1080P].mkv
└── Spy x Family/
    └── Season 2/
        └── 01 [1080P].mkv

以后继续整理新下载时，仍然使用同一个命令。只要 library.db 已存在，默认就是增量更新：只把本次整理成功的文件写入索引，不会重新扫描整个目标目录。

aniorg \
  --source="/path/to/new-downloads" \
  --target="/path/to/anime" \
  --library-index

如果你手动往目标目录添加、删除、移动了文件，或者想重新生成整个索引，使用 --rebuild-library-index：

aniorg \
  --source="/path/to/downloads" \
  --target="/path/to/anime" \
  --library-index \
  --rebuild-library-index

--rebuild-library-index 必须和 --library-index 或 --mlip 一起使用。重建会在文件整理完成后扫描整个 target，因此本次整理成功的新文件也会包含在新的 library.db 里。

给 MiruPlay 生成成品库时，使用 --mlip；它不会生成 Kodi NFO：

aniorg \
  --source="/path/to/downloads" \
  --target="/path/to/anime" \
  --mlip

如果还想补充 TMDB 背景图，可以额外传入 --tmdb-api-key。

如果同时想生成 Kodi NFO、图片和 MLIP 索引，可以一起开启元数据刮削：

aniorg \
  --source="/path/to/downloads" \
  --target="/path/to/anime" \
  --scrape-metadata \
  --tmdb-api-key="YOUR_TMDB_KEY" \
  --library-index

预览时可以组合 --dry-run。此时不会创建或修改 library.db，只会打印将执行初始化、增量更新还是重建：

aniorg \
  --source="/path/to/downloads" \
  --target="/path/to/anime" \
  --library-index \
  --dry-run \
  --verbose

如果不传 --target，目标目录沿用现有规则等于 source，所以索引会写到 <source>/library.db。播放器读取时应把 media_file.path 当作相对 library.db 所在目录的路径处理，路径分隔符统一为 /。

-- ============================================================
-- Media Library Index Protocol (MLIP)
--
-- Version : 1
-- Storage : SQLite 3
--
-- 设计原则：
-- 1. 不扫描目录即可构建媒体库
-- 2. 不依赖在线刮削
-- 3. 支持长期扩展
-- 4. 所有数据均可由整理器重新生成
-- 5. 不使用 polymorphic association / JSON / EAV
-- ============================================================

PRAGMA foreign_keys = ON;

CREATE TABLE meta
(
    key     TEXT PRIMARY KEY,
    value   TEXT NOT NULL
);

-- meta keys:
-- schema = 1
-- protocol = MLIP
-- generator = AnimeOrganizer
-- generator_version = <cargo package version>
-- library_uuid = <uuid>
-- library_root = <canonical target path>
-- generated_at = <RFC3339 timestamp>

CREATE TABLE series
(
    id              INTEGER PRIMARY KEY,
    uuid            TEXT UNIQUE NOT NULL,
    title           TEXT NOT NULL,
    original_title  TEXT,
    sort_title      TEXT,
    summary         TEXT,
    year            INTEGER,

    -- series_type:
    -- 1 TV
    -- 2 Movie
    -- 3 OVA
    -- 4 ONA
    -- 5 SP
    series_type     INTEGER NOT NULL DEFAULT 1
);

CREATE INDEX idx_series_title ON series(title);

CREATE TABLE episode
(
    id          INTEGER PRIMARY KEY,
    uuid        TEXT UNIQUE NOT NULL,
    series_id   INTEGER NOT NULL,
    season      INTEGER NOT NULL DEFAULT 1,
    episode     REAL NOT NULL,
    sort_order  REAL NOT NULL,
    title       TEXT,
    summary     TEXT,
    runtime     INTEGER, -- seconds

    FOREIGN KEY(series_id)
        REFERENCES series(id)
        ON DELETE CASCADE,

    UNIQUE(series_id, season, episode)
);

CREATE INDEX idx_episode_series ON episode(series_id);

CREATE TABLE media_file
(
    id              INTEGER PRIMARY KEY,
    episode_id      INTEGER NOT NULL,
    path            TEXT NOT NULL UNIQUE,
    size            INTEGER,
    modified_time   INTEGER,

    FOREIGN KEY(episode_id)
        REFERENCES episode(id)
        ON DELETE CASCADE
);

CREATE INDEX idx_media_path ON media_file(path);
CREATE INDEX idx_media_episode ON media_file(episode_id);

CREATE TABLE series_artwork
(
    id              INTEGER PRIMARY KEY,
    series_id       INTEGER NOT NULL,

    -- artwork_kind:
    -- 1 poster
    -- 2 fanart
    -- 3 banner
    -- 4 logo
    -- 5 thumb
    -- 6 clearart
    -- 7 season_poster
    artwork_kind    INTEGER NOT NULL,
    path            TEXT NOT NULL,

    FOREIGN KEY(series_id)
        REFERENCES series(id)
        ON DELETE CASCADE,

    UNIQUE(series_id, artwork_kind, path)
);

CREATE INDEX idx_series_artwork_series ON series_artwork(series_id);

CREATE TABLE episode_artwork
(
    id              INTEGER PRIMARY KEY,
    episode_id      INTEGER NOT NULL,
    artwork_kind    INTEGER NOT NULL,
    path            TEXT NOT NULL,

    FOREIGN KEY(episode_id)
        REFERENCES episode(id)
        ON DELETE CASCADE,

    UNIQUE(episode_id, artwork_kind, path)
);

CREATE INDEX idx_episode_artwork_episode ON episode_artwork(episode_id);

CREATE TABLE genre
(
    id      INTEGER PRIMARY KEY,
    name    TEXT UNIQUE NOT NULL
);

CREATE TABLE series_genre
(
    series_id   INTEGER NOT NULL,
    genre_id    INTEGER NOT NULL,

    PRIMARY KEY(series_id, genre_id),

    FOREIGN KEY(series_id)
        REFERENCES series(id)
        ON DELETE CASCADE,

    FOREIGN KEY(genre_id)
        REFERENCES genre(id)
        ON DELETE CASCADE
);

CREATE TABLE series_external_id
(
    series_id   INTEGER NOT NULL,

    -- provider:
    -- 1 bangumi
    -- 2 tmdb
    -- 3 anidb
    provider    INTEGER NOT NULL,
    value       TEXT NOT NULL,

    PRIMARY KEY(series_id, provider, value),

    FOREIGN KEY(series_id)
        REFERENCES series(id)
        ON DELETE CASCADE
);

CREATE TABLE episode_external_id
(
    episode_id  INTEGER NOT NULL,
    provider    INTEGER NOT NULL,
    value       TEXT NOT NULL,

    PRIMARY KEY(episode_id, provider, value),

    FOREIGN KEY(episode_id)
        REFERENCES episode(id)
        ON DELETE CASCADE
);

CREATE TABLE capability
(
    name        TEXT PRIMARY KEY,
    enabled     INTEGER NOT NULL
);

-- v1 capabilities:
-- artwork = 1
-- genre = 1
-- external_id = 1
-- people = 0
-- subtitle = 0
-- media_technical = 0
-- multi_file = 1

PRAGMA user_version = 1;

v1 明确不包含 tag、person、credit、字幕、hash、codec、分辨率。以后需要时加新表，不改这些表。

🎨 文件命名格式

支持的源文件名格式

[发布组] 动漫名称（可含季度） - 集数 [标签信息].扩展名

示例：

[ANi] 妖怪旅館營業中貳 - 07 [1080P][Baha][WEB-DL][AAC AVC][CHT].mp4
[SubsPlease] 间谍过家家 - 12 [1080p].mkv
[EMBER] 进击的巨人 The Final Season - 01 [1080p][Multiple Subtitle].avi

目标文件结构

动漫名称（含季度）/
├── Season 1/
│   ├── 01 [标签信息].扩展名
│   └── 02 [标签信息].扩展名
├── Season 2/
│   ├── 01 [标签信息].扩展名
│   └── ...
├── tvshow.nfo
├── poster.jpg
└── fanart.jpg

🔗 硬链接说明

硬链接是推荐的整理方式，具有以下优势：

零额外空间: 不占用额外磁盘空间
快速操作: 几乎瞬间完成
文件同步: 源文件和目标文件内容完全同步

使用条件

同一文件系统: 源文件和目标必须在同一分区/NAS卷
文件系统支持: ext4、NTFS、APFS 等均支持
权限要求: 需要对源和目标目录有写入权限

跨设备错误

如果源文件和目标不在同一文件系统，会显示错误：

硬链接失败：源文件和目标必须在同一文件系统

此时可选择：

将目标目录改为与源文件同一文件系统
使用复制模式 (--mode=copy)，或通过 --fallback-on-link-failure=copy 自动回退
使用移动模式 (--mode=move)，或通过 --fallback-on-link-failure=move 自动回退

🔧 刮削子命令（需 `--features scraper`）

# 刮削近期更新
cargo run --features scraper -- scrape --days 7 --format json

# 匹配别名提案
cargo run --features scraper -- match --input scraped.json --format github

# 构建 SQLite 别名库
cargo run --features scraper -- build-db --output bangumi.db

# 从 dump 提取别名
cargo run --features scraper -- extract-aliases --download

# 合并新别名到数据库
cargo run --features scraper -- merge-aliases --input new_aliases.json

# 应用匹配的别名提案
cargo run --features scraper -- apply-matches --input proposals.json

# 创建别名请求 issue
cargo run --features scraper -- create-alias-issues --input uncertain.json --repo ModerRAS/anime-organizer

📡 RSS 订阅管理（需 `--features clouddrive`）

# 列出订阅
aniorg rss --list-subscriptions

# 添加订阅
aniorg rss --add-subscription \
  --rss-url "https://example.com/rss" \
  --rss-target "/anime" \
  --rss-filter "720p"

# 单次执行
aniorg rss --single-shot \
  --clouddrive-url http://localhost:19798 \
  --rss-url "https://example.com/rss" \
  --rss-target "/anime"

# Daemon 模式（持续监控）
aniorg rss --daemon \
  --clouddrive-url http://localhost:19798 \
  --rss-interval 300

认证支持两种方式：直接传 --clouddrive-token，或使用 --clouddrive-user + --clouddrive-pass 登录获取令牌。订阅和去重状态默认保存在 Windows 的 %LOCALAPPDATA%\anime-organizer\rss.db。

☁️ CloudDrive 辅助命令（需 `--features clouddrive`）

# 直接提交 magnet 或 torrent URL 到离线下载
aniorg add-offline "magnet:?xt=urn:btih:..." \
  --target "/anime" \
  --clouddrive-url http://localhost:19798 \
  --clouddrive-token "YOUR_TOKEN"

# 浏览云盘目录
aniorg list-folder "/anime" \
  --clouddrive-url http://localhost:19798 \
  --clouddrive-token "YOUR_TOKEN"

💡 使用示例

# 整理下载目录
aniorg --source="D:\Downloads\Anime"

# 整理到指定目录
aniorg -s "/home/user/Downloads" -t "/media/anime"

# 硬链接模式
aniorg -s "/home/user/Downloads" -m link -t "/mnt/anime"

# 多季作品按 Season 目录整理
aniorg -s "/path/to/downloads" -t "/path/to/anime" --season-mode

# 预览变更并显示详细日志
aniorg -s "/path/to/downloads" --dry-run -v

# 指定文件类型
aniorg -s "/path/to/downloads" --include-ext="mp4,mkv"

# 使用自定义别名库
aniorg -s "/path/to/downloads" --alias-file="./my-aliases.json"

# 强制覆盖已有 NFO
aniorg -s "/path/to/downloads" --scrape-metadata --force-overwrite

English

📖 Project Description

anime-organizer (aniorg) is a command-line tool designed for anime collectors to automatically organize video files in download directories.

Core Features:

Auto-parse filenames to extract anime name, episode number, publisher info
Support hard link mode - organize files without using extra disk space
Generate Kodi-compatible NFO metadata files
Download poster and fanart images
RSS subscription and 115 cloud drive sync (requires clouddrive feature)

Use Cases:

Organize anime files in download directories
Automate anime media library management
Generate metadata for Kodi/Jellyfin/Plex media centers

🚀 Features

Smart Parsing: Auto-recognize [Publisher] AnimeName - Episode [Tags].ext format
Flexible Organization: Restructure to AnimeName/Season N/Episode [Tags].ext
Multiple Modes: Support move, copy, and hard link operations
Metadata Scraping: Generate Kodi-compatible NFO files from Bangumi metadata
Artwork Download: Download anime posters from Bangumi first, use TMDB as a backup and fanart source, then AniDB as the final poster fallback
Alias Matching: Local bangumi.db aliases plus optional custom JSON overrides, with Bangumi title/search fallback
RSS Subscription: RSS auto-subscription and 115 cloud drive sync (requires clouddrive feature)
Cross-Platform: Support Windows, Linux, macOS
Zero Runtime Dependencies: Single binary deployment
High Performance: Native Rust implementation

📥 Installation

Option 1: Download Pre-built Binary

Download from GitHub Releases.

Option 2: Build from Source

git clone https://github.com/ModerRAS/anime-organizer.git
cd anime-organizer

# Default build (metadata feature enabled)
cargo build --release

# Full features
cargo build --release --features "scraper clouddrive torrent-scraper"

# Embedded AniFileBERT ONNX filename parser (CPU)
cargo build --release --features "anifilebert"

# AniFileBERT plus Windows DirectML (GPU; NPU can be selected explicitly)
cargo build --release --features "anifilebert-directml"

The compiled binary is located at target/release/aniorg. ANIORG_BERT_PROVIDER=cpu|auto|directml-gpu|directml-npu|directml-any controls the ONNX Runtime provider; ANIORG_DIRECTML_DEVICE_ID=0 pins a DirectML device. Without anifilebert-directml, the parser uses CPU. With it, the default is auto: try DirectML GPU first, then fall back to CPU. CPU threads can be tuned with ANIORG_ORT_INTRA_THREADS and ANIORG_ORT_INTER_THREADS; both default to 1. anifilebert-amd-npu remains as a compatibility alias for anifilebert-directml; VitisAI requires an additional ONNX Runtime provider package and is not part of the default build.

If your local Windows machine defaults to the GNU Rust toolchain, validate AniFileBERT/DirectML builds with the MSVC rustc explicitly. If ONNX Runtime fails during the local link step, point ORT_LIB_LOCATION at the extracted ORT directory and set ORT_PREFER_DYNAMIC_LINK=1 to use the import-lib/dll path.

🎯 Quick Start

# Hard link mode (default, zero extra space)
aniorg --source="/path/to/downloads"

# Preview mode
aniorg --source="/path/to/downloads" --dry-run --verbose

# Enable automatic fallback to copy when hard link fails
aniorg --source="/path/to/downloads" --fallback-on-link-failure=copy

# Organize multi-season releases into Season folders
aniorg --source="/path/to/downloads" --season-mode --target="/path/to/anime"

# Generate NFO files and artwork
aniorg --source="/path/to/downloads" --scrape-metadata

# Generate or update the MLIP library index in the target root
aniorg --source="/path/to/downloads" --target="/path/to/anime" --library-index

# Generate a MiruPlay-ready MLIP library with Bangumi metadata and posters
aniorg --source="/path/to/downloads" --target="/path/to/anime" --mlip

# Force a full target rescan and rebuild the library index
aniorg --source="/path/to/downloads" --target="/path/to/anime" --library-index --rebuild-library-index

📋 Arguments

Argument	Short	Type	Required	Default	Description
`--source`	`-s`	string	✅	-	Source directory path
`--target`	`-t`	string	❌	source	Target root directory
`--mode`	`-m`	enum	❌	link	Operation mode: move/copy/link
`--dry-run`		bool	❌	false	Preview only, no actual changes
`--include-ext`		string	❌	mp4,mkv,...	File extensions to process
`--filename-parser`		enum	❌	rules	Filename parser: `rules`, `anifilebert`, or `auto` (fall back to AniFileBERT after rules fail)
`--verbose`	`-v`	bool	❌	false	Show detailed logs
`--fallback-on-link-failure`		enum	❌	-	Fallback when hard link fails: move or copy (disabled by default)
`--season-mode` / `--分季`		bool	❌	false	Group multi-season titles as `Series/Season N/`
`--scrape-metadata` / `--刮削`		bool	❌	false	Enable Bangumi metadata scraping with optional TMDB artwork
`--tmdb-api-key`		string	❌	-	TMDB API key for backup posters and fanart
`--alias-file`		string	❌	-	Custom alias JSON file overriding same-name entries from local `bangumi.db`
`--no-images`		bool	❌	false	Generate NFO only, skip artwork download
`--no-episode-metadata`		bool	❌	false	Skip Bangumi episode title, summary, and duration lookup
`--force-overwrite`		bool	❌	false	Overwrite existing NFO and image files
`--bangumi-cache`		string	❌	system cache dir	Bangumi cache directory
`--metadata-source`		string	❌	-	Local `subject.jsonlines` file or containing directory
`--library-index`		bool	❌	false	Generate/update `library.db` in the target root
`--mlip`		bool	❌	false	Generate a MiruPlay-ready MLIP library and write Bangumi metadata into `library.db`
`--rebuild-library-index`		bool	❌	false	Force a full target rescan and rebuild; requires `--library-index` or `--mlip`
`--probe-runtime`		bool	❌	false	Use `ffprobe` to probe video duration and write `episode.runtime` in seconds
`--help`	`-h`	bool	❌	false	Show help
`--version`	`-V`	bool	❌	false	Show version

🧾 Metadata Scraping

When --scrape-metadata is enabled, the tool will:

Prefer aliases from --alias-file JSON and a local alias database; when no local animeatlas.sqlite/bangumi.db is available, it downloads AnimeAtlas latest-release animeatlas.sqlite into the cache directory and falls back to Bangumi title/search matching if that download fails
Generate tvshow.nfo in the series root
Generate per-episode *.nfo files beside organized videos in Season N/
Download poster.jpg and seasonXX-poster.jpg from Bangumi first; when a TMDB API key is provided, TMDB is used as a poster backup and for fanart.jpg

The --alias-file JSON can reuse the object output format from extract-aliases, for example:

{
  "Frieren": {
    "bangumi_id": 444444,
    "name": "葬送のフリーレン",
    "tmdb_id": 209867,
    "anidb_id": 18597
  }
}

🗃️ MLIP Library Index

--library-index manages a fixed library.db in the target root. It only writes the file index and does not fetch metadata. For MiruPlay, prefer --mlip; it implies library.db generation and writes Bangumi series metadata, episode titles/summaries, and posters, while leaving Kodi NFO generation disabled unless --scrape-metadata is also set. A TMDB API key is optional and only adds backup poster/fanart coverage. When Bangumi episodes include duration_seconds, it is written to episode.runtime; pass --probe-runtime to use ffprobe and prefer actual local video duration.

The first run creates the database by scanning the full target directory after organization finishes:

aniorg \
  --source="/path/to/downloads" \
  --target="/path/to/anime" \
  --library-index

Later runs with the same command are incremental when library.db already exists: only files successfully organized in the current run are upserted.

aniorg \
  --source="/path/to/new-downloads" \
  --target="/path/to/anime" \
  --library-index

Use --rebuild-library-index when files were manually added, removed, or moved in the target directory:

aniorg \
  --source="/path/to/downloads" \
  --target="/path/to/anime" \
  --library-index \
  --rebuild-library-index

--dry-run --library-index does not create or modify library.db; it only reports whether the command would initialize, incrementally update, or rebuild the index. media_file.path values are stored relative to the directory containing library.db and always use / separators.

🔗 Hard Link Notes

Hard linking is the recommended mode:

Zero Extra Space: No additional disk space used
Fast Operation: Almost instant
File Sync: Source and target share the same content

If hard linking fails due to cross-filesystem layouts or lack of support, you can opt in to automatic fallback via --fallback-on-link-failure=copy or --fallback-on-link-failure=move; otherwise, the failure is reported and the file is skipped.

Requirements:

Source and target must be on the same filesystem
Filesystem must support hard links (ext4, NTFS, APFS, etc.)
Write permission required for both directories

🔧 Scraper Subcommands (requires `--features scraper`)

# Scrape recent updates
cargo run --features scraper -- scrape --days 7 --format json

# Match alias proposals
cargo run --features scraper -- match --input scraped.json --format github

# Build SQLite alias database
cargo run --features scraper -- build-db --output bangumi.db

# Extract aliases from dump
cargo run --features scraper -- extract-aliases --download

# Merge new aliases into database
cargo run --features scraper -- merge-aliases --input new_aliases.json

# Apply confident match proposals
cargo run --features scraper -- apply-matches --input proposals.json

# Create alias request issues
cargo run --features scraper -- create-alias-issues --input uncertain.json --repo ModerRAS/anime-organizer

📡 RSS Subscription Management (requires `--features clouddrive`)

# List subscriptions
aniorg rss --list-subscriptions

# Add subscription
aniorg rss --add-subscription \
  --rss-url "https://example.com/rss" \
  --rss-target "/anime" \
  --rss-filter "720p"

# Single shot execution
aniorg rss --single-shot \
  --clouddrive-url http://localhost:19798 \
  --rss-url "https://example.com/rss" \
  --rss-target "/anime"

# Daemon mode (continuous monitoring)
aniorg rss --daemon \
  --clouddrive-url http://localhost:19798 \
  --rss-interval 300

Authentication supports either --clouddrive-token or --clouddrive-user + --clouddrive-pass. Subscription and dedupe state is stored in %LOCALAPPDATA%\anime-organizer\rss.db on Windows.

☁️ CloudDrive Helper Commands (requires `--features clouddrive`)

# Submit a magnet or torrent URL directly to offline download
aniorg add-offline "magnet:?xt=urn:btih:..." \
  --target "/anime" \
  --clouddrive-url http://localhost:19798 \
  --clouddrive-token "YOUR_TOKEN"

# Browse a cloud folder
aniorg list-folder "/anime" \
  --clouddrive-url http://localhost:19798 \
  --clouddrive-token "YOUR_TOKEN"

🧲 Torrent Scraping (requires `--features torrent-scraper`)

# Scrape DMHY torrent titles
aniorg torrent-scrape --source dmhy --output dmhy_titles.txt

# Scrape Nyaa torrent titles
aniorg torrent-scrape --source nyaa --query "anime" --output nyaa_titles.txt

# Scrape both sources
aniorg torrent-scrape --source all --pages 3 --output all_titles.txt

🛠️ Development

# Run tests
cargo test

# Run with verbose output
cargo run -- --source="/path/to/downloads" --verbose

# Build release binary
cargo build --release

# Build with all features
cargo build --release --features "scraper clouddrive torrent-scraper"

License

AGPL-3.0 License - see LICENSE for details.

Name		Name	Last commit message	Last commit date
Latest commit History 123 Commits
.github		.github
assets/anifilebert		assets/anifilebert
proto		proto
src		src
tests		tests
.gitignore		.gitignore
AGENTS.md		AGENTS.md
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
LICENSE		LICENSE
README.md		README.md
build.rs		build.rs

Folders and files

Latest commit

History

Repository files navigation

anime-organizer

中文

📖 项目描述

🚀 功能特性

📥 安装方式

方式一：下载预编译二进制

方式二：从源码构建

🎯 快速开始

基本用法

预览模式

📋 参数说明

🧾 元数据刮削

🗃️ MLIP 媒体库索引

使用方式

🎨 文件命名格式

支持的源文件名格式

目标文件结构

🔗 硬链接说明

使用条件

跨设备错误

🔧 刮削子命令（需 --features scraper）

📡 RSS 订阅管理（需 --features clouddrive）

☁️ CloudDrive 辅助命令（需 --features clouddrive）

💡 使用示例

English

📖 Project Description

🚀 Features

📥 Installation

Option 1: Download Pre-built Binary

Option 2: Build from Source

🎯 Quick Start

📋 Arguments

🧾 Metadata Scraping

🗃️ MLIP Library Index

🔗 Hard Link Notes

🔧 Scraper Subcommands (requires --features scraper)

📡 RSS Subscription Management (requires --features clouddrive)

☁️ CloudDrive Helper Commands (requires --features clouddrive)

🧲 Torrent Scraping (requires --features torrent-scraper)

🛠️ Development

License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 105

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

🔧 刮削子命令（需 `--features scraper`）

📡 RSS 订阅管理（需 `--features clouddrive`）

☁️ CloudDrive 辅助命令（需 `--features clouddrive`）

🔧 Scraper Subcommands (requires `--features scraper`)

📡 RSS Subscription Management (requires `--features clouddrive`)

☁️ CloudDrive Helper Commands (requires `--features clouddrive`)

🧲 Torrent Scraping (requires `--features torrent-scraper`)

Packages