Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/synacktraa/ani-skip
A script that offers an automated solution to bypass anime opening and ending sequences, enhancing your viewing experience by eliminating the need for manual intro and outro skipping.
https://github.com/synacktraa/ani-skip
ani-cli anime aniskip cli mpv-script shell
Last synced: 4 days ago
JSON representation
A script that offers an automated solution to bypass anime opening and ending sequences, enhancing your viewing experience by eliminating the need for manual intro and outro skipping.
- Host: GitHub
- URL: https://github.com/synacktraa/ani-skip
- Owner: synacktraa
- License: gpl-3.0
- Created: 2022-12-15T23:50:28.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-10-16T14:40:58.000Z (4 months ago)
- Last Synced: 2025-01-28T20:08:20.591Z (4 days ago)
- Topics: ani-cli, anime, aniskip, cli, mpv-script, shell
- Language: Shell
- Homepage: https://api.aniskip.com/api-docs
- Size: 39.1 KB
- Stars: 110
- Watchers: 3
- Forks: 12
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
ani-skip
A script to automatically skip anime opening and ending sequences, making it easier to watch your favorite shows without having to manually skip the intros and outros each time.**Important:** There's a chance `ani-skip` may not recognize the anime you're watching. It leverages the [aniskip API](https://api.aniskip.com/api-docs). If an anime's episode(s) are missing, you can contribute or request its inclusion on their [discord server](https://discord.com/invite/UqT55CbrbE).
## Troubleshooting Errors
Should you run into problems, first ensure you're using the most recent version:
- For Linux:
```bash
sudo ani-skip -U
```- For Windows:
Open Git Bash as an administrator and enter:
```bash
ani-skip -U
```If the issue remains unresolved, please create a new issue.
---
## Usage
```sh
ani-skip -h
```
```
Usage:
ani-skip [OPTIONS]Options:
-q, --query
Anime Title or MyAnimeList ID
-e, --episode
Specify the episode number
-V, --version
Show the version of the script
-h, --help
Show this help message and exit
-U, --update
Update the script
Some example usages:
ani-skip -q "Solo Leveling" # Returns MyAnimeList ID
ani-skip -q "Solo Leveling" -e 3 # Returns MPV skip flag
ani-skip -q 52299 -e 5 # Returns MPV skip flag
```- Build MPV skip options directly using anime's title
```sh
ani-skip --query "Black Clover (170 episodes)" --episode 10
```
```
--chapters-file=/tmp/tempfile --script-opts=skip-op_start=140.153,skip-op_end=230.153,skip-ed_start=1301.824,skip-ed_end=1431
```
> `script-opts` with the `script` flag is produced by ani-skip when metadata for a specific anime's skip times exists in the database. It's important to append these flags at the end due to certain mpv nuances.- Fetch `MyAnimeList` ID
```sh
ani-skip -q "Solo Leveling"
```
```
52299
```
> Persisting it will help building flags quickly when requesting the same anime for skip times.- Build MPV skip options directly using `MyAnimeList` ID
```sh
ani-skip -q 52299 -e 2
```
```
--chapters-file=/tmp/tempfile --script-opts=skip-op_start=130.531,skip-op_end=220.531,skip-ed_start=1326.58,skip-ed_end=1416.58
```
> Use the stored or persisted MAL ID to expedite the process of fetching skip times.## Install
- Linux
> For Arch linux, ani-skip is available in the AUR as [ani-skip-git](https://aur.archlinux.org/packages/ani-skip-git).
```sh
git clone https://github.com/synacktraa/ani-skip.git
sudo apt install mpv fzf
sudo cp ani-skip/ani-skip /usr/local/bin
mkdir -p ~/.config/mpv/scripts && cp ani-skip/skip.lua ~/.config/mpv/scripts
```
- Windows
> Make sure [scoop](https://scoop.sh/) is installed.
- Open powershell and run:
```powershell
scoop install mpv fzf git
```
- Open git bash
```sh
git clone https://github.com/synacktraa/ani-skip.git
cp ani-skip/ani-skip /usr/bin
mkdir -p ~/scoop/apps/mpv/current/portable_config/scripts
cp ani-skip/skip.lua ~/scoop/apps/mpv/current/portable_config/scripts
```## Dependencies
- grep
- sed
- curl
- fzf
- mpv - Video Player## Checklist
- [x] MPV support
- [x] MyAnimeList Id scraper
- [ ] VLC support
- [ ] Create packages for Windows, Linux and Termux
- [ ] Test it on Android termux and Mac