Skip to content

fenio/anylinuxfs-gui

Repository files navigation

anylinuxfs GUI

A macOS GUI application for anylinuxfs - mount Linux filesystems (ext4, btrfs, XFS, etc.) on macOS.

Features

  • Disk Management - Browse and mount Linux partitions (ext2/3/4, btrfs, XFS, ZFS, etc.)
  • Safe Eject - Properly unmount and eject external drives with one click
  • Encrypted Drives - Support for LUKS and BitLocker encrypted volumes
  • Embedded VM Shell - Interactive terminal with image selector (Alpine Linux or FreeBSD)
  • Custom Actions - Create and manage mount/unmount hooks with environment variables
  • Image Management - Install/uninstall VM images (Alpine Linux, FreeBSD for ZFS)
  • Package Management - Add/remove custom Alpine packages to extend VM capabilities
  • Real-time Monitoring - Live mount status and log viewer with follow mode
  • VM Configuration - Customize RAM, vCPUs, and log verbosity
  • System Tray - Menu bar icon with quick access to show/hide, unmount, and quit
  • Admin Mode - Privilege escalation for accessing disks that require sudo
  • Launch at Login - Optional auto-start via macOS Launch Agent
  • Quit Protection - Warns before quitting if a filesystem is still mounted
  • Force Cleanup - Detect and clean up orphaned VM instances from failed mounts
  • Auto-refresh - Disk list updates automatically when drives are connected/ejected
  • Native macOS - Light/dark mode support, Apple Silicon optimized

Installation

Homebrew (recommended)

brew install fenio/tap/anylinuxfs-gui

This will automatically install the anylinuxfs CLI dependency.

If you get "damaged" or Gatekeeper warnings, run:

xattr -cr /Applications/anylinuxfs-gui.app

Manual

Download the latest DMG from Releases, open it, and drag the app to Applications.

Important: The app is not notarized by Apple. After installation, remove the quarantine attribute:

xattr -cr /Applications/anylinuxfs-gui.app

Then you can open the app normally.

Screenshots

Disks Shell Images Packages Actions Logs Settings

Requirements

  • macOS (Apple Silicon)
  • anylinuxfs CLI (installed automatically via Homebrew)

Building from Source

Prerequisites

Build

npm install
npm run tauri build

The built app will be at src-tauri/target/release/bundle/macos/anylinuxfs-gui.app

Credits

Logo designed by Junaid Iqbal.

License

GPL-3.0 - see LICENSE