Files

T

david 9f107b5f80 Initial commit: akai-fetch - AKAI sampler ISO downloader & extractor

- fetch: Go CLI tool for searching, downloading, and extracting
  AKAI sampler ISOs from archive.org
- scripts/extract_wavs.sh: Shell script driving akaiutil to
  convert samples to WAV
- Dockerfile: Multi-stage build packaging akaiutil + fetch
- third_party/akaiutil: Vendored akaiutil v4.6.7 source (GPLv2)
- docs/akaiutil.md: Full akaiutil reference

2026-06-15 22:33:53 -07:00

8.4 KiB

Raw Blame History

akaiutil — AKAI Sampler Filesystem Tool

Version 4.6.7 (21-OCT-2022) — GPLv2 — by Klaus Michael Indlekofer

Interactive console-based file manager for AKAI S900/S950/S1000/S1100/S3000/CD3000 sampler disk images, floppies, hard drives, and CD-ROMs.

Usage

akaiutil [-h] [-r] [-F] [-C] [-l <lock-file>] [-o <start-offset>] [-s <pseudo-disk-size>]
         [-n <pseudo-disk-number>] [-c <cdrom-index> ...] [-p <physdrive-index> ...]
         [[-f] <floppy-drive>] ... [[-f] <disk-file>] ...

Options

Flag	Description
`-h`	Print help
`-r`	Read-only mode (must come first)
`-F`	Disable floppy filesystem detection
`-C`	Disable block cache
`-l <file>`	Lock file for exclusive access
`-o <offset>`	Byte offset where disk data starts (decimal or `0x` hex)
`-s <size>`	Pseudo-disk size in KB (for multi-disk images)
`-n <num>`	Max pseudo-disks per file descriptor (max 8)
`-c <n>`	(Windows) Open CD-ROM `\\.\cdromN`
`-p <n>`	(Windows) Open physical drive `\\.\physicaldriveN`

On Linux, pass raw devices like /dev/da1, /dev/disk2s0.

Examples

# Open a floppy image
akaiutil fff.img

# Open harddisk images
akaiutil hhh1.img hhh2.img

# Multi-harddisk image with explicit size
akaiutil -s 524280 mmm.img

# Linux raw device access
akaiutil /dev/da1 hhh.img

# Read-only CD-ROM (macOS)
akaiutil -r /dev/disk2s0

Virtual Filesystem

/disk<N>/<partition-letter>/<volume-name>/<file-name>

Shorthand: /N = /diskN, /floppyN = /diskN/A/<volume1>. Use _ for spaces in names. . and .. work as usual.

Interactive Commands

Command	Alias	Description
`help [<cmd>]`	`man`	List commands or show help for a command
`exit` / `quit`	`bye`, `q`	Exit
`restart`	—	Rescan disks
`restartkeep`	`restart.`, `sync`	Rescan, keep current directory
`df`	—	Show disk info (all disks + partitions)
`dinfo`	`pwd`	Show current directory info
`cd [<path>]`	—	Change directory
`cdi <index>`	—	Change to volume by index
`dir [<path>]`	`ls`	List directory
`dirrec`	`lsrec`	Recursive listing
`lcd <path>`	—	Change local (host) directory
`ldir`	`lls`	List local directory
`dircache`	`lscache`	Show block cache info

File Operations

Command	Alias	Description
`del <path>` / `deli <idx>`	`rm` / `rmi`	Delete file
`ren <old> <new> [<idx>]`	`mv`	Rename/move file
`reni <old-idx> <new> [<idx>]`	`mvi`	Rename by index
`copy <src> <dst> [<idx>]`	`cp`	Copy file
`copyi <src-idx> <dst> [<idx>]`	`cpi`	Copy by index
`infoi <idx>`	—	Show file info
`infoall`	—	Show info for all files

Import / Export

Command	Alias	Description
`get <path> [<begin> [<end>]]`	`export`	Export file to host
`geti <idx> [<begin> [<end>]]`	`exporti`	Export by index
`getall`	`exportall`	Export all files
`put [<vol>/]<name> [<idx>]`	`import`	Import file (use `*` for all)
`getdisk <file>`	`dget`, `dexport`	Export entire disk image
`putdisk <file>`	`dput`, `dimport`	Import disk image
`getpart [<path>] <file>`	`pget`, `pexport`	Export partition
`putpart <file> [<path>]`	`pput`, `pimport`	Import partition
`gettags <file>`	`tagsget`	Export partition tags
`puttags <file>`	`tagsput`	Import partition tags

WAV Conversion

Command	Alias	Description
`sample2wav <path>` / `sample2wavi <idx>`	`s2wav` / `getwav`	Sample → WAV
`sample2wavall`	`s2wavall`	All samples → WAV
`wav2sample <file> [<idx>]`	`wav2s`, `putwav`	WAV → sample (auto-detect)
`wav2sample9` / `wav2sample9c`	`putwav9` / `putwav9c`	WAV → S900 (non-compressed / compressed)
`wav2sample1`	`putwav1`	WAV → S1000
`wav2sample3`	`putwav3`	WAV → S3000

