adb-scrollshot 0.1.0__tar.gz

adb_scrollshot-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,28 @@
+name: Checks
+on:
+  push:
+  pull_request:
+permissions:
+  contents: read
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python: ['3.11', '3.14']
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+        with:
+          python-version: ${{ matrix.python }}
+      - run: uv sync --locked
+      - run: uv run ruff check .
+      - run: uv run ruff format --check .
+      - run: uv run pytest
+      - run: uv run adb-scrollshot --help
+      - run: uv build
+      - run: uv run python scripts/package_release.py
+      - uses: actions/upload-artifact@v4
+        with:
+          name: adb-scrollshot-python-${{ matrix.python }}
+          path: dist/

adb_scrollshot-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,45 @@
+name: Publish to PyPI
+on:
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: pypi-publish
+  cancel-in-progress: false
+jobs:
+  build:
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@v6
+        with:
+          python-version: '3.14'
+      - run: uv sync --locked
+      - run: uv run ruff check .
+      - run: uv run ruff format --check .
+      - run: uv run pytest
+      - run: uv build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: pypi-distributions
+          path: |
+            dist/*.whl
+            dist/*.tar.gz
+          if-no-files-found: error
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/adb-scrollshot
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: pypi-distributions
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

adb_scrollshot-0.1.0/.gitignore

@@ -0,0 +1,37 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Tool caches
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+.DS_Store
+
+# Local credentials and settings
+.env
+.env.*
+!.env.example
+.idea/
+.vscode/
+
+# Captures may contain private phone content; never ship these.
+captures/
+*_frames/
+*_pages/
+*.png
+*.jpg
+*.jpeg
+*.webp
+*.mkv
+*.mp4
+*.mov
+*.zip

adb_scrollshot-0.1.0/.python-version

@@ -0,0 +1 @@
+3.14

adb_scrollshot-0.1.0/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## 0.1.0
+
+- Add public Python functions for lossless screenshot capture, offline stitching,
+  and full-resolution page export, with device-free regression tests.
+- Prepare a manually triggered PyPI Trusted Publishing workflow and setup guide.
+- Support importing the library from the checkout alongside the legacy launcher.
+- Package automatic ADB scrolling screenshots as the `adb-scrollshot` command.
+- Separate device access, region selection, matching, and image export modules.
+- Preserve native-resolution PNG output and optional full-resolution page export.
+- Keep the original Python launcher for compatibility.
+- Save captured progress on device-command failure during scrolling.
+- Add locked dependencies, device-free regression tests, CI, and source delivery tooling.
+- Exclude screen captures, recordings, local settings, and caches from Git and releases.

adb_scrollshot-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vishal Nagda
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

adb_scrollshot-0.1.0/PKG-INFO

@@ -0,0 +1,204 @@
+Metadata-Version: 2.5
+Name: adb-scrollshot
+Version: 0.1.0
+Summary: Lossless Android scrolling screenshots with automatic capture and overlap removal
+Project-URL: Repository, https://github.com/vishalnagda1/adb-scrollshot
+Project-URL: Documentation, https://github.com/vishalnagda1/adb-scrollshot/blob/main/README.md
+License-Expression: MIT
+License-File: LICENSE
+Keywords: adb,android,image-stitching,screenshot,scrolling
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Multimedia :: Graphics :: Capture :: Screen Capture
+Requires-Python: >=3.11
+Requires-Dist: numpy<3,>=2
+Requires-Dist: opencv-python<6,>=4.10
+Description-Content-Type: text/markdown
+
+# ADB Scrollshot
+
+Capture a sharp, continuous scrolling screenshot from an Android phone. The
+command automatically swipes, captures lossless PNG screenshots, removes
+matching overlap, and stops when the selected content stops moving.
+
+The final image keeps the original captured pixel resolution. Optional shorter
+PNG pages make long captures easier to view and share.
+
+## Requirements
+
+- Python 3.11 or newer and [uv](https://docs.astral.sh/uv/).
+- Android Platform Tools (`adb`) on your PATH.
+- An unlocked Android phone with USB debugging enabled and this computer authorized.
+- A desktop session for interactive area selection; use `--roi` otherwise.
+
+On macOS, install ADB with `brew install android-platform-tools`. On other
+platforms, install Android Platform Tools and add it to PATH. Confirm that
+`adb devices` lists your phone with the state `device`, not `unauthorized`.
+`adb` is a separate system prerequisite and is not included in this package.
+
+## Install from PyPI
+
+```sh
+python -m pip install adb-scrollshot
+adb-scrollshot --select --keep-frames --tile-height 3120 --output captures/high_quality.png
+```
+
+For an isolated command-line installation, use `uv tool install adb-scrollshot`.
+For Python programs, install into your project's virtual environment and import
+`adb_scrollshot`. Python 3.11 or newer is required.
+
+## Quick start
+
+From this project directory:
+
+```sh
+uv sync --locked
+uv run adb-scrollshot --select --keep-frames --tile-height 3120 --output captures/high_quality.png
+```
+
+1. Open the desired page on your phone and return to its top.
+2. Run the command. Draw a rectangle around **only the scrolling content**,
+   excluding fixed toolbars, status bars, navigation bars, and sticky headers.
+3. Press **Enter**. Leave the phone untouched while it scrolls and captures.
+4. Find `captures/high_quality.png`, its original screenshots in
+   `captures/high_quality_frames/`, and shorter PNGs in `captures/high_quality_pages/`.
+
+`scrcpy` is optional; it can mirror the phone while ADB captures directly.
+Without `--output`, the destination is `captures/long_screenshot.png`.
+Use a fresh output name for each run; existing output files may be overwritten.
+Use a fresh name especially with frame/page export to avoid leftover files
+from a previous, longer capture.
+
+The original launcher still works:
+
+```sh
+uv run python adb_scrollshot.py --select --keep-frames --tile-height 3120
+```
+
+You can also use `uv run python -m adb_scrollshot --help`.
+
+## Common options
+
+Run `uv run adb-scrollshot --help` for all options.
+
+| Option | Purpose |
+| --- | --- |
+| `--select` | Draw the scrolling area; this is the default selection mode. |
+| `--roi 0,250,1440,2500` | Specify x, y, width, height in source screenshot pixels. |
+| `--whole-screen` | Use only if the entire screen scrolls without fixed UI. |
+| `--serial DEVICE_ID` | Choose one device when several are connected. |
+| `--keep-frames` | Keep original PNGs for inspection or troubleshooting. |
+| `--tile-height 3120` | Also export native-resolution sections, at most 3120 pixels tall. |
+| `--pause 1.5` | Wait longer for rendering after each swipe. |
+| `--swipe-duration 900` | Make the upward swipe slower, in milliseconds. |
+| `--max-swipes 80` | Raise the safety limit; the default is 45. |
+| `--layout full-first` | Preserve the entire initial screen, including its footer, before appended content. |
+
+The default `continuous` layout places the initial fixed header at the top and
+its fixed footer at the end. When the selected region is narrower than the
+screen, appended side margins are copied from the first screenshot; select the
+full content width to avoid repeating unrelated side content.
+
+## Quality and limits
+
+View the PNG at **Actual Size / 100%** in your image viewer. Fitting a very tall
+image into a window can make sharp text appear blurry. Some messaging apps
+also shrink images; send the PNG as a file or share the shorter pages.
+
+The area-selection preview is reduced for convenience, but the saved content
+is not resized. PNG compression is lossless. Upscaling or recording at a higher
+video bitrate cannot add detail missing from the source screenshots.
+
+Overlap matching assumes vertically translating, static content. Animations,
+video, sticky elements inside the selection, repeated patterns, or app layout
+changes can prevent reliable matching. The tool stops and saves a partial PNG
+when it cannot match safely. Page boundaries may cut through a line of text;
+the continuous PNG remains available. Very long captures consume memory.
+
+- **Ctrl+C:** saves progress captured so far.
+- **Connection loss during scrolling:** attempts to save progress and exits with code 2.
+- **Exit 0:** normal end, user interruption, or swipe limit reached; read the
+  terminal message to see whether the bottom was actually detected.
+- **Exit 1:** setup or output error; **exit 2:** invalid arguments or a partial
+  capture caused by unreliable matching, display changes, or connection failure.
+
+No image is uploaded by this application. Captures can contain private screen
+content; they and recordings are excluded from Git and release archives.
+
+## Development
+
+```sh
+uv sync --locked
+uv run pytest
+uv run ruff check .
+uv run ruff format --check .
+uv build
+uv run python scripts/package_release.py
+```
+
+The lockfile pins dependencies. CI checks Python 3.11 and 3.14 on Linux and builds
+artifacts. The automated tests use synthetic screenshots and simulated ADB;
+physical-device behavior still needs a manual smoke test.
+
+```text
+src/adb_scrollshot/
+  adb.py          Device discovery, commands, and lossless screen capture
+  cli.py          Argument parsing and automatic capture loop
+  images.py       PNG composition and page export
+  matching.py     Overlap matching and end detection
+  selection.py    Interactive region selection and validation
+  __main__.py     Python module entry point
+tests/            Device-free regression tests
+scripts/          Source-delivery ZIP builder
+docs/             Delivery, installation, and manual validation guide
+.github/workflows/ci.yml
+```
+
+See [docs/DELIVERY.md](docs/DELIVERY.md) for installation from a wheel, release
+contents, a manual acceptance checklist, and Git handoff commands.
+
+## Use as a Python library
+
+Install with `python -m pip install adb-scrollshot` and import `adb_scrollshot`.
+You can also install the supplied wheel with
+`python -m pip install ./dist/adb_scrollshot-0.1.0-py3-none-any.whl`, or run these
+examples inside this checkout with `uv run python`.
+
+Capture a single lossless screen, without scrolling:
+
+```python
+from adb_scrollshot import capture_screenshot
+
+image = capture_screenshot("captures/screen.png")
+print(image.shape)  # (height, width, 3), uint8 BGR pixels
+```
+
+Stitch screenshots captured in top-to-bottom order (each must overlap the last):
+
+```python
+import cv2
+from adb_scrollshot import export_pages, stitch_screenshots
+
+frames = [cv2.imread(path) for path in ["screen1.png", "screen2.png", "screen3.png"]]
+output = stitch_screenshots(
+    frames,
+    "captures/stitched.png",
+    roi=(0, 250, 1440, 2500),  # adapt to your screenshots; exclude fixed UI
+)
+pages = export_pages(cv2.imread(str(output)), output, tile_height=3120)
+```
+
+`stitch_screenshots` accepts an iterable of OpenCV BGR arrays, skips unchanged
+captures, and raises `ValueError` on invalid input or unreliable overlap. It
+writes only after all frames have been accepted. `capture_screenshot` raises
+`RuntimeError` for ADB errors; filesystem errors propagate as `OSError`.
+For automatic scrolling, use the `adb-scrollshot` CLI. ADB is required for live
+capture, but not for stitching existing frames or exporting pages.
+
+Public PyPI publishing is configured separately. See
+[docs/PUBLISHING.md](docs/PUBLISHING.md) for the one-time account setup and release procedure.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

adb_scrollshot-0.1.0/README.md

@@ -0,0 +1,186 @@
+# ADB Scrollshot
+
+Capture a sharp, continuous scrolling screenshot from an Android phone. The
+command automatically swipes, captures lossless PNG screenshots, removes
+matching overlap, and stops when the selected content stops moving.
+
+The final image keeps the original captured pixel resolution. Optional shorter
+PNG pages make long captures easier to view and share.
+
+## Requirements
+
+- Python 3.11 or newer and [uv](https://docs.astral.sh/uv/).
+- Android Platform Tools (`adb`) on your PATH.
+- An unlocked Android phone with USB debugging enabled and this computer authorized.
+- A desktop session for interactive area selection; use `--roi` otherwise.
+
+On macOS, install ADB with `brew install android-platform-tools`. On other
+platforms, install Android Platform Tools and add it to PATH. Confirm that
+`adb devices` lists your phone with the state `device`, not `unauthorized`.
+`adb` is a separate system prerequisite and is not included in this package.
+
+## Install from PyPI
+
+```sh
+python -m pip install adb-scrollshot
+adb-scrollshot --select --keep-frames --tile-height 3120 --output captures/high_quality.png
+```
+
+For an isolated command-line installation, use `uv tool install adb-scrollshot`.
+For Python programs, install into your project's virtual environment and import
+`adb_scrollshot`. Python 3.11 or newer is required.
+
+## Quick start
+
+From this project directory:
+
+```sh
+uv sync --locked
+uv run adb-scrollshot --select --keep-frames --tile-height 3120 --output captures/high_quality.png
+```
+
+1. Open the desired page on your phone and return to its top.
+2. Run the command. Draw a rectangle around **only the scrolling content**,
+   excluding fixed toolbars, status bars, navigation bars, and sticky headers.
+3. Press **Enter**. Leave the phone untouched while it scrolls and captures.
+4. Find `captures/high_quality.png`, its original screenshots in
+   `captures/high_quality_frames/`, and shorter PNGs in `captures/high_quality_pages/`.
+
+`scrcpy` is optional; it can mirror the phone while ADB captures directly.
+Without `--output`, the destination is `captures/long_screenshot.png`.
+Use a fresh output name for each run; existing output files may be overwritten.
+Use a fresh name especially with frame/page export to avoid leftover files
+from a previous, longer capture.
+
+The original launcher still works:
+
+```sh
+uv run python adb_scrollshot.py --select --keep-frames --tile-height 3120
+```
+
+You can also use `uv run python -m adb_scrollshot --help`.
+
+## Common options
+
+Run `uv run adb-scrollshot --help` for all options.
+
+| Option | Purpose |
+| --- | --- |
+| `--select` | Draw the scrolling area; this is the default selection mode. |
+| `--roi 0,250,1440,2500` | Specify x, y, width, height in source screenshot pixels. |
+| `--whole-screen` | Use only if the entire screen scrolls without fixed UI. |
+| `--serial DEVICE_ID` | Choose one device when several are connected. |
+| `--keep-frames` | Keep original PNGs for inspection or troubleshooting. |
+| `--tile-height 3120` | Also export native-resolution sections, at most 3120 pixels tall. |
+| `--pause 1.5` | Wait longer for rendering after each swipe. |
+| `--swipe-duration 900` | Make the upward swipe slower, in milliseconds. |
+| `--max-swipes 80` | Raise the safety limit; the default is 45. |
+| `--layout full-first` | Preserve the entire initial screen, including its footer, before appended content. |
+
+The default `continuous` layout places the initial fixed header at the top and
+its fixed footer at the end. When the selected region is narrower than the
+screen, appended side margins are copied from the first screenshot; select the
+full content width to avoid repeating unrelated side content.
+
+## Quality and limits
+
+View the PNG at **Actual Size / 100%** in your image viewer. Fitting a very tall
+image into a window can make sharp text appear blurry. Some messaging apps
+also shrink images; send the PNG as a file or share the shorter pages.
+
+The area-selection preview is reduced for convenience, but the saved content
+is not resized. PNG compression is lossless. Upscaling or recording at a higher
+video bitrate cannot add detail missing from the source screenshots.
+
+Overlap matching assumes vertically translating, static content. Animations,
+video, sticky elements inside the selection, repeated patterns, or app layout
+changes can prevent reliable matching. The tool stops and saves a partial PNG
+when it cannot match safely. Page boundaries may cut through a line of text;
+the continuous PNG remains available. Very long captures consume memory.
+
+- **Ctrl+C:** saves progress captured so far.
+- **Connection loss during scrolling:** attempts to save progress and exits with code 2.
+- **Exit 0:** normal end, user interruption, or swipe limit reached; read the
+  terminal message to see whether the bottom was actually detected.
+- **Exit 1:** setup or output error; **exit 2:** invalid arguments or a partial
+  capture caused by unreliable matching, display changes, or connection failure.
+
+No image is uploaded by this application. Captures can contain private screen
+content; they and recordings are excluded from Git and release archives.
+
+## Development
+
+```sh
+uv sync --locked
+uv run pytest
+uv run ruff check .
+uv run ruff format --check .
+uv build
+uv run python scripts/package_release.py
+```
+
+The lockfile pins dependencies. CI checks Python 3.11 and 3.14 on Linux and builds
+artifacts. The automated tests use synthetic screenshots and simulated ADB;
+physical-device behavior still needs a manual smoke test.
+
+```text
+src/adb_scrollshot/
+  adb.py          Device discovery, commands, and lossless screen capture
+  cli.py          Argument parsing and automatic capture loop
+  images.py       PNG composition and page export
+  matching.py     Overlap matching and end detection
+  selection.py    Interactive region selection and validation
+  __main__.py     Python module entry point
+tests/            Device-free regression tests
+scripts/          Source-delivery ZIP builder
+docs/             Delivery, installation, and manual validation guide
+.github/workflows/ci.yml
+```
+
+See [docs/DELIVERY.md](docs/DELIVERY.md) for installation from a wheel, release
+contents, a manual acceptance checklist, and Git handoff commands.
+
+## Use as a Python library
+
+Install with `python -m pip install adb-scrollshot` and import `adb_scrollshot`.
+You can also install the supplied wheel with
+`python -m pip install ./dist/adb_scrollshot-0.1.0-py3-none-any.whl`, or run these
+examples inside this checkout with `uv run python`.
+
+Capture a single lossless screen, without scrolling:
+
+```python
+from adb_scrollshot import capture_screenshot
+
+image = capture_screenshot("captures/screen.png")
+print(image.shape)  # (height, width, 3), uint8 BGR pixels
+```
+
+Stitch screenshots captured in top-to-bottom order (each must overlap the last):
+
+```python
+import cv2
+from adb_scrollshot import export_pages, stitch_screenshots
+
+frames = [cv2.imread(path) for path in ["screen1.png", "screen2.png", "screen3.png"]]
+output = stitch_screenshots(
+    frames,
+    "captures/stitched.png",
+    roi=(0, 250, 1440, 2500),  # adapt to your screenshots; exclude fixed UI
+)
+pages = export_pages(cv2.imread(str(output)), output, tile_height=3120)
+```
+
+`stitch_screenshots` accepts an iterable of OpenCV BGR arrays, skips unchanged
+captures, and raises `ValueError` on invalid input or unreliable overlap. It
+writes only after all frames have been accepted. `capture_screenshot` raises
+`RuntimeError` for ADB errors; filesystem errors propagate as `OSError`.
+For automatic scrolling, use the `adb-scrollshot` CLI. ADB is required for live
+capture, but not for stitching existing frames or exporting pages.
+
+Public PyPI publishing is configured separately. See
+[docs/PUBLISHING.md](docs/PUBLISHING.md) for the one-time account setup and release procedure.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

adb_scrollshot-0.1.0/adb_scrollshot.py

@@ -0,0 +1,26 @@
+#!/usr/bin/env python3
+"""Compatibility launcher; preferred usage: uv run adb-scrollshot --select."""
+
+import importlib.util
+import sys
+from pathlib import Path
+
+source = Path(__file__).resolve().parent / "src"
+
+if __name__ == "__main__":
+    # Keep the original direct-script command working from a source release.
+    sys.path.insert(0, str(source))
+    from adb_scrollshot.cli import entrypoint
+
+    raise SystemExit(entrypoint())
+else:
+    # A checkout-level launcher must not mask the importable src package.
+    spec = importlib.util.spec_from_file_location(
+        __name__,
+        source / "adb_scrollshot" / "__init__.py",
+        submodule_search_locations=[str(source / "adb_scrollshot")],
+    )
+    assert spec is not None and spec.loader is not None
+    package = importlib.util.module_from_spec(spec)
+    sys.modules[__name__] = package
+    spec.loader.exec_module(package)

adb_scrollshot-0.1.0/docs/DELIVERY.md

@@ -0,0 +1,78 @@
+# Delivery and handoff
+
+## Build
+
+From a checkout or extracted source ZIP:
+
+```sh
+uv sync --locked
+uv run ruff check .
+uv run ruff format --check .
+uv run pytest
+uv build
+uv run python scripts/package_release.py
+```
+
+`dist/` contains an installable wheel, a source distribution (`.tar.gz`), a
+source-project ZIP, and its SHA256 checksum. The ZIP includes source, tests,
+CI configuration, documentation, and the lockfile. It excludes screenshots,
+recordings, credentials, virtual environments, caches, and Git history.
+
+These are Python deliverables, not a standalone macOS app. Recipients need
+Python, ADB, and a phone with USB debugging authorized. Installing Python
+packages may require network access. The wheel includes the CLI and runtime
+package; tests and development tools are in the source deliverables.
+
+## Install the wheel
+
+```sh
+uv tool install ./adb_scrollshot-0.1.0-py3-none-any.whl
+adb-scrollshot --help
+adb-scrollshot --select --keep-frames --tile-height 3120 --output captures/result.png
+```
+
+Use the wheel's actual location, for example `./dist/adb_scrollshot-0.1.0-py3-none-any.whl`
+when installing from the checkout. If the command is not on PATH after tool
+installation, follow uv's PATH instructions or run `uv tool update-shell` and
+open a new terminal.
+
+Alternatively, unzip the source release, change into its directory, and use
+`uv sync --locked` followed by `uv run adb-scrollshot ...`.
+
+## Manual acceptance checklist
+
+1. Confirm `adb devices` reports an authorized device.
+2. Open a static page at its top and select only the scrolling viewport.
+3. Capture several screens with `--keep-frames --tile-height 3120`.
+4. Confirm headers/footers appear as intended, joins have no missing or repeated
+   content, and the final PNG width matches the original frame width.
+5. Inspect text at Actual Size; confirm shorter pages retain the same detail.
+6. Confirm the terminal reports bottom detection rather than a safety-limit stop.
+7. On a disposable capture, press Ctrl+C and verify progress is saved.
+
+Automated tests verify native-pixel overlap, lossless PNG round trips, device
+selection errors, automatic end detection, and saving progress on interruption,
+connection loss, or failed matching. They do not establish compatibility with
+every app or physical phone. Linux CI is configured but must run on the hosting
+service after push; macOS is the local development environment.
+
+## Git handoff
+
+The repository is initialized locally. Review and create your initial commit:
+
+```sh
+git status --short
+git add .gitignore .python-version pyproject.toml uv.lock README.md CHANGELOG.md adb_scrollshot.py src tests scripts docs .github
+git diff --cached --stat
+git commit -m "Package ADB Scrollshot with CLI, tests, and delivery tooling"
+```
+
+After creating a remote repository under your account, add its URL and push:
+
+```sh
+git remote add origin YOUR_REPOSITORY_URL
+git push -u origin main
+```
+
+The project uses the MIT license, with copyright attributed to Vishal Nagda.
+See [PUBLISHING.md](PUBLISHING.md) for public PyPI release instructions.