fastlane

deliver • snapshot • frameit • PEM • sigh • produce • cert • codes

frameit

Twitter: @KauseFx License Gem Build Status

Quickly put your screenshots into the right device frames

Get in contact with the developer on Twitter: @KrauseFx

Features • Installation • Usage • Tips • Need help?

frameit is part of fastlane: connect all deployment tools into one streamlined workflow.

Features

Put a gorgeous device frame around your iOS screenshots just by running one simple command. Support for:

  • iPhone 6 Plus, iPhone 6, iPhone 5s and iPad mini
  • Portrait and Landscape
  • Black and Silver devices
Like this tool? Be the first to know about updates and new fastlane tools

Here is a nice gif, that shows frameit in action:

assets/FrameitGit.gif

Installation

Make sure, you have the commandline tools installed

xcode-select --install

Install the gem

sudo gem install frameit

Because of legal reasons, I can not pre-package the device frames with frameit.

The process of adding is really easy, just run frameit and the guide will help you set it up. You only have to do this once per computer.

  • Run frameit
  • Press Enter. The Apple page to download the images should open in your browser.
  • Download the devices you want to use
  • Press Enter
  • Unzip and move the content of the zip files to ~/.frameit/device_frames
  • Press Enter

Usage

Why should you have to use Photoshop, just to add a frame around your screenshots?

Just navigate to your folder of screenshots and use the following command:

frameit

To use the silver version of the frames:

frameit silver

To run the setup process again to add new frames use:

frameit setup

When using frameit without titles on top, the screenshots will have the full resolution, which means they can't be uploaded to the App Store directly. They are supposed to be used for websites, print media and emails. Check out the section below to use the screenshots for the App Store.

Tips

fastlane Toolchain

  • fastlane: Connect all deployment tools into one streamlined workflow
  • deliver: Upload screenshots, metadata and your app to the App Store using a single command
  • snapshot: Automate taking localized screenshots of your iOS app on every device
  • PEM: Automatically generate and renew your push notification profiles
  • sigh: Because you would rather spend your time building stuff than fighting provisioning
  • produce: Create new iOS apps on iTunes Connect and Dev Portal using the command line
  • cert: Automatically create and maintain iOS code signing certificates
  • codes: Create promo codes for iOS Apps using the command line
Like this tool? Be the first to know about updates and new fastlane tools

Generate localized screenshots

Check out snapshot to automatically generate screenshots using UI Automation.

White background of frames

Some stock images provided by Apple still have a white background instead of a transparent one. You'll have to edit the Photoshop file to remove the white background, delete the generated .png file and run frameit again.

Use a clean status bar

You can use SimulatorStatusMagic to clean up the status bar.

Uninstall

  • sudo gem uninstall frameit
  • rm -rf ~/.frameit

Need help?

  • If there is a technical problem with frameit, submit an issue.
  • I'm available for contract work - drop me an email: [email protected]

License

This project is licensed under the terms of the MIT license. See the LICENSE file.

Contributing

  1. Create an issue to discuss about your idea
  2. Fork it (https://github.com/KrauseFx/frameit/fork)
  3. Create your feature branch (git checkout -b my-new-feature)
  4. Commit your changes (git commit -am 'Add some feature')
  5. Push to the branch (git push origin my-new-feature)
  6. Create a new Pull Request