Curd

A cli application to stream anime with Anilist integration and Discord RPC written in golang. Works on Linux, MacOS and Windows.

Join the discord server

https://discord.gg/rrpBfu2gHq

Join the Matrix server

https://matrix.to/#/#curd:matrix.org

Demo Video

Normal mode:

curd-go-demo.mp4

Rofi with Image preview

curd-go-rofi-demo.mp4

Features

Multiple Content Providers (Senshi, AniNeko, AllAnime, and Animepahe) with ordered fallback and up to 1080p support
Built-in headless browser to bypass Cloudflare/DDoS-Guard protections
Stream anime online
Track anime locally, on AniList, or on MyAnimeList
Browser-based AniList and MyAnimeList login flows
Skip anime Intro and Outro
Skip Filler and Recap episodes
Discord RPC about the anime
Rofi support
Image preview in rofi
Local anime history to continue from where you left off last time
Save mpv speed for next episode
Configurable through config file

Installing and Setup

Note: Curd requires mpv, rofi, and ueberzugpp for Rofi support and image preview. These are included in the installation instructions below for each distribution.

Linux

Arch Linux / Manjaro (AUR-based systems)

Using Yay:

yay -Sy curd

or using Paru:

paru -Sy curd

Or, to manually clone and install:

git clone https://aur.archlinux.org/curd.git
cd curd
makepkg -si
sudo pacman -S rofi ueberzugpp

Debian / Ubuntu (and derivatives)

sudo apt update
sudo apt install mpv curl rofi ueberzugpp
# For x86_64 systems:
curl -Lo curd https://github.com/Wraient/curd/releases/latest/download/curd-linux-x86_64
# For ARM64 systems:
curl -Lo curd https://github.com/Wraient/curd/releases/latest/download/curd-linux-arm64
chmod +x curd
sudo mv curd /usr/bin/
curd

Fedora Installation

sudo dnf update
sudo dnf install mpv curl rofi ueberzugpp
# For x86_64 systems:
curl -Lo curd https://github.com/Wraient/curd/releases/latest/download/curd-linux-x86_64
# For ARM64 systems:
curl -Lo curd https://github.com/Wraient/curd/releases/latest/download/curd-linux-arm64
chmod +x curd
sudo mv curd /usr/bin/
curd

openSUSE Installation

sudo zypper refresh
sudo zypper install mpv curl rofi ueberzugpp
# For x86_64 systems:
curl -Lo curd https://github.com/Wraient/curd/releases/latest/download/curd-linux-x86_64
# For ARM64 systems:
curl -Lo curd https://github.com/Wraient/curd/releases/latest/download/curd-linux-arm64
chmod +x curd
sudo mv curd /usr/bin/
curd

NixOS Installation

Add curd as a flake input, for example:

{inputs={nixpkgs.url="github:NixOS/nixpkgs/nixos-unstable";curd={url="github:Wraient/curd";inputs.nixpkgs.follows="nixpkgs";};}}

Install the package, for example:

{inputs,pkgs, ...}: {environment.systemPackages=[inputs.curd.packages.${pkgs.system}.default];}

Generic Installation

Choose the appropriate binary for your system:

# For Linux x86_64:
curl -Lo curd https://github.com/Wraient/curd/releases/latest/download/curd-linux-x86_64
# For Linux ARM64:
curl -Lo curd https://github.com/Wraient/curd/releases/latest/download/curd-linux-arm64
chmod +x curd
sudo mv curd /usr/bin/
curd

Uninstallation

sudo rm /usr/bin/curd

For AUR-based distributions:

yay -R curd

MacOS

MacOS Installation

Install required dependencies

brew install mpv curl

Download the appropriate binary for your system:

For Apple Silicon (M1/M2) Macs:

curl -Lo curd https://github.com/Wraient/curd/releases/latest/download/curd-macos-arm64

For Intel Macs:

curl -Lo curd https://github.com/Wraient/curd/releases/latest/download/curd-macos-x86_64

