/frameit

Want a device frame around your screenshot? Do it in an instant!

Primary LanguageRubyMIT LicenseMIT

DeliverSnapshotFrameItPEMSigh

-------

FrameIt - Add gorgeous device frames around your screenshots

Twitter: @KauseFx License Gem

Want a device frame around your screenshot? Do it in an instant!

This library is not supposed to be used for App Store screenshots.

Follow the developer on Twitter: @KrauseFx


FeaturesInstallationUsageTipsNeed help?


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 Air
  • Portrait and Landscape
  • Black and Silver devices

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

assets/FrameitGit.gif

Here is how the result can look like assets/Overview.png

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

Tips

Other helpful tools

Check out other tools in this collection to speed up your deployment process:

  • deliver: Deploy screenshots, app metadata and app updates to the App Store using just one command
  • snapshot: Create hundreds of screenshots of your iPhone app... while doing something else
  • PEM: Tired of manually creating and maintaining your push certification profiles?
  • sigh: Because you would rather spend your time building stuff than fighting provisioning.

Generate screenshots

Check out Snapshot to automatically generate screenshots using UI Automation.

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. Run frameit --trace to get the stacktrace.
  • I'm available for contract work - drop me an email: frameit@felixkrause.at

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