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:

https://github.com/user-attachments/assets/376e7580-b1af-40ee-82c3-154191f75b79

Rofi with Image preview

https://github.com/user-attachments/assets/cbf799bc-9fdd-4402-ab61-b4e31f1e264d

Features

• Multiple Content Providers (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

yay -Sy curd

paru -Sy curd

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

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

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

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

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

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

# 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

sudo rm /usr/bin/curd

yay -R curd

MacOS

brew install mpv curl

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

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

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

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

sudo rm /usr/local/bin/curd

Windows

Data Storage

C:\.local\share\curd

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

$USER/.local/share/curd

$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

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.

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
• Animepahe Content - Alternative provider for 1080p streams
• Jikan - Get filler episode number

Credits

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