For Universal Binary (works on both architectures):

curl -Lo curd https://github.com/Wraient/curd/releases/latest/download/curd-macos-universal

Then complete the installation:

chmod +x curd
sudo mv curd /usr/local/bin/
curd

Uninstallation

sudo rm /usr/local/bin/curd

Windows

Windows Installation

Option 1: Using the installer

Download and run the Windows Installer

Option 2: Standalone executable

Download curd-windows-x86_64.exe

Data Storage

Windows

Stroage: (Token, Timestamps, debug.log, etc)

C:\.local\share\curd

Config :

C:\Users\USERNAME\AppData\Roaming\Curd

Linux/Unix

Stroage: (Token, Timestamps, debug.log, etc)

$USER/.local/share/curd

Config :

$USER/.config/curd

Usage

Run curd with the following options:

curd [options]

Arguments would always take precedence over configuration

Note:
To use rofi you need rofi and ueberzug installed.
Rofi .rasi files are at default ~/.local/share/curd/
You can edit them as you like.
If there are no rasi files with specific names, they would be downloaded from this repo.

Options

Flag	Description	Default
`-c`	Continue the last episode	-
`-change-token`	Change your authentication token	-
`-dub`	Watch the dubbed version of the anime	-
`-sub`	Watch the subbed version of the anime	-
`-softsub`	Prefer soft subtitles when available (AniNeko)	-
`-hardsub`	Prefer hard subtitles when available (AniNeko)	-
`-new`	Add a new anime to your list	-
`-e`	Edit the configuration file	-
`-skip-op`	Automatically skip the opening section of each episode	`true`
`-skip-ed`	Automatically skip the ending section of each episode	`true`
`-skip-filler`	Automatically skip filler episodes	`true`
`-skip-recap`	Automatically skip recap sections	`true`
`-discord-presence`	Enable or disable Discord presence	`true`
`-image-preview`	Show an image preview of the anime	-
`-no-image-preview`	Disable image preview	-
`-next-episode-prompt`	Prompt for the next episode after completing one	-
`-rofi`	Open anime selection in the rofi interface	-
`-no-rofi`	Disable rofi interface	-
`-percentage-to-mark-complete`	Set the percentage watched to mark an episode as complete	`85`
`-player`	Specify the player to use for playback	`"mpv"`
`-save-mpv-speed`	Save the current MPV speed setting for future sessions	`true`
`-score-on-completion`	Prompt to score the episode on completion	`true`
`-storage-path`	Path to the storage directory	`"$HOME/.local/share/curd"`
`-subs-lang`	Set the language for subtitles	`"english"`
`-u`	Update the script	-
`-v`	Show curd version	-

Examples

Continue the Last Episode:
```
curd -c
```
Add a New Anime:
```
curd -percentage-to-mark-complete=90
```
Play with Rofi and Image Preview:
```
curd -rofi -image-preview
```

Configuration

All configurations are stored in a file you can edit with the -e option.

curd -e

Script is made in a way that you use it for one session of watching.

You can quit it anytime and the resume time would be saved in the history file

more settings can be found at config file. config file is located at ~/.config/curd/curd.conf

On first start, curd asks which tracking mode you want to use:

local
anilist
myanimelist
anilist + myanimelist

Local history stays enabled in all modes. anilist means local history + AniList sync, myanimelist means local history + MyAnimeList sync, and anilist + myanimelist updates both platforms. In dual-sync mode, curd compares the latest remote update time for each anime and pushes the newest status/progress/category back to the older tracker so both sides converge automatically. Legacy installs are migrated to anilist automatically. If you switch trackers later, curd exposes a Change Tracker menu entry and can either merge both lists, replace MyAnimeList with AniList, or replace AniList with MyAnimeList.

MyAnimeList OAuth requires your own MAL application credentials. You can set them in the config file or with environment variables:

CURD_MAL_CLIENT_ID=your_client_id
CURD_MAL_CLIENT_SECRET=your_client_secret

