Curd

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

Join the discord server

https://discord.gg/rrpBfu2gHq

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

• Stream anime online
• Update anime in Anilist after completion
• 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

<details> <summary>Arch Linux / Manjaro (AUR-based systems)</summary>

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

</details> <details> <summary>Debian / Ubuntu (and derivatives)</summary>

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

</details> <details> <summary>Fedora Installation</summary>

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

</details> <details> <summary>openSUSE Installation</summary>

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

</details> <details> <summary>NixOS Installation</summary>

1. 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";
        };
    }
}

2. Install the package, for example:

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

</details> <details> <summary>macOS Installation</summary>

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

</details> <details> <summary>Windows Installation</summary>

Option 1: Using the installer

• Download and run the Windows Installer

Option 2: Standalone executable

• Download curd-windows-x86_64.exe

</details> <details> <summary>Generic Installation</summary>

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

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

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

</details> <details> <summary>Uninstallation</summary>

sudo rm /usr/bin/curd

For AUR-based distributions:

yay -R curd

</details>

Windows Installer

Data Storage

<details> <summary>Windows</summary> Stroage: (Token, Timestamps, debug.log, etc)

C:\.local\share\curd

Config :

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

</details> <details> <summary>Linux/Unix</summary> Stroage: (Token, Timestamps, debug.log, etc)

$USER/.local/share/curd

Config :

$USER/.config/curd

</details>

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 | - | | -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

| 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 name