https://github.com/po5/mpv-auto-chapters

mpv script that automatically finds chapters for your anime files
https://github.com/po5/mpv-auto-chapters

mpv mpv-script

Last synced: 12 days ago
JSON representation

mpv script that automatically finds chapters for your anime files

• Host: GitHub
• URL: https://github.com/po5/mpv-auto-chapters
• Owner: po5
• License: gpl-3.0
• Created: 2024-09-02T21:33:05.000Z (2 months ago)
• Default Branch: master
• Last Pushed: 2024-09-08T11:25:38.000Z (2 months ago)
• Last Synced: 2024-09-08T13:08:45.639Z (2 months ago)
• Topics: mpv, mpv-script
• Language: Lua
• Homepage:
• Size: 20.5 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-mpv - autochapters - Automatically finds chapters for your anime files. (Playback)

README

        
# autochapters

Automatically finds chapters for your anime files.

## Installation

Place the "autochapters" folder in your mpv `scripts` folder. Do not take the Lua file out of the folder.  

This script requires **curl** and **guessit** to be installed and [accessible within Path](https://learn.microsoft.com/en-us/previous-versions/office/developer/sharepoint-2010/ee537574(v=office.14)#to-add-a-path-to-the-path-environment-variable).  

For Windows grab the [curl](https://curl.se/windows/) and [guessit-windows.exe](https://github.com/guessit-io/guessit/releases/latest) binaries. Rename the guessit file to `guessit.exe`.  

Use your package manager on Mac/Linux.

## Usage

Open any anime episode. The offline database will automatically be cached on first launch.  

If your file did not already have chapters, this script will extract the anime title and episode number from the filename, and look for matching chapters online.  

Filenames are processed on your local device and never sent over the internet.

## Synergy with other scripts

Any script that uses chapters such as [chapterskip](https://github.com/po5/chapterskip) can be used to automatically skip openings/endings.  

Chapter data is also available under the `user-data/autochapters` property, and filename parsing results at `user-data/guessit`.

## Acknowledgements

[Aniskip](https://github.com/aniskip) for the API serving chapters.  

[ani-skip](https://github.com/synacktraa/ani-skip) for being annoying enough to use that I went and made this.  

manami's [anime-offline-database](https://github.com/manami-project/anime-offline-database) which is used to link titles to MyAnimeList IDs.  

Taiga's [anime-relations](https://github.com/erengy/anime-relations) used to resolve continuous numbering schemes to their respective seasons.