{"id":16567626,"url":"https://github.com/hoochanlon/free-ntfs-for-mac","last_synced_at":"2026-01-22T11:02:27.148Z","repository":{"id":65009587,"uuid":"580705530","full_name":"hoochanlon/Free-NTFS-for-Mac","owner":"hoochanlon","description":"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 ","archived":false,"fork":false,"pushed_at":"2026-01-18T13:02:33.000Z","size":128860,"stargazers_count":1274,"open_issues_count":2,"forks_count":85,"subscribers_count":7,"default_branch":"main","last_synced_at":"2026-01-18T15:14:41.095Z","etag":null,"topics":["arm","intel","m1","macos","nigate","ntfs","ntfs-3g","osxfuse"],"latest_commit_sha":null,"homepage":"https://hoochanlon.github.io/Free-NTFS-for-Mac","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"zlib","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hoochanlon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-12-21T08:35:27.000Z","updated_at":"2026-01-18T14:42:50.000Z","dependencies_parsed_at":"2023-02-12T08:00:24.910Z","dependency_job_id":"c7e37419-d763-4812-a4b9-fd5106d8f110","html_url":"https://github.com/hoochanlon/Free-NTFS-for-Mac","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/hoochanlon/Free-NTFS-for-Mac","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoochanlon%2FFree-NTFS-for-Mac","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoochanlon%2FFree-NTFS-for-Mac/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoochanlon%2FFree-NTFS-for-Mac/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoochanlon%2FFree-NTFS-for-Mac/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hoochanlon","download_url":"https://codeload.github.com/hoochanlon/Free-NTFS-for-Mac/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoochanlon%2FFree-NTFS-for-Mac/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28661882,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-22T01:17:37.254Z","status":"online","status_checked_at":"2026-01-22T02:00:07.137Z","response_time":144,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arm","intel","m1","macos","nigate","ntfs","ntfs-3g","osxfuse"],"created_at":"2024-10-11T21:07:06.000Z","updated_at":"2026-01-22T11:02:27.142Z","avatar_url":"https://github.com/hoochanlon.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Nigate\n\n**Language / 言語 / 语言**: [English](README.md) | [日本語](README.ja.md) | [中文](README.cn.md)\n\n![Main Interface](src/imgs/example/2026-01-21-10.51.01.png)\n\nThis 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]\n\n### Features\n\n- 🎨 **Modern Interface** - Dark theme with clean and beautiful design\n- 📱 **Real-time Monitoring** - Automatically detects NTFS device connections\n- ✅ **Dependency Check** - Automatically checks and installs required system dependencies\n- 🔄 **One-Click Mount** - Easily mount read-only NTFS devices in read-write mode\n- ⚡ **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\n- 📊 **Status Display** - Clearly displays device status and operation logs\n- 🛡️ **Secure \u0026 Reliable** - Uses Electron security best practices\n- ☕ **Prevent Sleep** - One-click toggle to prevent system sleep, ensuring the system stays awake during long operations\n- 🍃 **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\n- 🥷 **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\n\n### Important Notes\n\n\u003e [!important]\n\u003e **Read-Write Notes**:\n\u003e  - **Basic Operations**: Supports file copy, cut, delete, and rename (metadata-level operations)\n\u003e  - **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\n\u003e  - **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\n\u003e  - **Additional Note**: Ninja Tools `/ninja/kamui.sh` supports direct in-place data modification on original files, suitable for scenarios requiring direct file editing [^2]\n\n- **Administrator Privileges**: Mounting operations require administrator privileges, and the system will prompt for a password\n- **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\n- **Device Name**: USB drive names do not support spaces or illegal characters\n- **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\" \u003e \"Privacy \u0026 Security\"\n- **System Integrity Protection (SIP)** (Optional): To disable SIP, you need to operate in Recovery Mode:\n  1. Restart Mac, hold the power button until the Apple logo and progress bar appear, enter Recovery Mode\n  2. Find and open Terminal from the toolbar at the top of the screen, enter command: `csrutil disable`\n  3. Close Terminal and restart Mac\n  4. After restart, you can run `csrutil status` in terminal to check the status\n- **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\n\n### Quick Start\n\n#### Method 1: Online Experience (Shell - Ninja Tools)\n\nThe following scripts are from the `ninja/` folder's Ninja Tools collection, providing command-line support for NTFS and Linux filesystem read-write access.\n\n**🌍 All scripts support multiple languages!** Use `LANG=ja` or `LANG=zh` to set the language.\n\n##### NTFS Read-Write Support\n\nCopy and paste into a ***terminal with full administrative privileges*** and press Enter:\n\n```shell\n# English (default)\n/bin/bash -c \"$(curl -fsSL https://cdn.statically.io/gh/hoochanlon/Free-NTFS-for-Mac/main/ninja/nigate.sh)\"\n\n# Japanese\nLANG=ja /bin/bash -c \"$(curl -fsSL https://cdn.statically.io/gh/hoochanlon/Free-NTFS-for-Mac/main/ninja/nigate.sh)\"\n\n# Chinese\nLANG=zh /bin/bash -c \"$(curl -fsSL https://cdn.statically.io/gh/hoochanlon/Free-NTFS-for-Mac/main/ninja/nigate.sh)\"\n```\n\n##### Linux ext4 and Other Filesystem Read-Write Support\n\nSupports ext2/3/4, btrfs, xfs, zfs, NTFS, exFAT, LUKS encryption, LVM, RAID, and many other filesystems:\n\n```shell\n# English (default)\n/bin/bash -c \"$(curl -fsSL https://cdn.statically.io/gh/hoochanlon/Free-NTFS-for-Mac/main/ninja/kamui.sh)\"\n\n# Japanese\nLANG=ja /bin/bash -c \"$(curl -fsSL https://cdn.statically.io/gh/hoochanlon/Free-NTFS-for-Mac/main/ninja/kamui.sh)\"\n\n# Chinese\nLANG=zh /bin/bash -c \"$(curl -fsSL https://cdn.statically.io/gh/hoochanlon/Free-NTFS-for-Mac/main/ninja/kamui.sh)\"\n```\n\n#### Method 2: Download Locally (Shell - Ninja Tools)\n\nAfter downloading, you can directly type `nigate` to start:\n\n```shell\ncurl https://fastly.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac/ninja/nigate.sh \u003e ~/Public/nigate.sh \u0026\u0026 sudo -S mkdir -p /usr/local/bin \u0026\u0026 cd /usr/local/bin \u0026\u0026 sudo ln -s ~/Public/nigate.sh nigate.shortcut \u0026\u0026 echo \"alias nigate='bash nigate.shortcut'\" \u003e\u003e ~/.zshrc \u0026\u0026 osascript -e 'tell application \"Terminal\" to do script \"nigate\"'\n```\n\n#### Method 3: GUI Version (Electron)\n\nDownload and use from [tags](https://github.com/hoochanlon/Free-NTFS-for-Mac/tags).\n\n- **🌍 Application interface supports multiple languages**: Chinese (Simplified/Traditional), Japanese, English, German, and more\n\n**Tray**\n\n![ ](src/imgs/example/2026-01-21-10.52.29.png)\n\n### Dependency Management\n\n#### One-Click Install Dependencies\n\n```shell\n# English (default)\n/bin/bash -c \"$(curl -fsSL https://cdn.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac@main/ninja/kunai.sh)\"\n\n# Japanese\nLANG=ja /bin/bash -c \"$(curl -fsSL https://cdn.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac@main/ninja/kunai.sh)\"\n\n# Chinese\nLANG=zh /bin/bash -c \"$(curl -fsSL https://cdn.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac@main/ninja/kunai.sh)\"\n```\n\n#### One-Click Uninstall Dependencies\n\n```shell\n# English (default)\n/bin/bash -c \"$(curl -fsSL https://cdn.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac@main/ninja/ninpo.sh)\"\n\n# Japanese\nLANG=ja /bin/bash -c \"$(curl -fsSL https://cdn.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac@main/ninja/ninpo.sh)\"\n\n# Chinese\nLANG=zh /bin/bash -c \"$(curl -fsSL https://cdn.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac@main/ninja/ninpo.sh)\"\n```\n\n### System Permission Settings\n\nConfigure system permissions and security settings (Gatekeeper, SIP, etc.):\n\n```shell\n# English (default)\n/bin/bash -c \"$(curl -fsSL https://cdn.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac@main/ninja/shuriken.sh)\"\n\n# Japanese\nLANG=ja /bin/bash -c \"$(curl -fsSL https://cdn.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac@main/ninja/shuriken.sh)\"\n\n# Chinese\nLANG=zh /bin/bash -c \"$(curl -fsSL https://cdn.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac@main/ninja/shuriken.sh)\"\n```\n\n\u003e 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)\n\n### Operations \u0026 Development\n\n### 🚀 One-Click Run (Recommended for Beginners)\n\n**Users without any development environment can deploy in one step!**\n\nThe 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.\n\n#### Method 1: Use One-Click Script in Project Root (Recommended)\n\n```bash\n# Clone project\ngit clone \u003crepository-url\u003e\ncd Free-NTFS-for-Mac\n\n# One-click run (auto-install environment, compile, start)\n./dev.sh\n```\n\nOr use the script in the ninja directory:\n\n```bash\n./ninja/izanaki.sh\n```\n\n**The script automatically completes:**\n- ✅ Detects and installs Node.js (if not present)\n- ✅ Detects and installs pnpm (if not present)\n- ✅ Syncs version numbers\n- ✅ Installs project dependencies\n- ✅ Compiles TypeScript code\n- ✅ Compiles Stylus styles\n- ✅ Starts application (development mode)\n\n#### Method 2: Manual Installation (For Experienced Developers)\n\n1. **Clone and Initialize**\n\n```bash\ngit clone \u003crepository-url\u003e\ncd Free-NTFS-for-Mac\npnpm install\n```\n\n2. **Run Application**\n\n```bash\n# Production mode\npnpm start\n\n# Development mode (automatically opens DevTools)\npnpm run dev\n```\n\n3. **Build Application**\n\n```bash\npnpm run build\n```\n\n### 🌍 Multi-Language Support\n\nAll scripts and tools support multiple languages, can be set via `LANG` environment variable:\n\n```bash\n# English (default)\n./dev.sh\n\n# Japanese\nLANG=ja ./dev.sh\n\n# Chinese\nLANG=zh ./dev.sh\n```\n\nSupported scripts include:\n- `dev.sh` / `ninja/izanaki.sh` - One-click run script\n- `ninja/kamui.sh` - Linux filesystem mount\n- `ninja/nigate.sh` - NTFS auto mount\n- `ninja/build.sh` - Application packaging\n- `ninja/shuriken.sh` - System permission settings\n- And all other ninja tools collection scripts\n\n#### Project Setup Script\n\nIf you encounter errors with `pnpm run dev`, run the setup script to fix them:\n\n```bash\npnpm run setup\n```\n\nOr run directly:\n\n```bash\n./ninja/izanaki.sh\n```\n\nThis script automatically:\n- ✅ Checks if required files exist\n- ✅ Sets script execution permissions\n- ✅ Creates necessary directory structure\n- ✅ Syncs version numbers\n- ✅ Compiles TypeScript and Stylus\n- ✅ Verifies critical files\n\nAfter building, you can find the packaged application in the `dist` directory.\n\n### Mac Packaging Instructions\n\nAfter packaging, the following will be generated in the `dist` directory:\n- **DMG File**: Installation package for distribution\n- **ZIP File**: Compressed application package\n\nOther notes:\n- Use `./ninja/build.sh` script for more flexible packaging\n- First run may require right-clicking the application and selecting \"Open\" (macOS security restrictions)\n\n### Troubleshooting\n\n#### Mount Failure\n\n1. Check if all dependencies are installed\n2. Confirm the device is not occupied by other programs\n3. If it's a Windows Fast Startup issue, fully shut down the device in Windows\n\n#### Dependency Installation Failure\n\n1. Ensure network connection is normal\n2. Check if Homebrew is correctly installed\n3. May need to manually run installation commands in terminal\n\n#### Application Won't Start\n\n1. Check if Node.js version meets requirements\n2. Delete `node_modules` and rerun `pnpm install`\n3. Check console error messages\n\n### Acknowledgments\n\nThank you to all developers, testers, and users who have contributed to this project! See [ACKNOWLEDGMENTS.md](ACKNOWLEDGMENTS.md) for details.\n\n[^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.\n\n[^2]: Powered by [nohajc/anylinuxfs](https://github.com/nohajc/anylinuxfs) with secondary encapsulation\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhoochanlon%2Ffree-ntfs-for-mac","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhoochanlon%2Ffree-ntfs-for-mac","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhoochanlon%2Ffree-ntfs-for-mac/lists"}