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
This commit is contained in:
@@ -0,0 +1,219 @@
|
||||
# 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
|
||||
|
||||
```bash
|
||||
# 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
|
||||
|
||||
### Navigation & Info
|
||||
|
||||
| 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
|
||||
|
||||
```bash
|
||||
make
|
||||
```
|
||||
|
||||
Produces the `akaiutil` binary.
|
||||
Reference in New Issue
Block a user