Skip to content
Upload ipa binary to in fastlane chain
Branch: master
Clone or download

Latest commit

Latest commit 4fbb8b1 Mar 3, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
bin ADD: upload infomations Oct 17, 2016
fastlane-plugin-firim fix #21 Nov 22, 2019
lib chore: bump to 0.2.4 Feb 26, 2020
test ADD: basic funs Oct 9, 2016
.gitignore FIX: Fixed #2 Dec 21, 2016
.travis.yml ADD: basic funs Oct 9, 2016
Gemfile ADD: basic funs Oct 9, 2016
LICENSE.txt ADD: basic funs Oct 9, 2016 chore: wrong word Mar 3, 2020
firim.gemspec Make the fastlane gem dependency less strict Jan 10, 2017


For the reason of had changed the Base URL, pls set firim_api_url to or issue


Firim is a command tool to directly upload ipa and change app infomation on is a Beta APP host website, you can upload ipa for AdHoc or InHouse distribution for testing.

Getting Started

Add this line to your application's Gemfile:

gem 'firim'

And then execute:

$ bundle

Or install it yourself as:

$ gem install firim

Quick Start

  • cd [your_project_folder]
  • firim init
  • Enter your API Token (From
  • firim -i [your_ipa_path]


Use with fastlane fastlane-plugin-firim

You can specify the app infomations in Firimfile, To get a list of available options run

firim --help

Upload with icon NOTICE: Icon must be jpg format

firim -i [your_ipa_path] -l [your_icon_path]

Use firim_api_url to set API URL, if change the Base URL. default is

Assign API Token

There are three ways to assign Firim API Token

  1. Set FIRIM_TOKEN environment variables
  2. Add token to macOS Keychain
  3. Set in Firimfile

Firim will check the value from 1 to 3. Run Firim will add token to keychain in interactive shell. Also can use firim addtoken and firim removetoken to add or remove token.

Need help?

Please submit an issue on GitHub and provide information about your setup


Bug reports and pull requests are welcome on GitHub at This project is intended to be a safe, welcoming space for collaboration.


The gem is available as open source under the terms of the MIT License.


  • Export all app infomation to a file
  • Generate a web page show all the app's link and infomations
  • Show the app list, and export all app infomations to a file
  • force reset icon
You can’t perform that action at this time.