원문 t4t5/omdrop-owl 저장소 메타(2026-10-11 gh api 확인): LICENSE 파일 없음, 주 언어 Shell, 2026-10-08 생성, Stars 약 1,500. 토픽 airdrop·omarchy·opendrop.

한 줄 요약

iPhone과 AirDrop을 주고받는 리눅스 도구 omdrop은 원래 Apple Silicon Mac의 Broadcom 무선 칩이 있어야 했다. omdrop-owl은 그 “무선 부분”만 갈아 끼워, 일반 노트북의 Wi-Fi 카드에서도 AirDrop이 되게 한다.

배경: 왜 무선 백엔드를 따로 만드나

AirDrop은 Apple 기기끼리 AWDL(Apple Wireless Direct Link)이라는 전용 Wi-Fi 직접 연결 위에서 돈다. omdrop은 Omarchy용 AirDrop 송수신기로, AWDL을 Broadcom 칩용 커널 드라이버 패키지(omdrop-awdl)에 맡긴다. 그래서 Broadcom 칩이 없는 Framework 노트북이나 Intel 카드 머신에서는 쓸 수 없었다.

omdrop-owl은 omdrop-awdl의 형제 패키지다. omdrop의 무선 백엔드 계약(docs/radio-backend.md)대로 /usr/lib/omdrop에 도우미를 깔고, omdrop CLI와 패널이 그걸 부른다. 다만 2026-10-11 현재 omdrop 본 저장소 docs/에는 이 문서가 없고, omdrop 쪽 지원은 t4t5가 올린 PR #25(“Support non-Apple Wi-Fi cards”)로 열려 있을 뿐 머지되지 않았다. AWDL 자체는 커널이 아니라 사용자 공간에서 OWL(SEEMOO 연구실의 리눅스용 AWDL 구현, 여기서는 MediaTek 우회 패치를 단 포크)이 모니터 인터페이스 위에서 돌린다. omdrop의 송수신기는 수정 없이 그 위에서 동작한다.

공유 모드: Wi-Fi를 끊지 않고 AWDL 얹기

기본 방식은 Wi-Fi 접속을 유지한 채 AWDL이 공유기 채널을 같이 쓰는 것이다.

  1. 공유기 채널에서 AWDL을 돌린다. 그 채널은 AWDL 채널인 6·44·149 중 하나여야 한다. iPhone이 AWDL 시간 슬롯의 상당 부분을 이 채널에 쓰므로, 무선 칩이 공유기를 떠날 필요가 없다.
  2. 모니터 인터페이스가 Wi-Fi 접속(station)의 MAC 주소를 그대로 쓴다. OWL은 -S intersect로 그 채널에서 폰이 쓰는 슬롯만 광고한다.
  3. MT7925는 주입한 프레임을 station MAC으로 내보내고, station 인터페이스가 폰의 유니캐스트에 ACK를 해 준다. 그래서 별도의 “능동” 모니터 인터페이스가 필요 없다.
  4. OWL이 awdl0을 만들면 omdrop 수신기가 여기에 붙고, 몇 초마다 _airdrop._tcp를 알린다.

omdrop-awdl에서 awdl0이나 BlueZ하고만 대화하는 도구(send-to-peer, airdrop-send.py, BLE·mDNS 광고 스크립트 등)는 고정 커밋에서 받아 수정 없이 재사용한다.

지원 하드웨어

카드별 동작은 드라이버당 한 줄인 프로필 표 userspace/owl-profiles가 정한다.

드라이버카드상태
mt7925eMediaTek MT7925 (Framework 13)검증됨. 양방향, Wi-Fi 연결 유지
iwlwifiIntel AX201검증됨(Ubuntu 24.04, 커널 6.8). 양방향, 보이는 동안 Wi-Fi 꺼짐(배타 모드)
iwlwifiIntel AX200배타 모드 미검증. 접속 중엔 주입 프레임을 버려 공유 모드 불가
iwlwifiIntel AX211배타 모드 미검증. 공유 모드 불가, 애드혹 인터페이스를 같이 띄우자 펌웨어가 죽음

