Features
Shared folders
Share a folder permanently from the VM's Settings, Virtual Machine › Shared Folders, or the command line. Changes reach a running VM right away.
hangar share add <vm> <path> [--read-only]
hangar run <vm> --dir [name:]path[:ro]The first shares a folder for good; the second shares it for one run only.
Where the folder appears
| Guest | Where the folder appears |
|---|---|
| macOS | /Volumes/My Shared Files/<name> |
| Windows | Z:\<name> |
| Linux | /mnt/hangar/<name>, mounted by Hangar's agent (without it: sudo mount -t virtiofs hangar /mnt/hangar) |
Drop and Tools are Hangar's own names, so your shared folders can't use them.
Drag and drop
Drop files or folders onto a running VM's window to copy them in. In macOS, Windows and GTK 4 Linux desktops such as GNOME with Hangar's agent, they land where you let go: on the desktop, in a Finder, File Explorer or Files window, or in an app that accepts files.
How it works: Hangar copies them to the VM's Drop share, which is always there. The agent then puts a transparent window over the screen, and Hangar replays a short click-and-drag at the drop point, so the guest makes a drag of its own.
Copies the guest refuses, and files sent with hangar drop <vm> <files>, stay where they always went:
| Guest | Dropped files |
|---|---|
| macOS | Moved to Downloads |
| Windows | Z:\Drop |
| Linux | /mnt/hangar/Drop |
Symbolic links are skipped. The guest can write into this folder, like any read-write share.
Windows VMs get the agent's drag helper when they're installed; macOS and Linux VMs get it from Virtual Machine › Install Guest Agent… (Linux needs GTK 4).