You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Snap-O is a tidy and speedy macOS app that captures screenshots and screen recordings from Android devices and emulators.
9
+
Snap-O is a fast, tidy macOS app for capturing screenshots and screen recordings from Android devices and emulators.
10
10
11
-
It runs on macOS 15 or later and needs`adb` from the Android Platform Tools.
11
+
It runs on macOS 15 or later and requires`adb` from the Android Platform Tools.
12
12
13
13
## Why build a screen capture tool?
14
14
15
-
When you capture screens for teammates—or to drop into pull requests—lots of small paper
16
-
cuts add up quickly. You might like Snap-O if you've ever wished you could:
15
+
Taking screenshots for teammatesor pull requests adds many small paper cuts.
16
+
You might like Snap-O if you've ever wished you could:
17
17
18
18
- Share screenshots and recordings without littering your disk with throwaway files
19
19
- Preview a recording instantly without saving it first
@@ -26,7 +26,7 @@ I'm open-sourcing.
26
26
## Features
27
27
28
28
- Shows a screenshot the moment the window opens
29
-
- Records Android device screens with one command
29
+
- Records Android device screens with a single command
30
30
- Keeps your disk uncluttered by cleaning up after itself
31
31
- Lets you drag and drop captures anywhere without saving them first
32
32
- Supports multiple windows of captures at once
@@ -39,28 +39,30 @@ I'm open-sourcing.
39
39
3. Enjoy the immediate screenshot
40
40
4.`⌘R` to refresh the screenshot. `⇧⌘R` to start a screen recording.
41
41
42
-
### ADB Selection
42
+
### ADB Selection (optional)
43
43
44
-
The first time you run Snap-O you will need to tell it where `adb` lives. Snap‑O does not ship with the Android Platform Tools and it will prompt you to choose your installed `adb` binary.
44
+
Snap-O talks to the ADB server directly without running `adb`.
45
45
46
-
Note: Snap‑O uses the macOS Hardened Runtime. It executes the `adb` binary you select; always choose a trusted `adb` from the official Android Platform Tools.
46
+
If the ADB server is not running, Snap-O asks you to pick your `adb` binary so it can restart the server for you.
47
+
48
+
Note: Snap‑O uses the macOS Hardened Runtime. It will run the `adb` binary you select, so always choose a trusted `adb` from the official Android Platform Tools.
47
49
48
50
### Drag and Drop
49
51
50
-
After capturing a screenshot or screen recording, drag and drop works without saving the file first. Drop the capture straight into a GitHub pull request, Slack message, or any app that accepts images and video.
52
+
After you capture a screenshot or screen recording, you can drag and drop it without saving first. Drop the capture straight into a GitHub pull request, a Slack message, or any app that accepts images and video.
51
53
52
54
### Keyboard Shortcuts
53
55
54
-
| Action | Shortcut |
55
-
|-------------------------|----------|
56
-
| New screenshot |`⌘R`|
57
-
| Start recording |`⇧⌘R`|
58
-
| Start live preview |`⇧⌘L`|
59
-
| Stop recording/ preview |`⎋`|
60
-
| Save as |`⌘S`|
61
-
| Copy image to clipboard |`⌘C`|
62
-
| Previous device |`⌘▲`|
63
-
| Next device |`⌘▼`|
56
+
| Action | Shortcut |
57
+
|--------------------------|----------|
58
+
| New screenshot |`⌘R`|
59
+
| Start recording |`⇧⌘R`|
60
+
| Start live preview |`⇧⌘L`|
61
+
| Stop recording/ preview |`⎋`|
62
+
| Save as |`⌘S`|
63
+
| Copy image to clipboard |`⌘C`|
64
+
| Previous device |`⌘▲`|
65
+
| Next device |`⌘▼`|
64
66
65
67
### Android Studio External Tools
66
68
@@ -76,21 +78,21 @@ Use Android Studio’s External Tools to trigger Snap-O directly from the IDE.
76
78
77
79
Running these tools launches Snap-O (or brings it to the foreground) and immediately starts a capture or recording.
78
80
81
+
There is currently no support for choosing a specific device/emulator when starting Snap-O in this way.
82
+
79
83
## Why not Compose Multiplatform?
80
84
81
-
Snap-O relies on AVKit because it is the most polished video player to embed on macOS and it keeps the download size small. VLC-based playback felt clunky and the viewing experience suffered. When Compose Multiplatform gains a path to the native player with the same quality, this robot will happily reconsider the architecture.
85
+
Snap-O uses AVKit because it gives a polished video player on macOS and keeps the download small. VLC-based playback felt clunky and the viewing experience suffered. When Compose Multiplatform lets us use a native player with the same quality, we'll revisit the design.
82
86
83
87
## Alternatives
84
88
85
-
Snap-O doesn't support interactions in its Live Preview mode, yet.
89
+
Snap-O currently has only basic "Live Preview" support.
86
90
87
-
For a more fully-featured live preview, take a look at [scrcpy](https://github.com/Genymobile/scrcpy).
91
+
For a more feature-rich live preview, take a look at [scrcpy](https://github.com/Genymobile/scrcpy).
88
92
89
93
## Project status
90
94
91
-
Snap-O is a small side project maintained when time and curiosity allow. If it
92
-
works for you: fantastic! If it doesn't, please feel free to open an issue or
93
-
fork it to taste.
95
+
Snap-O is a small side project kept alive when time allows. If it works for you, great! If it doesn't, feel free to open an issue or fork it to fit your needs.
94
96
95
97
## Building from source
96
98
@@ -106,7 +108,7 @@ If you need to notarize the app yourself:
0 commit comments