rcdl 3.0.0b50

Coomer/Kemono CLI Downloader

RCDL

Riton Coomer Download Manager
rcdl is a tool to automatically download the videos of your favorites creators from coomer.st and kemono.cr

Install

Dependencies

• yt-dlp
• aria2
• ffmpeg (Only for fuse command)
• HandBrakeCLI (Only for opti command)
  Recommended install methods:

pipx install yt-dlp
sudo apt update
sudo apt install aria2 ffmpeg handbrake-cli -y

Install RCDL

It is recommended to use pipx to install rcdl

pipx install rcdl   # recommended method
pip install rcdl    # alternative

How to use

Run the CLI with:

rcdl --help

The first run will prompt you to enter the path you want rcdl to live in. Cache, configuration and log file will be in a hidden .cache/ folder.

Main function:

rcdl refresh         # look creators.json and find all possible videos
    --max-fail-count # Set maximum number of failed attempt before skipping entirely the refresh
rcdl dlsf            # download all found videos
    --max-fail-count # Set maximum number of failed attempt before skipping entirely the refresh
rcdl discover        # Discover new creator (WIP)
    --tag            # tag to be searched for
    --max-page       # number of page to search for (default: 10)
rcdl opti            # Optimized video to reduce disk storage usage
rcdl fuse            # Fuse all videos within a same post if they are fully downloaded

Manage creators:

rcdl list                       # list all current creators
rcdl add [URL]                  # add a new creator with an url
rcdl add [service]/[creator_id] # add a new creator with service/creator_id
rcdl remove [creator_id]        # remove creator with a creator_id

Helper function:

rcdl status          # give number of entry in the database per tables and status
rcdl repair          # repair database to match database state to the system file state
rcdl clean --all     # remove all partially downloaded file, external dependencies cache, etc...
    --partial        # remove partially downloaded file
    --cache          # remove aria2 and yt-dlp cache
    --medias-deleted # delete all media set to DELETED in db
    --all            # set all above flags to true
rcdl show-config     # print all config var and theirs value (paths, etc...)

Other:

rcdl --version      # see version of program
rcdl --debug [CMD]  # run in debug mode; Only for dev

Settings

Default settings file:

[app]
default_max_page = 10
max_fail_count = 7
timeout = 10

[fuse]
max_width = 1920
max_height = 1080
fps = 30
preset = "veryfast"
threads = 0

[paths]
handbrake_run_cmd = "HandBrakeCLI"

In rcdl/.cache/config.toml:

[paths]
handbrake_run_cmd = "HandBrakeCLI"  # if installed via apt
handbrake_run_cmd = "flatpak run --command=HandBrakeCLI fr.handbrake.ghb"   # if installed via flatpak

Dev

Install

git clone https://github.com/ritonun/cdl.git rcdl
cd rcdl
uv run rcdl

Install dev depencies:

uv sync --group dev

Pylint:

uv run pylint --recursive=y rcdl/ > pylint.txt

Major Version History

v3

• opti, status, clean, repair command & multiple --options flag
• GUI
• Major DB improvements
• Config files
• First run bootstrap

v2

• UI update
• DB impromevent
• creator, fuse command

v1

• First release of the project, prototype