https://github.com/hoochanlon/free-ntfs-for-mac
Nigate: A fully compatible NTFS read-write solution for Mac, optimized for Apple silicon.An open-source NTFS utility for Mac that provides read-write access, mounting, and management for NTFS drives
https://github.com/hoochanlon/free-ntfs-for-mac
arm intel m1 macos nigate ntfs ntfs-3g osxfuse
Last synced: 8 months ago
JSON representation
Nigate: A fully compatible NTFS read-write solution for Mac, optimized for Apple silicon.An open-source NTFS utility for Mac that provides read-write access, mounting, and management for NTFS drives
- Host: GitHub
- URL: https://github.com/hoochanlon/free-ntfs-for-mac
- Owner: hoochanlon
- License: zlib
- Created: 2022-12-21T08:35:27.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2026-01-18T13:02:33.000Z (8 months ago)
- Last Synced: 2026-01-18T15:14:41.095Z (8 months ago)
- Topics: arm, intel, m1, macos, nigate, ntfs, ntfs-3g, osxfuse
- Language: TypeScript
- Homepage: https://hoochanlon.github.io/Free-NTFS-for-Mac
- Size: 123 MB
- Stars: 1,274
- Watchers: 7
- Forks: 85
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Nigate
**Language / 言語 / 语言**: [English](README.md) | [日本語](README.ja.md) | [中文](README.cn.md)
This is the Electron GUI version of Nigate, which provides a modern and intuitive interface for NTFS device management while retaining the original geek terminal version.[^1]
### Features
- 🎨 **Modern Interface** - Dark theme with clean and beautiful design
- 📱 **Real-time Monitoring** - Automatically detects NTFS device connections
- ✅ **Dependency Check** - Automatically checks and installs required system dependencies
- 🔄 **One-Click Mount** - Easily mount read-only NTFS devices in read-write mode
- ⚡ **Auto Read-Write** - When enabled, newly inserted NTFS devices will be automatically mounted in read-write mode without manual operation. Intelligently skips devices you manually set to read-only, respecting your choices
- 📊 **Status Display** - Clearly displays device status and operation logs
- 🛡️ **Secure & Reliable** - Uses Electron security best practices
- ☕ **Prevent Sleep** - One-click toggle to prevent system sleep, ensuring the system stays awake during long operations
- 🍃 **Status Protection** - Long press for 3s to toggle protection status. When protected, auto read-write, tray mode, and prevent sleep features will be disabled to prevent accidental operations
- 🥷 **Ninja Tools** - Provide cross-filesystem mounting and end-to-end scripts from development to release, with one-click permission fixes and multi-language output to simplify complex operations and lower the usage barrier
### Important Notes
> [!important]
> **Read-Write Notes**:
> - **Basic Operations**: Supports file copy, cut, delete, and rename (metadata-level operations)
> - **Write Limitations (GUI Application)**: The GUI application (Electron GUI version) does not support direct in-place data modification on original files due to lack of kernel write permissions
> - **Editing Recommendations**: Please use editors that support Atomic Write (such as VS Code / Kate). These tools save files by "creating new and replacing old files", thereby bypassing in-place overwrite limitations
> - **Additional Note**: Ninja Tools `/ninja/kamui.sh` supports direct in-place data modification on original files, suitable for scenarios requiring direct file editing [^2]
- **Administrator Privileges**: Mounting operations require administrator privileges, and the system will prompt for a password
- **Windows Fast Startup**: If the device uses Fast Startup in Windows, mounting may fail. It is recommended to fully shut down (not hibernate) in Windows, or disable Fast Startup
- **Device Name**: USB drive names do not support spaces or illegal characters
- **Gatekeeper (Allow Anywhere)**: First-time use may require disabling Gatekeeper to allow unsigned applications. Run in terminal: `sudo spctl --master-disable`. After disabling, you can see the "Anywhere" option in "System Settings" > "Privacy & Security"
- **System Integrity Protection (SIP)** (Optional): To disable SIP, you need to operate in Recovery Mode:
1. Restart Mac, hold the power button until the Apple logo and progress bar appear, enter Recovery Mode
2. Find and open Terminal from the toolbar at the top of the screen, enter command: `csrutil disable`
3. Close Terminal and restart Mac
4. After restart, you can run `csrutil status` in terminal to check the status
- **Bootable USB Drives**: If a USB drive has been used to create bootable media like Ventoy or WePE, it may take some time when mounting it in read-write mode
### Quick Start
#### Method 1: Online Experience (Shell - Ninja Tools)
The following scripts are from the `ninja/` folder's Ninja Tools collection, providing command-line support for NTFS and Linux filesystem read-write access.
**🌍 All scripts support multiple languages!** Use `LANG=ja` or `LANG=zh` to set the language.
##### NTFS Read-Write Support
Copy and paste into a ***terminal with full administrative privileges*** and press Enter:
```shell
# English (default)
/bin/bash -c "$(curl -fsSL https://cdn.statically.io/gh/hoochanlon/Free-NTFS-for-Mac/main/ninja/nigate.sh)"
# Japanese
LANG=ja /bin/bash -c "$(curl -fsSL https://cdn.statically.io/gh/hoochanlon/Free-NTFS-for-Mac/main/ninja/nigate.sh)"
# Chinese
LANG=zh /bin/bash -c "$(curl -fsSL https://cdn.statically.io/gh/hoochanlon/Free-NTFS-for-Mac/main/ninja/nigate.sh)"
```
##### Linux ext4 and Other Filesystem Read-Write Support
Supports ext2/3/4, btrfs, xfs, zfs, NTFS, exFAT, LUKS encryption, LVM, RAID, and many other filesystems:
```shell
# English (default)
/bin/bash -c "$(curl -fsSL https://cdn.statically.io/gh/hoochanlon/Free-NTFS-for-Mac/main/ninja/kamui.sh)"
# Japanese
LANG=ja /bin/bash -c "$(curl -fsSL https://cdn.statically.io/gh/hoochanlon/Free-NTFS-for-Mac/main/ninja/kamui.sh)"
# Chinese
LANG=zh /bin/bash -c "$(curl -fsSL https://cdn.statically.io/gh/hoochanlon/Free-NTFS-for-Mac/main/ninja/kamui.sh)"
```
#### Method 2: Download Locally (Shell - Ninja Tools)
After downloading, you can directly type `nigate` to start:
```shell
curl https://fastly.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac/ninja/nigate.sh > ~/Public/nigate.sh && sudo -S mkdir -p /usr/local/bin && cd /usr/local/bin && sudo ln -s ~/Public/nigate.sh nigate.shortcut && echo "alias nigate='bash nigate.shortcut'" >> ~/.zshrc && osascript -e 'tell application "Terminal" to do script "nigate"'
```
#### Method 3: GUI Version (Electron)
Download and use from [tags](https://github.com/hoochanlon/Free-NTFS-for-Mac/tags).
- **🌍 Application interface supports multiple languages**: Chinese (Simplified/Traditional), Japanese, English, German, and more
**Tray**
### Dependency Management
#### One-Click Install Dependencies
```shell
# English (default)
/bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac@main/ninja/kunai.sh)"
# Japanese
LANG=ja /bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac@main/ninja/kunai.sh)"
# Chinese
LANG=zh /bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac@main/ninja/kunai.sh)"
```
#### One-Click Uninstall Dependencies
```shell
# English (default)
/bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac@main/ninja/ninpo.sh)"
# Japanese
LANG=ja /bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac@main/ninja/ninpo.sh)"
# Chinese
LANG=zh /bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac@main/ninja/ninpo.sh)"
```
### System Permission Settings
Configure system permissions and security settings (Gatekeeper, SIP, etc.):
```shell
# English (default)
/bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac@main/ninja/shuriken.sh)"
# Japanese
LANG=ja /bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac@main/ninja/shuriken.sh)"
# Chinese
LANG=zh /bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac@main/ninja/shuriken.sh)"
```
> For more information, see: [Ninja Tools Testing #39](https://github.com/hoochanlon/Free-NTFS-for-Mac/issues/39) and [Ninja Tools Documentation](docs/07-忍者工具集内容说明.md)
### Operations & Development
### 🚀 One-Click Run (Recommended for Beginners)
**Users without any development environment can deploy in one step!**
The project provides intelligent one-click run scripts that automatically detect and install all necessary tools (Node.js, pnpm, dependencies, etc.), then automatically compile and start the application.
#### Method 1: Use One-Click Script in Project Root (Recommended)
```bash
# Clone project
git clone
cd Free-NTFS-for-Mac
# One-click run (auto-install environment, compile, start)
./dev.sh
```
Or use the script in the ninja directory:
```bash
./ninja/izanaki.sh
```
**The script automatically completes:**
- ✅ Detects and installs Node.js (if not present)
- ✅ Detects and installs pnpm (if not present)
- ✅ Syncs version numbers
- ✅ Installs project dependencies
- ✅ Compiles TypeScript code
- ✅ Compiles Stylus styles
- ✅ Starts application (development mode)
#### Method 2: Manual Installation (For Experienced Developers)
1. **Clone and Initialize**
```bash
git clone
cd Free-NTFS-for-Mac
pnpm install
```
2. **Run Application**
```bash
# Production mode
pnpm start
# Development mode (automatically opens DevTools)
pnpm run dev
```
3. **Build Application**
```bash
pnpm run build
```
### 🌍 Multi-Language Support
All scripts and tools support multiple languages, can be set via `LANG` environment variable:
```bash
# English (default)
./dev.sh
# Japanese
LANG=ja ./dev.sh
# Chinese
LANG=zh ./dev.sh
```
Supported scripts include:
- `dev.sh` / `ninja/izanaki.sh` - One-click run script
- `ninja/kamui.sh` - Linux filesystem mount
- `ninja/nigate.sh` - NTFS auto mount
- `ninja/build.sh` - Application packaging
- `ninja/shuriken.sh` - System permission settings
- And all other ninja tools collection scripts
#### Project Setup Script
If you encounter errors with `pnpm run dev`, run the setup script to fix them:
```bash
pnpm run setup
```
Or run directly:
```bash
./ninja/izanaki.sh
```
This script automatically:
- ✅ Checks if required files exist
- ✅ Sets script execution permissions
- ✅ Creates necessary directory structure
- ✅ Syncs version numbers
- ✅ Compiles TypeScript and Stylus
- ✅ Verifies critical files
After building, you can find the packaged application in the `dist` directory.
### Mac Packaging Instructions
After packaging, the following will be generated in the `dist` directory:
- **DMG File**: Installation package for distribution
- **ZIP File**: Compressed application package
Other notes:
- Use `./ninja/build.sh` script for more flexible packaging
- First run may require right-clicking the application and selecting "Open" (macOS security restrictions)
### Troubleshooting
#### Mount Failure
1. Check if all dependencies are installed
2. Confirm the device is not occupied by other programs
3. If it's a Windows Fast Startup issue, fully shut down the device in Windows
#### Dependency Installation Failure
1. Ensure network connection is normal
2. Check if Homebrew is correctly installed
3. May need to manually run installation commands in terminal
#### Application Won't Start
1. Check if Node.js version meets requirements
2. Delete `node_modules` and rerun `pnpm install`
3. Check console error messages
### Acknowledgments
Thank you to all developers, testers, and users who have contributed to this project! See [ACKNOWLEDGMENTS.md](ACKNOWLEDGMENTS.md) for details.
[^1]: **Note**: Using this tool to mount or modify NTFS devices carries a risk of data loss. It is strongly recommended to backup important data before operation. This tool is provided "as is" without any warranty. The developer is not responsible for data loss caused by using this tool.
[^2]: Powered by [nohajc/anylinuxfs](https://github.com/nohajc/anylinuxfs) with secondary encapsulation