explaingit

khr898/ntfsmac

Analysis updated 2026-05-18

259SwiftAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

ntfsmac adds read and write support for Windows NTFS drives on Apple Silicon Macs, using a hidden Linux virtual machine instead of a kernel extension.

Mindmap

mindmap
  root((ntfsmac))
    What it does
      NTFS read and write
      No kernel extension
      No SIP changes
    Tech stack
      Swift
      libkrun
      NFS
      ntfs-3g
    How it works
      Linux microVM
      NFS bridge to macOS
      Privileged helper
    Interfaces
      CLI first
      Menu bar GUI
    Requirements
      Apple Silicon only
      macOS 13 plus
    License
      MIT

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Read and write files on a Windows formatted NTFS drive from an Apple Silicon Mac.

USE CASE 2

Mount an NTFS disk without installing a kernel extension or disabling SIP.

USE CASE 3

Manage NTFS drives through either a CLI or a lightweight menu bar app.

What is it built with?

SwiftlibkrunNFSntfs-3g

How does it compare?

khr898/ntfsmaclcharvol/macsifthimomohi/airtranslate
Stars259240197
LanguageSwiftSwiftSwift
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencedevelopergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Only supports Apple Silicon Macs on macOS 13 or newer, no Intel fallback.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

ntfsmac lets Mac computers with Apple Silicon chips read and write NTFS drives, the disk format Windows uses, without needing a kernel extension or turning off macOS security protections. macOS normally has no native way to write to NTFS drives, and the usual workarounds involve either a kernel extension, which newer macOS security policy blocks, or a paid third party driver. Instead, ntfsmac takes a different approach. It runs a small, disposable Linux virtual machine in the background that does the actual NTFS reading and writing using a Linux tool called ntfs-3g. That virtual machine then shares the drive back to macOS over a standard network file sharing protocol, using a private, host only network bridge. From the Mac's point of view, it just looks like a normal mounted network drive, so there is no kernel extension to install and no System Integrity Protection setting to change. The tool comes as a command line interface first, with a menu bar app as a second option that has no icon in the Dock. From the command line you can mount a specific disk, unmount it, run a diagnostic check on the whole setup, or fully uninstall the tool and its background helper. The menu bar app shows the mount status through its icon color: grey when idle, blue while mounting, green once mounted and writable, yellow if mounted read only because of a dirty journal, and red on error. Every privileged action, such as mounting or touching network routing state, goes through a dedicated helper process rather than the app directly calling sudo, which keeps the amount of code running with elevated permissions as small as possible. The project only works on Apple Silicon Macs running macOS 13 or newer, with no support for Intel Macs. It is signed with an ad hoc signature rather than a paid Apple developer certificate, which is why the GUI is distributed as a downloadable disk image rather than through the Homebrew package manager's official channel, and the command line tool lives in the author's own separate Homebrew tap. ntfsmac is released under the MIT license, and the project is currently in active development.

Copy-paste prompts

Prompt 1
Walk me through installing ntfsmac with Homebrew and mounting an NTFS disk.
Prompt 2
Explain how ntfsmac avoids using a kernel extension to write to NTFS drives.
Prompt 3
Help me interpret the ntfsmac menu bar icon colors and what each one means.
Prompt 4
Show me how to run ntfsmac diagnose to check my bridge and helper setup.

Frequently asked questions

What is ntfsmac?

ntfsmac adds read and write support for Windows NTFS drives on Apple Silicon Macs, using a hidden Linux virtual machine instead of a kernel extension.

What language is ntfsmac written in?

Mainly Swift. The stack also includes Swift, libkrun, NFS.

What license does ntfsmac use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is ntfsmac to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ntfsmac for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.