qr-drive-mount

Desktop companion for QR Drive — mounts your phone as a network drive (Finder on macOS, File Explorer on Windows, or a folder on Linux) over WebDAV via a local relay.

Requirements

• Node.js 18+
• macOS: built-in mount_webdav (no extras needed)
• Windows: built-in net use (no extras needed)
• Linux: gio (comes with GVFS / most GNOME desktops) or mount.davfs (sudo apt install davfs2)

Installation

npm install -g qr-drive-mount

Usage

Run the daemon once before scanning a QR code in the web app:

qr-drive-mount

It listens on http://127.0.0.1:47321. The QR Drive web app detects it automatically and shows a "Mount in Finder" toggle. Scan a QR code on your phone, enable the toggle, and the phone's storage appears as a drive.

To stop it, press Ctrl+C or close the terminal.

Auto-start (optional)

The daemon does not start automatically on login — you run it on demand. If you want it always available:

macOS — add a Login Item:
System Settings → General → Login Items → + and select the qr-drive-mount binary (find it with which qr-drive-mount).

Or create a launchd plist at ~/Library/LaunchAgents/qr-drive-mount.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>        <string>qr-drive-mount</string>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/local/bin/node</string>
    <string>/usr/local/bin/qr-drive-mount</string>
  </array>
  <key>RunAtLoad</key>    <true/>
  <key>KeepAlive</key>    <true/>
</dict>
</plist>

Then: launchctl load ~/Library/LaunchAgents/qr-drive-mount.plist

Linux (systemd user service):

# ~/.config/systemd/user/qr-drive-mount.service
[Unit]
Description=QR Drive Mount daemon

[Service]
ExecStart=/usr/bin/qr-drive-mount
Restart=on-failure

[Install]
WantedBy=default.target

Enable: systemctl --user enable --now qr-drive-mount

License

AGPL-3.0-only