Kubespider

💥 A unified download orchestration system

English | 简体中文
I am a cloud computing engineer🤓, focusing on Serverless/FinOps/Runtime, developed Kubespider in my spare time.

The original intention of developing Kubespider is: I have an idle server(in a local area network), and I want to use it as a NAS to realize automatic TV series downloads, trigger downloads on a local laptop, and adapt to various website(YouTube, BiliBili, etc.) and different type resources(TV series, movie, music, etc.)

I was exposed to Terraform before and was surprised by its versatility. Inspired by Terraform, Kubespider aims to build a general download orchestration system, which is compatible with various resource platforms and download software, compatible with multiple download methods(request trigger, cycle trigger, update trigger) and is the most perfect unified solution for resource download.

⛵ System architecture

To realize a general download orchestration system, it is necessary to adapt various resource websites and download software, so these two parts are abstracted from the core functions:

kubespider-core: The core module of Kubespider accepts the trigger download request, calls the resource provider for resolution (it will eventually be resolved into a standard mode, such as the user enters the bilibili blogger address, and the corresponding resource provider outputs the mp4 file address download list), and finally calls the download provider to implement Download; this module will also periodically call providers (such as TV series provider) to download additional resources.
source-provider：The provider of each resource website accepts input of general resource addresses, and outputs standard resource address URLs, such as the personal homepage of a YouTuber, and outputs all mp4 download addresses of the blogger’s videos. The configuration file is in .config/source_provider.cfg.
download-provider：The provider of each download software receives the request task from kubespider-core, and calls the corresponding service to realize the download. The configuration file is in .config/download_provider.cfg.

💽 Installation

Premise

The operating computer and your server are on the same LAN. (I haven't tried the installation not in the same LAN yet)
The server is a Linux system。
Docker is installed on the server。

Default installation(Deploy with Docker)

To adapt to multiple resource platforms, Kubespider provides many adapters. Enable or disable these adapters according to your needs. The configuration file is in the .config folder:

1.Download the repository and install

git clone https://github.com/jwcesign/kubespider.git
cd kubespider
bash hack/install_kubespider.sh

Output like:

root@cesign [09:01:34 PM] [+22.0°C] [~/git/kubespider] [main *]
-> # bash hack/install_kubespider.sh
 _          _                     _     _
| | ___   _| |__   ___  ___ _ __ (_) __| | ___ _ __
| |/ / | | | '_ \ / _ \/ __| '_ \| |/ _` |/ _ \ '__|
|   <| |_| | |_) |  __/\__ \ |_) | | (_| |  __/ |
|_|\_\\__,_|_.__/ \___||___/ .__/|_|\__,_|\___|_|
                           |_|
[INFO] Start to deploy with default configuration...
b13820946878c4f00635e7fa3db64ea83506850ebb7d07ff77b62814db1d894a
9c0aa1059f1546a4f1a2accac445ce1389f1c400b96328f3e18c8af03f0bbc70
[INFO] Deploy successful, check the information:
*******************************************
Kubespider config path: /root/kubespider/.config/
Download file path: /root/kubespider/nas/
Kubespider webhook address: http://<server_ip>:3080
Aria2 server address: http://<server_ip>:6800/jsonrpc, you can use any gui or webui to connect it
Aria2 default secret is:kubespider
*******************************************

This step will install Kubespide and Aria2 resource downloader as the default downloader.
After installation, all downloaded files will be stored in ${HOME}/kubespider/nas.
Configuration files are located in ${HOME}/kubespider/.config.

2.Connect to aria2

For checking the download tasks on your server conveniently, go to the chrome store to download AriaNg plugin.
Then connect, the plugin configuration is as follows(shown at the end of the script install_kubespider.sh execution output):

Of course, it is not necessary, you can also use the desktop program to connect: AriaNg

3.Install Chrome plugin

With Kubespider Chrome plugin, you can get a better experience.
After step 1 has been done, open chrome, then install Kubespider plugin, and configure it as follows(The server address is http://<server_ip>:3080):

If I want to download a movie, I can right click and send the download task to Kubespider(demo website):

Then with aria2 chrome plugin, you can see the download task starts:

4.More (Optional)

Install Plex, watch videos on multiple platforms, install now.
Install Baidu network disk(only in china), download in the background, install now.
Install Thunder(only in china), download in the background, install now.

🔧 Feature list

Basic feature

Supports magnet, torrent, and common resource downloads, such as zip, etc.

Download provider

Support aria2-type downloaders。

Source provider

Based on mikanani, it realizes fully automatic anime chasing, please refer to link for configuration.
Download related seed resources of btbtt12, please refer to link for configuration.
Based on meijutt to automatically follow American TV series, please refer to link for configuration.
Based on y2mate, download a YouTube video (TODO).

🤝 Contribution

If you are interested in participating in joint development, welcome to STAR/FORK/PR, please check link for Roadmap.

For how to write a resource provider for a resource website, please see link.
How to write a download provider for download software, please see link.
For How to develop chrome extension webhook, please see link.

📝 Disclaimer

All downloading and use of the software are deemed to have carefully read and fully agreed to the following terms:

The software is only for personal learning and communication, and it is strictly prohibited for commercial and bad purposes.
If any commercial behavior and bad use are found, the software author has the right to revoke the right to use.
The risk of using this software will be entirely borne by him, and the software author will not bear any responsibility.
Except for the terms of service indicated in the software, the author of this software is not responsible for any accidents, negligence, contract damage, defamation, copyright or other intellectual property infringement and any losses caused by improper use of this software, and also no legal responsibility is assumed.
The author of the software will not be responsible for the interruption of services or other defects caused by force majeure or uncontrollable reasons such as hacker attacks, communication line interruptions, etc., which cause users to fail to use normally but will try their best to reduce losses or impacts caused to users.
For issues not covered in this statement, please refer to relevant national laws and regulations. When this statement conflicts with relevant national laws and regulations, the national laws and regulations shall prevail.
The copyright of this software statement and its right to modify, update and final interpretation belong to the software author.

mtyzaq / kubespider