Skip to content

lambdacasserole/picksel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

60 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Picksel

Asset manager for pulling down Pixabay images.

What's Picksel?

If you grind your teeth when you find yourself committing large stock images to your static build repo, you're in the right place. Picksel is designed to cut down or eliminate the number of images you commit to your Git/Mercurial/whatever repository by acting as kind of like a 'package manager' for pulling down images from the free stock image site Pixabay.

Installation

Picksel is an npm package. Just run the following from your command prompt (assuming you have npm and node.js installed).

npm install -g picksel

From there, navigate to your project folder and run:

picksel auth

And enter your Pixabay API key when prompted. Follow this up with:

picksel init

This will initialize your project for use with Picksel.

Usage

To add a Pixabay image as an asset dependency, use the following command:

picksel add 195893 small flowers.jpg

In the above command we specify the hash ID of the image on Pixabay, the resolution to download it at, and the name of the destination file on disk. Once you're happy with your dependencies, run:

picksel install

To do the heavy lifting of downloading your image assets and putting them in the right place.

Remember!

To download pictures in any resolution higher than 'small' you will need to have your API access elevated by a member of the team at Pixabay. You can ask for elevated API access on the Pixabay website. If this problem is raised on GitHub as an issue it'll be immediately closed. It's out of my hands.

Contributing

At the risk of being swarmed by an angry mob of Node.js developers, I'm going to admit that Picksel is written in CoffeeScript. The built JavaScript is distributed on npm. Comments, suggestions and pull requests are very welcome.

Acknowledgements

Big shout-out and much love to Pixabay for providing an awesome website and API to program against. Visit them for loads of free public domain stock photos, videos and more.

Disclaimer

PICKSEL AND ITS AUTHOR(S) ARE NOT AFFILIATED WITH PIXABAY AND ALL OTHER PIXABAY PRODUCT NAMES ARE TRADEMARKS OR REGISTERED TRADEMARKS OF BRAXMEIER & STEINBERGER GBR. ALL OTHER COMPANY AND PRODUCT NAMES ARE TRADEMARKS OR REGISTERED TRADEMARKS OF THEIR RESPECTIVE COMPANIES.