Multiplatform SwiftUI SMB2/3 file browser for iPhone, iPad and Mac, with the same
browser UI over iCloud Drive and on-device files.
Verified against a real Samba 4.19.5 server: connect, enumerate shares, list,
upload, download with byte-comparison, streamed read, rename and delete all pass.
Downloads
| File | Platform | Notes |
|---|---|---|
SimpleSMB-macOS.dmg |
macOS 14+ (Apple silicon) | Ad-hoc signed, not notarized |
SimpleSMB-iOS-unsigned.ipa |
iOS/iPadOS 17+ | Unsigned — cannot be installed as-is |
Read this before downloading
The .dmg is not notarized. It is ad-hoc signed with no Apple Developer team,
so Gatekeeper will refuse it on first open. Right-click the app → Open →
Open to run it anyway. Apple silicon only.
The .ipa is unsigned and will not install on a device. Building a signed,
installable .ipa requires a paid Apple Developer account, which this project does
not have. It is published for inspection and for anyone who wants to re-sign it
themselves (AltStore, Sideloadly, or their own team in Xcode). Sideloading is
your call and your risk. If you just want to run it, open the project in Xcode
and build to your own device or a simulator — that path is signed correctly and
takes a minute.
Known limitations
- AMSMB2 is pinned to an unreleased revision (
497ce6e). Release 4.0.3 cannot
connect to a guest SMB share at all — it sends an NTLMv2 response over an empty
password instead of an anonymous session, and Samba rejects it. Details in
TEST_RESULTS.md. - Live testing covered one server (Samba/CasaOS, guest access). Windows
shares, macOS file sharing, other NAS firmware and authenticated logins are
untested. - No Files app Document Provider extension — it needs an App Group, which needs a
provisioned team. - iCloud Drive uses the document picker rather than direct container access, for
the same reason. - Drag-and-drop between panes is implemented but the gesture is not covered by an
automated test; SwiftUI drag sessions do not start from synthesized events. - Not tested on physical devices.
Verification
SimpleSMB-macOS.dmg 8c2dad0410f9a905372aa1c01ebe201957f90f8c836f4e743bceb7eedf65bb1e
SimpleSMB-iOS-unsigned.ipa ac9701a50ad810a39fe4250ce090e2ec79b5c04f3caecad3072765a466ded473
Built with Xcode 26.6 / Swift 6.3.3 against the iOS 26.5 and macOS 26.5 SDKs.
Full test results, including seven defects found and fixed during development,
are in TEST_RESULTS.md.