Skip to content

hoochanlon/Free-NTFS-for-Mac

BranchesTags

Repository files navigation

Nigate

Language / 言語 / 语言: English | 日本語 | 中文

中文

这是 Nigate 的 Electron 图形界面版本，在保留原有极客终端版本的同时，提供了现代化、直观的操作界面，让 NTFS 设备管理更加简单便捷。1

功能特性

  • 🎨 现代化界面 - 采用深色主题，界面简洁美观
  • 📱 实时监控 - 自动检测 NTFS 设备接入
  • ✅ 依赖检查 - 自动检查并安装所需系统依赖
  • 🔄 一键挂载 - 轻松将只读 NTFS 设备挂载为读写模式
  • 📊 状态显示 - 清晰显示设备状态和操作日志
  • 🛡️ 安全可靠 - 使用 Electron 安全最佳实践

使用说明

首次使用

  1. 检查系统依赖

    • 打开应用后，点击"检查依赖"按钮
    • 系统会自动检查所需的依赖（Swift、Homebrew、MacFUSE、ntfs-3g）
    • 如果有缺失的依赖，点击"安装缺失依赖"按钮进行安装

  2. 挂载 NTFS 设备

    • 插入 NTFS 格式的移动存储设备
    • 应用会自动检测设备（每 5 秒刷新一次）
    • 对于只读设备，点击"挂载为读写"按钮
    • 输入管理员密码完成挂载

注意事项

  • 管理员权限：挂载操作需要管理员权限，系统会提示输入密码
  • Windows 快速启动：如果设备在 Windows 中使用了快速启动功能，可能导致挂载失败。建议在 Windows 中完全关闭（而非休眠），或禁用快速启动功能
  • 设备名称：U盘名称不支持空格与非法字符
  • 系统完整性保护：首次使用可能需要禁用系统完整性保护（SIP），在终端运行：sudo spctl --master-disable

快速开始，两种方式，任选其一 （Shell）

一、在线体验，复制粘贴到 完全管理权限的终端 回车，一键起飞。

/bin/bash -c "$(curl -fsSL https://cdn.statically.io/gh/hoochanlon/Free-NTFS-for-Mac/main/nigate.sh)"

二、下载到本地，往后开启可直接输入nigate

curl https://fastly.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac/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"'

快速开始，图形化软件版（Electron）

下载使用，见tags

主界面

托盘

运维 & 开发

安装步骤

  1. 安装依赖
pnpm install
  1. 运行应用
pnpm start

或开发模式（自动打开 DevTools）：

pnpm run dev
  1. 构建应用
pnpm run build

构建完成后，可在 dist 目录找到打包好的应用。

Mac 打包说明

打包完成后，会在 dist 目录生成：

  • DMG 文件：用于分发的安装包
  • ZIP 文件：压缩的应用包

其他打包选项：

  • 使用 ./build.sh 脚本进行更灵活的打包
  • 首次运行可能需要右键点击应用选择"打开"（macOS 安全限制）

故障排除

挂载失败

  1. 检查是否已安装所有依赖
  2. 确认设备未被其他程序占用
  3. 如果是 Windows 快速启动问题，请在 Windows 中完全关闭设备

依赖安装失败

  1. 确保网络连接正常
  2. 检查 Homebrew 是否正确安装
  3. 可能需要手动在终端运行安装命令

应用无法启动

  1. 检查 Node.js 版本是否符合要求
  2. 删除 node_modules 并重新运行 pnpm install
  3. 查看控制台错误信息

English

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.2

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
  • 📊 Status Display - Clearly displays device status and operation logs
  • 🛡️ Secure & Reliable - Uses Electron security best practices

Usage Instructions

First Time Use

  1. Check System Dependencies

    • After opening the application, click the "Check Dependencies" button
    • The system will automatically check required dependencies (Swift, Homebrew, MacFUSE, ntfs-3g)
    • If any dependencies are missing, click "Install Missing Dependencies" to install them

  2. Mount NTFS Devices

    • Insert an NTFS-formatted removable storage device
    • The application will automatically detect the device (refreshes every 5 seconds)
    • For read-only devices, click the "Mount as Read-Write" button
    • Enter administrator password to complete mounting

Important Notes

  • 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
  • System Integrity Protection: First-time use may require disabling System Integrity Protection (SIP). Run in terminal: sudo spctl --master-disable

Quick Start - Two Methods (Shell)

Method 1: Online Experience

Copy and paste into a terminal with full administrative privileges and press Enter:

/bin/bash -c "$(curl -fsSL https://cdn.statically.io/gh/hoochanlon/Free-NTFS-for-Mac/main/nigate.sh)"

Method 2: Download Locally

After downloading, you can directly type nigate to start:

curl https://fastly.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac/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"'

Quick Start - GUI Version (Electron)

Download and use from tags

Main Interface

Tray

Operations & Development

Installation Steps

  1. Install Dependencies
pnpm install
  1. Run Application
pnpm start

Or development mode (automatically opens DevTools):

pnpm run dev
  1. Build Application
pnpm run build

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 Packaging Options:

  • Use ./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

日本語

これは Nigate の Electron グラフィカルインターフェース版で、元の極客ターミナル版を保持しながら、NTFS デバイス管理をより簡単で便利にする、現代的で直感的な操作インターフェースを提供します。3