If the browser reaches the localhost callback page but curd does not continue automatically, rerun the command and paste the full callback URL when prompted. Curd now keeps the pending MyAnimeList PKCE state so the login can be completed manually.

Option	Type	Valid Values	Description
`DiscordPresence`	Boolean	`true`, `false`	Enables or disables Discord Rich Presence integration.
`AnimeNameLanguage`	Enum	`english`, `romaji`	Sets the preferred language for anime names.
`MpvArgs`	List	all mpv args eg ["--fullscreen=yes", "--mute=yes"]	Add args to mpv player
`MpvPlaybackStartTimeout`	Integer	`1` to `600` (seconds)	How long to wait for MPV playback to start before trying another provider. Default: `20`
`AddMissingOptions`	Boolean	`true`, `false`	When `true`, on a version upgrade only options registered as new for that release are appended to `curd.conf` (not every historical default). Set `false` to opt out. Defaults still apply in memory always.
`VimKeys`	Boolean	`true`, `false`	When `true`, selection menus use vim motions: `j`/`k`/`h`/`l` (and arrows) to move, `/` or `?` to search. Default: `false` (type-to-filter immediately). Add `VimKeys=true` to `~/.config/curd/curd.conf` to enable.
`CheckUpdates`	Boolean	`true`, `false`	When `true` (default), checks GitHub for a newer release while idle (does not delay startup). If an update is found, the next launch shows notes and options: update now / skip / remind later / turn off.
`MpvEpisodePlaylist`	Boolean	`true`, `false`	When `true` (default), after playback is stable curd fills the MPV playlist with episodes (and dub/sub when available) so you can pick from MPV's playlist UI. Access: `MPV` → right-click the prev/next OSC button (or `Ctrl+P`). Selecting a row loads that stream and keeps tracking in sync.
`AlternateScreen`	Boolean	`true`, `false`	Toggles the use of an alternate screen buffer for cleaner UI.
`RofiSelection`	Boolean	`true`, `false`	Enables or disables anime selection via Rofi.
`PercentageToMarkComplete`	Integer	`0` to `100`	Sets the percentage of an episode watched to consider it as completed.
`StoragePath`	String	Any valid path (Environment variables accepted)	Specifies the directory where Curd stores its data.
`SubOrDub`	Enum	`sub`, `dub`	Sets the preferred format for anime audio.
`SubStyle`	Enum	`ask`, `soft`, `hard`	For AniNeko sub streams: `ask` prompts once when both soft-sub and hard-sub servers exist, then saves your choice here; `soft` uses external `.vtt` subtitles via mpv; `hard` uses burned-in subs. Default: `ask`
`NextEpisodePrompt`	Boolean	`true`, `false`	Prompts the user before automatically playing the next episode.
`SubsLanguage`	String	`english` (redundant rn)	Sets the preferred subtitle language.
`ScoreOnCompletion`	Boolean	`true`, `false`	Automatically prompts the user to rate the anime upon completion.
`SkipOp`	Boolean	`true`, `false`	Automatically skips the opening of episodes when supported.
`SkipEd`	Boolean	`true`, `false`	Automatically skips the ending of episodes when supported.
`SkipRecap`	Boolean	`true`, `false`	Skips recap sections in episodes when supported.
`ImagePreview`	Boolean	`true`, `false`	Enables or disables image previews during anime selection (only for rofi).
`Player`	String	any mpv-compatible binary (e.g. `mpv`, `iina`)	Player binary used for playback. If not found, Curd falls back to `mpv`.
`SaveMpvSpeed`	Boolean	`true`, `false`	Retains the playback speed set in MPV for next episode.
`SkipFiller`	Boolean	`true`, `false`	Skips filler episodes when supported.
`MenuOrder`	String	Comma-separated list	Controls which menu items appear and their order. Available options: `CURRENT`, `ALL`, `UNTRACKED`, `UPDATE`, `REMAP_PROVIDER`, `CONTINUE_LAST`, `PLANNING`, `COMPLETED`, `PAUSED`, `DROPPED`, `REWATCHING`, `TRACKER`, `PROVIDER`. Only listed items will be shown. Default: `CURRENT,ALL,UNTRACKED,UPDATE,REMAP_PROVIDER,CONTINUE_LAST,TRACKER,PROVIDER`
`Provider`	List	`stacked`, `["anipub"]`, `["anineko"]`, `["allanime"]`, `["animepahe"]`	Sets the content-provider fallback list. `stacked` (default) uses the preferred order: senshi → anipub → anineko → allanime → animepahe. A single-provider list uses only that site. AllAnime and Animepahe are disabled by default unless included in `Provider`. Default: `stacked`
`ManualProviderSearch`	Boolean	`true`, `false`	Skip automatic provider matching and always show provider search results for manual selection. Displays a hint with the tracker title, format (TV/Movie/etc.), episode count, and sub/dub mode. Default: `false`
`TrackingLocal`	Boolean	`true`	Legacy compatibility flag. Local playback history is always enabled.
`TrackingRemote`	Enum	`none`, `anilist`, `myanimelist`, `anilist+myanimelist`	Selects which remote tracker curd syncs with.
`TrackingConfigured`	Boolean	`true`, `false`	Internal flag used to remember that the startup tracking prompt has already been completed.
`MyAnimeListClientID`	String	MAL OAuth client ID	Client ID used for MyAnimeList browser login.
`MyAnimeListClientSecret`	String	MAL OAuth client secret	Optional secret used for MyAnimeList browser login and token refresh.
`MyAnimeListImported`	Boolean	`true`, `false`	Tracks whether the one-time AniList-to-MyAnimeList import prompt has already been handled.

