Picdown
Picdown is a command line tool that downloads the given images from a source file. It also allows you to make parallel requests to download images. Picdown provides fancy outputs such as progress bar for each request to inform the user.
Installation
Picdown is dockerised, which means you can experiment it by building the image from Dockerfile. Please run the below command to do that.
Note that you need to have a proper docker environment first.
docker build . -t picdown
If you want to build it manually, please follow the following instructions.
bundle config --global silence_root_warning true
bundle config --global set path vendor/bundle
bundle install
bundle exec rake install
gem install pkg/picdown-*.gem
Picdown is also a gem published on GitLab. You can have it by skipping installation steps. Please ensure that you have set up GitLab Rubygems Registry before running the following command.
gem install picdown --version <VERSION>
Usage
Please have a look at the help text of picdown
for more information.
➜ picdown -h
Commands:
picdown download FILE # Download files from the specified source file.
picdown validate PATH # Validate source file
picdown version # Print version
validate
It validates the given source file if it contains valid URLs.
picdown validate SOURCE
download
It downloads the images given by the source file. It needs a valid file path.
picdown download SOURCE
To download the images parallel:
picdown download SOURCE --parallel=4
You are also able to configure the download parameters. Please check the below help text for additional parameters.
➜ picdown download -h
...
Options:
--destination=VALUE # Destination where files to be downloaded., default: "."
--parallel=VALUE # Number of parallel download processes., default: 1
--open-timeout=VALUE # Open timeout for connections. (secs), default: 15
--read-timeout=VALUE # Read timeout for connections. (secs), default: 15
--max-size=VALUE # Max file size. (bytes), default: 5242880
--max-redirects=VALUE # Max redirections., default: 3
...
Demo
Picdown includes a demo file, which is located in assets
, that you can use.
picdown download assets/test.txt
or
docker run -t picdown download assets/test.txt
License
Not licensed yet.