A modern CLI to download animes automatically from Twist

Overview

Kurby

PyPI - Python Version Downloads PyPI version

Kirby ball in Kirby: Canvas Curse

Kurby is a nice and simple CLI that use Twist website, and their huge collection to download animes for free and automatically

Animes from Twist are generally in High Definition with English subtitles. Please consider donating for their amazing work :)

Overview

The CLI is built with Typer and it is composed of 3 commands

  • animes: Search animes to find what is available and extract the slug to be used in the other commands

animes

--search option allows you to make a fuzzy search

  • details: Show details of an anime if needed

details

You can see the number of episodes available and when the first and last episode were uploaded

  • download: Choose and download which episodes of the anime you want !

download

Because sometimes bad things can happen, Kurby will automatically retry for you

You can also download without having a slug initially. In this case, Kurby will propose you a selection

download-selection

And that's it !

You can also use kurby --help to get more information on the different commands

Installation

pip install kurby
kurby --help

Installation on Windows

  • Right click on the install.bat and run it as an Administrator, this will install Chocolatey who will manage the python installation
  • Once the installation is finished, and you're asked to press a key, open a new terminal (Win + R > cmd )
  • You can now start using Kurby with kurby --help

Installation on Android without root needed

  • Install Termux on your Android phone
  • In Termux, run this command to allow access to storage: termux-setup-storage, and tap allow
  • Next, run the follow command pkg install git python
  • Then pip3 install kurby
  • You're done ! You can download animes on your phone like so kurby download --d ~/storage/shared
Thanks to 6b86b3ac03c167320d93 for this tutorial

Installation from sources

Create your virtual environment (optional)

mkvirtualenv kurby
workon kurby

Install poetry

curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python -

Install dependencies using poetry

poetry install --no-dev
kurby-cli --help # or python kurby-cli --help

Getting the latest episode automatically

An interesting use case is to get the latest episode of an anime as soon as it is available.

This is possible on Linux using crontab (or another equivalent on others OS) and a little tweak of chemistry. Here is an example of a few instructions that can help you do this.

now=$(date -u "+%Y-%m-%dT%H:%M:%S")
date=$(cat kurby.date || echo $now) # Get the date of previous download
python kurby download {{YOUR_ANIME}} --dfrom=${DATE} # Download any episodes that has been uploaded since the last time
echo $now > kurby.date # Store the current date as the new date

Next steps

Kurby is already functional as it is but here are the next things I would like to add :

  • Adding the support of asynchronous download
  • Refactor the retrying strategy to add more customisable options and allow errors during a download without interruption
  • Refactor the crawling process to potentially avoid being detected as a bot

Disclaimer

Downloading copyright videos may be illegal in your country.

This tool is for educational purposes only.

The developers or this application do not store or distribute any files whatsoever.

You might also like...
SABnzbd - The automated Usenet download tool

SABnzbd is an Open Source Binary Newsreader written in Python.

The free and open-source Download Manager written in pure Python
The free and open-source Download Manager written in pure Python

The free and open-source Download Manager written in pure Python

FireDM is a python open source (Internet Download Manager) with multi-connections, high speed engine, it downloads general files and videos from youtube and tons of other streaming websites .
FireDM is a python open source (Internet Download Manager) with multi-connections, high speed engine, it downloads general files and videos from youtube and tons of other streaming websites .

python open source (Internet Download Manager) with multi-connections, high speed engine, based on python, LibCurl, and youtube_dl https://github.com/firedm/FireDM

📼Command line tool based on youtube-dl to easily download selected channels from your subscriptions.
📼Command line tool based on youtube-dl to easily download selected channels from your subscriptions.

youtube-cdl Command line tool based on youtube-dl to easily download selected channels from your subscriptions. This tool is very handy if you want to

A Udemy downloader that can download DRM protected videos and non-DRM protected videos.
A Udemy downloader that can download DRM protected videos and non-DRM protected videos.

Udemy Downloader with DRM support NOTE This program is WIP, the code is provided as-is and i am not held resposible for any legal repercussions result

Scripts to download files and folders programmatically from Google Drive

Google Drive Downloader Scripts Every time I need to download a lot of files from Google Drive (e.g. a dataset), it's always incredibly frustrating an

This is a python based web scraping bot for windows to download all ACCEPTED submissions of any user on Codeforces
This is a python based web scraping bot for windows to download all ACCEPTED submissions of any user on Codeforces

CODEFORCES DOWNLOADER This is a python based web scraping bot for windows to download all ACCEPTED submissions of any user on Codeforces Requirements

A collection of modules I have created to programmatically search for/download imagery from live cam feeds across the state of California.
A collection of modules I have created to programmatically search for/download imagery from live cam feeds across the state of California.

A collection of modules that I have created to programmatically search for/download imagery from all publicly available live cam feeds across the state of California. In no way am I affiliated with any of these organizations and these modules/methods of gathering imagery are completely unofficial.

Comments
  • Getting an error while downloading

    Getting an error while downloading

    Hello! I'm constantly getting this error while downloading any anime::

    Retrying kurby.helpers.download_source in 10.886510581867924 seconds as it raised ReadError: [WinError 10054]

    Is there a way to fix it?

    opened by Nelsini 2
  • Update #0002

    Update #0002

    Update #0002

    • [ ] Looking for updates when starting the CLI
    • [ ] Adding CI with unitary tests and periodical tests
    • [ ] Adding new providers to replace Twist.moe
    opened by aberrier 0
Owner
Alain BERRIER
I think I love Python too much. I have some projects on Gitlab too
Alain BERRIER
Automatically download multiple papers by keywords in CVPR

Automatically download multiple papers by keywords in CVPR

null 46 Jun 8, 2022
Can automatically download mods from a Curseforge modpack

Curseforge-Modpack-Downloader A Python script which automatically downloads mods from a Curseforge modpack. Installing Dependencies ⚠ Make sure you ha

Rayr 1 Sep 20, 2022
Automatically download and crop key information from the arxiv daily paper. (cpu version)

Automatically download and crop key information from the arxiv daily paper. (cpu version)

HeoLis 4 Jul 30, 2022
⚙️ A CLI tool that can download songs from youtube.

⚙️ Music Downloader Music Downloader is a tool that can download songs from Youtube. Installation Base requirements: Python 3.7+ If you have Python 3.

matjs 4 Nov 3, 2021
A CLI that searches and download Youtube videos in mp3 format.

A CLI that searches and download Youtube videos in mp3 format.

Finhawk 4 Jul 25, 2022
A cli tool to download purchased products from the DLsite.

dlsite-downloader A cli tool to download purchased products from the DLsite. How can I use? This program runs with configurations defined at settings.

AcrylicShrimp 9 Dec 23, 2022
Download courses from khanacademy.org

khan-dl A python script to download courses from Khan Academy using youtube-dl and beautifulsoup4.

rand-net 806 Jan 3, 2023
A tool written in Python to download all Snapmaps content from a specific location.

snapmap-archiver A tool written in Python to download all Snapmaps content from a specific location.

null 46 Dec 9, 2022
1Fichier Download Manager.

1fichier-dl 1Fichier Download Manager. Features ⭐ Manage your downloads ⭐ Bypass time limits Credits All icons, including the app icon, were provided

manuGMG 470 Oct 8, 2022
Command-line program to download videos from YouTube.com and other video sites

youtube-dl - download videos from youtube.com or other video platforms

youtube-dl 116.4k Jan 7, 2023