{"id":50938152,"url":"https://github.com/ovitrif/awb","last_synced_at":"2026-06-17T11:04:03.441Z","repository":{"id":356184398,"uuid":"1231423082","full_name":"ovitrif/awb","owner":"ovitrif","description":"Android Wireless Bridge for interactive debug pairing and screen mirroring on macOS","archived":false,"fork":false,"pushed_at":"2026-06-15T14:03:59.000Z","size":1111,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-15T14:08:03.063Z","etag":null,"topics":["android","bridge","debug","mirroring","pairing","wifi"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ovitrif.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-07T00:24:25.000Z","updated_at":"2026-06-15T09:23:26.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ovitrif/awb","commit_stats":null,"previous_names":["ovitrif/airdroid","ovitrif/airadb","ovitrif/awb"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/ovitrif/awb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovitrif%2Fawb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovitrif%2Fawb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovitrif%2Fawb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovitrif%2Fawb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ovitrif","download_url":"https://codeload.github.com/ovitrif/awb/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ovitrif%2Fawb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34445186,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-17T02:00:05.408Z","response_time":127,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","bridge","debug","mirroring","pairing","wifi"],"created_at":"2026-06-17T11:04:02.665Z","updated_at":"2026-06-17T11:04:03.426Z","avatar_url":"https://github.com/ovitrif.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# awb\n\nAndroid Wireless Bridge for macOS: pair, connect, and mirror Android phones over Wi-Fi\nwithout remembering a single `adb` command.\n\nawb wraps Android's wireless debugging flow behind a QR code. Scan it with your phone and\nawb handles mDNS discovery, `adb pair`, `adb connect`, and reconnects, then launches\n[scrcpy](https://github.com/Genymobile/scrcpy) screen mirroring if you want it. It ships as\ntwo small native binaries: the `awb` CLI and a menu bar app.\n\n## Install\n\n```sh\ncurl -fsSL https://github.com/ovitrif/awb/releases/latest/download/install.sh | sh\n```\n\nPin a release or choose the install directory:\n\n```sh\ncurl -fsSL https://github.com/ovitrif/awb/releases/latest/download/install.sh | \\\n  AWB_INSTALL_TAG=v2.0.0 AWB_INSTALL_DIR=\"$HOME/.local/bin\" sh\n```\n\nRequirements: `adb` on your PATH (Android SDK platform-tools). `scrcpy` is optional and\nonly needed for screen mirroring. The phone needs Android 11+ with developer options\nenabled, on the same Wi-Fi network as your Mac.\n\n## Menu bar app\n\n```sh\nawb app\n```\n\nThe awb icon appears in the menu bar. Left-click toggles the popover: connected devices\nwith one-click mirroring, a Logs tab, scrcpy settings, and QR pairing for new phones.\nRight-click offers Show, Pair, Refresh, and Quit.\n\nmacOS release archives also contain `AWB.app` for /Applications and login items; it is the\nsame menu bar app in a bundle.\n\n## CLI\n\n```sh\nawb\n```\n\nRunning `awb` with no arguments checks ADB, shows a QR code, and guides the phone from\n`Developer options -\u003e Wireless debugging -\u003e Pair device with QR code` to a connected\ndevice, with live waits, retries, and manual IP:port fallbacks when discovery misbehaves.\nOnce connected it offers to start scrcpy.\n\nUseful commands and flags:\n\n```sh\nawb status --json        # ADB, scrcpy, and device status for scripts and UIs\nawb reset-adb            # kill and restart the local ADB server\nawb completions zsh      # print zsh completions\nawb app                  # launch the menu bar app\nawb --connect-only       # pair and connect without the scrcpy menu\nawb --background         # start scrcpy detached and exit\nawb --foreground         # start scrcpy and wait until it exits\nawb --stable             # scrcpy + keepalive watch + reconnects + Wi-Fi diagnostics\nawb --watch --wifi-doctor\nawb --timeout 120        # wait longer than the 60-second default\nawb --device-serial SERIAL --background\nawb --window-title \"Pixel 10 Pro\" --window-width 480 --window-height 1071\nawb --plain-window --always-on-top\nawb --adb /path/to/adb --scrcpy /path/to/scrcpy\n```\n\nBy default scrcpy launches borderless at 480x1071 with `--stay-awake` and no audio; pass\n`--plain-window` for scrcpy's regular decorated window. The menu bar app stores its scrcpy\noptions in `~/.config/awb/config.toml`.\n\n## Build from source\n\n```sh\ngit clone https://github.com/ovitrif/awb.git\ncd awb\ncargo build --release            # target/release/awb and target/release/awb-app\nscripts/bundle-app.sh            # optional: wraps awb-app into target/bundle/AWB.app\n```\n\nThe workspace has three crates: `awb-core` (ADB, scrcpy, QR, and Bonjour logic), `awb`\n(the CLI), and `awb-app` (the menu bar app, built from the design in `DESIGN.pen`).\n\n## License\n\nMIT. Bundled [Inter](https://rsms.me/inter/) font is licensed under the SIL OFL 1.1;\nicons are [Phosphor](https://phosphoricons.com/) (MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fovitrif%2Fawb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fovitrif%2Fawb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fovitrif%2Fawb/lists"}