Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hi-ray/cd-dd
CommunityDragon directory downloader
https://github.com/hi-ray/cd-dd
Last synced: 8 days ago
JSON representation
CommunityDragon directory downloader
- Host: GitHub
- URL: https://github.com/hi-ray/cd-dd
- Owner: Hi-Ray
- Created: 2022-05-10T00:49:07.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-09-07T01:52:03.000Z (over 1 year ago)
- Last Synced: 2024-12-18T07:20:05.812Z (18 days ago)
- Language: JavaScript
- Homepage:
- Size: 1.25 MB
- Stars: 10
- Watchers: 1
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Community Dragon Directory Downloader
[](https://www.npmjs.com/package/cdragon-dd) [](https://www.npmjs.com/package/cdragon-dd)
Download directories from community dragon's cdn
## IMPORTANT
Your urls must end in a "/" you should just copy and paste your urls into the command line
## Usage
You can either download and run a prebuilt binary from the [releases tab](https://github.com/Hi-Ray/cd-dd/releases) or install the package via npmjs.
If you want to install this package without npmjs, please read the documentation [here](https://github.com/Hi-Ray/cd-dd/blob/master/install-with-git.md).
```shell
> npm i cdragon-dd # install the package for your current project
> npm i cdragon-dd -g # install the package as a global CLI tool
> cd-dd [...flags]
```
## Usage example
Download all the files in the directory (URL).
```shell
> cd-dd https://raw.communitydragon.org/latest/game/data/images/
```
Download all the files in the directory (URL) and its subdirectories (recursive).
```shell
> cd-dd -r https://raw.communitydragon.org/latest/game/data/images/
```
Download all the files in the directory (URL) and its subdirectories (recursive) into the local directory `./data`.
```shell
> cd-dd -o ./data -r https://raw.communitydragon.org/latest/game/data/images/
```
Download all the files in the directory (URL) and don't cache results.
```shell
> cd-dd -k replace -r https://raw.communitydragon.org/latest/game/data/images/
> cd-dd -k nothing -r https://raw.communitydragon.org/latest/game/data/images/
```
## Flags
```
Usage: cd-dd [options]
Arguments:
URL URL starting with https://
Options:
-o, --output Output directory location. Default is ./out
-r, --recursive Recursively download directory and files
-k, --keep-files [mode] Keep files if they already exist in the output directory (choices: "all", "replace", "nothing", default: "all")
-V, --version output the version number
-h, --help display help for command
```
## How does caching work?
When the keep-files flag is set to "all" or "replace", a `.cddd` file will be created in every downloaded directory which holds a compressed version of the downloaded files which can identify whether a the current version of the file was already downloaded or not.
If the keep-files flag is set to "all", existing valid files not be downloaded nor replaced.
If the keep-files flag is set to "replace" existing files are downloaded and replaced and a .cddd cache file will be created but ignored.
In the keep-files "nothing" mode, the .cddd flag is not created. Use this mode only if you are sure you are not going to download the same data twice at any point.