AksyFS

Prerequisites

AksyFS needs FUSE installed, which is part of any recent Linux kernel and for which a library package is available in all recent Linux distributions (named "libfuse2" on Ubuntu). Mac users can install MacFUSE. Currently, there is no FUSE package for Windows.

Besides the FUSE library, AksyFS now (since changeset:1226) only works with the latest version of the FUSE Python bindings, 0.2pre3 is recommended. This version is not yet available in major Linux distributions, but can be downloaded from the fuse site or automatically installed when using easy_install. See Installation for more information about easy_install.

Usage

mounting: 

aksy-fs <mount point> -osampler_type <z48|mpc4k|s56k>

umounting: 

sudo umount <mount point>

or 

fusermount -u <mount point>

Troubleshooting

To get debugging information, set log level to debug in your AksyConfiguration: 

[logging]
level=DEBUG

Supported Operations

  • reading and writing files to and from any location (memory/disk)
  • file and directory creation, deletion and renaming
  • file moving across locations

This uses the save operation for the direction (memory -> disk), and load for the opposite direction (disk -> memory); hence it doesn't remove the original file.

FAQ

  • Why do a lot of my samples in memory show a size of 512MB, and why do programs and multis also seem to have a fixed size?

The Akai System Exclusive protocol does not have functions to retrieve file sizes of files in memory. In order not to truncate files (a lot of applications will stat() the file before reading it), I've picked a sufficiently high upper limit for the different file types. When they're actually transferred EOF is used to signal the end of the file. After the transfer, a subsequent retrieval of the file metadata (eg. ls -l) will then use the cached file to show the correct file size.

  • I'm getting a 'service loop failed' when unmounting

This exception is caused by a bug in fuse itself, and is harmless.

  • How can I run aksy-fs as non-root user?

Besides setting up the permissions as described in LinuxRunningAsUser, FUSE needs the string 'user_allow_other' in /etc/fuse.conf to be able to mount as non-root user.