Repository navigation
Releases
Releases Β· appium/appium-inspector
2026.9.2
(note to plugin users: this version is identical to 2026.9.1 - the only difference is a single dev dependency bump)
Highlights
- More responsive design: the app can now scale down to 500x600px while remaining fully functional
- Driver and device-specific features: new header buttons for UiAutomator2 and Espresso driver sessions, and for iOS, tvOS and watchOS devices in XCUITest driver sessions (yes, Appium now supports watchOS!)
- The device screenshot can now be resized
- Element attributes shown in the app source tree can now be customized
- Gesture ticks in the gesture editor can now be reordered using drag-and-drop
What's Changed
π¦ Platform Support
- β macOS: the minimum supported version is now macOS 13 (Ventura)
π New Features
- feat: add header buttons to switch Espresso subdriver by @eglitise in #3133
- feat: show Home/Siri buttons in tvOS/watchOS sessions by @eglitise in #3137
- feat: add all XCUITest pressButton options into the header by @eglitise in #3141
- feat: add dropdown for watchOS gestures in the app header by @eglitise in #3142
- feat: add watchOS Digital Crown controls in the app header by @eglitise in #3149
- feat: allow the Screenshot panel to be resized by @eglitise in #3145
- feat: customize important source attributes by @lucasmariano003-wq in #3150
- feat: add dropdown for selecting active window strategy (UiAutomator2) by @eglitise in #3165
- feat: reorder actions in the gesture builder by @lucasmariano003-wq in #3152
- feat: reduce minimum window size for standalone app by @eglitise in #3182
π¨ Design Changes
- style: update Siri command UI to match other controls by @eglitise in #3156
- style: fix grouping of context-related elements by @eglitise in #3157
- style: render cloud providers modal in 3 rows by @eglitise in #3172
- style: use default title bar on macOS + tune CSS throughout by @eglitise in #3174
- style: follow OS preferences for scrollbar visibility by @eglitise in #3176
- style: apply responsive design throughout the Session Builder by @eglitise in #3177
- style: apply responsive design throughout the Session Inspector by @eglitise in #3180
- style: add favicon to plugin version by @eglitise in #3188
π Fixes
- fix: make the New Session screen responsive on narrow windows by @tatanota in #3063
- fix: ensure Capability Editor does not always open in narrow mode by @eglitise in #3070
- fix: make the Session Inspector screen responsive on narrow windows by @tatanota in #3064
- fix: add aria-label to icon-only buttons by @eglitise in #3126 (thanks to @MFA-G for the original PR)
- fix: adjust responsiveness in Session Inspector by @eglitise in #3127
- fix: ensure notifications can be normally dismissed by @eglitise in #3128
- fix: make display controls respond to any source of display config changes by @eglitise in #3131
- fix: gate display control buttons behind Android version as well by @eglitise in #3135
- fix: enable retrieval of active app for tvOS & watchOS by @eglitise in #3136
- fix: do not show screenshot mode controls when quitting session by @eglitise in #3138
- fix: hide W3C Action features on unsupported platforms by @eglitise in #3139
- fix: adjust Commands tab responsiveness to work with Splitter by @eglitise in #3158
- fix: adjust offset calculation for Safari webviews by @eglitise in #3155
- fix: add translation key for gesture tick drag handle by @eglitise in #3173
- fix: show empty pointer coords when null/undefined by @eglitise in #3181
π Documentation
π Localization
- chore: Update translations by @github-actions[bot] in #3074, #3089, #3113, #3143, #3166, and #3191
- chore: audit i18n keys by @eglitise in #3175
π Other Changes
- chore: migrate to oxc by @eglitise in #3076
- chore: upgrade to Vite 8 and related tools by @eglitise in #3078
- chore: add more oxlint rules by @eglitise in #3081
- chore: use oxc's React Compiler integration by @eglitise in #3122
- chore: refactoring changes by @eglitise in #3129, #3134, #3140, #3148, and #3185
- refactor: migrate remaining Redux containers to hooks by @lucasmariano003-wq in #3151
- chore: use static runtime for AppImage build by @eglitise in #3189
- ci: support releasing via new version number by @eglitise in #3190
New Contributors
- @lucasmariano003-wq made their first contribution in #3151
Full Changelog: v2026.7.1...v2026.9.2
2026.7.1
Highlights
- New 'Tap By Element' button in screenshot controls
- New header button for switching active device display (see requirements)
- Integrations with RobotActions and AstroFarm cloud providers
What's Changed
π New Features
- feat: add RobotActions as a cloud provider by @krishtoautomate in #2855
- feat: add dropdown for switching displays by @eglitise in #2922
- feat: add AstroFarm cloud provider support by @Milindsoni08 in #2938
- feat: add Tap By Element screenshot interaction mode by @tatanota in #3039
π¨ Design Changes
π Fixes
- fix: reinstate source tree expand icon rotation by @eglitise in #2824
- fix: align lines connecting source tree nodes by @eglitise in #2826
- fix: improve handling of UiA2 devices with different size displays by @eglitise in #2921
- fix(lambdatest): fix session listing and attach-to-session for LambdaTest by @SahilSawLT in #2892
- fix: surface network/timeout errors when fetching running sessions by @MatrixNeoKozak in #2952
- refactor: adjust JS - WebdriverIO recorder labels to include TS by @tatanota in #3040
π Documentation
- docs: adjust appiumpro notes by @eglitise in #3008
- docs: update screenshots for tap by element mode by @eglitise in #3054
π Localization
- chore: Update translations by @github-actions[bot] in #2858, #2879, #2887, #2925, #2942, #2958 and #2979
π Other Changes
- chore: Migrate vendor scripts to typescript by @mykola-mokhnach in #2819
- chore: refactoring changes by @eglitise in #2930, #2991, #2992, #2999, #3011, #3014, #3020, #3028, #3030, #3031 and #3033
- ci: adjust workflows by @eglitise in #2957, #2965, #2982, #2988 and #3055
- chore: Drop lodash by @mykola-mokhnach in #3021
- chore: tune electron-builder options by @eglitise in #3058 and #3060
New Contributors
- @krishtoautomate made their first contribution in #2855
- @Milindsoni08 made their first contribution in #2938
- @SahilSawLT made their first contribution in #2892
- @MatrixNeoKozak made their first contribution in #2952
- @tatanota made their first contribution in #3040
Full Changelog: v2026.5.1...v2026.7.1
2026.5.1
Highlights
- Attach to Session improvements
- You can now directly attach to a session using its session ID
- Improved presentation of discovered sessions
- Improved logic for generating suggested element XPath
What's Changed
π New Features
- feat: improve suggested xpath generation logic by @eglitise in #2733
- feat: support manually attaching to session using session ID by @eglitise in #2754
- feat: allow selecting installation directory for Windows installer by @eglitise in #2779
π¨ Design Changes
- style: use common refresh button in Attach to Session by @eglitise in #2756
- style: render discovered sessions as card grid by @eglitise in #2758
- style: increase gesture tick density at window widths >=1920px by @eglitise in #2790
π Fixes
- fix: update WDIO protocol command names by @eglitise in #2708, #2730
- fix: clear cached driver instance after detaching by @eglitise in #2753
π Localization
π Other Changes
- chore: use browser clipboard API everywhere by @eglitise in #2671
- chore: update Electron IPC usage by @eglitise in #2675
- test: add copy of the fake app fixture by @eglitise in #2691
- chore: internal locator generation related changes by @eglitise in #2718, #2719, #2727, #2729
- ci: update publish docs workflow by @eglitise in #2734
- chore: remove i18n translation caching by @eglitise in #2752
- chore: split Attach to Session into subcomponent files by @eglitise in #2755
- chore: run npm audit fix by @eglitise in #2777, #2812
Full Changelog: v2026.2.1...v2026.5.1
2026.2.1
Highlights
- Plugin version now also works in non-HTTPS contexts
- New header button for detaching from session without deleting it
- Selected Element panel now auto-hides if no element is selected
- New box model in Selected Element panel for easier retrieval of element position and size
- Integration with RabbitQA cloud provider
What's Changed
π New Features
- feat: add RabbitQA cloud provider support with logo and configuration by @TahaTangulu in #2628
- feat: add box model for Selected Element by @eglitise in #2636
- feat: add button to detach from session without termination by @eglitise in #2641
π¨ Design Changes
π Fixes
- fix: allow plugin usage in insecure contexts by @eglitise in #2607
- fix(session-builder): Add markDirty flag to SET_SERVER_PARAM to enable Save button only for user edits by @Semih702 in #2623
π Documentation
- docs: tune requirements by @eglitise in #2594
- chore: update LambdaTest to TestMu AI by @eglitise in #2609
- chore: refine TestMu AI logos and add refs by @Delta456 in #2624
- docs: match provider images in README to active theme by @eglitise in #2627
- chore: apply consistent cropping to all provider logos by @eglitise in #2632
- docs: update RabbitQA README link and add dark/light theme logo support by @TahaTangulu in #2633
- docs: update footer copyright by @eglitise in #2664
π Localization
π Other Changes
- chore: refactoring by @eglitise in #2634, #2635, #2640
- chore: fix Spin usage in antd 6.3.0 by @eglitise in #2647
- chore: improve logging when installing dev extensions by @eglitise in #2649
New Contributors
- @Semih702 made their first contribution in #2623
- @TahaTangulu made their first contribution in #2628
Full Changelog: v2026.1.3...v2026.2.1
2026.1.3
Highlights
- New button in MJPEG mode for fallback to screenshot API
- Styling changes: all new icons, better syntax highlighting, monospace font where appropriate
What's Changed
π New Features
- feat: switch syntax highlighting to react-refractor by @eglitise in #2567
- feat: add buttons to switch between MJPEG stream and screenshot API by @eglitise in #2565
π¨ Design Changes
- style: switch external icon source to Tabler by @eglitise in #2556
- style: use Tabler icons everywhere by @eglitise in #2559
- style: use monospace font where appropriate & update app source colors by @eglitise in #2574
- style: use monospace font in commands tab as well by @eglitise in #2585
π Fixes
- fix: update gesture import/export to match session import/export by @eglitise in #2553
- fix: adjust WDIO command overrides by @eglitise in #2572
π Documentation
- docs: update images by @eglitise in #2588
- docs: direct users away from browser version by @eglitise in #2590
π Localization
- chore: Update translations by @github-actions[bot] in #2569
π Other Changes
- chore: tune release notes generation by @eglitise in #2550
- chore: remove sample files by @eglitise in #2552
- chore: merge Root and index files by @eglitise in #2560
- chore: migrate to react-i18next useTranslation hook by @eglitise in #2563
- chore: rebuild lockfile by @eglitise in #2589
Full Changelog: v2026.1.2...v2026.1.3
2026.1.2
Highlights
- Support importing/exporting session files and language selection in the web/plugin version
- You can now also import multiple files at once
β οΈ Session files exported from this Inspector version CANNOT be imported in older versions (files exported from older versions CAN still be imported in this version)
- Faster element highlighting when hovering over screenshot
- Known issue: hovering over an element handle does not highlight the rest of the element box (clicking on it still applies the full highlight as expected)
- Locator improvements in web context
- Support element search using web locator strategies
- Add
id(css) and tag name based locators in suggested locators
What's Changed
π New Features
- feat: support element search using web locator strategies in web context by @eglitise in #2514
- feat: add 2 suggested locator strategies for web context by @eglitise in #2515
- feat: automatically detect port number when using the appium-inspector-plugin by @wswebcreation in #2521
- feat: move language selector to application settings by @eglitise in #2523
- feat: update .appiumsession file format by @eglitise in #2535
- feat: import/export sessions from Saved Capability Sets by @eglitise in #2543
π¨ Design Changes
- style: reduce empty space for gesture editor tick cards by @eglitise in #2471
- style: remove @ant-design/pro-components by @eglitise in #2484
- style: adjust search modal locator strategy buttons by @eglitise in #2513
- style: fix vertical align of app source tree expand icon by @eglitise in #2538
π Fixes
- fix: make caps editor behavior more deterministic by @eglitise in #2457
- fix: adjust element highlighters by @eglitise in #2490
- fix: unhide cloud provider for selected caps set if hidden by @eglitise in #2494
- fix: gesture circles not shown in Firefox/Safari by @eglitise in #2495
- fix: add command result type & remove extra quotes by @eglitise in #2506
- fix: redux state mutation error when loading session from URL query string by @sudharsan-selvaraj in #2529
π Localization
- chore: Update translations by @github-actions[bot] in #2441, #2453, #2478, #2516, #2524, #2531, #2546
π Other Changes
- chore: update ESLint configuration by @eglitise in #2462
- chore: replace moment with dayjs by @eglitise in #2473
- chore: replace axios with ky by @eglitise in #2481
- chore: upgrade to antd v6 by @eglitise in #2472, #2488, #2492, #2510
- chore: upgrade to React 19 by @eglitise in #2491, #2493
- chore: simplify Renovate config by @eglitise in #2496
- chore: decouple mocked xpath.select from its real usage by @eglitise in #2517
- chore: fix lint issues by @eglitise in #2542
Full Changelog: v2025.11.1...v2026.1.1
2025.11.1
Highlights
- Enhanced Commands tab
- Available commands are now retrieved directly from the driver and active plugins (requires Appium 2.16+)
- Add support for execute methods, which are also retrieved from the driver/plugins (requires Appium 2.16+)
- Improved presentation of results (adjust modal size, add functionality for copying, formatting, sorting, filtering)
- New header button for toggling automatic session restart upon device disconnect
- Integration with Fireflink DeviceFarm cloud provider
What's Changed
π¦ Platform Support
- β macOS: the minimum supported version is now macOS 12
π New Features
- feat: add Fireflink DeviceFarm cloud provider by @darshanyn04 in #2322
- feat: Improve Appium Inspector stability by handling USB/Wifi disconnection gracefully by @mohangowdak in #2328
- feat: improve command result UX by @wilhus & @eglitise in #2358
- feat: retrieve commands and execute methods from active extensions by @eglitise in #2414
π¨ Design Changes
π Fixes
- fix: resolve error when quitting session with existing source query by @eglitise in #2290
- fix: improve error message when no capabilities are provided by @eglitise in #2373
- fix: compatibility between new vendors and older capability sets by @eglitise in #2400
- fix: skip source/screenshot refresh upon opening session info tab by @eglitise in #2418
π Documentation
- docs: update minimum macOS version by @eglitise in #2297
- docs: add docs for reload on disconnect button by @eglitise in #2352
π Localization
π Other Changes
- chore: refactoring changes by @eglitise in #2310, #2311, #2312
- chore: disable reload on disconnect by default by @eglitise in #2360
- chore: refactor & parallelize refresh action by @eglitise in #2362
- refactor: compare with
undefineddirectly instead of usingtypeofby @noritaka1166 in #2366 - refactor: Make locator generation utils easier to read and understand by @mykola-mokhnach in #2393
- chore: add React hooks ESLint plugin & fix lint issues by @eglitise in #2408
- chore: improve performance via React Compiler by @eglitise in #2410
- chore: publish via trusted publisher by @KazuCocoa in #2424
New Contributors
- @darshanyn04 made their first contribution in #2322
- @mohangowdak made their first contribution in #2328
Full Changelog: v2025.8.2...v2025.11.1
2025.8.2
What's Changed
Bugfix release to address the issue where the plugin version could not be loaded.
π Fixes
- fix: adjust screenshot container size for small resolution DUTs by @eglitise in #2283
- fix: adjust plugin version Express paths by @eglitise in #2285
Full Changelog: v2025.8.1...v2025.8.2
2025.8.1
Highlights
- Integration with webmate cloud provider
- Ability to toggle capabilities on/off in the session builder for easier testing
- Ability to search the application source using plaintext
What's Changed
π¦ Platform Support
- β Plugin version only: drop compatibility with Appium 2 (this follows all other official Appium plugins)
π New Features
- feat: search app source by @wilhus in #2235
- feat: add webmate as a cloud provider by @dkalak in #2240
- feat: enable/disable capabilities by @wilhus in #2249
- feat: add button to collapse all Source tree nodes by @eglitise in #2267
π¨ Design Changes
π Fixes
- fix: adjust width for capability set title edit field by @eglitise in #2271
- fix: adjust recorder for element actions by @eglitise in #2272
π Documentation
- docs: update installation steps by @eglitise in #2262
- docs: update all images and add recent features by @eglitise in #2278
π Localization
- chore: Update translations by @github-actions[bot] in #2273
π Other Changes
- chore: update Renovate config by @eglitise in #2244
- chore: set plugin requirements to Appium 3 by @eglitise in #2258
- chore: move Session Inspector tab antd Card wrappers to tab-specific files by @eglitise in #2263
- chore: add style label support to autolabeler & release notes by @eglitise in #2266
New Contributors
Full Changelog: v2025.7.3...v2025.8.1
2025.7.3
What's Changed
Small release to adjust the desktop app icons - no changes in the browser/plugin versions.
π Fixes
- fix: set correct size for macOS icon by @eglitise in #2212
- fix: adjust Windows icon by @eglitise in #2214
Full Changelog: v2025.7.2...v2025.7.3