feat: Sample Tag Editor — view and edit AKAI sample tags in web UI #8

New Issue

2026-06-22T02:38:00Z

david commented

2026-06-22 02:38:00 +00:00

Feature: Sample Tag Editor

As a sample library organiser
I want to view and edit AKAI sample tags through the web UI
So that I can categorise and filter samples within a disk image without the akaiutil CLI

Acceptance Criteria

Scenario: View tags on a partition

Given an AKAI disk image with tags defined on Partition A
When I open the Disk Browser and select Partition A
Then I see a tag list: "Tag 1: Drums", "Tag 2: Bass", "Tag 3: FX"
And each tagged sample file shows its tag colour/dot indicator

Scenario: Tag a sample

Given a sample file "KICK.S" with no tags
When I right-click it and select "Tag → Drums"
Then KICK.S shows the Drums tag indicator
And the change persists after re-opening the disk image

Scenario: Clear all tags from a partition

Given a partition with 50 tagged files
When I click "Clear All Tags" in the tag editor
Then I see a confirmation dialog: "Remove all 50 tags from this partition?"
And after confirming, no files show tag indicators

Implementation

akaiutil commands: lstags (list), settagi <file-idx> <tag-idx> (tag), clrtagi <file-idx> <tag-idx> (untag), inittags (init)
Endpoints: GET /api/volume/tags?iso=<path>&volume=<name>, POST /api/file/tag, POST /api/file/untag
Tag operations require read-write mode on the disk image
Store tag names and assign colours in the web UI (local mapping, not stored in AKAI)

Karpathy Principle

Read-only view first (lstags is read-only). Write operations behind confirmation dialogs. Simple, safe, incremental.

## Feature: Sample Tag Editor **As a** sample library organiser **I want to** view and edit AKAI sample tags through the web UI **So that** I can categorise and filter samples within a disk image without the akaiutil CLI ### Acceptance Criteria **Scenario: View tags on a partition** ``` Given an AKAI disk image with tags defined on Partition A When I open the Disk Browser and select Partition A Then I see a tag list: "Tag 1: Drums", "Tag 2: Bass", "Tag 3: FX" And each tagged sample file shows its tag colour/dot indicator ``` **Scenario: Tag a sample** ``` Given a sample file "KICK.S" with no tags When I right-click it and select "Tag → Drums" Then KICK.S shows the Drums tag indicator And the change persists after re-opening the disk image ``` **Scenario: Clear all tags from a partition** ``` Given a partition with 50 tagged files When I click "Clear All Tags" in the tag editor Then I see a confirmation dialog: "Remove all 50 tags from this partition?" And after confirming, no files show tag indicators ``` ### Implementation - akaiutil commands: `lstags` (list), `settagi <file-idx> <tag-idx>` (tag), `clrtagi <file-idx> <tag-idx>` (untag), `inittags` (init) - Endpoints: `GET /api/volume/tags?iso=<path>&volume=<name>`, `POST /api/file/tag`, `POST /api/file/untag` - Tag operations require read-write mode on the disk image - Store tag names and assign colours in the web UI (local mapping, not stored in AKAI) ### Karpathy Principle Read-only view first (lstags is read-only). Write operations behind confirmation dialogs. Simple, safe, incremental.

david added the feature disk-ops web-ui good-first-issue labels 2026-06-22 02:38:00 +00:00

david referenced a pull request that will close this issue

2026-06-22 11:14:43 +00:00

feat: Sample Tag Viewer — read-only tag browser for AKAI disk images #17

david closed this issue

2026-06-22 18:13: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#8