https://github.com/rrbe/localshare
Tiny macOS app to share files & folders over WiFi — scan a QR code and browse them in your phone's browser. No cloud, no setup. 局域网文件分享，扫码即在手机浏览器中打开
https://github.com/rrbe/localshare
airdrop-alternative apple-silicon cli file-preview file-server file-sharing file-transfer html-preview http-server lan local-network localsend-alternative macos macos-app qr-code qrcode static-file-server swift swiftui wifi
Last synced: 1 day ago
JSON representation
Tiny macOS app to share files & folders over WiFi — scan a QR code and browse them in your phone's browser. No cloud, no setup. 局域网文件分享，扫码即在手机浏览器中打开
- Host: GitHub
- URL: https://github.com/rrbe/localshare
- Owner: rrbe
- License: mit
- Created: 2026-06-05T01:35:28.000Z (about 1 month ago)
- Default Branch: master
- Last Pushed: 2026-07-06T04:21:04.000Z (1 day ago)
- Last Synced: 2026-07-06T05:08:05.023Z (1 day ago)
- Topics: airdrop-alternative, apple-silicon, cli, file-preview, file-server, file-sharing, file-transfer, html-preview, http-server, lan, local-network, localsend-alternative, macos, macos-app, qr-code, qrcode, static-file-server, swift, swiftui, wifi
- Language: Swift
- Size: 3.02 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# LocalShare — share Mac files, scan a QR code to view or save them in your phone's browser
[简体中文](README_CN.md) | English
A small macOS app that moves files and text between your Mac and other devices (phone, tablet…) over WiFi — the other end just uses a browser, with no client to install.
- Pick a file or folder, scan the QR code that appears (or just open the link), and browse the files in your phone's browser (HTML, PDF, Markdown, images…)
- Two-way text transfer — type some text and share it via a QR code, or send text back from the phone to the Mac
Home
Share Files
Transfer Text
## Features
- Share files and text by QR code, or just by opening the link
- Serves HTML / PDF / video / images; previews Markdown / JSON / CSV
- After you share, the other end can send files and text back
- Shows who's currently viewing
- `localshare` command line: bring up the window to share, or `--headless` to print the link and QR code in the terminal
## Why this app exists
- When AirDrop is flaky, or the other device isn't an Apple device
- iPhone Safari can't open local HTML files directly, so previewing the web pages you vibe-coded is awkward
- No need to spin up `python3 -m http.server`
- No need to install a client like LocalSend
- Preview only — no need to actually save files onto the phone
- Quickly pass text around, without relying on flaky Handoff
## GUI usage
Scan the QR code, or open the LAN address directly. If macOS shows a firewall prompt on first launch, click "Allow".
The QR code points to something like `http://192.168.x.x:8080/?t=`: the link carries a one-time token, so whoever scans it gets in seamlessly, while anyone who only knows the IP:port cannot access it.
> ⚠️ Traffic is plain HTTP (unencrypted). Best avoided on public networks like airports and cafés.
## Terminal usage
In Settings → Command-Line Tool, click "Install". After that you can share from the terminal in one command:
```bash
localshare a.html b.pdf # bring up the LocalShare window to share these files
localshare ~/Documents/report # folders work the same; mix and match multiple items
localshare --headless ./dist # no window — print the link and QR code in the terminal (Ctrl-C to stop)
```
## Download
https://github.com/rrbe/LocalShare/releases
## Notes
The app is ad-hoc signed, so **opening** it may be blocked by Gatekeeper (warning that it's "damaged" or "can't be opened").
- In System Settings → Privacy & Security → Security, find the prompt and click "Open Anyway"; or
- run the command below in the terminal to strip the quarantine attribute, then open the app normally:
```bash
xattr -dr com.apple.quarantine /Applications/LocalShare.app
```
## License
MIT — see [LICENSE](LICENSE).
## Credits
This project was inspired by:
- [localsend](https://github.com/localsend/localsend)
- [dufs](https://github.com/sigoden/dufs)