deliver •
snapshot •
frameit •
PEM •
sigh •
produce •
cert •
codes
-------
frameit
============
[](https://twitter.com/KrauseFx)
[](https://github.com/KrauseFx/frameit/blob/master/LICENSE)
[](http://rubygems.org/gems/frameit)
[](https://travis-ci.org/fastlane/frameit)
###### Quickly put your screenshots into the right device frames
Get in contact with the developer on Twitter: [@KrauseFx](https://twitter.com/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](https://tinyletter.com/krausefx)
Here is a nice gif, that shows ```frameit``` in action:
# 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](https://developer.apple.com/app-store/marketing/guidelines/#images) 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`](https://fastlane.tools) Toolchain
- [`fastlane`](https://fastlane.tools): Connect all deployment tools into one streamlined workflow
- [`deliver`](https://github.com/KrauseFx/deliver): Upload screenshots, metadata and your app to the App Store using a single command
- [`snapshot`](https://github.com/KrauseFx/snapshot): Automate taking localized screenshots of your iOS app on every device
- [`PEM`](https://github.com/KrauseFx/pem): Automatically generate and renew your push notification profiles
- [`sigh`](https://github.com/KrauseFx/sigh): Because you would rather spend your time building stuff than fighting provisioning
- [`produce`](https://github.com/KrauseFx/produce): Create new iOS apps on iTunes Connect and Dev Portal using the command line
- [`cert`](https://github.com/KrauseFx/cert): Automatically create and maintain iOS code signing certificates
- [`codes`](https://github.com/KrauseFx/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](https://tinyletter.com/krausefx)
## Generate localized screenshots
Check out [`snapshot`](https://github.com/KrauseFx/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](https://github.com/shinydevelopment/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: frameit@krausefx.com
# 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
