Updated readme (#17)

Author: rz-openai

README.md

@@ -6,14 +6,14 @@
 
 [![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
 
-Snap-O is a tidy and speedy macOS app that captures screenshots and screen recordings from Android devices and emulators.
+Snap-O is a fast, tidy macOS app for capturing screenshots and screen recordings from Android devices and emulators.
 
-It runs on macOS 15 or later and needs `adb` from the Android Platform Tools.
+It runs on macOS 15 or later and requires `adb` from the Android Platform Tools.
 
 ## Why build a screen capture tool?
 
-When you capture screens for teammates—or to drop into pull requests—lots of small paper
-cuts add up quickly. You might like Snap-O if you've ever wished you could:
+Taking screenshots for teammates or pull requests adds many small paper cuts.
+You might like Snap-O if you've ever wished you could:
 
 - Share screenshots and recordings without littering your disk with throwaway files
 - Preview a recording instantly without saving it first
@@ -26,7 +26,7 @@ I'm open-sourcing.
 ## Features
 
 - Shows a screenshot the moment the window opens
-- Records Android device screens with one command
+- Records Android device screens with a single command
 - Keeps your disk uncluttered by cleaning up after itself
 - Lets you drag and drop captures anywhere without saving them first
 - Supports multiple windows of captures at once
@@ -39,28 +39,30 @@ I'm open-sourcing.
 3. Enjoy the immediate screenshot
 4. `⌘R` to refresh the screenshot. `⇧⌘R` to start a screen recording.
 
-### ADB Selection
+### ADB Selection (optional)
 
-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.
+Snap-O talks to the ADB server directly without running `adb`.
 
-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.
+If the ADB server is not running, Snap-O asks you to pick your `adb` binary so it can restart the server for you.
+
+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.
 
 ### Drag and Drop
 
-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.
+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.
 
 ### Keyboard Shortcuts
 
-| Action                  | Shortcut |
-|-------------------------|----------|
-| New screenshot          | `⌘R`     |
-| Start recording         | `⇧⌘R`    |
-| Start live preview      | `⇧⌘L`    |
-| Stop recording/ preview | `⎋`      |
-| Save as                 | `⌘S`     |
-| Copy image to clipboard | `⌘C`     |
-| Previous device         | `⌘▲`     |
-| Next device             | `⌘▼`     |
+| Action                   | Shortcut |
+|--------------------------|----------|
+| New screenshot           | `⌘R`     |
+| Start recording          | `⇧⌘R`    |
+| Start live preview       | `⇧⌘L`    |
+| Stop recording / preview | `⎋`      |
+| Save as                  | `⌘S`     |
+| Copy image to clipboard  | `⌘C`     |
+| Previous device          | `⌘▲`     |
+| Next device              | `⌘▼`     |
 
 ### Android Studio External Tools
 
@@ -76,21 +78,21 @@ Use Android Studio’s External Tools to trigger Snap-O directly from the IDE.
 
 Running these tools launches Snap-O (or brings it to the foreground) and immediately starts a capture or recording.
 
+There is currently no support for choosing a specific device/emulator when starting Snap-O in this way.
+
 ## Why not Compose Multiplatform?
 
-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.
+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.
 
 ## Alternatives
 
-Snap-O doesn't support interactions in its Live Preview mode, yet.
+Snap-O currently has only basic "Live Preview" support.
 
-For a more fully-featured live preview, take a look at [scrcpy](https://github.com/Genymobile/scrcpy).
+For a more feature-rich live preview, take a look at [scrcpy](https://github.com/Genymobile/scrcpy).
 
 ## Project status
 
-Snap-O is a small side project maintained when time and curiosity allow. If it
-works for you: fantastic! If it doesn't, please feel free to open an issue or
-fork it to taste.
+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.
 
 ## Building from source
 
@@ -106,7 +108,7 @@ If you need to notarize the app yourself:
 
 1. Copy `Config/Signing.xcconfig.sample` → `Config/Signing.xcconfig`.
 2. Edit the new file with your Apple Developer Team ID and signing certificate name.
-3. Archive (⌘B) or upload as usual. The file is ignored by Git so your credentials remain private.
+3. Archive (⌘B) or upload as usual. The file is ignored by Git, so your credentials remain private.
 
 ## Community