npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

bulksplash

v3.0.0

Published

A simple command line tool that lets you bulk download images from Unsplash

Downloads

38

Readme

Bulksplash

A simple command line tool that lets you bulk download images from Unsplash, previously known as Unsplash Bulk Downloader.

screenshot

Quick Start

To use Bulksplash, you need to install Node.js. Once you have Node.js installed, you can simple use the npx command to run Bulksplash:

npx bulksplash

This will automatically download and let you use Bulksplash. To be able to use Bulksplash wherever you like, you can install it globally using npm:

npm install bulksplash --g

Once installed, you can simply run bulksplash from the terminal on any folder to download images from Unsplash.

Obtaining an API key

To use Bulksplash, you NEED to obtain an API key for Unsplash. This can be done by signing up here and creating a Demo app. This will allow you to download 50 images per hour, but if you want to download more than that, you will need to apply for Production access via Unsplash Developers.

Options

Prompts in the terminal will guide you through the options for downloading images, with some default values for quicker use. The prompts are as follows:

  • What is your API key? - You need an API key for Unsplash to be able to use Bulksplash. Get one here.
  • Which directory do you want to save to? - The folder you want to download the pictures to. Defaults to your current directory
  • Which images do you want to download? - Whether you want to download images randomly or from a specific collection. Defaults to random
  • What search term? - A search term, or blank for random images. Defaults to blank
  • Enter the URL of the Unsplash collection you want to download from - The link of the Unsplash Collection you want to download Defaults to blank, needs to be a valid link
  • How many images (up to 50)? - The number of images to retrieve. Defaults to 20
  • Only featured images? - Should it only get featured images, curated by Unsplash? Defaults to Yes
  • What orientation? - What orientation should the images be? The options are Mixed, Portrait, Landscape, Squarish, or Custom. Mixed will get images regardless of orientation, while Custom allows you to choose a specific width and height. Defaults to Mixed
  • Width? - For any orientation, choose the width of the returned images. This is required when the Custom orientation is selected. Defaults to blank for original size
  • Height? - For Custom orientation, specify a height. This option is not displayed if the orientation is not
  • Export the credits for the photos to a .json file? - Whether to generate the bulksplash-credits.json file with all the details about hte photographers. Defaults to yes

Quick Usage

Bulksplash lets you directly use the tool without going through the prompt interface.

For example: bulksplash --amount=50 --d=basket -c=https://unsplash.com/collections/9454911 --f --j will download 50 featured images from the "Basketball" collection into the "test" sub-folder and generate a credits file.

Available options:

  • --d: the directory you want to save images to.
  • --c: if you want to download images from a collection, enter the link of the Unsplash collection you want to download images from.
  • --q: if you want to download images about something specific, you can enter a search query.
  • --a: the number of images you want to download.
  • --w: the width of the images.
  • --h: the height of the images.
  • --o: the orientation of the images ("landscape", "portrait", "squarish")
  • --f: whether you want to download featured images.
  • --n: the name scheme of the downloaded images (0 for authorname-randomstring, 1 for numbered list)
  • --j: whether you want to generate a credits file.

Please feel free to contribute to this tiny project and make it better and follow me on Twitter for more projects like this!