feat: TAR Bulk Import/Export — batch sample transfer with WAV conversion #7

New Issue

2026-06-22T02:37:53Z

david commented

2026-06-22 02:37:53 +00:00

Feature: TAR Bulk Import/Export

As a user migrating samples between samplers
I want to batch export/import samples as tar archives with automatic WAV conversion
So that I can migrate large sample libraries between disk images or sampler formats

Acceptance Criteria

Scenario: Export a volume as a tar archive with WAV conversion

Given an S1000 disk image with volume "STRINGS"
When I select it in Disk Browser and click "Export to TAR+WAV"
Then a file ./output/exports/STRINGS.tar is created
And it contains all samples from that volume converted to WAV
And extracting the tarball on the host shows standard .wav files

Scenario: Import WAVs from a tar archive into a new S3000 volume

Given a tar archive ./samples/synth-pads.tar containing .wav files
And a blank S3000 disk image
When I click "Import from TAR" and select S3000 format
Then a new volume "SYNTH-PADS" is created
And all WAVs are converted to S3000 sample format
And browsing the disk shows all imported samples

Scenario: Import WAVs into an S900 volume with compression

Given a tar archive of WAV files
And a blank S900 disk image
When I import with "S900 compressed" option
Then all samples are stored as S900-compressed format

Implementation

akaiutil commands: tarcwav <file> for export, tarxwav9 / tarxwav1 / tarxwav3 for import
Additional variants: tarxwav9c (S900 compressed), tarxwav3cd (CD3000)
Endpoints: POST /api/volume/export-tar and POST /api/volume/import-tar
Reuse the format selector UI pattern from WAV→Disk Packager
Show progress per-file during large imports/exports

Karpathy Principle

Export first (read-only, safe). Import on blank disk images only (safe default). One format at a time.

## Feature: TAR Bulk Import/Export **As a** user migrating samples between samplers **I want to** batch export/import samples as tar archives with automatic WAV conversion **So that** I can migrate large sample libraries between disk images or sampler formats ### Acceptance Criteria **Scenario: Export a volume as a tar archive with WAV conversion** ``` Given an S1000 disk image with volume "STRINGS" When I select it in Disk Browser and click "Export to TAR+WAV" Then a file ./output/exports/STRINGS.tar is created And it contains all samples from that volume converted to WAV And extracting the tarball on the host shows standard .wav files ``` **Scenario: Import WAVs from a tar archive into a new S3000 volume** ``` Given a tar archive ./samples/synth-pads.tar containing .wav files And a blank S3000 disk image When I click "Import from TAR" and select S3000 format Then a new volume "SYNTH-PADS" is created And all WAVs are converted to S3000 sample format And browsing the disk shows all imported samples ``` **Scenario: Import WAVs into an S900 volume with compression** ``` Given a tar archive of WAV files And a blank S900 disk image When I import with "S900 compressed" option Then all samples are stored as S900-compressed format ``` ### Implementation - akaiutil commands: `tarcwav <file>` for export, `tarxwav9` / `tarxwav1` / `tarxwav3` for import - Additional variants: `tarxwav9c` (S900 compressed), `tarxwav3cd` (CD3000) - Endpoints: `POST /api/volume/export-tar` and `POST /api/volume/import-tar` - Reuse the format selector UI pattern from WAV→Disk Packager - Show progress per-file during large imports/exports ### Karpathy Principle Export first (read-only, safe). Import on blank disk images only (safe default). One format at a time.

david added the feature disk-ops labels 2026-06-22 02:37:53 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: david/akai-utils#7