Create promo codes for iOS Apps using the command line
Automatically lose money by giving away your app for free...
This tool is no longer maintained and does not work.
codes is part of fastlane: connect all deployment tools into one streamlined workflow.
sudo gem install codes
Make sure, you have the latest version of the Xcode command line tools installed:
codes can help you automate sending promo codes to journalists and create promo codes for tons of apps with the press of a button.
codes [num] [-a app_identifier] [-u user_name] [-i app_id] [-o output_file] [-c country] [-X] [-f format]
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.
codes 3 -a com.example.myApp
Will generate 3 promo codes for the App with the Bundle Identifier
If you don't pass any paramaters,
codes will generate a single promo code and print it on the command line.
Display extra information
--format FORMAT argument to control the displayed information. The
--verbose argument displays all information and maps to
NRTFXP3XXXXX,20150520110716,ios,522069155,com.wewanttoknow.DragonBoxPlus,'DragonBox Algebra 5+',https://buy.itunes.apple.com/WebObjects/MZFinance.woa/wa/redeemLandingPage?code=NRTFXP3XXXXX
For example, if you want a custom URL, you could use something like
codes --format '%c: http://yoursite.com/redeem/%c'
codes 5 --urls
If specified, includes a full URL for each code that can be used to redeem that code.
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)
fastlane: Connect all deployment tools into one streamlined workflow
deliver: Upload screenshots, metadata and your app to the App Store
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
spaceship: Ruby library to access the Apple Dev Center and iTunes Connect
pilot: The best way to manage your TestFlight testers and builds from your terminal
boarding: The easiest way to invite your TestFlight beta testers
gym: Building your iOS apps has never been easier
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.
Please submit an issue on GitHub and provide information about your setup
Code of Conduct
Help us keep
codes open and inclusive. Please read and follow our Code of Conduct.
This project is licensed under the terms of the MIT license. See the LICENSE file.
This project and all fastlane tools are in no way affiliated with Apple Inc. This project is open source under the MIT license, which means you have full access to the source code and can modify it to fit your own needs. All fastlane tools run on your own computer or server, so your credentials or other sensitive information will never leave your own computer. You are responsible for how you use fastlane tools.