/day-player

A Sketch Plugin for creating placeholder images from online services.

Primary LanguageJavaScriptMIT LicenseMIT

Day Player Download Download the latest version (3.0.0)

Day Player Build Status

A Sketch Plugin for creating placeholder images from online services.

Installation

What Does It Do?

It allows you to insert customized placeholder images into any Sketch document from a number of different placeholder image services:

How to use it

  • Open a new or existing Sketch document
  • Plugins > Day Player > Service...
  • Update the options to your liking, OK/Enter
  • The image is created on the canvas

Animated gif showing basic Day Player usage

Appending images to an Artboard or Group

  • Open a new or existing Sketch document
  • Select the Artboard or Group
  • Plugins > Day Player > Service...
  • Update the options to your liking, OK/Enter
  • The image is created within the Artboard or Group
  • Image will be placed in the top left corner of the Artboard or Group

Artboard:

Animated gif showing Day Player usage on Artboard

Group:

Animated gif showing Day Player usage on Group

Creating images with dimensions and position of existing Layers

  • Open a new or existing Sketch document
  • Select the desired Layer
  • Plugins > Day Player > Service...
  • Update the options to your liking, OK/Enter
  • The image is created in the parent group of the selected layer
  • Image will inherit the x, y, width, and height of the selected layer

Animated gif showing Day Player existing layer usage

Advanced Service Options

All services offer width, height, and black & white / color options. Unsplash.it and Placehold.it offer further options to customize the placeholder images.

Unsplash.it:

Animated gif showing Day Player Unsplash.it usage

Placehold.it:

Animated gif showing Day Player Placehold.it usage


Contributing to this project

As with most open source projects, pull requests for bug fixes, and new functionality are always welcome.

Prerequisites

  • Node 5.x.x+

Fork this repo and clone a local copy of your fork.

Install dependencies:

npm install

Create necessary application bundle from source by running:

make install

Watch the src and resources directories and recompile when changes are made by running:

make watch

make install and make watch will copy the application bundle to the default Sketch plugins location ~/Library/Application Support/com.bohemiancoding.sketch3/Plugins/ as Day Player.sketchplugin.

See the Makefile for further details on the build process.