Native Amiga Filesystems on macOS / Linux / Windows with FUSE

Summary

amifuse Mount Amiga filesystem images on macOS/Linux/Windows using native AmigaOS filesystem handlers via FUSE. amifuse runs actual Amiga filesystem drivers (like PFS3) through m68k CPU emulation, allowing you to read Amiga hard disk images without relying on reverse-engineered implementations. Requirements macOS : macFUSE : macFUSE Linux : FUSE for Linux : FUSE for Linux Windows : WinFSP : WinFSP Python 3.9+ 7z : Required for make unpack (install via brew install p7zip on macOS) : Required for (install via on macOS) A filesystem handler: e.g. pfs3aio (or use make download ) Installation # Clone the repository with submodules git clone --recursive https://github.com/reinauer/amifuse.git cd amifuse # Or if already cloned, initialize submodules git submodule update --init With virtual environment (recommended) python3 -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate pip install -e ' ./amitools[vamos] ' # Install amitools from submodule (includes machine68k) pip install -e . # Install amifuse Without virtual environment pip install --user -e ' ./amitools[vamos] ' pip install --user -e . Install macFUSE from https://osxfuse.github.io/ or via Homebrew: brew install --cask macfuse You may need to reboot and allow the kernel extension in System Preferences > Security & Privacy. # Debian/Ubuntu sudo apt install fuse libfuse-dev # Fedora sudo dnf install fuse fuse-devel Quick Start To download a test PFS3 disk image and the pfs3aio handler: make download # Downloads pfs.7z and pfs3aio to Downloads/ make unpack # Extracts pfs.hdf and copies pfs3aio to current directory Then mount with: # macOS: auto-mounts to /Volumes/<partition_name>, uses embedded driver from RDB amifuse mount pfs.hdf # Linux: requires explicit mountpoint mkdir -p ./mnt amifuse mount pfs.hdf --mountpoint ./mnt Usage amifuse uses subcommands for different operations: amifuse inspect < image > # Inspect RDB partitions amifuse mount < image > # Mount a filesystem Inspecting Disk Ima...