표에 없는 카드는 * 줄로 떨어지고, /etc/omdrop/allow-untested로 직접 동의해야 돈다. /etc/omdrop/owl-profiles가 패키지 표보다 먼저 읽히므로 재빌드 없이 설정을 바꿔 볼 수 있다. sudo tools/test-card.sh가 양방향 사진 전송과 해제 후 5분간의 Wi-Fi 상태를 확인해 보고서를 만들고, 그 summary.txt를 붙여 PR을 내면 된다(다른 파일엔 공유기 MAC이 들어 있으니 빼라고 적혀 있다).

배타 모드: Intel 카드

AX201은 공유기에 접속한 동안 AWDL 프레임을 하나도 올려 주지 않는다. 그래서 보이는 동안 Wi-Fi를 끄고, stop 때 NetworkManager에 돌려준다.

  • AWDL의 BSSID에 애드혹(IBSS) 인터페이스로 합류해 펌웨어가 폰의 유니캐스트에 ACK하게 한다. 모니터 인터페이스만으로는 안 된다.
  • iPhone이 HT 속도로 보내므로 셀은 HT20이다. ACK를 못 하면 iPhone이 재시작 전까지 무시한다.
  • 5GHz에서 애드혹 셀을 못 열어 채널 6에서 돈다.
  • 한가할 때 iPhone이 채널 6에 주는 슬롯은 16개 중 1~2개라 느리다. 2.4MB 사진이 iPhone→PC 17초, PC→iPhone 10.5초 걸렸다.

설치

Arch는 makepkg -si, Debian·Ubuntu는 빌드 의존성을 깔고 tools/build-deb.sh로 .deb를 만든다. 어느 쪽이든 pins에 고정한 커밋의 OWL을 patches/를 얹어 빌드하고, polkit 정책과 awdl0·mon0·awdlibss0를 NetworkManager가 건드리지 않게 하는 규칙까지 함께 설치한다. Broadcom 백엔드(brcmfmac-awdl-dkms)와는 충돌한다. 백엔드는 한 번에 하나다. 그 뒤 무선 백엔드를 지원하는 omdrop(위 PR #25 참고)을 설치해 바에서 켜고, 막히면 omdrop-discoverable probe로 원인을 본다.

알려진 한계

  • MT7925 멈춤: 공유기에 접속한 상태에서 모니터 인터페이스를 지우면 station이 “연결됨”인데 수신을 멈춘다(수 초~수 분 뒤). mt76 드라이버·펌웨어 버그로 보고, 계약상 드라이버를 다시 올릴 수 없어 stop 직후 재접속을 강제한다.
  • 송신이 수신보다 느리다: 약 490kB/s 대 1.3MB/s. 주입 프레임이 요청한 PHY 속도와 무관하게 약 2.5ms에 하나씩 나간다.
  • 공유 모드에서 공유기 채널이 6·44·149가 아니면 start가 종료 코드 3으로 끝난다.
  • iPhone이 AWDL 주소를 무작위로 바꿔서 상대 기기를 기억하지 못한다.
  • LICENSE 파일이 없다. 재사용·재배포 조건은 정해지지 않은 상태다.

X 반응 (2026-10-10)

t4t5의 “AirDrop 완전 역분석, Framework 노트북에서 잘 된다” 글이 중국어·아랍어권으로 퍼졌다. @realfxw는 이 프로젝트가 주목받는 이유를 세 가지로 정리했다. 첫째, LocalSend 같은 도구는 상대 Apple 사용자에게 별도 앱 설치를 요구하지만 이 방식은 순정 AirDrop 프로토콜을 그대로 쓴다. 둘째, 오래전에 멈춘 OpenDrop을 최신 프로토콜로 되살렸다. 셋째, AI로 Wi-Fi 칩별 프로토콜 profile을 디버깅하는 방식을 보여 줘 다른 하드웨어로 넓힐 여지가 있다.^[raw/articles/twitter-web-exporter/x-2108778428845699115.md] @EngMoElgaraihy도 Omarchy 플러그인과 묶어 같은 내용을 전했다.^[raw/articles/twitter-web-exporter/x-2108751766510616878.md] 일부 글이 “Windows PC용”이라고 쓴 것은 사실과 다르다. 현재 대상은 리눅스다.

작성자 t4t5 본인도 2026-10-09에 저장소 링크를 올리며 @brentkearney의 Omarchy 플러그인(PR #25)과 짝을 이룬다고 알렸다.

관련 페이지