fastlane

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

codes

Twitter: @KauseFx License Gem

Create promo codes for iOS Apps using the command line

or

Automatically lose money by giving away your app for free...
This tool was sponsored by Max Bäumle and Textastic Code Editor

Get in contact with the developers of codes on Twitter: @KrauseFx, @acrooow

Installation • Why? • Usage • Tips • Considerations • Need help?

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

Installation

sudo gem install codes

Make sure, you have the latest version of the Xcode command line tools installed:

xcode-select --install

Why?

codes can help you automate sending promo codes to journalists and create promo codes for tons of apps with the press of a button.

Usage

codes [num] [-a app_identifier] [-u user_name] [-i app_id] [-o output_file]

All parameters are optional.

codes will print out the promo codes and store them in a file called codes_[your app identifier].txt in the current directory by default.

Example:

codes 3 -a com.example.myApp

Will generate 3 promo codes for the the App with the Bundle Identifier com.example.myApp.

If you don't pass any paramaters, codes will generate a single promo code and print it on the command line.

Generate URLs

codes 5 --urls

If specified, includes a full URL for each code that can be used to redeem that code.

assets/codes.gif

Like this tool? Be the first to know about updates and new fastlane tools

Environment Variables

In case you prefer environment variables:

  • CODES_USERNAME (Your iTunes Connect username)
  • CODES_APP_IDENTIFIER (Your App's Bundle ID)
  • CODES_APP_ID(Your App's internal iTunes Connect App ID)

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
  • frameit: Quickly put your screenshots into the right device frames
  • 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: Create new iOS signing certificates
Like this tool? Be the first to know about updates and new fastlane tools

Considerations

As part of the process of downloading promo codes from iTunes Connect, the user would normally have to accept a contract every single time. Since there is no way to check with iTunes if this contract was accepted manually before, codes agrees to this contract automatically. Before using codes for the first time, we advise you to go to iTunes Connect and go through the process of creating promo codes manually at least once and to read the contract when it comes up.

Need help?

  • If there is a technical problem with codes, 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/codes/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