WAV input must be mono/stereo, 8/16/24/32-bit PCM.

S900 Compression

Command	Alias	Description
`sample900compr <path>`	`s9compr`	Compress S900 sample
`sample900comprall`	`s9comprall`	Compress all S900 samples
`sample900uncompr <path>`	`s9uncompr`	Uncompress S900 sample
`sample900uncomprall`	`s9uncomprall`	Uncompress all

Volume Management

Command	Alias	Description
`mkvol [<path>]`	`mkdir`	Create volume (auto-detect type)
`mkvol9` / `mkvol1` / `mkvol3` / `mkvol3cd`	`mkdir9` etc.	Create S900/S1000/S3000/CD3000 volume
`mkvoli <idx> [<name> [<load-num>]]`	`mkdiri`	Create volume at specific index
`delvol <path>` / `delvoli <idx>`	`rmdir`	Delete volume
`wipevol <path>` / `wipevoli <idx>`	`rmall`	Wipe all files in volume
`renvol <old> <new>`	`mvdir`	Rename volume
`copyvol <src> <dst>` / `copyvoli <idx> <dst>`	`cpvol`	Copy volume
`copypart <src> <dst>`	`cppart`	Copy all volumes of a partition
`setosvervol <ver>` / `setlnum <num>`	—	Set volume OS version / load number
`fixramname <path>` / `fixramnameall`	—	Fix file name headers

Volume Parameters

Command	Alias	Description
`lsparam` / `lsparami <idx>`	—	List parameters
`initparam` / `initparami <idx>`	—	Initialize parameters
`setparam <idx> <val>` / `setparami <vidx> <pidx> <val>`	—	Set parameter
`getparam <file>` / `putparam <file>`	`paramget` / `paramput`	Export/import parameters

Tag Management

Command	Description
`lstags`	List tags
`inittags`	Initialize all tags
`rentag <idx> <name>`	Rename a tag
`settagi <file-idx> <tag-idx>` / `settagall <tag-idx>`	Tag a file / all files
`clrtagi <file-idx> <tag-idx or all>` / `clrtagall <tag or all>`	Untag
`setfiltertag <idx>` / `clrfiltertag <idx or all>`	Filter by tag

Formatting / Filesystem Operations

Command	Description
`formatfloppyl9` / `l1` / `l3`	Format low-density floppy for S900/S1000/S3000
`formatfloppyh9` / `h1` / `h3`	Format high-density floppy
`wipefloppy`	Create filesystem on floppy
`formatharddisk9 [<size>]`	Format HD for S900 (SH205, SUPRA20M, SUPRA30M, SUPRA60M, or size)
`formatharddisk1 [<part-size> [<total-size>]]`	Format HD for S1000
`formatharddisk3 [<part-size> [<total-size>]]`	Format HD for S3000
`formatharddisk3cd [<part-size> [<total-size>]]`	Format CD3000 CD-ROM
`wipepart` / `wipepart3cd`	Create filesystem in partition
`fixpart` / `fixharddisk`	Fix filesystem
`scanbadblkspart` / `scanbadblksdisk`	Scan for bad blocks
`markbadblkspart` / `markbadblksdisk`	Mark free bad blocks
`setcdinfo [<label>]` / `cdinfo` / `vcdinfo`	CD3000 CD-ROM info

FAT / Direct-to-Disk Takes

Command	Alias	Description
`tinfoi <idx>` / `tinfoall`	—	DD take info
`tdeli <idx>`	`trmi`	Delete DD take
`treni <idx> <name>`	`tmvi`	Rename DD take
`tgeti <idx>` / `tgetall`	`texporti`	Export DD take (`.TK`)
`tput <file>`	`timport`	Import DD take (`*.TK` for all)
`take2wavi <idx>` / `take2wavall`	`t2wavi`, `getwavti`	DD take → WAV
`wav2take <file>`	`wav2t`, `putwavt`	WAV → DD take

Tar Archives

Command	Alias	Description
`tarc <file>`	`gettar`	Create tar from current directory
`tarcwav <file>`	`gettarwav`	Tar-create with WAV conversion
`tarx <file>`	`puttar`	Extract tar (auto-detect type)
`tarx9` / `tarx1` / `tarx3` / `tarx3cd`	`puttar9` etc.	Extract as specific type
`tarxwav`	`puttarwav`	Extract with WAV → sample conversion
`tarxwav9` / `tarxwav9c` / `tarxwav1` / `tarxwav3`	—	Extract WAV as specific sampler type

Filesystem Types

Type	Description	Block Size	Max Size / Blocks
FLL	Low-density floppy	1 KB	800 KB (800 blocks)
FLH	High-density floppy	1 KB	1600 KB (1600 blocks)
HD9	S900/S950 harddisk	8 KB	~64 MB (8191 blocks)
HD	S1000/S3000 partition	8 KB	60 MB/partition, ~512 MB total
DD	S1100/S3000 Direct-to-Disk	8 KB	~512 MB

Build

make

Produces the akaiutil binary.

8.4 KiB Raw Blame History