# ben-z/findphone

Locate a nearby Bluetooth device by signal strength, from the macOS command line — for when Find My isn't available

Repository: https://github.com/ben-z/findphone
Canonical: https://ross.abutalabs.com/products/findphone
Language: Swift
License Family: other
Last push: 2026-08-01T08:02:23+00:00

## Health v2 (maintenance only)
Score: 65/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 95, release rhythm 63, longevity 2
- inputs: {"age_days": 33, "days_push": 32, "days_rel": 33, "gap_med": null, "n_releases_24m": 1}
- flags: young, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1308, forks 183 (observed 2026-08-28T04:04:19.267145+00:00)

## What it is
A macOS command-line tool that locates nearby Bluetooth devices by signal strength, for cases where Find My is unavailable. It offers survey mode to list nearby Apple devices and hunt mode with optional audio clicks that speed up as you approach the target.

## Use cases
- find a lost iphone in a room when find my is disabled by mdm
- locate a nearby bluetooth device by signal strength from the terminal
- track which corner of the room a device is in with audio clicks
- list paired bluetooth devices and their addresses on macos
- sweep a room by ear to find a hidden phone

## When to choose
- you're on macOS 13+ and Find My is unavailable but the device is within Bluetooth range
- you want a lightweight, dependency-free Swift CLI with a universal binary
- you need audio-guided proximity hunting or redacted output for screen recording

## When to avoid
- the device is out of Bluetooth range or you need actual GPS location
- you need a GUI or cross-platform (Windows/Linux) tool
- you need precise distance measurement — signal strength is heavily attenuated by walls and metal

## Facets
- artifact type: cli-tool
- maturity: active
- function: search-engine, developer-tools, cli
- domain: apple-ecosystem, developer-tools, hardware
- platform: cli
- tags: bluetooth, ble, find-my, device-tracking, signal-strength, corebluetooth, command-line, macos, swift

## Member repositories
- ben-z/findphone (main) score 65

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:19.267145+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:50:04.318510+00:00, confidence not recorded.
  - readme: https://github.com/ben-z/findphone (fetched 2026-08-28T04:04:19.267145+00:00, sha 4f7e111cc43c)
- Data as of 2026-08-30T08:39:29.467469+00:00.