Skip to content

Latest commit

 

History

History
60 lines (44 loc) · 2.74 KB

CLAUDE.md

File metadata and controls

60 lines (44 loc) · 2.74 KB

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

JingleBox2 is a cross-platform audio pad launcher built with .NET 9 and Avalonia UI for radio, streaming, and live audio workflows. It features a USE tab for performance (triggering audio pads) and a CONFIG tab for setup, with MIDI controller support.

Build Commands

dotnet restore          # Restore packages
dotnet build            # Build project
dotnet run              # Run locally
dotnet publish -c Release -r win-x64    # Publish for Windows
dotnet publish -c Release -r linux-x64  # Publish for Linux

Architecture

Core Layers

  1. Entry Point: Program.cs → App.axaml.cs → MainWindow.axaml.cs
  2. ViewModels: MVVM pattern using CommunityToolkit.Mvvm
  3. Services: Audio engine (BASS), MIDI service (managed-midi), Config store (JSON)

Key Directories

  • Audio/ - Audio playback engine using ManagedBass (BASS library wrapper)
  • Config/ - Configuration models and JSON persistence to %APPDATA%/JingleBox2/config.json
  • Midi/ - MIDI input handling and routing to pads
  • ViewModels/ - MainViewModel (orchestrator), PadViewModel (per-pad), MidiViewModel
  • Views/ - Avalonia user controls (UseView, ConfigView, MidiView, SettingsView)
  • Themes/ - XAML resource dictionaries (Dark, Light, Neon, Industrial)
  • native/ - BASS audio library binaries for win-x64, linux-x64, linux-arm64

Data Flow

  • Playback: PadViewModel → BassAudioEngine → BASS library → PadPlaybackChanged event → UI update
  • Config: PadViewModel property change → MainViewModel → ConfigStore.Save() → JSON file
  • MIDI: MidiService.MessageReceived → MidiRouter → PadTriggerAdapter → PadViewModel.TogglePlayCommand

Key Classes

  • BassAudioEngine (Audio/): Manages pad audio playback, device selection, file/stream sources, dynamic resize
  • ConfigStore (Config/): JSON persistence with profile migration support
  • MidiRouter (Midi/): Maps MIDI messages to pad triggers with toggle/start modes
  • MainViewModel: Central orchestrator connecting audio, config, and MIDI subsystems
  • PadViewModel: Single pad state (name, source, volume, playback state)

Technical Notes

  • Configurable pad matrix size (rows x columns) via SETTINGS tab
    • Minimum: 4 pads total (e.g., 2x2, 1x4, 4x1)
    • Maximum: 16 pads total (e.g., 4x4, 2x8, 8x2)
    • Default: 4 rows x 2 columns = 8 pads (backward compatible)
  • Two source types per pad: local files (WAV/MP3/OGG/FLAC) or HTTP streams
  • BASS library binaries are copied to output via build targets in csproj
  • managed-midi API has obsolete warnings (suppressed via <NoWarn>CS0618</NoWarn>)
  • Startup errors logged to startup.log for debugging