4.0

AniChapters v4.0

AniChapters v4.0 introduces major improvements to the core engine, stability, and overall user experience. This update focuses on improving the accuracy of automatic chapter detection while addressing usability issues reported by users.

🚀 Highlights

Improved Audio Matching Engine

The audio matching system has been refined to provide more accurate OP/ED detection across a wider range of anime episodes. This improves chapter placement consistency and reduces false matches.

ffprobe Console Window Fix

The application no longer opens a terminal window during file analysis. ffprobe now runs silently in the background, resulting in a much smoother and less disruptive workflow.

Core Engine Improvements

Several internal improvements were made to the core processing logic to make analysis faster and more reliable.

Settings Persistence

The application now remembers the user's last selected settings and restores them automatically on startup.

Stability Improvements

Multiple fixes were applied to improve stability during batch processing and file analysis.

🔧 Technical Improvements

• Improved audio processing workflow
• Better handling of background subprocesses
• Codebase cleanup and internal refactoring
• Improved configuration handling

📦 Notes

This release focuses on improving reliability and usability while laying the foundation for future features.

Thank you to everyone who tested the application and provided feedback!

v3.0

AniChapters v3.0 — Shared Chapters Database
What's New
☁ Shared Chapters Database

AniChapters now supports a community-driven chapter database.

When a user analyzes an episode and generates chapters, the result is uploaded to a shared database.
Future users analyzing the same episode can skip audio analysis entirely and instantly load the existing chapters.

This significantly reduces processing time and allows the community to collaboratively build a large chapter library.

The system works using Supabase (PostgreSQL) as a centralized backend.

⚡ Smart Episode Lookup

Before running audio analysis, AniChapters now checks the shared database using:

AniList ID

Season number

Episode number

If chapters already exist, they are downloaded immediately and applied to the video.

💾 Local Cache System

A local cache database has been added to speed up repeated episode processing.

When chapters are downloaded from the shared database, they are also stored locally so the same episode can be loaded instantly in future runs.

Cache files are stored in a temporary runtime database:

shared_chapters_cache.db
🔑 Supabase Integration

Added full support for Supabase as the backend service.

The application now automatically:

Verifies database connectivity on startup

Tests read/write permissions

Ensures the shared chapters table is accessible

Only publishable API keys are used for client access.

📡 Improved AniList Integration

AniChapters now resolves the correct anime identifier automatically via AniList, ensuring reliable episode matching across users.

Files Changed
analyzer.py — Added shared DB lookup and result upload
app.py — Shared DB startup checks and cache integration
shared_db.py — New: database orchestrator (remote + cache)
remote_db.py — New: Supabase communication layer
api_anilist.py — New: AniList ID resolution
supabase_setup.sql — New: database schema for shared chapters
.gitignore — Added cache and credential exclusions
Notes

Only Supabase publishable keys are used for client access.

Local cache improves performance but the primary source of chapters is the shared database.

Database writes use upsert logic to prevent duplicate episode entries.

AniChapters v2.0

AniChapters v2.0 — Core Engine Overhaul

What's New

🔧 Audio Matching Engine — Complete Rewrite

The audio matching engine has been fully replaced with a proven, battle-tested algorithm based on Auto Chap v4.2 (librosa + scipy signal correlation).

The previous engine used an NCC-FFT approach via ffmpeg that produced inconsistent results. The new engine uses:

• librosa for accurate audio loading
• scipy.signal.correlate for robust cross-correlation matching
• A silence-prefix padding trick to correctly handle themes that appear at the very start of an episode
• Parallel OP/ED processing via ThreadPoolExecutor

This results in significantly more accurate OP/ED detection across a wider range of shows.

---

🗂️ Theme Cache Location

Downloaded themes are now stored in a .themes folder next to your video files, making it easy to find and manage cached themes per series.

---

🧹 Clear Cache Improvement

The Clear Cache button now properly deletes downloaded theme files (.ogg) in addition to temporary processing files, and displays the total storage freed.

---

🚫 UI Cleanup

Removed an unnecessary internal log message that appeared during analysis.

---

Requirements

Make sure to install the new dependencies:

pip install librosa scipy audioread

---

Files Changed

• analyzer.py — Replaced matching logic with Auto Chap v4.2 engine
• app.py — Cache clearing + anime name passing improvements
• core.py — New file: Auto Chap v4.2 engine (do not modify)
• Requirements.txt — Added librosa, scipy, audioread

AniChapters v1.0

AniChapters v1.0

AniChapters is a desktop tool that automatically detects anime Opening (OP) and Ending (ED) and generates MKV chapters.

The program analyzes your local video files and creates chapter timestamps automatically.

Features

• Automatic OP/ED detection
• Generate MKV chapters XML
• Review detected chapters before exporting
• Merge chapters into MKV files
• Optional in-place editing using mkvpropedit
• animethemes.moe integration

Download

Download AniChapters_v1.0.zip from the assets below.

How to use

1. Extract the zip file
2. Run AniChapters.exe
3. Add your anime episodes
4. Fetch themes
5. Run analysis and export chapters

Notes

Some shows may require manual review if OP/ED differs between episodes.

Disclaimer

AniChapters does not download anime.
It only analyzes video files you already have.