機能特性

  • 🎨 現代的インターフェース - ダークテーマを採用し、シンプルで美しいデザイン
  • 📱 リアルタイム監視 - NTFS デバイスの接続を自動検出
  • ✅ 依存関係チェック - 必要なシステム依存関係を自動チェック・インストール
  • 🔄 ワンクリックマウント - 読み取り専用 NTFS デバイスを読み書きモードで簡単にマウント
  • 📊 ステータス表示 - デバイスの状態と操作ログを明確に表示
  • 🛡️ 安全で信頼性が高い - Electron のセキュリティベストプラクティスを使用

使用説明

初回使用

  1. システム依存関係のチェック

    • アプリケーションを開いた後、「依存関係をチェック」ボタンをクリック
    • システムは必要な依存関係（Swift、Homebrew、MacFUSE、ntfs-3g）を自動的にチェックします
    • 不足している依存関係がある場合、「不足している依存関係をインストール」ボタンをクリックしてインストールします

  2. NTFS デバイスのマウント

    • NTFS フォーマットのリムーバブルストレージデバイスを挿入
    • アプリケーションは自動的にデバイスを検出します（5秒ごとに更新）
    • 読み取り専用デバイスの場合、「読み書きとしてマウント」ボタンをクリック
    • 管理者パスワードを入力してマウントを完了

注意事項

  • 管理者権限: マウント操作には管理者権限が必要で、システムがパスワードの入力を求めます
  • Windows 高速スタートアップ: デバイスが Windows で高速スタートアップ機能を使用している場合、マウントが失敗する可能性があります。Windows で完全にシャットダウン（スリープではなく）するか、高速スタートアップ機能を無効にすることをお勧めします
  • デバイス名: USB ドライブ名はスペースと不正な文字をサポートしていません
  • システム整合性保護: 初回使用時は、システム整合性保護（SIP）を無効にする必要がある場合があります。ターミナルで実行: sudo spctl --master-disable

クイックスタート - 2つの方法（Shell）

方法1: オンライン体験

完全な管理権限を持つターミナルにコピー＆ペーストして Enter キーを押してください：

/bin/bash -c "$(curl -fsSL https://cdn.statically.io/gh/hoochanlon/Free-NTFS-for-Mac/main/nigate.sh)"

方法2: ローカルにダウンロード

ダウンロード後、nigate と直接入力して起動できます：

curl https://fastly.jsdelivr.net/gh/hoochanlon/Free-NTFS-for-Mac/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"'

クイックスタート - グラフィカルソフトウェア版（Electron）

tags からダウンロードして使用

メインインターフェース

トレイ

運用 & 開発

インストール手順

  1. 依存関係のインストール
pnpm install
  1. アプリケーションの実行
pnpm start

または開発モード（DevTools を自動的に開く）：

pnpm run dev
  1. アプリケーションのビルド
pnpm run build

ビルド完了後、dist ディレクトリにパッケージ化されたアプリケーションが見つかります。

Mac パッケージング説明

パッケージング完了後、dist ディレクトリに以下が生成されます：

  • DMG ファイル: 配布用のインストールパッケージ
  • ZIP ファイル: 圧縮されたアプリケーションパッケージ

その他のパッケージングオプション:

  • ./build.sh スクリプトを使用してより柔軟なパッケージングを行う
  • 初回実行時は、アプリケーションを右クリックして「開く」を選択する必要がある場合があります（macOS セキュリティ制限）

トラブルシューティング

マウント失敗

  1. すべての依存関係がインストールされているか確認
  2. デバイスが他のプログラムによって占有されていないことを確認
  3. Windows 高速スタートアップの問題の場合、Windows でデバイスを完全にシャットダウンしてください

依存関係のインストール失敗

  1. ネットワーク接続が正常であることを確認
  2. Homebrew が正しくインストールされているか確認
  3. ターミナルで手動にインストールコマンドを実行する必要がある場合があります

アプリケーションが起動しない

  1. Node.js のバージョンが要件を満たしているか確認
  2. node_modules を削除し、pnpm install を再実行
  3. コンソールのエラーメッセージを確認

Footnotes

  1. 注：使用本工具挂载或修改 NTFS 设备存在数据丢失风险。强烈建议操作前备份重要数据。本工具按"现状"提供，不提供任何担保。因使用本工具造成的数据损失，开发者不承担责任。 ↩

  2. 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. ↩

  3. 注: このツールを使用して NTFS デバイスをマウントまたは変更することは、データ損失のリスクがあります。操作前に重要なデータをバックアップすることを強く推奨します。このツールは「現状のまま」提供され、いかなる保証もありません。このツールの使用によって引き起こされたデータ損失について、開発者は責任を負いません。 ↩

About

Nigate: A fully compatible NTFS read-write solution for Mac, optimized for Apple silicon.

hoochanlon.github.io/Free-NTFS-for-Mac

Topics

macos arm intel ntfs osxfuse m1 ntfs-3g nigate

Resources

Readme

License

Zlib license
Activity

Stars

648 stars

Watchers

7 watching

Forks

54 forks
Report repository

Releases 2

nigate (supports macOS 26 and above) Latest
Sep 29, 2023
+ 1 release

Packages

No packages published

Languages