appium /appium
Cross-platform automation framework for all kinds of apps, built on top of the W3C WebDriver protocol
★ 22,220⑂ 6,308👁 839⑃ 8,202● 14,030▤ 1,946
+3
Daily
+42
Weekly
+157
Monthly
22,220
stars
6,308
forks
839
watchers
8,202
prs
14,030
issues
1,946
releases
README
Cross-platform test automation for native, hybrid, mobile web and desktop apps. Documentation | Get Started | Ecosystem | Changelog | Contributing Guide | Discussion Forum Appium is an open-source automation framework that provides WebDriver-based automation possibilities for a wide range of different mobile, desktop and IoT platforms. Appium is modular and extensible, and supports multiple programming languages, which means there is an entire ecosystem of related software: __Drivers__ add support for automating specific platforms __Clients__ allow writing Appium tests in your programming language of choice __Plugins__ allow to further extend Appium functionality Upgrading From Older Versions The Appium team only provides support for the most recent version of Appium. If you wish to upgrade from an older major Appium version, please refer to the migration guides: Appium v3 to v4 Appium v2 to v3 Appium v1 to v2 Installation Appium can be installed using npm (other package managers are not currently supported). Please check the installation docs for the system requirements and further information. If upgrading from Appium 1, make sure Appium 1 is fully uninstalled (npm uninstall -g appium). Unexpected errors might appear if this has not been done. bash npm i -g appium Note that this will only install the core Appium server, which cannot automate anything on its own. Please install drivers for your target platforms in order to automate them. Drivers Appium supports app automation across a variety of platforms, like iOS, Android, macOS, Windows, and more. Each platform is supported by one or more "drivers", which know how to automate that particular platform. You can find a full list of officially-supported and third-party drivers in Appium Ecosystem's Drivers page. Driver management is done using Appium's Extension command-line interface: bash Install an official driver from npm (see documentation for a list of such drivers) appium driver install Install any driver from npm appium driver install --source=npm See documentation for installation from other sources List already installed drivers appium driver list --installed Update a driver (it must be already installed) This will NOT update the major version, in order to prevent breaking changes appium driver update Update a driver to the most recent version (may include breaking changes) appium driver update --unsafe Uninstall a driver (it won't last forever, will it?) appium driver uninstall Clients Client libraries enable writing Appium tests in different programming languages. There are officially-supported clients for Java, Python, Ruby, and .NET C, as well as third-party clients for other languages. You can find a full list of clients in Appium Ecosystem's Clients page. Plugins Plugins allow you to extend server functionality without changing the server code. The main difference between drivers and plugins is that th
Top issues
#14825Accessing page content when using deeply nested React Navigation navigators on iOS Using Appium186 comments · 2020-10-20#22857iPhone Duo support (including feedback)10 comments · 2026-10-03#22081Crash appium with device Tecno CM7 Android 159 comments · 2026-03-17#19819bug: `appium driver list --installed` is unable to find drivers in monorepo8 comments · 2024-02-22#17984appium server Relay as selenium grid 4 directly to register to grid 48 comments · 2022-12-27#15789Dependency Dashboard6 comments · 2021-08-30#22966[appium4] WebDriver specification conformance review5 comments · 2026-10-11#20607ActionSheet close automatically (iOS 18 Simulator) with autoAcceptAlerts :true as iOS 18 started returning correct XCUIElementTypeSheet5 comments · 2024-09-24
Discussions
#22803IOS 27 Memory heap on Cordova App0 comments · 2026-09-22#22633Test startup became very slow last week; @wdio/appium-service sometimes times out1 comments · 2026-08-14#22517Open-source GitHub Action for collecting Appium UI evidence0 comments · 2026-07-19#22371Couldn't interact with elements having resource-id1 comments · 2026-06-09#22287Why my (responsive) mobileweb page only on iOS and Safari browser is automatically submitting itself on specific page loading ?1 comments · 2026-05-20#22231Create a new Safari Browser session on iPhone every time the test is re-run1 comments · 2026-05-03#22219Since Appium 3.2, and the latest Chrome on Android real device, every web page control action is occurring with zoom action, is it preventable ?3 comments · 2026-04-29#22176How to using npm to offline install appium3 comments · 2026-04-15
Latest release
@appium/[email protected] @appium/[email protected] 2026-11-151.0.0 (2026-11-15)
⚠ BREAKING CHANGES
base-driver: a command result shaped like {protocol, value} is no longer unwrapped. It is returned as the command value. {protocol, error} is still thrown when error is an Error and protocol is W3C or MJSONWP.
@appium/tsconfig now sets noImplicitOverride: true. Extensions extending this config must mark overriding members with override, otherwise tsc fails with TS4114.
base-driver: POST body has to be a JSON object, otherwise the server returns invalid argument error.
http-server: clients that send an Origin header must enable the CORS feature (--al