https://github.com/flixma/mockingbird

Easily bulk embed your screenshots in Apple device mockups.
https://github.com/flixma/mockingbird

apple bulk-operation design-tools ios marketing mockup-generator multithreading opencv photoshop python3 screenshots xcode

Last synced: 3 months ago
JSON representation

Easily bulk embed your screenshots in Apple device mockups.

• Host: GitHub
• URL: https://github.com/flixma/mockingbird
• Owner: FlixMa
• License: gpl-3.0
• Created: 2019-10-18T16:34:19.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2020-05-17T11:07:04.000Z (over 4 years ago)
• Last Synced: 2024-10-10T22:40:13.733Z (3 months ago)
• Topics: apple, bulk-operation, design-tools, ios, marketing, mockup-generator, multithreading, opencv, photoshop, python3, screenshots, xcode
• Language: Python
• Size: 276 KB
• Stars: 20
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Mockingbird

## TL;DR - Key Features

- Uses Photoshop documents

- Supports Bulk-Edit

- Supports single and multi-frame mockups

- Supports transparency

- Supports resizing (aspect fit)

- Supports Multicore Systems



## The Long Story

This tool helps you to embed your app screenshots inside Apples device mockups.

Because the script reads the original photoshop documents Apple provides within their marketing guidelines, there is no need to wait for updates of the library after new product releases.

Multi-Frame Mockups, e.g. one containing iPad and iPhone, are supported.

### Installation

The only prerequisite is Python 3.6 or higher. On macOS its comfy to install it via homebrew, i.e. `brew install python3`.

To install mockingbird, use `pip3 install mockingbird-psd`.

### Instructions

Your screenshots need to be organized into folders.

Each folder represents one device and contains the screenshots for every feature you wish to showcase.

The folders are specified using the `--screenshots` parameter.

Concerning the layers of the photoshop document, the folders should be given from background to foreground.

You might also want to have a look at the usage message `mockingbird --help`

#### Single-Frame mockups:

`mockingbird --frame ./iphone_11.psd --screenshots ./iphone11`

#### Multi-Frame mockups:

`mockingbird --frame ./ipad_iphone.psd --screenshots ./ipad129inch ./iphone11`

This command uses the dual-device psd file and combines it with the images from `./ipad129inch` in the background device and `./iphone11` in the foreground device.