{"id":23388243,"url":"https://github.com/guoquan/mountfs","last_synced_at":"2025-04-11T06:28:50.599Z","repository":{"id":263732106,"uuid":"891283559","full_name":"guoquan/mountfs","owner":"guoquan","description":"mouNTFS helps you write to NTFS drives on your Mac","archived":false,"fork":false,"pushed_at":"2024-12-13T08:24:13.000Z","size":46,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-25T04:23:54.269Z","etag":null,"topics":["fuse","macos","ntfs","ntfs-3g"],"latest_commit_sha":null,"homepage":"https://mountfs.sh","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/guoquan.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}},"created_at":"2024-11-20T03:51:32.000Z","updated_at":"2025-02-28T15:18:45.000Z","dependencies_parsed_at":"2024-11-20T06:29:04.098Z","dependency_job_id":"5cb47e92-9225-4b95-9b2a-106ef36ec736","html_url":"https://github.com/guoquan/mountfs","commit_stats":null,"previous_names":["guoquan/mountfs"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guoquan%2Fmountfs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guoquan%2Fmountfs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guoquan%2Fmountfs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guoquan%2Fmountfs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/guoquan","download_url":"https://codeload.github.com/guoquan/mountfs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248354205,"owners_count":21089772,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["fuse","macos","ntfs","ntfs-3g"],"created_at":"2024-12-22T02:18:21.149Z","updated_at":"2025-04-11T06:28:50.572Z","avatar_url":"https://github.com/guoquan.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# *mouNT*FS\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Built-with-AI](https://img.shields.io/badge/Built--with-AI_🤖-blueviolet)](https://github.com/guoquan/mountfs#contributors)\n[![Website](https://img.shields.io/badge/HTTPS-mountfs.sh_🌐-blue)](https://mountfs.sh)\n\n## What's *mouNT*FS\n\n*mouNT*FS (pronounced \"maun-tee-ef-es\") helps you write to NTFS (pronounced \"en-tee-ef-es\") drives on your Mac. No more \"read-only\" frustration! Just select your drive, provide your password to confirm, and you're ready to go - with native macOS dialogs that feel right at home.\n\nCurrently, *mouNT*FS is just one simple shell script that does one thing well - mounting NTFS drives with write access. We keep it clean and focused.\n\n🤝 This project is an experiment in human-AI collaboration, co-developed with AI buddies.\n🤖 All code is written by AI, with 👤 humans focusing on design, review, and direction - no direct human coding.\n🥳 This must be a fun ride, and let's see where it goes.\n\n### Features\n\n- 🤖 Co-developed with AI buddies\n- 📁 Native file picker for volume selection\n- 🔐 Secure password handling through system dialog\n- 📊 Detailed volume information:\n  - Volume name and device path\n  - Current usage and total size\n  - File system and mount status\n- 🔄 Automatic fallback between mount methods\n- ✅ Write access verification\n\n### Under the Hood\n\nThe script safely handles NTFS mounting by first unmounting the volume, then trying the `mount_ntfs` with read-write option. If that fails, it falls back to the more reliable `ntfs-3g`. After mounting, it verifies write access and uses native macOS dialogs throughout the process.\n\n## Getting Started\n\n### Requirements\n\n- macOS - so that you lose NTFS read-write access\n- [Homebrew](https://brew.sh) - to install macFUSE and ntfs-3g, and a lot of cool stuff for macOS 🍺\n- [macFUSE](https://osxfuse.github.io) - FUSE file system support for macOS\n- [ntfs-3g](https://github.com/tuxera/ntfs-3g) - NTFS driver with write support ([macOS version](https://github.com/gromgit/homebrew-fuse))\n\n### Installation\n\n0. Make sure you have [Homebrew](https://brew.sh) installed.\n\n1. Install macFUSE and ntfs-3g-mac:\n\n```bash\nbrew install --cask macfuse\nbrew install gromgit/fuse/ntfs-3g-mac\n```\n\n2. Download `mountfs.sh`:\n\n```bash\ncd ~/Downloads  # or any directory you won't get lost\ncurl -L -o mountfs.sh https://get.mountfs.sh\nchmod +x mountfs.sh\n```\n\n3. Configure security settings:\n   - Trust macFUSE library in Settings → Privacy \u0026 Security (signed by \"Benjamin Fleischer\")\n   - macFUSE needs a kernel extension to be enabled, which requires a system restart\n   - Grant disk access when prompted\n\nNote: These security settings are required by macOS to allow third-party file system drivers. They only need to be configured once, unless you uninstall or reinstall the drivers.\n\nRefer to [macFUSE wiki](https://github.com/macfuse/macfuse/wiki/Getting-Started#how-to-install-macfuse) for more details.\n\n### Usage\n\n1. **Launch**:\n   - Double-click `mountfs.sh` in Finder, *OR*\n   - Run in terminal `./mountfs.sh`\n\n2. **Select Volume**:\n   - Choose your NTFS volume in the native file picker\n   - Non-NTFS volumes will be automatically rejected\n\n3. **Review \u0026 Confirm**:\n   - Check volume information\n   - Confirm the mount operation\n\n4. **Authenticate**:\n   - Enter administrator password in the popup dialog\n\n## Using *mouNT*FS\n\n### Notes\n\n- Requires administrator privileges for mounting\n- Performs safe unmount before remounting\n- Verifies write access after mounting\n- Uses the best available mount method\n\n### Troubleshooting\n\nIf mounting fails:\n\n1. Ensure the volume is NTFS formatted\n2. Check macFUSE and ntfs-3g installation\n3. Try safely ejecting and reconnecting\n4. Check system logs for errors\n\n## Alternatives\n\n- **[Mounty](https://mounty.app/)** - Popular free GUI app for NTFS mounting\n- **[NTFS for Mac by Paragon](https://www.paragon-software.com/home/ntfs-mac/)** - Commercial solution with full NTFS support\n- **[Tuxera NTFS](https://www.tuxera.com/products/tuxera-ntfs-for-mac/)** - Another commercial driver with high performance\n- Feel free to explore other alternatives!\n\n*mouNT*FS focuses on simplicity and native macOS integration while remaining free and open source. We ❤️ open source!\n\n## Information\n\n### Roadmap\n\n- [ ] GUI interface with native macOS look and feel\n- [ ] Better error messages and recovery options\n- [ ] System tray integration for quick access\n- [ ] Volume monitoring for automatic mounting\n- [ ] Localization support for multiple languages\n\n### Contribution\n\nContributions and suggestions are welcome! Feel free to open issues or pull requests.\n\nAs a human-AI collaboration project:\n\n- For **code** contributions, please bring your AI buddy and keep the no-direct-human-coding spirit\n- For **other** contributions (docs, testing, reviews, etc.), both humans and AI buddies are more than welcome!\n\nGiven wide-spread AI concerns, safety review is welcome.\n\n### Contributors\n\n| 🤖 AI | 👤 Humans |\n|-------|-----------|\n| 🦾 [Claude](https://anthropic.com/claude) (3.5 Sonnet, via [Cursor](https://cursor.sh))\u003cbr\u003e 🧠 [GPT](https://openai.com/index/gpt-4/) (GPT-4o) | 🐰 [guoquan](https://guoquan.net) |\n\n### License\n\n[MIT License](LICENSE) © 2024 Quan Guo\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguoquan%2Fmountfs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguoquan%2Fmountfs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguoquan%2Fmountfs/lists"}