Todo (fix)

Use Powershell for windows token input instead of notepad or cmd
Add a better way to do commands in windows (Convinience for users)

Dependencies

mpv - Video player (required fallback)
iina - Optional mpv-based player on macOS
rofi - Selection menu
ueberzug - Display images in rofi
chromium - Required for Animepahe (auto-downloaded by default, but Termux users must install manually via pkg install chromium)

API Used

Anilist API - Update user data and download user data
MyAnimeList API - MyAnimeList OAuth and tracking sync
AniSkip API - Get anime intro and outro timings
AllAnime Content - Fetch anime url
Senshi Project - Default provider with direct HLS streams and MAL-based catalog matching
AniPub - Fast JSON catalog APIs with MegaPlay HLS streams
AniNeko Content - Alternative provider with soft/hard sub stream selection
Animepahe Content - Alternative provider for 1080p streams
Jikan - Get filler episode number

Credits

ani-cli - Code for fetching anime url
jerry - For the inspiration

Name		Name	Last commit message	Last commit date
Latest commit History 582 Commits
.github		.github
Build		Build
cmd/curd		cmd/curd
docs		docs
internal		internal
rofi		rofi
vendor		vendor
.gitattributes		.gitattributes
LICENSE		LICENSE
PKGBUILD		PKGBUILD
README.md		README.md
VERSION.txt		VERSION.txt
flake.lock		flake.lock
flake.nix		flake.nix
go.mod		go.mod
go.sum		go.sum
package.nix		package.nix

Navigation Menu

Repository files navigation

Curd

Join the discord server

Join the Matrix server

Demo Video

Features

Installing and Setup

Linux

MacOS

Windows

Data Storage

Usage

Arguments would always take precedence over configuration

Options

Examples

Configuration

Todo (fix)

Dependencies

API Used

Credits

About

Releases

Packages

Used by

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

Curd

Join the discord server

Join the Matrix server

Demo Video

Features

Installing and Setup

Linux

MacOS

Windows

Data Storage

Usage

Arguments would always take precedence over configuration

Options

Examples

Configuration

Todo (fix)

Dependencies

API Used

Credits

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages