FUSE for macOS extends macOS by adding support for FUSE file systems
Shell C
Failed to load latest commit information.
build.d Merge branch 'support/osxfuse-3' Sep 7, 2016
common Merge branch 'support/osxfuse-3' Sep 7, 2016
framework @ 3784fac Create non-existent mount points Aug 22, 2016
fuse @ 3e0cee0 (fuse) Remove obsolete non-portable functions Sep 10, 2016
kext @ 0b91ec7 Merge branch 'support/osxfuse-3' Sep 7, 2016
prefpane @ 40ce5d1 Switch to secure website URL Jun 21, 2016
support @ 5dd5a09 Merge branch 'support/osxfuse-3' Sep 7, 2016
.gitignore Update .gitignore Jun 1, 2016
.gitmodules Remove obsolete Git submodules Feb 15, 2016
LICENSE.txt Merge branch 'support/osxfuse-3' Jun 16, 2016
README.md Merge branch 'support/osxfuse-3' Jun 16, 2016
build.sh Add support for Xcode 8 Jun 16, 2016


FUSE for macOS

FUSE for macOS allows you to extend macOS via third party file systems.

About FUSE for macOS

The FUSE for macOS software package provides multiple APIs for developing file systems for OS X 10.9 to macOS 10.12. It is a successor to MacFUSE, which has been the basis of many products, but is no longer being maintained.

You can use the provided APIs to develop numerous types of file systems, whose content can come from a local disk, from across the network, from memory, or any other source. One of these APIs is a superset of the FUSE API, that originated on Linux.

Due to the fact that FUSE file systems are regular applications (as opposed to kernel extensions), you have just as much flexibility and choice in programming tools, debuggers, and libraries as you have if you were developing standard macOS applications.

For more information visit the website of the FUSE for macOS Project.

Build Instructions

The build script automatically locates all supported installations of Xcode in your Applications folder. It builds a distribution package compatible with the currently running version of macOS.


  • Xcode 4.3 and newer versions do not include autotools and libtool, that are needed to build libosxfuse. Install MacPorts or Homebrew and run the following commands in Terminal to install the required tools:


      sudo port install autoconf automake libtool gettext


      brew install autoconf automake libtool gettext
      brew link --force gettext
  • The "Command Line Tools" package is needed to generate BridgeSupport metadata for OSXFUSE.framework because of a bug in gen_bridge_metadata (hard coded path to cpp).

The Xcode tools packages can be obtained from https://developer.apple.com/downloads/ (free Apple Developer ID required).

To clone the source repository into a newly created subdirectory named osxfuse in the current working directory, run the following command in Terminal:

git clone --recursive -b support/osxfuse-3 git://github.com/osxfuse/osxfuse.git osxfuse

Run the following command in the cloned repository to build FUSE for macOS from source:

./build.sh -t distribution

The resulting distribution package can be found in /tmp/osxfuse/distribution.