iphone Automation for iOS, Android, and Windows Apps.

License: Apache-2.0

Language: JavaScript

Keywords: android, appium, automation, ios, webdriver, windows


NPM version Dependency Status devDependency Status

Monthly Downloads

FOSSA Status Greenkeeper badge

Appium is an open source, cross-platform test automation tool for native, hybrid and mobile web and desktop apps. We support simulators (iOS), emulators (Android), and real devices (iOS, Android, Windows, Mac).

Want to skip straight to the action? Check out our getting started doc.

Supported Platforms

Appium supports app automation across a variety of platforms, like iOS, Android, and Windows. Each platform is supported by one or more "drivers", which know how to automate that particular platform. Choose a driver below for specific information about how that driver works and how to set it up:

Why Appium?

  1. You don't have to recompile your app or modify it in any way, due to use of standard automation APIs on all platforms.
  2. You can write tests with your favorite dev tools using any WebDriver-compatible language such as Java, Objective-C, JavaScript (Node), PHP, Python, Ruby, C#, Clojure, or Perl with the Selenium WebDriver API and language-specific client libraries.
  3. You can use any testing framework.
  4. Appium has built-in mobile web and hybrid app support. Within the same script you can switch seamlessly between native app automation and webview automation, all using the WebDriver model that's already the standard for web automation.

Investing in the WebDriver protocol means you are betting on a single, free and open protocol for testing that has become a web standard. Don't lock yourself into a proprietary stack.

For example, if you use Apple's XCUITest library without Appium you can only write tests using Obj-C/Swift, and you can only run tests through Xcode. Similarly, with Google's UiAutomator or Espresso you can only write tests in Java/Kotlin. Appium opens up the possibility of true cross-platform native app automation, for mobile and beyond. Finally!

If you're new to Appium, or want a more comprehensive description of what this is all about, please read our Introduction to Appium Concepts.


Your environment needs to be set up for the particular platforms that you want to run tests on. Each of the drivers above documents the requirements for their particular brand of automation. At a minimum, you will need to be able to run Node.js 10+.

Get Started

Check out our Getting Started guide to get going with Appium.

There is also sample code that contains many examples of tests in a variety of different languages!


For prettily-rendered docs, please visit You can always find the full list of Appium doc pages at Appium's GitHub Repo as well.


Please take a look at our contribution documentation for instructions on how to build, test and run Appium from source.


Interested in where Appium is heading in the future? Check out the Roadmap

Project History, Credits & Inspiration

User Forums

Announcements and debates often take place on the Discussion Group, be sure to sign up!


We put together a troubleshooting guide. Please have a look here first if you run into any problems. It contains instructions for checking a lot of common errors and how to get in touch with the community if you're stumped.


FOSSA Status

Project Statistics

Sourcerank 16
Repository Size 80.7 MB
Stars 11,024
Forks 4,419
Watchers 884
Open issues 151
Dependencies 76
Contributors 280
Tags 226
Last updated
Last pushed

Top Contributors See all

Jonathan Lipps bootstraponline Isaac A. Murchie seb vincent Sebastian Tiedtke Dan Graham Kazuaki Matsuo Jonah Dan Cuellar Adam Christian Payman Delshad Eric Millin Appium Triager Santiago Suarez Ordoñez Bernard Kobos Jason Carr Moiz Virani Dylan Lacey Sergio Neves Barros Mathieu Sabourin

Packages Referencing this Repo

Automation for Apps.
Latest release 1.17.0 - Updated - 11K stars
Automation for Apps.
Latest release 1.16.0-alpha.3 - Published - 11K stars
Automation for Apps.
Latest release 1.16.0-beta.1 - Published - 11K stars
Automation for Apps.
Latest release 1.13.0-beta.3-2 - Updated - 11K stars
Automation for Apps. modified by chengming
Latest release 1.12.1 - Updated - 11K stars
Automation for Apps.
Latest release 1.6.3 - Published - 11K stars
Event Timing Parser
Latest release 1.2.0 - Updated - 11K stars
Automation for Apps.
Latest release 1.4.15-pebble-1 - Updated - 11K stars
Automation for Apps.
Latest release 1.5.3 - Updated - 11K stars
Automation for Apps.
Latest release 1.0.22 - Updated - 11K stars
Automation for Apps.
Latest release 2.0.4 - Updated - 11K stars
:iphone: Automation for iOS, Android, and Windows Apps.
Latest release 3.0.1 - Updated - 11K stars

Recent Tags See all

v1.17.0 March 15, 2020
v1.17.0-rc.2 March 11, 2020
v1.17.0-rc.1 March 04, 2020
push March 04, 2020
v1.17.0-beta.1 February 25, 2020
v1.16.0 December 23, 2019
v1.16.0-rc.2 December 23, 2019
v1.16.0-rc.1 December 06, 2019
v1.16.0-rc.0 November 28, 2019
v1.16.0-beta.3 November 26, 2019
v1.16.0-beta.2 November 21, 2019
v1.15.1 October 11, 2019
v1.15.0 September 24, 2019
v1.15.0-rc.5 September 24, 2019
v1.15.0-rc.4 September 24, 2019

Interesting Forks See all

Automation for Apps.
JavaScript - Updated - 31 stars - 11 forks
iphone Automation for iOS, Android, and Windows Apps.
JavaScript - Other - Last pushed - 13 stars - 33 forks
Selenium for Apps.
JavaScript - Other - Last pushed - 5 stars - 1 forks
iphone Automation for iOS and Android Apps.
JavaScript - Other - Last pushed - 5 stars
iphone Automation for iOS and Android Apps.
JavaScript - Other - Last pushed - 4 stars - 2 forks

Something wrong with this page? Make a suggestion

Last synced: 2019-11-21 21:47:37 UTC

Login to resync this repository