MagicDownloadHub

A generic youtube with integrated search engine and multithreading downloader implemented based on sealedtx/java-youtube-downloader

Features

• Text User Interface with colorized annotations
• A fully compatible search engine with filters
• Multithreading videos download
• Video Manager (WIP)

Docs

Assumed that you've launched the application successfully and are presented with the home screen (the figure at the start of this markdown)

Searching

To search for a phrase, do the following:

• Press 2 ( Search with keyword )
• Enter the phrase
• Press Enter

You can also [3] Extend this search, [4] Browse your search tabs, and [5] View current tab's search result

Downloading

First, you may want to check all available video and audio formats of the video by using [6] Get all formats using videoID

To download one or multiple video, do the following:

• Press 7

• Enter the videoID (Note that if you also want to include a name, append your name with a "@" then place it BEFORE the videoID. If you place multiple names, the LATEST name will be chose, your name must not contain any spaces as well). For example:

  @not_rick_roll dQw4w9WgXcQ

• Press Enter

After finish downloading, the first video you specified in this will be opened, you should check and ensure the quality and audio are matched to your desire. If no name was given to a video, we'll generate a random UUID for it.

Default Configuration

settings	type	default value	description
downloadPath	String	"downloaded_videos"	The root download path
openVideoAfterDownload	Boolean	true	For single video download only. Auto open up the video (if supported) when downloaded
timeoutTimeInMillisecond	Long	1000 * 60 * 60 * 12	Timeout time of a downloading thread if takes too long
verifyVideoIDOnPayloadDownload	Boolean	false	Verify if that videoId is existed or not. Useful to make sure you enter valid id
filterDuplicateVideoId	Boolean	true	Filter out duplicate videoId in your payload. Disable to download a video multiple times

Run with Maven

Step 1: Clone the project

MagicDownloadHub currently required SDK 21+ to run, you can download it from the official source of Oracle here. Also, the Text User Interface works only for utf-8 supported console only. For Window user, you can set the code page of the command prompt to be UTF-8 using chcp.

chcp 65001

Since the main repo java-youtube-downloader is experiencing some issues about the test cases, unit tests is temporarily disable in this repo. However, you may fix and build this with tests at any time.

Next, you can clone this repo (we don't support SSH cloning right now)

git clone https://github.com/gugugiyu/MagicDownloadHub.git

Step 2: Install the dependencies

Then, build the jar file from the artifact

mvn clean install

Step 3: Run the program

and finally run the executable jar

mvn exec:java -DmainClass=com.magic.Application

Run with JAVA directly

This project comes pre-packaged into a jar file so that you can run with just java, follow the following command to run it:

git clone https://github.com/gugugiyu/MagicDownloadHub.git
cd target
java -Dfile.encoding="UTF-8" -cp magic-hub-1.0-SNAPSHOT.jar com.magic.Application

We can even further optimized the process above to just one click by creating a bat file that runs this program from just a click. Most convenient if you want a one-click application

chcp 65001
cd "PATH_TO_TARGET_FILE"
java -Dfile.encoding="UTF-8" -cp magic-hub-1.0-SNAPSHOT.jar com.magic.Application
pause
cd "PATH_TO_POST_APPLICATION DIRECTORY" # Left this blank if you want

Note: The [1] show saved video directory will NOT work before you download any video when run with java directly as it will be initialized on your first download (by either single or payload download)

Contribution

This project is under development, and any contributions are welcome