Skip to content

motiful/ntfs-rw-mac-kit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NTFS RW Mac Kit

NTFS RW Mac Kit

Give family Macs a repeatable, free path to write NTFS external drives.

License: MIT macOS Homebrew FUSE-T


Why

macOS can read NTFS drives but normally cannot write to them. Paid drivers work, but they add licenses, kernel-extension prompts, and confusion for non-technical family members. This kit packages the community route that worked in practice: FUSE-T, ntfs-3g, and Mounty.

Use this when you need to copy photos, videos, or archives from a Mac onto an NTFS external drive without buying Paragon or reformatting the disk.

Features

  • Installs the free NTFS write stack: FUSE-T, ntfs-3g, and Mounty.
  • Builds the FUSE-T-compatible ntfs-3g from the maintained community fork.
  • Provides a double-click fallback mounter when Mounty UI state is confusing.
  • Checks whether NTFS disks are actually writable instead of trusting app icons.
  • Includes a Paragon cleanup helper for machines that tried the paid driver.
  • Documents the real failure cases: busy mounts, Windows dirty flags, hibernation, and chkdsk.

When To Use

Situation Use this kit?
You need occasional NTFS write access on macOS Yes
You want a free alternative to Paragon/Tuxera Yes
You can reformat the disk to exFAT Prefer exFAT instead
The disk reports Windows hibernation or chkdsk errors Repair on Windows first
You need enterprise-grade automatic fleet management No

Quick Start

Download the release zip, unzip it, then double-click:

scripts/install.command

After installation:

1. Keep Mounty open in the menu bar.
2. Plug in the NTFS drive.
3. Click Mounty -> Re-mount <drive name>.
4. Enter your Mac password if prompted.
5. Copy files in Finder.

If Mounty does not behave, double-click:

scripts/mount-ntfs-rw.command

Install

From Release

  1. Download ntfs-rw-mac-kit.zip from the latest GitHub release.
  2. Unzip it.
  3. Double-click scripts/install.command.
  4. Follow the terminal prompts.

From Source

git clone https://github.com/motiful/ntfs-rw-mac-kit.git
cd ntfs-rw-mac-kit
chmod +x scripts/*.command scripts/*.sh
scripts/install.command

Usage

Normal Flow

Mounty is the friendly path:

Open Mounty -> plug in NTFS disk -> Re-mount -> enter password -> use Finder

The successful writable mount may look like this:

fuse-t:/Elements on /Volumes/Elements (nfs)

That is normal. FUSE-T exposes a writable view even though Disk Utility may show the raw NTFS partition as not mounted.

Fallback Flow

If Mounty shows stale state or a vague error, run:

scripts/mount-ntfs-rw.command

It lists external NTFS disks, unmounts the macOS read-only mount, and mounts the selected disk read-write with ntfs-3g.

Check Status

scripts/check-status.command

This prints installed components, current NTFS/FUSE-T mounts, and a real write test for mounted volumes.

Prerequisites

Requirement Notes
macOS Tested on macOS 26 with Apple Silicon
Homebrew Installer can install it if missing
Xcode Command Line Tools Required to build ntfs-3g
Admin password Needed for FUSE-T package install and NTFS mounting

How It Works

The installer uses Homebrew to install FUSE-T and Mounty, then builds macos-fuse-t/ntfs-3g so the NTFS driver links against libfuse-t. Mounty is used as the menu-bar front end; the fallback script calls ntfs-3g directly.

flowchart LR
  A["NTFS external drive"] --> B["macOS read-only mount"]
  B --> C["Mounty or fallback script"]
  C --> D["ntfs-3g"]
  D --> E["FUSE-T writable mount"]
  E --> F["Finder copy / move"]
Loading

Troubleshooting

Most problems are not mysterious once you inspect the real mount state. See Troubleshooting for the common cases:

  • Mounty does not list the disk.
  • Mounty says the volume cannot be unmounted.
  • Resource busy.
  • Windows dirty flag, hibernation, or chkdsk.
  • Paragon leftovers.

Contributing

Contributions are welcome. See CONTRIBUTING.md.

License

MIT - See LICENSE.

Acknowledgments

This kit wraps the work of the FUSE-T, NTFS-3G, and Mounty projects. It does not replace them; it just makes the working path easier to repeat.

Crafted with Readme Craft.

About

A family-friendly macOS kit for writable NTFS disks using FUSE-T, ntfs-3g, and Mounty.

Topics

Resources

License

Contributing

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages