Skip to content

[codex] Add scrcpy Android connection guide#22

Merged
anthonyrussano merged 1 commit into
mainfrom
codex/scrcpy-android-connection-guide
Jun 28, 2026
Merged

[codex] Add scrcpy Android connection guide#22
anthonyrussano merged 1 commit into
mainfrom
codex/scrcpy-android-connection-guide

Conversation

@anthonyrussano

Copy link
Copy Markdown
Member

What changed

  • Added a Linux runbook for building scrcpy 4.0 from a local checkout with the verified prebuilt Android server.
  • Documented USB authorization and launch steps, Android wireless-debugging pairing, explicit transport selection, and cleanup.
  • Added troubleshooting for USB resets, stale ADB state, client/server version mismatches, VPN routing, multiple transports, and harmless Wayland icon warnings.
  • Used placeholders instead of the tested phone's real serial number and private LAN endpoint.

Why

The guide preserves a successfully tested Pixel connection workflow so it can be repeated without reconstructing build, ADB, and transport details from terminal history.

Impact

Readers can reproduce the local scrcpy build and connect through either USB or Wi-Fi debugging, including recovery from the failures observed during the original session.

Validation

  • Parsed front matter with the site's hexo-front-matter dependency.
  • Rendered the article with the site's Markdown renderer dependency, including the troubleshooting table.
  • Completed a fresh Meson/Ninja scrcpy build using the article's documented options.
  • Verified the resulting Android server SHA-256: 84924bd564a1eb6089c872c7521f968058977f91f5ff02514a8c74aff3210f3a.
  • Ran git diff --cached --check before committing.

@anthonyrussano anthonyrussano marked this pull request as ready for review June 28, 2026 23:37
Copilot AI review requested due to automatic review settings June 28, 2026 23:37
@anthonyrussano anthonyrussano merged commit f0ad811 into main Jun 28, 2026

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new runbook-style article documenting a reproducible workflow for building scrcpy v4.0 from a local Linux checkout while using the verified prebuilt Android server, and connecting to an Android device via USB or Wireless debugging (with troubleshooting and cleanup guidance).

Changes:

  • Introduces end-to-end build steps (Meson/Ninja) and server download + SHA-256 verification for scrcpy v4.0.
  • Documents USB connection, Wireless debugging pairing/connection, explicit transport selection, and disconnect/cleanup steps.
  • Adds a troubleshooting table covering common ADB/scrcpy failure modes (USB resets, stale ADB state, version mismatches, VPN/local routing, multi-transport ambiguity).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants