https://github.com/jdsteinbach/unsplash-collection-downloader

Download a whole Unsplash collection
https://github.com/jdsteinbach/unsplash-collection-downloader

Last synced: 16 days ago
JSON representation

Download a whole Unsplash collection

• Host: GitHub
• URL: https://github.com/jdsteinbach/unsplash-collection-downloader
• Owner: jdsteinbach
• Created: 2018-10-11T23:41:34.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2024-09-08T01:36:03.000Z (2 months ago)
• Last Synced: 2024-10-10T05:03:08.987Z (28 days ago)
• Language: JavaScript
• Size: 4.88 KB
• Stars: 6
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
# Unsplash Collection Downloader

A node module to download an Unsplash collection of your choice into a directory of your choice

## Installation

```sh

npm i -g unsplash-collection-downloader

```

## Authorization

[Register an app](https://unsplash.com/developers) and get your own keys from Unsplash.

Create `.env` and add your keys:

```

ACCESS_KEY=YOUR_ACCESS_KEY_HERE

SECRET_KEY=YOUR_SECRET_KEY_HERE

```

## Choose a Collection

You can add the collection ID to your `.env`. This is useful if you have a single collection you always want this package to retrieve:

```

COLLECTION_ID=YOUR_COLLECTION_ID

```

Or, you can pass the collection ID with a flag when you run the package. This allows you to download specific collections easily:

```sh

$ unsplash-collection-downloader --c=116851

```

## Choose a Directory

Images will be downloaded to the directory you run this package in.

You can override that directory with a flag (_do not_ include a trailing slash):

```sh

$ unsplash-collection-downloader --dir="path/dir"

```

## Pagination

This plugin requires paginated requests to run properly with Unsplash's API. The default value is `25`. If you run into any issues that require you to reduce the number of images per page, there's a flag for that override too:

```sh

$ unsplash-collection-downloader --p=10

```

## Roadmap

* [ ] Add tests

* [ ] Better error handling

* [ ] Flag for specific image size, maybe?