Import Audio

Your Task

Input: $ARGUMENTS

Import an audio file (WAV, MP3, etc.) to the correct album location based on config.

Import Audio Skill

You move audio files to the correct location in the user's audio directory.

Step 1: Parse Arguments

Expected format: <file-path> <album-name>

Examples:

• ~/Downloads/track.wav sample-album
• ~/Downloads/03-t-day-beach.wav sample-album

If arguments are missing, ask:

Usage: /import-audio <file-path> <album-name>

Example: /import-audio ~/Downloads/track.wav sample-album

Step 2: Read Config (REQUIRED)

ALWAYS read the config file first. Never skip this step.

cat ~/.bitwize-music/config.yaml

Extract:

• paths.audio_root → The base audio directory
• artist.name → The artist name (e.g., "bitwize")

Step 3: Construct Target Path

The target path is ALWAYS:

{audio_root}/{artist}/{album}/{filename}

Example with:

• audio_root: ~/bitwize-music/audio
• artist: bitwize
• album: sample-album
• file: 03-t-day-beach.wav

Result:

~/bitwize-music/audio/bitwize/sample-album/03-t-day-beach.wav

CRITICAL: The path MUST include the artist folder. Never put files directly at {audio_root}/{album}/.

Step 4: Create Directory and Move File

mkdir -p {audio_root}/{artist}/{album}
mv "{source_file}" "{audio_root}/{artist}/{album}/{filename}"

Step 5: Confirm

Report:

Moved: {source_file}
   To: {audio_root}/{artist}/{album}/{filename}

Error Handling

Source file doesn't exist:

Error: File not found: {source_file}

Config file missing:

Error: Config not found at ~/.bitwize-music/config.yaml
Run /configure to set up.

File already exists at destination:

Warning: File already exists at destination.
Overwrite? (The original was not moved)

Examples

/import-audio ~/Downloads/03-t-day-beach.wav sample-album

Config has:

paths:
  audio_root: ~/bitwize-music/audio
artist:
  name: bitwize

Result:

Moved: ~/Downloads/03-t-day-beach.wav
   To: ~/bitwize-music/audio/bitwize/sample-album/03-t-day-beach.wav

Common Mistakes

❌ Don't: Skip reading config

Wrong:

# Assuming audio_root path
mv file.wav ~/music-projects/audio/sample-album/

Right:

# Always read config first
cat ~/.bitwize-music/config.yaml
# Use paths.audio_root from config

Why it matters: If audio_root is different from what you assume, files end up in the wrong place.

❌ Don't: Forget to include artist in path

Wrong destination:

{audio_root}/{album}/file.wav
# Example: ~/music-projects/audio/sample-album/file.wav

Correct destination:

{audio_root}/{artist}/{album}/file.wav
# Example: ~/music-projects/audio/bitwize/sample-album/file.wav

Why it matters: Audio path structure includes artist name. This is the most common mistake with import-audio.

❌ Don't: Use hardcoded artist name

Wrong:

# Hardcoding artist
mv file.wav ~/audio/bitwize/sample-album/

Right:

# Read artist.name from config
artist=$(yq '.artist.name' ~/.bitwize-music/config.yaml)
audio_root=$(yq '.paths.audio_root' ~/.bitwize-music/config.yaml)
mv file.wav "$audio_root/$artist/sample-album/"

❌ Don't: Assume current working directory

Wrong:

# Moving relative to current directory
mv ~/Downloads/file.wav ./audio/sample-album/

Right:

# Use absolute path from config
audio_root=$(yq '.paths.audio_root' ~/.bitwize-music/config.yaml)
# Then use $audio_root for absolute path

❌ Don't: Mix up content_root and audio_root

Wrong:

# Using content_root for audio files
mv file.wav {content_root}/artists/bitwize/albums/electronic/sample-album/

Right:

# Audio files go to audio_root, not content_root
mv file.wav {audio_root}/{artist}/{album}/

Path comparison:

• Content: {content_root}/artists/{artist}/albums/{genre}/{album}/ (markdown, lyrics)
• Audio: {audio_root}/{artist}/{album}/ (WAV files, flattened structure)
• Documents: {documents_root}/{artist}/{album}/ (PDFs, research)