Quick reference for the Hexbloop macOS app architecture.
ContentView - Main drag-drop interface with hexagon animations
swift/Hexbloop/ContentView.swift
HexbloopApp - App entry point, window configuration
swift/Hexbloop/HexbloopApp.swift
Hexagon - Custom Shape for hexagonal UI elements
swift/Hexbloop/ContentView.swift
AudioPlayer - Ambient audio loop controller (disabled)
swift/Hexbloop/ContentView.swift
ProcessingParameters - Audio effect settings (distortion, compression, reverb)
swift/Hexbloop/MacAudioEngine.swift
Configuration - App configuration state
swift/Hexbloop/Configuration.swift
FileType - Enums for distortion presets, audio matching
swift/Hexbloop/MacAudioEngine.swift
MacAudioEngine - AVFoundation audio processing pipeline
swift/Hexbloop/MacAudioEngine.swift
ArtGenerator - Procedural SVG artwork with 7 styles
swift/Hexbloop/ArtGenerator.swift
NameGenerator - Mystical file name generation system
swift/Hexbloop/NameGenerator.swift
AudioProcessorService - Audio processing state management
swift/Hexbloop/AudioProcessorService.swift
HexbloopFileManager - File operations and output management
swift/Hexbloop/HexbloopFileManager.swift
AudioProcessor - Legacy audio processing interface
swift/Hexbloop/AudioProcessor.swift
Moon Phase Processing - Astronomical calculations influencing audio parameters
- Full Moon: Bright, ethereal (low overdrive, high treble)
- New Moon: Dark, heavy (high overdrive, deep bass)
- Waxing/Waning: Interpolated between extremes
Art Styles - 8 procedural generation styles
- Electronic, Dark Synthwave, Ambient Space, Lo-Fi, Industrial, Cyberpunk, Vaporwave, Glitch
Audio Pipeline - AVAssetExportSession → Effects → Metadata embedding
- Uses AVFoundation instead of sox/ffmpeg for native processing
Processing Flow
- Generate mystical name (NameGenerator)
- Calculate moon phase influence
- Process audio (MacAudioEngine)
- Generate artwork (ArtGenerator)
- Embed metadata + artwork
- Save to ~/Documents/HexbloopOutput/