# @ferocia-oss/osnap

> A CLI for grabbing ios/android screenshots and saving to your clipboard or filesystem.

Latest version **1.3.7** (published 2026-08-25) · MIT license · 0 weekly downloads

## Install

```sh
npm install @ferocia-oss/osnap
pnpm add @ferocia-oss/osnap
yarn add @ferocia-oss/osnap
bun add @ferocia-oss/osnap
```

Provides the commands `0`, `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`.

## Health

**Score 60/100 (C)** — status: active.

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

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 1.3.7 |
| Published | 2026-08-25 |
| First published | 2022-12-13 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | >=22 |
| Dependencies | 4 |
| Unpacked size | 23.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Maintainers | azz, nick-f |
| Keywords | ios, android, screenshot |

## Links

- npm: https://www.npmjs.com/package/@ferocia-oss/osnap
- Repository: https://github.com/ferocia/osnap
- npm.io page: https://npm.io/package/@ferocia-oss/osnap

## Dependencies (4)

- [execa](https://npm.io/package/execa.md) ^10.0.1
- [which](https://npm.io/package/which.md) ^7.0.0
- [minimist](https://npm.io/package/minimist.md) ^1.2.7
- [tempfile](https://npm.io/package/tempfile.md) ^6.0.1

## Alternatives

- [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads
- [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads
- [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads
- [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads
- [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads

## Recent versions

- 1.3.7 (latest) — 2026-08-25
- 1.3.6 — 2026-08-25
- 1.3.5 — 2023-04-06
- 1.3.4 — 2023-04-06
- 1.3.2 — 2023-04-04
- 1.3.1 — 2023-03-21
- 1.3.0 — 2022-12-13
- 1.2.1 — 2022-12-13
- 1.2.0 — 2022-12-13

## README

# :camera: osnap

A CLI for grabbing iOS/Android screenshots and saving to your clipboard or filesystem.

![Demo](https://raw.githubusercontent.com/ferocia/osnap/main/osnap-demo.gif)

## :writing_hand: Usage

```sh
osnap [ios|android] [-f filename.png] [-d device_id]
```

:apple: With iOS

```sh
osnap ios
osnap ios -f sweet.png
```

:robot: With Android

```sh
osnap android
osnap android -f cool.png
osnap android -f omg.png -d emulator-5554
```

## :golfing_woman: Installing

```sh
npm i -g osnap
```

## :baby_bottle: Requirements

- MacOS 26.6
- Node 22 and up
- Either Android or Xcode toolchains

These are the currently tested versions. This may work in older versions.

## :star2: Inspired By

- <http://www.alecjacobson.com/weblog/?p=3816>
- <https://gist.github.com/mwender/49609a18be41b45b2ae4>

## :policeman: License

MIT

## :dizzy: Change Log

See the [Releases](https://github.com/ferocia/osnap/releases) section.

---
_Source: https://npm.io/package/@ferocia-oss/osnap · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._