t4t5/owly

选用指南

AI 根据 README 整理 · 2026/10/17 09:41:45 · 基于较早版本，请核对最新 README

使用方式

需要安装 omdrop 插件（0.16.0 或更新版本）才能工作；在 Omarchy 上作为插件添加，其他 Linux 系统使用 omdrop CLI 命令。

查看 README 依据

The `interface`, `channels` and `allowUntested` options set `/etc/omdrop/infra-iface`, `/etc/omdrop/channels` and `/etc/omdrop/allow-untested`. </details> ## Usage omdrop-owl needs the [omdrop](https://github.com/netmojo-systems/omdrop-plugin.git) plugin (0.16.0 or newer) to work. ### On Omarchy (add it as a plugin): ```sh omarchy plugin add https://github.com/netmojo-systems/omdrop-plugin.git ``` and turn it on from the bar. ### On other Linux systems: The bar icon and panel are Omarchy-only. On other distros, you can use the `omdrop` CLI: ```sh

部署要求

支持多种 Linux 发行版（Arch、Debian/Ubuntu、Fedora、NixOS），需要特定 Wi-Fi 网卡驱动支持，部分模式需要 hostapd。

查看 README 依据

# omdrop-owl https://github.com/user-attachments/assets/b195ce4c-e078-49be-bc13-44a72b6dc189 AirDrop between iPhones and Linux laptops whose Wi-Fi isn't Apple's Broadcom chip. Pairs with [omdrop](https://github.com/netmojo-systems/omdrop-plugin). See [supported hardware](#supported-hardware). ## Install On Arch/Omarchy ([AUR](https://aur.archlinux.org/packages/omdrop-owl)): ```sh yay -S omdrop-owl ``` <details> <summary>On Debian or Ubuntu (from source)</summary> ```sh sudo apt install build-essential cmake git pkg-config dpkg-dev \

libev-dev libpcap-dev libnl-3-dev libnl-genl-3-dev libnl-route-3-dev tools/build-deb.sh sudo apt install ./omdrop-owl_*.deb ``` This builds OWL at the commit pinned in `pins`, with `patches/`, and installs it root-owned into `/usr/lib/omdrop` together with `omdrop-discoverable` and omdrop-awdl's portable tools, a polkit policy for the helper, a NetworkManager rule keeping `awdl0`, `mon0`, `awdlibss0` and `awdlap0` unmanaged, and a systemd `.link` file that keeps udev from changing `awdl0`'s MAC address. `hostapd` is recommended: exclusive mode needs it on cards without

ad-hoc mode. It conflicts with `brcmfmac-awdl-dkms`: one radio backend at a time. </details> <details> <summary>On Fedora (from source)</summary> ```sh sudo dnf install rpm-build cmake gcc gcc-c++ make git libev-devel libpcap-devel libnl3-devel tools/build-rpm.sh sudo dnf install ./omdrop-owl-*.rpm ``` This builds the same files as the Debian package into an `.rpm` (Fedora package names; other rpm-based distros would rename them). `sudo dnf remove omdrop-owl` removes them all. </details> <details> <summary>On NixOS (flake)</summary> ```nix

已知限制

共享模式要求接入点位于信道 6、44 或 149；部分网卡（如 MT7925）发送速度较慢，MT7921/MT7922 不可靠；UFW 防火墙会阻止接收，需要安装防火墙规则。

查看 README 依据

`/etc/NetworkManager/conf.d/` and run `sudo nmcli general reload conf`, or NetworkManager manages OWL's interfaces and the phone never shows up. Copy `packaging/10-omdrop-owl-awdl0.link` to `/etc/systemd/network/` too: where udev's default MAC policy rewrites `awdl0`'s address (Ubuntu 22.04), the phone is sent a link-local `awdl0` doesn't have and never connects. ## Known issues - **Shared mode needs your AP on channel 6, 44 or 149.** On any other channel, `start` refuses and says so. - **The MT7925 drops off Wi-Fi when the monitor interface is removed** (an

mt76/firmware bug), so `stop` reconnects Wi-Fi straight after. - **The MT7927 starts but is never heard.** It uses the MT7925's driver, so it runs the MT7925's shared profile without an opt-in, but its monitor interface doesn't receive the phone's frames. With an `active-monitor` line in `/etc/omdrop/owl-profiles` it's heard and can send, but the phone's uploads arrive at about 5 kB/s and time out ([#44](https://github.com/t4t5/omdrop-owl/issues/44)). Exclusive mode through the hidden AP is untested. - **The MT7925 sends slower than it receives** (about 490 kB/s against

1.3 MB/s): injected frames leave at most one every ~2.5 ms. - **UFW blocks the receiver**, so the phone never sees this machine. Run `omdrop firewall install` to allow TCP 8771 from link-local addresses on `awdl0`. - **Exclusive mode is slow on channel 6**, where Intel cards and others that refuse a 5 GHz cell run, since AWDL there gets few of the iPhone's slots: a 2.4 MB photo takes 10–17 s on an AX201. - **The MT7921/MT7922 are unreliable.** `mt7921e` sends injected unicast at 1 Mbit/s whatever rate is asked for, and not at all on 5 GHz, so discovery