# :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.