Hear One Device — keep your earbuds paired to one device, and hear the rest through it.
HearOneDevice streams your PC's system audio to your Android phone over Bluetooth LE. Your earbuds stay paired to the phone only, and PC audio plays through the phone, mixed with the phone's own sounds. Playback keeps going with the phone screen off.
- Pairing per PC. Every PC, and each OS on a dual-boot machine, needs its own pairing with the same earbuds.
- Multipoint auto-switching. With earbuds connected to both PC and phone, audio I was listening to on the phone kept getting switched over to the PC.
- Only one source at a time. I wanted to hear the PC and the phone together (a video on the PC plus notifications and calls on the phone).
At first, an AI assistant told me, roughly: "Bluetooth is hard for this. BLE can carry about 16 kHz mono — phone-call quality, not enough for music. Receiving like earbuds do over A2DP would be ideal, but phones aren't built to receive music, so Android doesn't expose that to apps." So I built a Wi-Fi/web version instead (v0.3.0) that sent audio over the network to the phone's browser. On the library's internal network the phone couldn't reach the PC, so I tried going through a relay server, but the audio quality wasn't good enough and I gave up on it. A browser also can't guarantee playback with the screen off.
So I rewrote it over Bluetooth anyway, and now I listen to music through it in Opus 48 kHz stereo. The lesson I took from it: to judge whether an AI's "that won't work" is actually true, you need enough background knowledge of your own.
With my own phone (Galaxy S25) and earbuds, I've listened to it in my school's library, in lecture rooms, and on the subway without anything feeling off. The delay feels like about 0.1 seconds.
- PC app: Windows, Linux (PulseAudio, or PipeWire's PulseAudio compatibility; BlueZ)
- Phone app: Android 8.0+ with BLE (iOS is not supported)
- No internet or Wi-Fi needed — the PC and phone talk directly over Bluetooth.
Download the PC installer and the .apk from Releases.
- Open the PC app and press 공유 시작 (Start sharing). The app UI is in Korean. A QR code appears.
- Scan it with the phone app. The PC is saved to the phone's history and audio starts playing.
- Next time, pick 마지막 PC로 듣기 (listen to last PC) or choose from PC 연결 기록 (PC history) in the phone app.
If the phone is registered as a Bluetooth device on the PC, a pairing prompt may pop up on the phone when connecting (seen with some Windows Bluetooth chips). Removing the phone from the PC's device list fixes it. HearOneDevice does not use Bluetooth pairing.
PC Android phone
system audio ─► Opus encode ─► AES-256-GCM ─► BLE notify ─► decrypt ─► MediaCodec ─► AudioTrack ─► earbuds
(PulseAudio monitor / (per-connection (jitter buffer, foreground service)
WASAPI loopback) audio key)
- Discovery: the PC advertises a service UUID. The phone treats every PC advertising it as a candidate and connects, and the key check (below) tells it which one is yours. It tries the last PC that passed first, then by signal strength.
- Codec: Opus 48 kHz stereo — 64 kbps by default, 128 kbps for higher quality. Switchable live from the PC app; the phone picks the decoder from the packet header.
- Latency over buffering: the phone's jitter buffer targets 80 ms, favoring low latency over riding out bursts.
- Stop: when the PC stops sharing it sends a control packet, so the phone stops instead of searching again. The phone plays a short chime on connect and disconnect, so you know without looking at the screen.
The QR code carries a key that is handed over once. On every connection the PC and phone verify each other with it, and audio is sent only to a verified phone, encrypted with AES-256-GCM. A phone that never scanned the QR can't listen, and sniffing the radio reveals nothing. Details in docs/PROTOCOL.md.
PC app (Tauri 2 + React):
npm install
npm run tauri dev # run
npm run tauri build # build installer
cd src-tauri && cargo test
cd src-tauri && cargo run --example send # send only, no UIBuilding on Linux needs the dev packages for libpulse, dbus, and Tauri's base dependencies (webkit2gtk 4.1).
Phone app (Kotlin):
cd android
./gradlew assembleDebugCode layout and rules are in CLAUDE.md. One file does one thing; capture, codec, and transport only pass bytes/samples to each other.
- docs/PROTOCOL.md — PC ↔ phone protocol (UUIDs, advertising, packets, key check, encryption)
- docs/CODECS.md — codec table (Opus 64k default, 128k high quality)
HearOneDevice는 PC 시스템 소리를 블루투스(BLE)로 안드로이드 폰에 보내 재생합니다. 이어폰은 폰에만 페어링해 두면 되고, PC 소리는 폰 소리와 섞여서 들립니다. 폰 화면이 꺼져도 재생이 이어집니다.
- PC마다 페어링. PC마다, 듀얼부팅이면 OS마다 같은 이어폰을 따로 페어링해야 했습니다.
- 멀티포인트 자동 전환. 이어폰을 PC와 폰에 같이 연결해 두면 폰 소리를 듣다가 PC로 넘어가 버렸습니다.
- 소리는 한 번에 하나. PC와 폰 소리를 같이 듣고 싶었습니다 (PC로 영상 보면서 폰 알림·통화).
처음에 AI에게 들은 말은 대략 이랬습니다: "블루투스로는 어렵습니다. BLE로 보낼 수 있는 건 16kHz 모노 정도인데, 그건 전화 통화 수준이라 음악을 듣기엔 부족하고 원래 소리를 온전히 전달할 수 없습니다. 이어폰처럼 A2DP로 받으면 좋겠지만, 휴대폰은 음악을 받는 장치가 아니라서 그 기능을 앱에 열어 주지 않습니다." 그래서 Wi-Fi(웹) 버전으로 만들었습니다(v0.3.0, 네트워크로 폰 브라우저에 소리를 보냄). 그런데 도서관 내부망에서는 폰이 PC에 연결되지 않아 중계 서버를 거치는 방식도 써봤지만, 음질 때문에 그만뒀습니다. 브라우저로는 화면이 꺼졌을 때 재생을 보장할 수도 없었습니다.
그래도 블루투스로 다시 만들었고, 지금은 Opus 48kHz 스테레오로 음악을 듣고 있습니다. AI가 "안 된다"고 할 때 그 말이 맞는지 판단하려면, 결국 나 스스로 배경지식이 있어야 한다는 걸 배운 프로젝트입니다.
제 폰(Galaxy S25)과 이어폰으로 학교 도서관, 강의실, 지하철에서 어색함 없이 들었습니다. 지연은 체감으로 0.1초쯤입니다.
- PC 앱: Windows, Linux (PulseAudio 또는 PipeWire의 PulseAudio 호환, BlueZ)
- 폰 앱: Android 8.0 이상, BLE 지원 기기 (iOS 미지원)
- 인터넷·Wi-Fi가 필요 없습니다. PC와 폰이 블루투스로 직접 연결됩니다.
Releases에서 PC 설치 파일과 .apk를 받습니다.
- PC 앱을 실행하고 "공유 시작"을 누르면 QR 코드가 뜹니다.
- 폰 앱에서 QR을 찍으면 그 PC가 기록에 저장되고 바로 재생됩니다.
- 다음부터는 폰 앱에서 "마지막 PC로 듣기"나 "PC 연결 기록"에서 고르면 됩니다.
PC 블루투스 기기 목록에 폰이 등록돼 있으면 연결할 때 폰에 페어링 창이 뜰 수 있습니다(일부 Windows 블루투스 칩). 등록을 지우면 됩니다. 이 앱은 블루투스 페어링을 쓰지 않습니다.
PC 안드로이드 폰
시스템 소리 ─► Opus 인코딩 ─► AES-256-GCM ─► BLE 알림 ─► 풀기 ─► MediaCodec ─► AudioTrack ─► 이어폰
(PulseAudio monitor / (연결마다 새 (지터 버퍼, 포그라운드 서비스)
WASAPI 루프백) 소리 열쇠)
- 찾기: PC는 서비스 UUID를 광고합니다. 폰은 그 UUID를 광고하는 PC를 모두 후보로 보고 붙어서, 아래 열쇠 확인으로 내 PC를 가립니다. 마지막으로 통과한 PC부터, 그다음은 신호 센 순서로 시도합니다.
- 코덱: Opus 48kHz 스테레오. 기본 64kbps, 고음질 128kbps. PC 앱에서 재생 중에 바꿀 수 있고, 폰은 패킷 헤더를 보고 디코더를 고릅니다.
- 지연 우선: 폰의 지터 버퍼 목표는 80ms로, 몰려 오는 지연을 버티기보다 지연이 짧은 쪽을 택했습니다.
- 멈춤: PC가 공유를 끝내면 제어 패킷을 보내, 폰이 다시 찾지 않고 멈춥니다. 폰은 연결·해제 때 짧은 알림음을 내서 화면을 안 봐도 알 수 있습니다.
QR에 실린 열쇠를 한 번 건네고, 연결할 때마다 PC와 폰이 그 열쇠로 서로를 확인합니다. 확인을 통과한 폰에만 소리를 잠가서(AES-256-GCM) 보냅니다. QR을 찍지 않은 폰은 소리를 들을 수 없고, 전파를 엿들어도 내용이 보이지 않습니다. 자세한 방식은 docs/PROTOCOL.md.
PC 앱 (Tauri 2 + React):
npm install
npm run tauri dev # 실행
npm run tauri build # 설치 파일 만들기
cd src-tauri && cargo test
cd src-tauri && cargo run --example send # 화면 없이 송신만Linux 빌드에는 libpulse, dbus, Tauri 기본 의존성(webkit2gtk 4.1)의 개발 패키지가 필요합니다.
폰 앱 (Kotlin):
cd android
./gradlew assembleDebug코드 구조와 규칙은 CLAUDE.md에 있습니다. 한 파일은 한 가지 기능만 하고, 캡처·코덱·전송은 바이트/샘플만 주고받습니다.
- docs/PROTOCOL.md — PC ↔ 폰 약속 (UUID, 광고, 패킷, 연결 확인, 잠그기)
- docs/CODECS.md — 코덱 번호 표 (Opus 64k 기본, 128k 고음질)