# appium-mac2-driver

> XCTest-based Appium driver for macOS apps automation

Latest version **4.3.6** (published 2026-10-02) · Apache-2.0 license · 65.6K weekly downloads

## Install

```sh
npm install appium-mac2-driver
pnpm add appium-mac2-driver
yarn add appium-mac2-driver
bun add appium-mac2-driver
```

## Health

**Score 80/100 (A)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: large bundle.

## Facts

| | |
|---|---|
| Version | 4.3.6 |
| Published | 2026-10-02 |
| First published | 2020-11-24 |
| Weekly downloads | 65.6K |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | ^20.19.0 \|\| ^22.12.0 \|\| >=24.0.0 |
| Dependencies | 7 |
| Unpacked size | 43.1 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 187 |
| Author | Appium Contributors |
| Maintainers | jlipps, nick.mokhnach, kazucocoa |
| Keywords | XCTest, appium, mac |

## Links

- npm: https://www.npmjs.com/package/appium-mac2-driver
- Repository: https://github.com/appium/appium-mac2-driver
- Homepage: https://github.com/appium/appium-mac2-driver#readme
- Issues: https://github.com/appium/appium-mac2-driver/issues
- npm.io page: https://npm.io/package/appium-mac2-driver

## Dependencies (7)

- [axios](https://npm.io/package/axios.md) 1.20.0
- [asyncbox](https://npm.io/package/asyncbox.md) 6.4.3
- [portscanner](https://npm.io/package/portscanner.md) 2.2.0
- [appium-xcode](https://npm.io/package/appium-xcode.md) 7.2.2
- [teen_process](https://npm.io/package/teen_process.md) 4.2.1
- [@colors/colors](https://npm.io/package/@colors/colors.md) 1.6.1
- [@appium/strongbox](https://npm.io/package/@appium/strongbox.md) 2.0.1

## Recent versions

- 4.3.6 (latest) — 2026-10-02
- 4.3.5 — 2026-09-10
- 4.3.4 — 2026-09-02
- 4.3.3 — 2026-09-01
- 4.3.2 — 2026-08-31
- 4.3.1 — 2026-08-30
- 4.3.0 — 2026-08-26
- 4.2.0 — 2026-08-10
- 4.1.1 — 2026-08-08
- 4.1.0 — 2026-08-07
- 4.0.7 — 2026-08-06
- 4.0.6 — 2026-08-04
- 4.0.5 — 2026-07-27
- 4.0.4 — 2026-07-15
- 4.0.3 — 2026-07-01
- … 141 more at https://npm.io/package/appium-mac2-driver/versions

## README

## Appium Mac2 Driver

<p align="center">
  <a href="https://appium.github.io/appium-mac2-driver/">
    <picture>
      <source media="(prefers-color-scheme: light)" srcset="docs/assets/images/appium-plus-mac2-light.png">
      <source media="(prefers-color-scheme: dark)" srcset="docs/assets/images/appium-plus-mac2-dark.png">
      <img width="400" alt="Appium Mac2 Driver">
    </picture>
  </a>
</p>

<div align="center">

[![NPM version](http://img.shields.io/npm/v/appium-mac2-driver.svg)](https://npmjs.org/package/appium-mac2-driver)
[![Downloads](http://img.shields.io/npm/dm/appium-mac2-driver.svg)](https://npmjs.org/package/appium-mac2-driver)
[![Release](https://github.com/appium/appium-mac2-driver/actions/workflows/publish.js.yml/badge.svg)](https://github.com/appium/appium-mac2-driver/actions/workflows/publish.js.yml)

</div>

---

<p align="center"><b>
   <a href="https://appium.github.io/appium-mac2-driver/">Documentation</a> |
   <a href="https://appium.github.io/appium-mac2-driver/latest/getting-started/">Get Started</a> |
   <a href="https://github.com/appium/appium-mac2-driver/blob/master/CHANGELOG.md">Changelog</a>
</b></p>

---

This is an Appium driver for automating macOS applications using Apple's XCTest framework.

> [!IMPORTANT]
> Since major version *3.0.0*, this driver is only compatible with Appium 3.


## Documentation

You can access the documentation here: [**https://appium.github.io/appium-mac2-driver**](https://appium.github.io/appium-mac2-driver)

---
_Source: https://npm.io/package/appium-mac2-driver · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._