Compare commits

...

10 Commits

Author SHA1 Message Date
Claude e09983223c Add comprehensive debug logging to SerialManager
- Debug output for connect(), disconnect(), writeData()
- Debug output for formatVUServer() with hex bytes
- Debug output for timer start/stop
- Rate-limited debug output (every 30 frames) to reduce console spam
- Shows connection state changes on main thread
2025-12-14 21:21:54 +00:00
Claude f4b55dbf62 Fix connection status UI not updating properly
- Ensure isConnected is always updated on main thread
- Ensure lastError is always updated on main thread
- Disconnect before reconnecting to avoid stale file descriptors
- Start update timer on main thread
2025-12-14 21:14:21 +00:00
Claude 5e13ff069d Implement VU-Server binary protocol for real hardware
- Add VUServerProtocol struct with proper binary frame format
- Header: '>' + cmd + reserved + data_type + reserved + len_h + len_l + reserved + len_l
- Support commands: setDialPercentSingle (0x03), setDialPercentAll (0x04)
- Support backlight control (RGB/RGBW)
- Add device info queries (firmware/hardware version, UID)
- Add response parsing for '<' responses from hardware
- Show firmware/hardware version in UI when connected
- Update protocol info display to reflect binary protocol
2025-12-14 16:35:31 +00:00
Claude 7a34c719e8 Add animated splash screen with Gnafzgi Software branding
- Create SplashView with animated VU meter icon, wave background
- Show "presented by GNAFZGI SOFTWARE" on app startup
- Auto-dismiss after 2.5 seconds with fade transition
- Bump version to 1.3
2025-12-14 15:46:22 +00:00
Claude 5e0cc74aaf Improve auto-probe UX: auto-connect after finding device
- Auto-probe now automatically connects after finding a VU meter
- Add connection status indicator (green/red dot) on each dial
- Add animation to dial value changes
- Show minimum arc value for better visibility at low values
- Display error messages in hardware panel
- Show "No USB serial devices" message when none found
- Improved status display with port name in green when connected
2025-12-14 15:29:45 +00:00
Claude 0ecf2c7940 Add VU Server for external app control and improve auto-probing
- Add TCP server (VUServer.swift) for external apps to send VU meter values
- Server supports VU Protocol (#channel:value), JSON, and raw bytes
- Configurable options: port, max clients, remote access, broadcast levels
- Add ServerView.swift with full server settings UI and client management
- Improve auto-probing to use two-phase detection (port scan then protocol test)
- Fix termios c_cc tuple access using withUnsafeMutableBytes
- Add network and serial entitlements for server and USB access
- Update version to 1.2.0
2025-12-14 15:23:50 +00:00
Claude f5e266b22b Add USB auto-probing to detect VU meter hardware
Features:
- Auto-probe scans all USB serial ports to find VU meter
- Tests multiple baud rates (115200, 9600, 57600, 38400, 19200)
- Tests all protocols (Raw, Text, JSON, VU-Server)
- Detects response from hardware to confirm connection
- Known USB device detection (CH340, CP210x, FTDI, Arduino, etc.)
- USB Vendor/Product ID display in port selection
- Quick Connect button for instant auto-connection
- Progress bar and status during probing
- Probe results display for debugging

USB detection:
- Reads USB idVendor/idProduct from IOKit registry
- Marks known VU meter devices with star icon
- Auto-selects detected VU meter port
2025-12-14 10:41:27 +00:00
Claude 52fa522d6d Add physical VU meter hardware support (4 dials)
New features:
- SerialManager for USB/Serial communication with hardware
- Support for 4 physical VU meter dials
- Flexible channel mapping: Audio L/R, Peak, Mono, CPU, RAM, Disk, Network
- Multiple protocols: Raw bytes, Text, JSON, VU-Server compatible
- Per-dial configuration: min/max values, inversion, smoothing
- Hardware panel in main view showing dial status
- Hardware settings sheet for configuration
- Auto-detection of USB serial devices

Protocol formats:
- Raw: [0xAA][D1][D2][D3][D4][0x55]
- Text: CH1:val;CH2:val;CH3:val;CH4:val\n
- JSON: {"dials":[d1,d2,d3,d4]}
- VU-Server: #0:val\n#1:val\n...
2025-12-14 10:15:20 +00:00
Claude 2ad21cad58 Add macOS Audio VU Meter app with system monitoring
Features:
- Real-time audio level monitoring via BlackHole virtual audio device
- Classic VU meter display with dB scale (-60 to 0 dB)
- Peak hold indicators with configurable hold time
- System resource monitors: CPU, RAM, Disk, Network
- SwiftUI interface with dark theme
- Multi-device audio input selection
- Settings window for configuration

Built with AVAudioEngine for audio capture and Mach kernel APIs
for system statistics.
2025-12-14 10:03:56 +00:00
admin dd1d45d3e0 Merge pull request #3 from metacube2/claude/twelve-tone-synthesizer-01BgdmRVwhTdP8FRvAbntAqo
Build twelve-tone synthesizer with reverb in PHP
2025-12-13 17:29:21 +01:00
18 changed files with 5374 additions and 0 deletions
@@ -0,0 +1,374 @@
// !$*UTF8*$!
{
archiveVersion = 1;
classes = {
};
objectVersion = 56;
objects = {
/* Begin PBXBuildFile section */
A1000001229E3D0000000001 /* AudioVUMeterApp.swift in Sources */ = {isa = PBXBuildFile; fileRef = A1000002229E3D0000000001 /* AudioVUMeterApp.swift */; };
A1000003229E3D0000000002 /* ContentView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A1000004229E3D0000000002 /* ContentView.swift */; };
A1000005229E3D0000000003 /* VUMeterView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A1000006229E3D0000000003 /* VUMeterView.swift */; };
A1000007229E3D0000000004 /* AudioEngine.swift in Sources */ = {isa = PBXBuildFile; fileRef = A1000008229E3D0000000004 /* AudioEngine.swift */; };
A1000009229E3D0000000005 /* SystemMonitor.swift in Sources */ = {isa = PBXBuildFile; fileRef = A100000A229E3D0000000005 /* SystemMonitor.swift */; };
A100000B229E3D0000000006 /* SettingsView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A100000C229E3D0000000006 /* SettingsView.swift */; };
A100000D229E3D0000000007 /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = A100000E229E3D0000000007 /* Assets.xcassets */; };
A1000020229E3D0000000019 /* SerialManager.swift in Sources */ = {isa = PBXBuildFile; fileRef = A1000021229E3D000000001A /* SerialManager.swift */; };
A1000022229E3D000000001B /* HardwareView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A1000023229E3D000000001C /* HardwareView.swift */; };
A1000024229E3D000000001D /* VUServer.swift in Sources */ = {isa = PBXBuildFile; fileRef = A1000025229E3D000000001E /* VUServer.swift */; };
A1000026229E3D000000001F /* ServerView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A1000027229E3D0000000020 /* ServerView.swift */; };
A1000028229E3D0000000021 /* SplashView.swift in Sources */ = {isa = PBXBuildFile; fileRef = A1000029229E3D0000000022 /* SplashView.swift */; };
/* End PBXBuildFile section */
/* Begin PBXFileReference section */
A1000002229E3D0000000001 /* AudioVUMeterApp.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AudioVUMeterApp.swift; sourceTree = "<group>"; };
A1000004229E3D0000000002 /* ContentView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ContentView.swift; sourceTree = "<group>"; };
A1000006229E3D0000000003 /* VUMeterView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = VUMeterView.swift; sourceTree = "<group>"; };
A1000008229E3D0000000004 /* AudioEngine.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AudioEngine.swift; sourceTree = "<group>"; };
A100000A229E3D0000000005 /* SystemMonitor.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SystemMonitor.swift; sourceTree = "<group>"; };
A100000C229E3D0000000006 /* SettingsView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SettingsView.swift; sourceTree = "<group>"; };
A100000E229E3D0000000007 /* Assets.xcassets */ = {isa = PBXFileReference; lastKnownFileType = folder.assetcatalog; path = Assets.xcassets; sourceTree = "<group>"; };
A100000F229E3D0000000008 /* AudioVUMeter.entitlements */ = {isa = PBXFileReference; lastKnownFileType = text.plist.entitlements; path = AudioVUMeter.entitlements; sourceTree = "<group>"; };
A1000010229E3D0000000009 /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = "<group>"; };
A1000011229E3D000000000A /* AudioVUMeter.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = AudioVUMeter.app; sourceTree = BUILT_PRODUCTS_DIR; };
A1000021229E3D000000001A /* SerialManager.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SerialManager.swift; sourceTree = "<group>"; };
A1000023229E3D000000001C /* HardwareView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = HardwareView.swift; sourceTree = "<group>"; };
A1000025229E3D000000001E /* VUServer.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = VUServer.swift; sourceTree = "<group>"; };
A1000027229E3D0000000020 /* ServerView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ServerView.swift; sourceTree = "<group>"; };
A1000029229E3D0000000022 /* SplashView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SplashView.swift; sourceTree = "<group>"; };
/* End PBXFileReference section */
/* Begin PBXFrameworksBuildPhase section */
A1000012229E3D000000000B /* Frameworks */ = {
isa = PBXFrameworksBuildPhase;
buildActionMask = 2147483647;
files = (
);
runOnlyForDeploymentPostprocessing = 0;
};
/* End PBXFrameworksBuildPhase section */
/* Begin PBXGroup section */
A1000013229E3D000000000C = {
isa = PBXGroup;
children = (
A1000014229E3D000000000D /* AudioVUMeter */,
A1000015229E3D000000000E /* Products */,
);
sourceTree = "<group>";
};
A1000014229E3D000000000D /* AudioVUMeter */ = {
isa = PBXGroup;
children = (
A1000002229E3D0000000001 /* AudioVUMeterApp.swift */,
A1000004229E3D0000000002 /* ContentView.swift */,
A1000006229E3D0000000003 /* VUMeterView.swift */,
A1000008229E3D0000000004 /* AudioEngine.swift */,
A100000A229E3D0000000005 /* SystemMonitor.swift */,
A100000C229E3D0000000006 /* SettingsView.swift */,
A1000021229E3D000000001A /* SerialManager.swift */,
A1000023229E3D000000001C /* HardwareView.swift */,
A1000025229E3D000000001E /* VUServer.swift */,
A1000027229E3D0000000020 /* ServerView.swift */,
A1000029229E3D0000000022 /* SplashView.swift */,
A100000E229E3D0000000007 /* Assets.xcassets */,
A100000F229E3D0000000008 /* AudioVUMeter.entitlements */,
A1000010229E3D0000000009 /* Info.plist */,
);
path = AudioVUMeter;
sourceTree = "<group>";
};
A1000015229E3D000000000E /* Products */ = {
isa = PBXGroup;
children = (
A1000011229E3D000000000A /* AudioVUMeter.app */,
);
name = Products;
sourceTree = "<group>";
};
/* End PBXGroup section */
/* Begin PBXNativeTarget section */
A1000016229E3D000000000F /* AudioVUMeter */ = {
isa = PBXNativeTarget;
buildConfigurationList = A1000017229E3D0000000010 /* Build configuration list for PBXNativeTarget "AudioVUMeter" */;
buildPhases = (
A1000018229E3D0000000011 /* Sources */,
A1000012229E3D000000000B /* Frameworks */,
A1000019229E3D0000000012 /* Resources */,
);
buildRules = (
);
dependencies = (
);
name = AudioVUMeter;
productName = AudioVUMeter;
productReference = A1000011229E3D000000000A /* AudioVUMeter.app */;
productType = "com.apple.product-type.application";
};
/* End PBXNativeTarget section */
/* Begin PBXProject section */
A100001A229E3D0000000013 /* Project object */ = {
isa = PBXProject;
attributes = {
BuildIndependentTargetsInParallel = 1;
LastSwiftUpdateCheck = 1500;
LastUpgradeCheck = 1500;
TargetAttributes = {
A1000016229E3D000000000F = {
CreatedOnToolsVersion = 15.0;
};
};
};
buildConfigurationList = A100001B229E3D0000000014 /* Build configuration list for PBXProject "AudioVUMeter" */;
compatibilityVersion = "Xcode 14.0";
developmentRegion = en;
hasScannedForEncodings = 0;
knownRegions = (
en,
Base,
);
mainGroup = A1000013229E3D000000000C;
productRefGroup = A1000015229E3D000000000E /* Products */;
projectDirPath = "";
projectRoot = "";
targets = (
A1000016229E3D000000000F /* AudioVUMeter */,
);
};
/* End PBXProject section */
/* Begin PBXResourcesBuildPhase section */
A1000019229E3D0000000012 /* Resources */ = {
isa = PBXResourcesBuildPhase;
buildActionMask = 2147483647;
files = (
A100000D229E3D0000000007 /* Assets.xcassets in Resources */,
);
runOnlyForDeploymentPostprocessing = 0;
};
/* End PBXResourcesBuildPhase section */
/* Begin PBXSourcesBuildPhase section */
A1000018229E3D0000000011 /* Sources */ = {
isa = PBXSourcesBuildPhase;
buildActionMask = 2147483647;
files = (
A1000001229E3D0000000001 /* AudioVUMeterApp.swift in Sources */,
A1000003229E3D0000000002 /* ContentView.swift in Sources */,
A1000005229E3D0000000003 /* VUMeterView.swift in Sources */,
A1000007229E3D0000000004 /* AudioEngine.swift in Sources */,
A1000009229E3D0000000005 /* SystemMonitor.swift in Sources */,
A100000B229E3D0000000006 /* SettingsView.swift in Sources */,
A1000020229E3D0000000019 /* SerialManager.swift in Sources */,
A1000022229E3D000000001B /* HardwareView.swift in Sources */,
A1000024229E3D000000001D /* VUServer.swift in Sources */,
A1000026229E3D000000001F /* ServerView.swift in Sources */,
A1000028229E3D0000000021 /* SplashView.swift in Sources */,
);
runOnlyForDeploymentPostprocessing = 0;
};
/* End PBXSourcesBuildPhase section */
/* Begin XCBuildConfiguration section */
A100001C229E3D0000000015 /* Debug */ = {
isa = XCBuildConfiguration;
buildSettings = {
ALWAYS_SEARCH_USER_PATHS = NO;
ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
CLANG_ANALYZER_NONNULL = YES;
CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
CLANG_CXX_LANGUAGE_STANDARD = "gnu++20";
CLANG_ENABLE_MODULES = YES;
CLANG_ENABLE_OBJC_ARC = YES;
CLANG_ENABLE_OBJC_WEAK = YES;
CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
CLANG_WARN_BOOL_CONVERSION = YES;
CLANG_WARN_COMMA = YES;
CLANG_WARN_CONSTANT_CONVERSION = YES;
CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
CLANG_WARN_EMPTY_BODY = YES;
CLANG_WARN_ENUM_CONVERSION = YES;
CLANG_WARN_INFINITE_RECURSION = YES;
CLANG_WARN_INT_CONVERSION = YES;
CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES;
CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
CLANG_WARN_STRICT_PROTOTYPES = YES;
CLANG_WARN_SUSPICIOUS_MOVE = YES;
CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
CLANG_WARN_UNREACHABLE_CODE = YES;
CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
COPY_PHASE_STRIP = NO;
DEBUG_INFORMATION_FORMAT = dwarf;
ENABLE_STRICT_OBJC_MSGSEND = YES;
ENABLE_TESTABILITY = YES;
ENABLE_USER_SCRIPT_SANDBOXING = YES;
GCC_C_LANGUAGE_STANDARD = gnu17;
GCC_DYNAMIC_NO_PIC = NO;
GCC_NO_COMMON_BLOCKS = YES;
GCC_OPTIMIZATION_LEVEL = 0;
GCC_PREPROCESSOR_DEFINITIONS = (
"DEBUG=1",
"$(inherited)",
);
GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
GCC_WARN_UNDECLARED_SELECTOR = YES;
GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
GCC_WARN_UNUSED_FUNCTION = YES;
GCC_WARN_UNUSED_VARIABLE = YES;
MACOSX_DEPLOYMENT_TARGET = 13.0;
MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
MTL_FAST_MATH = YES;
ONLY_ACTIVE_ARCH = YES;
SDKROOT = macosx;
SWIFT_ACTIVE_COMPILATION_CONDITIONS = "DEBUG $(inherited)";
SWIFT_OPTIMIZATION_LEVEL = "-Onone";
};
name = Debug;
};
A100001D229E3D0000000016 /* Release */ = {
isa = XCBuildConfiguration;
buildSettings = {
ALWAYS_SEARCH_USER_PATHS = NO;
ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = YES;
CLANG_ANALYZER_NONNULL = YES;
CLANG_ANALYZER_NUMBER_OBJECT_CONVERSION = YES_AGGRESSIVE;
CLANG_CXX_LANGUAGE_STANDARD = "gnu++20";
CLANG_ENABLE_MODULES = YES;
CLANG_ENABLE_OBJC_ARC = YES;
CLANG_ENABLE_OBJC_WEAK = YES;
CLANG_WARN_BLOCK_CAPTURE_AUTORELEASING = YES;
CLANG_WARN_BOOL_CONVERSION = YES;
CLANG_WARN_COMMA = YES;
CLANG_WARN_CONSTANT_CONVERSION = YES;
CLANG_WARN_DEPRECATED_OBJC_IMPLEMENTATIONS = YES;
CLANG_WARN_DIRECT_OBJC_ISA_USAGE = YES_ERROR;
CLANG_WARN_DOCUMENTATION_COMMENTS = YES;
CLANG_WARN_EMPTY_BODY = YES;
CLANG_WARN_ENUM_CONVERSION = YES;
CLANG_WARN_INFINITE_RECURSION = YES;
CLANG_WARN_INT_CONVERSION = YES;
CLANG_WARN_NON_LITERAL_NULL_CONVERSION = YES;
CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES;
CLANG_WARN_OBJC_LITERAL_CONVERSION = YES;
CLANG_WARN_OBJC_ROOT_CLASS = YES_ERROR;
CLANG_WARN_QUOTED_INCLUDE_IN_FRAMEWORK_HEADER = YES;
CLANG_WARN_RANGE_LOOP_ANALYSIS = YES;
CLANG_WARN_STRICT_PROTOTYPES = YES;
CLANG_WARN_SUSPICIOUS_MOVE = YES;
CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
CLANG_WARN_UNREACHABLE_CODE = YES;
CLANG_WARN__DUPLICATE_METHOD_MATCH = YES;
COPY_PHASE_STRIP = NO;
DEBUG_INFORMATION_FORMAT = "dwarf-with-dsym";
ENABLE_NS_ASSERTIONS = NO;
ENABLE_STRICT_OBJC_MSGSEND = YES;
ENABLE_USER_SCRIPT_SANDBOXING = YES;
GCC_C_LANGUAGE_STANDARD = gnu17;
GCC_NO_COMMON_BLOCKS = YES;
GCC_WARN_64_TO_32_BIT_CONVERSION = YES;
GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
GCC_WARN_UNDECLARED_SELECTOR = YES;
GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
GCC_WARN_UNUSED_FUNCTION = YES;
GCC_WARN_UNUSED_VARIABLE = YES;
MACOSX_DEPLOYMENT_TARGET = 13.0;
MTL_ENABLE_DEBUG_INFO = NO;
MTL_FAST_MATH = YES;
SDKROOT = macosx;
SWIFT_COMPILATION_MODE = wholemodule;
};
name = Release;
};
A100001E229E3D0000000017 /* Debug */ = {
isa = XCBuildConfiguration;
buildSettings = {
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
CODE_SIGN_ENTITLEMENTS = AudioVUMeter/AudioVUMeter.entitlements;
CODE_SIGN_STYLE = Automatic;
COMBINE_HIDPI_IMAGES = YES;
CURRENT_PROJECT_VERSION = 2;
DEVELOPMENT_ASSET_PATHS = "";
ENABLE_HARDENED_RUNTIME = YES;
ENABLE_PREVIEWS = YES;
GENERATE_INFOPLIST_FILE = YES;
INFOPLIST_FILE = AudioVUMeter/Info.plist;
INFOPLIST_KEY_LSApplicationCategoryType = "public.app-category.utilities";
INFOPLIST_KEY_NSHumanReadableCopyright = "";
INFOPLIST_KEY_NSMicrophoneUsageDescription = "Audio VU Meter needs access to audio input to display audio levels from BlackHole or other audio devices.";
LD_RUNPATH_SEARCH_PATHS = (
"$(inherited)",
"@executable_path/../Frameworks",
);
MARKETING_VERSION = 1.3;
PRODUCT_BUNDLE_IDENTIFIER = com.audiotools.AudioVUMeter;
PRODUCT_NAME = "$(TARGET_NAME)";
SWIFT_EMIT_LOC_STRINGS = YES;
SWIFT_VERSION = 5.0;
};
name = Debug;
};
A100001F229E3D0000000018 /* Release */ = {
isa = XCBuildConfiguration;
buildSettings = {
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
CODE_SIGN_ENTITLEMENTS = AudioVUMeter/AudioVUMeter.entitlements;
CODE_SIGN_STYLE = Automatic;
COMBINE_HIDPI_IMAGES = YES;
CURRENT_PROJECT_VERSION = 2;
DEVELOPMENT_ASSET_PATHS = "";
ENABLE_HARDENED_RUNTIME = YES;
ENABLE_PREVIEWS = YES;
GENERATE_INFOPLIST_FILE = YES;
INFOPLIST_FILE = AudioVUMeter/Info.plist;
INFOPLIST_KEY_LSApplicationCategoryType = "public.app-category.utilities";
INFOPLIST_KEY_NSHumanReadableCopyright = "";
INFOPLIST_KEY_NSMicrophoneUsageDescription = "Audio VU Meter needs access to audio input to display audio levels from BlackHole or other audio devices.";
LD_RUNPATH_SEARCH_PATHS = (
"$(inherited)",
"@executable_path/../Frameworks",
);
MARKETING_VERSION = 1.3;
PRODUCT_BUNDLE_IDENTIFIER = com.audiotools.AudioVUMeter;
PRODUCT_NAME = "$(TARGET_NAME)";
SWIFT_EMIT_LOC_STRINGS = YES;
SWIFT_VERSION = 5.0;
};
name = Release;
};
/* End XCBuildConfiguration section */
/* Begin XCConfigurationList section */
A1000017229E3D0000000010 /* Build configuration list for PBXNativeTarget "AudioVUMeter" */ = {
isa = XCConfigurationList;
buildConfigurations = (
A100001E229E3D0000000017 /* Debug */,
A100001F229E3D0000000018 /* Release */,
);
defaultConfigurationIsVisible = 0;
defaultConfigurationName = Release;
};
A100001B229E3D0000000014 /* Build configuration list for PBXProject "AudioVUMeter" */ = {
isa = XCConfigurationList;
buildConfigurations = (
A100001C229E3D0000000015 /* Debug */,
A100001D229E3D0000000016 /* Release */,
);
defaultConfigurationIsVisible = 0;
defaultConfigurationName = Release;
};
/* End XCConfigurationList section */
};
rootObject = A100001A229E3D0000000013 /* Project object */;
}
@@ -0,0 +1,20 @@
{
"colors" : [
{
"color" : {
"color-space" : "srgb",
"components" : {
"alpha" : "1.000",
"blue" : "0.459",
"green" : "0.831",
"red" : "0.216"
}
},
"idiom" : "universal"
}
],
"info" : {
"author" : "xcode",
"version" : 1
}
}
@@ -0,0 +1,58 @@
{
"images" : [
{
"idiom" : "mac",
"scale" : "1x",
"size" : "16x16"
},
{
"idiom" : "mac",
"scale" : "2x",
"size" : "16x16"
},
{
"idiom" : "mac",
"scale" : "1x",
"size" : "32x32"
},
{
"idiom" : "mac",
"scale" : "2x",
"size" : "32x32"
},
{
"idiom" : "mac",
"scale" : "1x",
"size" : "128x128"
},
{
"idiom" : "mac",
"scale" : "2x",
"size" : "128x128"
},
{
"idiom" : "mac",
"scale" : "1x",
"size" : "256x256"
},
{
"idiom" : "mac",
"scale" : "2x",
"size" : "256x256"
},
{
"idiom" : "mac",
"scale" : "1x",
"size" : "512x512"
},
{
"idiom" : "mac",
"scale" : "2x",
"size" : "512x512"
}
],
"info" : {
"author" : "xcode",
"version" : 1
}
}
@@ -0,0 +1,6 @@
{
"info" : {
"author" : "xcode",
"version" : 1
}
}
+431
View File
@@ -0,0 +1,431 @@
//
// AudioEngine.swift
// AudioVUMeter
//
// Core Audio engine for capturing audio from BlackHole or any input device
// Calculates RMS levels and converts to dB for VU meter display
//
import Foundation
import AVFoundation
import CoreAudio
import Combine
/// Represents an available audio input device
struct AudioDevice: Identifiable, Hashable {
let id: AudioDeviceID
let name: String
let uid: String
let inputChannels: Int
}
/// Main audio engine class for capturing and analyzing audio levels
class AudioEngine: ObservableObject {
// MARK: - Published Properties
/// Current audio levels (0.0 to 1.0)
@Published var leftLevel: Double = 0
@Published var rightLevel: Double = 0
/// Peak levels with hold
@Published var leftPeak: Double = 0
@Published var rightPeak: Double = 0
/// Levels in dB (-inf to 0)
@Published var leftLevelDB: Double = -60
@Published var rightLevelDB: Double = -60
/// Engine state
@Published var isRunning = false
@Published var selectedDeviceID: AudioDeviceID = 0
@Published var selectedDeviceName: String = "No Device"
@Published var availableDevices: [AudioDevice] = []
/// Settings
@Published var referenceLevel: Double = -18 // Reference level in dB
@Published var peakHoldTime: Double = 2.0 // Peak hold time in seconds
// MARK: - Private Properties
private var audioEngine: AVAudioEngine?
private var inputNode: AVAudioInputNode?
private var peakResetTimers: [Timer] = []
private let levelSmoothingFactor: Double = 0.3
private var previousLeftLevel: Double = 0
private var previousRightLevel: Double = 0
// MARK: - Initialization
init() {
refreshDeviceList()
selectBlackHoleDevice()
}
// MARK: - Device Management
/// Refresh the list of available audio input devices
func refreshDeviceList() {
availableDevices = getInputDevices()
if availableDevices.isEmpty {
selectedDeviceName = "No Input Devices"
}
}
/// Get all available audio input devices
private func getInputDevices() -> [AudioDevice] {
var devices: [AudioDevice] = []
var propertyAddress = AudioObjectPropertyAddress(
mSelector: kAudioHardwarePropertyDevices,
mScope: kAudioObjectPropertyScopeGlobal,
mElement: kAudioObjectPropertyElementMain
)
var propertySize: UInt32 = 0
var status = AudioObjectGetPropertyDataSize(
AudioObjectID(kAudioObjectSystemObject),
&propertyAddress,
0,
nil,
&propertySize
)
guard status == noErr else { return devices }
let deviceCount = Int(propertySize) / MemoryLayout<AudioDeviceID>.size
var deviceIDs = [AudioDeviceID](repeating: 0, count: deviceCount)
status = AudioObjectGetPropertyData(
AudioObjectID(kAudioObjectSystemObject),
&propertyAddress,
0,
nil,
&propertySize,
&deviceIDs
)
guard status == noErr else { return devices }
for deviceID in deviceIDs {
// Check if device has input channels
let inputChannels = getDeviceInputChannels(deviceID: deviceID)
guard inputChannels > 0 else { continue }
// Get device name
let name = getDeviceName(deviceID: deviceID)
let uid = getDeviceUID(deviceID: deviceID)
devices.append(AudioDevice(
id: deviceID,
name: name,
uid: uid,
inputChannels: inputChannels
))
}
return devices
}
/// Get device name
private func getDeviceName(deviceID: AudioDeviceID) -> String {
var propertyAddress = AudioObjectPropertyAddress(
mSelector: kAudioDevicePropertyDeviceNameCFString,
mScope: kAudioObjectPropertyScopeGlobal,
mElement: kAudioObjectPropertyElementMain
)
var name: CFString = "" as CFString
var propertySize = UInt32(MemoryLayout<CFString>.size)
let status = AudioObjectGetPropertyData(
deviceID,
&propertyAddress,
0,
nil,
&propertySize,
&name
)
return status == noErr ? name as String : "Unknown Device"
}
/// Get device UID
private func getDeviceUID(deviceID: AudioDeviceID) -> String {
var propertyAddress = AudioObjectPropertyAddress(
mSelector: kAudioDevicePropertyDeviceUID,
mScope: kAudioObjectPropertyScopeGlobal,
mElement: kAudioObjectPropertyElementMain
)
var uid: CFString = "" as CFString
var propertySize = UInt32(MemoryLayout<CFString>.size)
let status = AudioObjectGetPropertyData(
deviceID,
&propertyAddress,
0,
nil,
&propertySize,
&uid
)
return status == noErr ? uid as String : ""
}
/// Get number of input channels for a device
private func getDeviceInputChannels(deviceID: AudioDeviceID) -> Int {
var propertyAddress = AudioObjectPropertyAddress(
mSelector: kAudioDevicePropertyStreamConfiguration,
mScope: kAudioDevicePropertyScopeInput,
mElement: kAudioObjectPropertyElementMain
)
var propertySize: UInt32 = 0
var status = AudioObjectGetPropertyDataSize(
deviceID,
&propertyAddress,
0,
nil,
&propertySize
)
guard status == noErr, propertySize > 0 else { return 0 }
let bufferListPointer = UnsafeMutablePointer<AudioBufferList>.allocate(capacity: Int(propertySize))
defer { bufferListPointer.deallocate() }
status = AudioObjectGetPropertyData(
deviceID,
&propertyAddress,
0,
nil,
&propertySize,
bufferListPointer
)
guard status == noErr else { return 0 }
let bufferList = bufferListPointer.pointee
var channelCount = 0
let buffers = UnsafeMutableAudioBufferListPointer(UnsafeMutablePointer(mutating: bufferListPointer))
for buffer in buffers {
channelCount += Int(buffer.mNumberChannels)
}
return channelCount
}
/// Select BlackHole device if available
private func selectBlackHoleDevice() {
// Try to find BlackHole device
if let blackholeDevice = availableDevices.first(where: {
$0.name.lowercased().contains("blackhole")
}) {
selectedDeviceID = blackholeDevice.id
selectedDeviceName = blackholeDevice.name
return
}
// Fall back to first available device
if let firstDevice = availableDevices.first {
selectedDeviceID = firstDevice.id
selectedDeviceName = firstDevice.name
}
}
/// Switch to selected audio device
func switchDevice() {
let wasRunning = isRunning
if wasRunning {
stop()
}
if let device = availableDevices.first(where: { $0.id == selectedDeviceID }) {
selectedDeviceName = device.name
setSystemInputDevice(deviceID: selectedDeviceID)
}
if wasRunning {
start()
}
}
/// Set the system default input device
private func setSystemInputDevice(deviceID: AudioDeviceID) {
var deviceID = deviceID
var propertyAddress = AudioObjectPropertyAddress(
mSelector: kAudioHardwarePropertyDefaultInputDevice,
mScope: kAudioObjectPropertyScopeGlobal,
mElement: kAudioObjectPropertyElementMain
)
AudioObjectSetPropertyData(
AudioObjectID(kAudioObjectSystemObject),
&propertyAddress,
0,
nil,
UInt32(MemoryLayout<AudioDeviceID>.size),
&deviceID
)
}
// MARK: - Audio Engine Control
/// Start audio capture
func start() {
guard !isRunning else { return }
do {
audioEngine = AVAudioEngine()
guard let engine = audioEngine else { return }
inputNode = engine.inputNode
guard let input = inputNode else { return }
let format = input.outputFormat(forBus: 0)
// Install tap on input node to capture audio
input.installTap(onBus: 0, bufferSize: 1024, format: format) { [weak self] buffer, _ in
self?.processAudioBuffer(buffer)
}
try engine.start()
isRunning = true
print("Audio engine started - capturing from: \(selectedDeviceName)")
print("Format: \(format)")
} catch {
print("Failed to start audio engine: \(error)")
isRunning = false
}
}
/// Stop audio capture
func stop() {
guard isRunning else { return }
inputNode?.removeTap(onBus: 0)
audioEngine?.stop()
audioEngine = nil
inputNode = nil
isRunning = false
// Reset levels
DispatchQueue.main.async {
self.leftLevel = 0
self.rightLevel = 0
self.leftLevelDB = -60
self.rightLevelDB = -60
}
print("Audio engine stopped")
}
/// Reset peak indicators
func resetPeaks() {
DispatchQueue.main.async {
self.leftPeak = 0
self.rightPeak = 0
}
}
// MARK: - Audio Processing
/// Process incoming audio buffer
private func processAudioBuffer(_ buffer: AVAudioPCMBuffer) {
guard let floatData = buffer.floatChannelData else { return }
let frameCount = Int(buffer.frameLength)
let channelCount = Int(buffer.format.channelCount)
var leftRMS: Float = 0
var rightRMS: Float = 0
// Calculate RMS for left channel
let leftChannel = floatData[0]
var leftSum: Float = 0
for i in 0..<frameCount {
let sample = leftChannel[i]
leftSum += sample * sample
}
leftRMS = sqrt(leftSum / Float(frameCount))
// Calculate RMS for right channel (or use left if mono)
if channelCount > 1 {
let rightChannel = floatData[1]
var rightSum: Float = 0
for i in 0..<frameCount {
let sample = rightChannel[i]
rightSum += sample * sample
}
rightRMS = sqrt(rightSum / Float(frameCount))
} else {
rightRMS = leftRMS
}
// Convert to dB
let leftDB = 20 * log10(max(leftRMS, 1e-10))
let rightDB = 20 * log10(max(rightRMS, 1e-10))
// Normalize to 0-1 range (assuming -60dB is silence)
let minDB: Float = -60
let maxDB: Float = 0
let normalizedLeft = Double(max(0, min(1, (leftDB - minDB) / (maxDB - minDB))))
let normalizedRight = Double(max(0, min(1, (rightDB - minDB) / (maxDB - minDB))))
// Apply smoothing
let smoothedLeft = previousLeftLevel * (1 - levelSmoothingFactor) + normalizedLeft * levelSmoothingFactor
let smoothedRight = previousRightLevel * (1 - levelSmoothingFactor) + normalizedRight * levelSmoothingFactor
previousLeftLevel = smoothedLeft
previousRightLevel = smoothedRight
// Update UI on main thread
DispatchQueue.main.async {
self.leftLevel = smoothedLeft
self.rightLevel = smoothedRight
self.leftLevelDB = Double(leftDB)
self.rightLevelDB = Double(rightDB)
// Update peaks
if smoothedLeft > self.leftPeak {
self.leftPeak = smoothedLeft
self.schedulePeakReset(channel: 0)
}
if smoothedRight > self.rightPeak {
self.rightPeak = smoothedRight
self.schedulePeakReset(channel: 1)
}
}
}
/// Schedule peak reset after hold time
private func schedulePeakReset(channel: Int) {
// Cancel existing timer for this channel
if channel < peakResetTimers.count {
peakResetTimers[channel].invalidate()
}
let timer = Timer.scheduledTimer(withTimeInterval: peakHoldTime, repeats: false) { [weak self] _ in
DispatchQueue.main.async {
if channel == 0 {
self?.leftPeak = self?.leftLevel ?? 0
} else {
self?.rightPeak = self?.rightLevel ?? 0
}
}
}
if peakResetTimers.count > channel {
peakResetTimers[channel] = timer
} else {
peakResetTimers.append(timer)
}
}
}
@@ -0,0 +1,18 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>com.apple.security.app-sandbox</key>
<true/>
<key>com.apple.security.device.audio-input</key>
<true/>
<key>com.apple.security.device.serial</key>
<true/>
<key>com.apple.security.files.user-selected.read-only</key>
<true/>
<key>com.apple.security.network.server</key>
<true/>
<key>com.apple.security.network.client</key>
<true/>
</dict>
</plist>
@@ -0,0 +1,92 @@
//
// AudioVUMeterApp.swift
// AudioVUMeter
//
// macOS Audio VU Meter with System Monitoring
// Captures audio from BlackHole virtual audio device
// Outputs to physical VU meter hardware via Serial/USB
// Includes VU Server for external app connections
//
import SwiftUI
@main
struct AudioVUMeterApp: App {
@StateObject private var audioEngine = AudioEngine()
@StateObject private var systemMonitor = SystemMonitor()
@StateObject private var serialManager = SerialManager()
@StateObject private var vuServer = VUServer()
// Timer for updating hardware values
@State private var updateTimer: Timer?
// Splash screen state
@State private var showSplash = true
var body: some Scene {
WindowGroup {
ZStack {
ContentView()
.environmentObject(audioEngine)
.environmentObject(systemMonitor)
.environmentObject(serialManager)
.environmentObject(vuServer)
.onAppear {
setupServer()
startHardwareUpdateTimer()
}
.onDisappear {
stopHardwareUpdateTimer()
vuServer.stop()
}
// Splash screen overlay
if showSplash {
SplashView {
withAnimation(.easeOut(duration: 0.5)) {
showSplash = false
}
}
.transition(.opacity)
}
}
}
.windowStyle(.hiddenTitleBar)
.windowResizability(.contentSize)
Settings {
SettingsView()
.environmentObject(audioEngine)
.environmentObject(serialManager)
.environmentObject(vuServer)
}
}
private func setupServer() {
// Link server to serial manager for broadcasting
vuServer.serialManager = serialManager
// Auto-start server if it was enabled
if vuServer.options.enabled {
vuServer.start()
}
}
private func startHardwareUpdateTimer() {
updateTimer = Timer.scheduledTimer(withTimeInterval: 1.0/30.0, repeats: true) { _ in
// Check if external control is active from VU Server
if vuServer.externalControlActive, let externalValues = vuServer.receivedDialValues {
// Use values from external app
serialManager.dialValues = externalValues
} else {
// Use local audio/system values
serialManager.updateValues(audioEngine: audioEngine, systemMonitor: systemMonitor)
}
}
}
private func stopHardwareUpdateTimer() {
updateTimer?.invalidate()
updateTimer = nil
}
}
+363
View File
@@ -0,0 +1,363 @@
//
// ContentView.swift
// AudioVUMeter
//
// Main view containing all VU meters and hardware output
//
import SwiftUI
struct ContentView: View {
@EnvironmentObject var audioEngine: AudioEngine
@EnvironmentObject var systemMonitor: SystemMonitor
@EnvironmentObject var serialManager: SerialManager
@EnvironmentObject var vuServer: VUServer
@State private var showSettings = false
@State private var showHardwareSettings = false
@State private var showServerSettings = false
var body: some View {
ZStack {
// Background gradient
LinearGradient(
gradient: Gradient(colors: [
Color(red: 0.1, green: 0.1, blue: 0.15),
Color(red: 0.05, green: 0.05, blue: 0.1)
]),
startPoint: .top,
endPoint: .bottom
)
.ignoresSafeArea()
ScrollView {
VStack(spacing: 16) {
// Header
HStack {
Text("Audio VU Meter")
.font(.system(size: 24, weight: .bold, design: .rounded))
.foregroundColor(.white)
Spacer()
// Server settings button
Button(action: { showServerSettings.toggle() }) {
Image(systemName: "server.rack")
.font(.system(size: 14))
.foregroundColor(vuServer.isRunning ? .cyan : .gray)
}
.buttonStyle(.plain)
.help("VU Server Settings")
// Hardware settings button
Button(action: { showHardwareSettings.toggle() }) {
Image(systemName: "cable.connector")
.font(.system(size: 16))
.foregroundColor(serialManager.isConnected ? .green : .gray)
}
.buttonStyle(.plain)
.help("Hardware Settings")
// Settings button
Button(action: { showSettings.toggle() }) {
Image(systemName: "gear")
.font(.system(size: 18))
.foregroundColor(.gray)
}
.buttonStyle(.plain)
.popover(isPresented: $showSettings) {
QuickSettingsView()
.environmentObject(audioEngine)
}
}
.padding(.horizontal)
.padding(.top, 10)
// Audio device info
HStack {
Circle()
.fill(audioEngine.isRunning ? Color.green : Color.red)
.frame(width: 8, height: 8)
Text(audioEngine.selectedDeviceName)
.font(.system(size: 12, design: .monospaced))
.foregroundColor(.gray)
Spacer()
Text(audioEngine.isRunning ? "ACTIVE" : "STOPPED")
.font(.system(size: 10, weight: .semibold, design: .monospaced))
.foregroundColor(audioEngine.isRunning ? .green : .red)
}
.padding(.horizontal)
Divider()
.background(Color.gray.opacity(0.3))
// Audio VU Meters
VStack(spacing: 15) {
Text("AUDIO LEVELS")
.font(.system(size: 11, weight: .semibold, design: .monospaced))
.foregroundColor(.gray)
HStack(spacing: 30) {
// Left Channel
VUMeterView(
level: audioEngine.leftLevel,
peakLevel: audioEngine.leftPeak,
label: "L",
colorScheme: .audio
)
// Right Channel
VUMeterView(
level: audioEngine.rightLevel,
peakLevel: audioEngine.rightPeak,
label: "R",
colorScheme: .audio
)
}
// dB Display
HStack(spacing: 40) {
VStack {
Text(String(format: "%.1f dB", audioEngine.leftLevelDB))
.font(.system(size: 14, weight: .bold, design: .monospaced))
.foregroundColor(dbColor(for: audioEngine.leftLevelDB))
Text("LEFT")
.font(.system(size: 9, design: .monospaced))
.foregroundColor(.gray)
}
VStack {
Text(String(format: "%.1f dB", audioEngine.rightLevelDB))
.font(.system(size: 14, weight: .bold, design: .monospaced))
.foregroundColor(dbColor(for: audioEngine.rightLevelDB))
Text("RIGHT")
.font(.system(size: 9, design: .monospaced))
.foregroundColor(.gray)
}
}
}
.padding()
.background(
RoundedRectangle(cornerRadius: 12)
.fill(Color.black.opacity(0.3))
)
.padding(.horizontal)
Divider()
.background(Color.gray.opacity(0.3))
// System Monitors
VStack(spacing: 15) {
Text("SYSTEM MONITOR")
.font(.system(size: 11, weight: .semibold, design: .monospaced))
.foregroundColor(.gray)
HStack(spacing: 25) {
// CPU Meter
SystemMeterView(
value: systemMonitor.cpuUsage,
label: "CPU",
unit: "%",
colorScheme: .cpu
)
// RAM Meter
SystemMeterView(
value: systemMonitor.memoryUsage,
label: "RAM",
unit: "%",
colorScheme: .ram
)
// Disk I/O Meter
SystemMeterView(
value: systemMonitor.diskActivity,
label: "DISK",
unit: "%",
colorScheme: .disk
)
// Network Meter
SystemMeterView(
value: systemMonitor.networkActivity,
label: "NET",
unit: "%",
colorScheme: .network
)
}
}
.padding()
.background(
RoundedRectangle(cornerRadius: 12)
.fill(Color.black.opacity(0.3))
)
.padding(.horizontal)
Divider()
.background(Color.gray.opacity(0.3))
// Hardware Output Panel
HardwarePanelView()
.environmentObject(serialManager)
// VU Server Panel
ServerPanelView()
.environmentObject(vuServer)
// Control buttons
HStack(spacing: 15) {
Button(action: {
if audioEngine.isRunning {
audioEngine.stop()
} else {
audioEngine.start()
}
}) {
HStack {
Image(systemName: audioEngine.isRunning ? "stop.fill" : "play.fill")
Text(audioEngine.isRunning ? "Stop" : "Start")
}
.frame(width: 80)
}
.buttonStyle(ControlButtonStyle(color: audioEngine.isRunning ? .red : .green))
Button(action: {
audioEngine.resetPeaks()
}) {
HStack {
Image(systemName: "arrow.counterclockwise")
Text("Reset")
}
.frame(width: 80)
}
.buttonStyle(ControlButtonStyle(color: .orange))
}
.padding(.bottom, 15)
}
}
}
.frame(width: 400, height: 880)
.sheet(isPresented: $showHardwareSettings) {
HardwareSettingsSheet()
.environmentObject(serialManager)
}
.sheet(isPresented: $showServerSettings) {
ServerSettingsSheet()
.environmentObject(vuServer)
}
.onAppear {
audioEngine.start()
systemMonitor.startMonitoring()
}
.onDisappear {
audioEngine.stop()
systemMonitor.stopMonitoring()
serialManager.disconnect()
}
}
private func dbColor(for db: Double) -> Color {
if db > -3 { return .red }
if db > -10 { return .orange }
if db > -20 { return .yellow }
return .green
}
}
// MARK: - Hardware Settings Sheet
struct HardwareSettingsSheet: View {
@EnvironmentObject var serialManager: SerialManager
@Environment(\.dismiss) var dismiss
var body: some View {
VStack(spacing: 0) {
// Header
HStack {
Text("Hardware Configuration")
.font(.headline)
Spacer()
Button("Done") { dismiss() }
}
.padding()
.background(Color(nsColor: .windowBackgroundColor))
Divider()
// Settings content
HardwareSettingsView()
.environmentObject(serialManager)
}
.frame(width: 500, height: 600)
}
}
// MARK: - Quick Settings Popover
struct QuickSettingsView: View {
@EnvironmentObject var audioEngine: AudioEngine
var body: some View {
VStack(alignment: .leading, spacing: 15) {
Text("Audio Device")
.font(.headline)
Picker("Device", selection: $audioEngine.selectedDeviceID) {
ForEach(audioEngine.availableDevices, id: \.id) { device in
Text(device.name).tag(device.id)
}
}
.labelsHidden()
.frame(width: 250)
.onChange(of: audioEngine.selectedDeviceID) { _ in
audioEngine.switchDevice()
}
Divider()
Text("Reference Level")
.font(.headline)
HStack {
Text("-60 dB")
.font(.caption)
Slider(value: $audioEngine.referenceLevel, in: -60...0)
Text("0 dB")
.font(.caption)
}
Text("Peak Hold Time: \(Int(audioEngine.peakHoldTime))s")
.font(.caption)
Slider(value: $audioEngine.peakHoldTime, in: 0.5...5.0)
}
.padding()
.frame(width: 300)
}
}
// MARK: - Control Button Style
struct ControlButtonStyle: ButtonStyle {
let color: Color
func makeBody(configuration: Configuration) -> some View {
configuration.label
.font(.system(size: 12, weight: .semibold))
.foregroundColor(.white)
.padding(.horizontal, 15)
.padding(.vertical, 8)
.background(
RoundedRectangle(cornerRadius: 8)
.fill(color.opacity(configuration.isPressed ? 0.6 : 0.8))
)
}
}
#Preview {
ContentView()
.environmentObject(AudioEngine())
.environmentObject(SystemMonitor())
.environmentObject(SerialManager())
.environmentObject(VUServer())
}
@@ -0,0 +1,582 @@
//
// HardwareView.swift
// AudioVUMeter
//
// Hardware configuration and monitoring view for physical VU meters
// Includes auto-probe functionality to detect connected hardware
//
import SwiftUI
// MARK: - Hardware Panel in Main View
struct HardwarePanelView: View {
@EnvironmentObject var serialManager: SerialManager
var body: some View {
VStack(spacing: 15) {
// Header
HStack {
Text("HARDWARE OUTPUT")
.font(.system(size: 11, weight: .semibold, design: .monospaced))
.foregroundColor(.gray)
Spacer()
// Connection status
HStack(spacing: 6) {
Circle()
.fill(statusColor)
.frame(width: 8, height: 8)
Text(statusText)
.font(.system(size: 9, weight: .semibold, design: .monospaced))
.foregroundColor(statusColor)
}
}
// Probing progress
if serialManager.isProbing {
VStack(spacing: 8) {
ProgressView(value: serialManager.probeProgress)
.progressViewStyle(.linear)
Text(serialManager.probeStatus)
.font(.system(size: 10, design: .monospaced))
.foregroundColor(.orange)
}
} else {
// 4 Physical Dial Indicators
HStack(spacing: 15) {
ForEach(0..<4) { index in
DialIndicatorView(
dialNumber: index + 1,
value: serialManager.dialValues[index],
channelName: shortChannelName(serialManager.dialConfigs[index].dialChannel),
isConnected: serialManager.isConnected
)
}
}
}
// Buttons
HStack(spacing: 10) {
// Auto-probe button
Button(action: {
if serialManager.isProbing {
serialManager.stopAutoProbe()
} else {
serialManager.startAutoProbe()
}
}) {
HStack {
Image(systemName: serialManager.isProbing ? "stop.fill" : "magnifyingglass")
Text(serialManager.isProbing ? "Stop" : "Auto-Find")
}
.frame(maxWidth: .infinity)
}
.buttonStyle(ProbeButtonStyle(isProbing: serialManager.isProbing))
.disabled(serialManager.isConnected)
// Connect button
Button(action: {
serialManager.toggleConnection()
}) {
HStack {
Image(systemName: serialManager.isConnected ? "antenna.radiowaves.left.and.right.slash" : "antenna.radiowaves.left.and.right")
Text(serialManager.isConnected ? "Disconnect" : "Connect")
}
.frame(maxWidth: .infinity)
}
.buttonStyle(HardwareButtonStyle(isConnected: serialManager.isConnected))
.disabled(serialManager.isProbing)
}
// Stats / Device info / Errors
if serialManager.isConnected {
VStack(spacing: 4) {
HStack {
Text("TX: \(formatBytes(serialManager.bytesSent))")
.font(.system(size: 9, design: .monospaced))
.foregroundColor(.gray)
Text("RX: \(formatBytes(serialManager.bytesReceived))")
.font(.system(size: 9, design: .monospaced))
.foregroundColor(.gray)
Spacer()
Text(serialManager.selectedPortPath.components(separatedBy: "/").last ?? "")
.font(.system(size: 9, design: .monospaced))
.foregroundColor(.green)
}
// VU-Server hardware info
if serialManager.selectedProtocol == .vuServer {
HStack {
if let fw = serialManager.firmwareVersion {
Text("FW: \(fw)")
.font(.system(size: 8, design: .monospaced))
.foregroundColor(.cyan)
}
if let hw = serialManager.hardwareVersion {
Text("HW: \(hw)")
.font(.system(size: 8, design: .monospaced))
.foregroundColor(.cyan)
}
Spacer()
}
}
}
} else if let error = serialManager.lastError {
HStack {
Image(systemName: "exclamationmark.triangle.fill")
.foregroundColor(.red)
.font(.system(size: 10))
Text(error)
.font(.system(size: 9, design: .monospaced))
.foregroundColor(.red)
.lineLimit(2)
Spacer()
}
} else if let detected = serialManager.detectedDevice {
HStack {
Image(systemName: "checkmark.circle.fill")
.foregroundColor(.green)
.font(.system(size: 10))
Text("Found: \(detected.name)")
.font(.system(size: 9, design: .monospaced))
.foregroundColor(.green)
Spacer()
if let vid = detected.vendorID, let pid = detected.productID {
Text(String(format: "%04X:%04X", vid, pid))
.font(.system(size: 8, design: .monospaced))
.foregroundColor(.gray)
}
}
} else if serialManager.availablePorts.isEmpty {
HStack {
Image(systemName: "usb")
.foregroundColor(.orange)
.font(.system(size: 10))
Text("No USB serial devices detected")
.font(.system(size: 9, design: .monospaced))
.foregroundColor(.orange)
Spacer()
}
}
}
.padding()
.background(
RoundedRectangle(cornerRadius: 12)
.fill(Color.black.opacity(0.3))
.overlay(
RoundedRectangle(cornerRadius: 12)
.stroke(borderColor, lineWidth: 1)
)
)
.padding(.horizontal)
}
private var statusColor: Color {
if serialManager.isProbing { return .orange }
if serialManager.isConnected { return .green }
return .red
}
private var statusText: String {
if serialManager.isProbing { return "PROBING" }
if serialManager.isConnected { return "CONNECTED" }
return "DISCONNECTED"
}
private var borderColor: Color {
if serialManager.isProbing { return .orange.opacity(0.3) }
if serialManager.isConnected { return .green.opacity(0.3) }
return .clear
}
private func shortChannelName(_ channel: DialChannel) -> String {
switch channel {
case .audioLeft: return "L"
case .audioRight: return "R"
case .audioPeak: return "PK"
case .audioMono: return "M"
case .cpu: return "CPU"
case .ram: return "RAM"
case .disk: return "DSK"
case .network: return "NET"
}
}
private func formatBytes(_ bytes: UInt64) -> String {
if bytes < 1024 { return "\(bytes) B" }
if bytes < 1024 * 1024 { return String(format: "%.1f KB", Double(bytes) / 1024) }
return String(format: "%.1f MB", Double(bytes) / (1024 * 1024))
}
}
// MARK: - Single Dial Indicator
struct DialIndicatorView: View {
let dialNumber: Int
let value: Int
let channelName: String
let isConnected: Bool
var body: some View {
VStack(spacing: 4) {
// Dial number with connection indicator
HStack(spacing: 2) {
Circle()
.fill(isConnected ? Color.green : Color.red)
.frame(width: 5, height: 5)
Text("D\(dialNumber)")
.font(.system(size: 10, weight: .bold, design: .monospaced))
.foregroundColor(.white.opacity(0.7))
}
// Value arc
ZStack {
// Background arc
Circle()
.trim(from: 0.25, to: 0.75)
.stroke(Color.gray.opacity(0.3), lineWidth: 4)
.frame(width: 50, height: 50)
.rotationEffect(.degrees(180))
// Value arc - always show with minimum visibility
Circle()
.trim(from: 0.25, to: 0.25 + max(0.02, (Double(value) / 255.0) * 0.5))
.stroke(
dialColor(for: value, connected: isConnected),
style: StrokeStyle(lineWidth: 4, lineCap: .round)
)
.frame(width: 50, height: 50)
.rotationEffect(.degrees(180))
.animation(.easeOut(duration: 0.1), value: value)
// Value text
VStack(spacing: 0) {
Text("\(value)")
.font(.system(size: 14, weight: .bold, design: .monospaced))
.foregroundColor(isConnected ? .white : .gray)
}
}
// Channel name
Text(channelName)
.font(.system(size: 9, weight: .semibold, design: .monospaced))
.foregroundColor(channelColor(channelName))
}
}
private func dialColor(for value: Int, connected: Bool) -> Color {
if !connected {
return Color.gray.opacity(0.5)
}
let ratio = Double(value) / 255.0
if ratio > 0.9 { return .red }
if ratio > 0.75 { return .orange }
if ratio > 0.5 { return .yellow }
return .green
}
private func channelColor(_ name: String) -> Color {
switch name {
case "L", "R", "PK", "M": return .green
case "CPU": return .blue
case "RAM": return .purple
case "DSK": return .teal
case "NET": return .indigo
default: return .gray
}
}
}
// MARK: - Hardware Settings View
struct HardwareSettingsView: View {
@EnvironmentObject var serialManager: SerialManager
var body: some View {
Form {
// Auto-Probe Section
Section("Auto-Detect Hardware") {
HStack {
Button(action: {
if serialManager.isProbing {
serialManager.stopAutoProbe()
} else {
serialManager.startAutoProbe()
}
}) {
HStack {
Image(systemName: serialManager.isProbing ? "stop.fill" : "magnifyingglass.circle.fill")
Text(serialManager.isProbing ? "Stop Probing" : "Auto-Detect VU Meter")
}
}
.disabled(serialManager.isConnected)
Spacer()
Button("Quick Connect") {
serialManager.autoConnect()
}
.disabled(serialManager.isConnected || serialManager.isProbing)
}
if serialManager.isProbing {
VStack(alignment: .leading, spacing: 8) {
ProgressView(value: serialManager.probeProgress) {
Text(serialManager.probeStatus)
.font(.caption)
}
}
}
if let detected = serialManager.detectedDevice {
HStack {
Image(systemName: "checkmark.circle.fill")
.foregroundColor(.green)
VStack(alignment: .leading) {
Text("Detected: \(detected.name)")
.font(.headline)
if let vid = detected.vendorID, let pid = detected.productID {
Text(String(format: "USB ID: %04X:%04X", vid, pid))
.font(.caption)
.foregroundColor(.secondary)
}
}
}
}
}
// Connection Section
Section("Serial Connection") {
// Port selection with USB info
Picker("Port", selection: $serialManager.selectedPortPath) {
Text("Select Port...").tag("")
ForEach(serialManager.availablePorts) { port in
HStack {
if port.isVUMeter {
Image(systemName: "star.fill")
.foregroundColor(.yellow)
}
Text(port.name)
if let vid = port.vendorID, let pid = port.productID {
Text(String(format: "(%04X:%04X)", vid, pid))
.foregroundColor(.secondary)
.font(.caption)
}
}
.tag(port.path)
}
}
HStack {
Button(action: { serialManager.refreshPorts() }) {
Label("Refresh", systemImage: "arrow.clockwise")
}
.buttonStyle(.borderless)
Spacer()
Text("\(serialManager.availablePorts.count) ports found")
.font(.caption)
.foregroundColor(.secondary)
}
// Baud rate
Picker("Baud Rate", selection: $serialManager.baudRate) {
ForEach(SerialManager.availableBaudRates, id: \.self) { rate in
Text("\(rate)").tag(rate)
}
}
// Protocol
Picker("Protocol", selection: $serialManager.selectedProtocol) {
ForEach(SerialProtocol.allCases) { proto in
Text(proto.rawValue).tag(proto)
}
}
// Connect button
Button(action: { serialManager.toggleConnection() }) {
HStack {
Image(systemName: serialManager.isConnected ? "bolt.slash.fill" : "bolt.fill")
Text(serialManager.isConnected ? "Disconnect" : "Connect")
}
}
.foregroundColor(serialManager.isConnected ? .red : .green)
.disabled(serialManager.isProbing)
}
// Dial Configuration Section
Section("Dial Assignments") {
ForEach(0..<4) { index in
DialConfigRow(
dialNumber: index + 1,
config: $serialManager.dialConfigs[index]
)
}
}
// Advanced Settings
Section("Advanced") {
ForEach(0..<4) { index in
DisclosureGroup("Dial \(index + 1) Settings") {
HStack {
Text("Min Value")
Spacer()
TextField("0", value: $serialManager.dialConfigs[index].minValue, format: .number)
.frame(width: 60)
.textFieldStyle(.roundedBorder)
}
HStack {
Text("Max Value")
Spacer()
TextField("255", value: $serialManager.dialConfigs[index].maxValue, format: .number)
.frame(width: 60)
.textFieldStyle(.roundedBorder)
}
Toggle("Invert", isOn: $serialManager.dialConfigs[index].inverted)
HStack {
Text("Smoothing")
Slider(value: $serialManager.dialConfigs[index].smoothing, in: 0...0.9)
Text("\(Int(serialManager.dialConfigs[index].smoothing * 100))%")
.frame(width: 40)
}
}
}
}
// Probe Results (for debugging)
if !serialManager.probeResults.isEmpty {
Section("Probe Results") {
ForEach(serialManager.probeResults.indices, id: \.self) { index in
let result = serialManager.probeResults[index]
HStack {
Image(systemName: result.success ? "checkmark.circle" : "xmark.circle")
.foregroundColor(result.success ? .green : .red)
VStack(alignment: .leading) {
Text(result.port.name)
.font(.caption)
Text("\(result.baudRate) baud - \(result.protocol_.rawValue)")
.font(.caption2)
.foregroundColor(.secondary)
}
Spacer()
if let response = result.response {
Text(response.prefix(20) + "...")
.font(.caption2)
.foregroundColor(.green)
}
}
}
Button("Clear Results") {
serialManager.probeResults.removeAll()
}
}
}
// Protocol Info
Section("Protocol Reference") {
VStack(alignment: .leading, spacing: 8) {
protocolInfo
}
.font(.system(size: 11, design: .monospaced))
.foregroundColor(.secondary)
}
}
.formStyle(.grouped)
}
@ViewBuilder
private var protocolInfo: some View {
switch serialManager.selectedProtocol {
case .rawBytes:
Text("Format: [0xAA] [D1] [D2] [D3] [D4] [0x55]")
Text("Values: 0-255 per dial")
case .textCommand:
Text("Format: CH1:val;CH2:val;CH3:val;CH4:val\\n")
Text("Values: 0-255 per channel")
case .json:
Text("Format: {\"dials\":[d1,d2,d3,d4]}\\n")
Text("Values: 0-255 array")
case .vuServer:
Text("Binary Protocol: '>' + 9-byte header + payload")
Text("Commands: 0x03 (single %), 0x04 (all %)")
Text("Values: 0-100 percentage per dial")
}
}
}
// MARK: - Dial Config Row
struct DialConfigRow: View {
let dialNumber: Int
@Binding var config: DialConfig
var body: some View {
HStack {
Text("Dial \(dialNumber)")
.font(.system(.body, design: .monospaced))
.frame(width: 60, alignment: .leading)
Picker("", selection: $config.dialChannel) {
ForEach(DialChannel.allCases) { channel in
Text(channel.rawValue).tag(channel)
}
}
.labelsHidden()
}
}
}
// MARK: - Button Styles
struct HardwareButtonStyle: ButtonStyle {
let isConnected: Bool
func makeBody(configuration: Configuration) -> some View {
configuration.label
.font(.system(size: 12, weight: .semibold))
.foregroundColor(.white)
.padding(.vertical, 8)
.background(
RoundedRectangle(cornerRadius: 8)
.fill(isConnected ? Color.red.opacity(0.7) : Color.green.opacity(0.7))
.opacity(configuration.isPressed ? 0.6 : 1.0)
)
}
}
struct ProbeButtonStyle: ButtonStyle {
let isProbing: Bool
func makeBody(configuration: Configuration) -> some View {
configuration.label
.font(.system(size: 12, weight: .semibold))
.foregroundColor(.white)
.padding(.vertical, 8)
.background(
RoundedRectangle(cornerRadius: 8)
.fill(isProbing ? Color.orange.opacity(0.7) : Color.blue.opacity(0.7))
.opacity(configuration.isPressed ? 0.6 : 1.0)
)
}
}
// MARK: - Preview
#Preview {
HardwareSettingsView()
.environmentObject(SerialManager())
.frame(width: 500, height: 700)
}
+32
View File
@@ -0,0 +1,32 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>CFBundleDevelopmentRegion</key>
<string>$(DEVELOPMENT_LANGUAGE)</string>
<key>CFBundleExecutable</key>
<string>$(EXECUTABLE_NAME)</string>
<key>CFBundleIconFile</key>
<string></string>
<key>CFBundleIdentifier</key>
<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
<key>CFBundleInfoDictionaryVersion</key>
<string>6.0</string>
<key>CFBundleName</key>
<string>$(PRODUCT_NAME)</string>
<key>CFBundlePackageType</key>
<string>$(PRODUCT_BUNDLE_PACKAGE_TYPE)</string>
<key>CFBundleShortVersionString</key>
<string>1.0</string>
<key>CFBundleVersion</key>
<string>1</string>
<key>LSMinimumSystemVersion</key>
<string>$(MACOSX_DEPLOYMENT_TARGET)</string>
<key>NSHumanReadableCopyright</key>
<string>Copyright © 2024. All rights reserved.</string>
<key>NSMicrophoneUsageDescription</key>
<string>Audio VU Meter needs access to audio input to display audio levels from BlackHole or other audio devices.</string>
<key>NSPrincipalClass</key>
<string>NSApplication</string>
</dict>
</plist>
File diff suppressed because it is too large Load Diff
+484
View File
@@ -0,0 +1,484 @@
//
// ServerView.swift
// AudioVUMeter
//
// Server configuration and status view
// Allows enabling/disabling the VU Server for external app connections
//
import SwiftUI
// MARK: - Server Panel in Main View
struct ServerPanelView: View {
@EnvironmentObject var vuServer: VUServer
var body: some View {
VStack(spacing: 12) {
// Header
HStack {
Text("VU SERVER")
.font(.system(size: 11, weight: .semibold, design: .monospaced))
.foregroundColor(.gray)
Spacer()
// Status indicator
HStack(spacing: 6) {
Circle()
.fill(statusColor)
.frame(width: 8, height: 8)
Text(statusText)
.font(.system(size: 9, weight: .semibold, design: .monospaced))
.foregroundColor(statusColor)
}
}
// Quick info
if vuServer.isRunning {
HStack {
// Port info
Label(":\(vuServer.options.port)", systemImage: "network")
.font(.system(size: 10, design: .monospaced))
.foregroundColor(.cyan)
Spacer()
// Client count
Label("\(vuServer.connectedClients.count)", systemImage: "person.2.fill")
.font(.system(size: 10, design: .monospaced))
.foregroundColor(vuServer.connectedClients.isEmpty ? .gray : .green)
Spacer()
// External control indicator
if vuServer.externalControlActive {
Label("EXT", systemImage: "arrow.down.circle.fill")
.font(.system(size: 10, weight: .bold, design: .monospaced))
.foregroundColor(.orange)
}
}
}
// Toggle button
Button(action: {
vuServer.toggle()
vuServer.saveOptions()
}) {
HStack {
Image(systemName: vuServer.isRunning ? "stop.fill" : "play.fill")
Text(vuServer.isRunning ? "Stop Server" : "Start Server")
}
.frame(maxWidth: .infinity)
}
.buttonStyle(ServerButtonStyle(isRunning: vuServer.isRunning))
// Last command (if any)
if vuServer.isRunning && !vuServer.lastReceivedCommand.isEmpty {
HStack {
Text("Last:")
.font(.system(size: 8, design: .monospaced))
.foregroundColor(.gray)
Text(vuServer.lastReceivedCommand.prefix(30) + (vuServer.lastReceivedCommand.count > 30 ? "..." : ""))
.font(.system(size: 8, design: .monospaced))
.foregroundColor(.cyan)
.lineLimit(1)
Spacer()
}
}
}
.padding()
.background(
RoundedRectangle(cornerRadius: 12)
.fill(Color.black.opacity(0.3))
.overlay(
RoundedRectangle(cornerRadius: 12)
.stroke(borderColor, lineWidth: 1)
)
)
.padding(.horizontal)
}
private var statusColor: Color {
if vuServer.isRunning {
return vuServer.connectedClients.isEmpty ? .yellow : .green
}
return .gray
}
private var statusText: String {
if vuServer.isRunning {
if vuServer.connectedClients.isEmpty {
return "LISTENING"
}
return "\(vuServer.connectedClients.count) CLIENT\(vuServer.connectedClients.count == 1 ? "" : "S")"
}
return "STOPPED"
}
private var borderColor: Color {
if vuServer.externalControlActive { return .orange.opacity(0.5) }
if vuServer.isRunning { return .cyan.opacity(0.3) }
return .clear
}
}
// MARK: - Server Settings View (Full)
struct ServerSettingsView: View {
@EnvironmentObject var vuServer: VUServer
@State private var portString: String = ""
@State private var showAdvanced = false
var body: some View {
Form {
// Main Server Section
Section("Server Control") {
// Enable/Disable toggle
Toggle(isOn: Binding(
get: { vuServer.isRunning },
set: { newValue in
if newValue {
vuServer.start()
} else {
vuServer.stop()
}
vuServer.saveOptions()
}
)) {
HStack {
Image(systemName: vuServer.isRunning ? "antenna.radiowaves.left.and.right" : "antenna.radiowaves.left.and.right.slash")
.foregroundColor(vuServer.isRunning ? .green : .gray)
Text("Server Enabled")
}
}
// Status
if vuServer.isRunning {
HStack {
Text("Status")
Spacer()
Circle()
.fill(Color.green)
.frame(width: 8, height: 8)
Text("Running on port \(vuServer.options.port)")
.foregroundColor(.secondary)
}
}
// Error display
if let error = vuServer.lastError {
HStack {
Image(systemName: "exclamationmark.triangle.fill")
.foregroundColor(.red)
Text(error)
.foregroundColor(.red)
.font(.caption)
}
}
}
// Connection Settings
Section("Connection Settings") {
// Port
HStack {
Text("Port")
Spacer()
TextField("Port", text: $portString)
.frame(width: 80)
.textFieldStyle(.roundedBorder)
.onAppear {
portString = String(vuServer.options.port)
}
.onChange(of: portString) { newValue in
if let port = UInt16(newValue), port > 0 {
vuServer.options.port = port
vuServer.saveOptions()
}
}
}
// Allow remote connections
Toggle("Allow Remote Connections", isOn: $vuServer.options.allowRemote)
.onChange(of: vuServer.options.allowRemote) { _ in
vuServer.saveOptions()
if vuServer.isRunning {
vuServer.restart()
}
}
if vuServer.options.allowRemote {
HStack {
Image(systemName: "exclamationmark.triangle.fill")
.foregroundColor(.orange)
Text("Warning: Remote access enabled. Anyone on your network can connect.")
.font(.caption)
.foregroundColor(.orange)
}
}
// Max clients
Stepper("Max Clients: \(vuServer.options.maxClients)", value: $vuServer.options.maxClients, in: 1...20)
.onChange(of: vuServer.options.maxClients) { _ in
vuServer.saveOptions()
}
}
// Protocol Settings
Section("Protocol") {
Picker("Server Protocol", selection: $vuServer.options.serverProtocol) {
ForEach(ServerProtocol.allCases) { proto in
Text(proto.rawValue).tag(proto)
}
}
.onChange(of: vuServer.options.serverProtocol) { _ in
vuServer.saveOptions()
}
// Broadcast settings
Toggle("Broadcast Levels to Clients", isOn: $vuServer.options.broadcastLevels)
.onChange(of: vuServer.options.broadcastLevels) { _ in
vuServer.saveOptions()
}
if vuServer.options.broadcastLevels {
HStack {
Text("Broadcast Rate")
Slider(value: $vuServer.options.broadcastInterval, in: 0.033...1.0)
Text("\(Int(1.0 / vuServer.options.broadcastInterval)) Hz")
.frame(width: 50)
}
.onChange(of: vuServer.options.broadcastInterval) { _ in
vuServer.saveOptions()
}
}
}
// Connected Clients
Section("Connected Clients (\(vuServer.connectedClients.count))") {
if vuServer.connectedClients.isEmpty {
HStack {
Image(systemName: "person.slash")
.foregroundColor(.gray)
Text("No clients connected")
.foregroundColor(.secondary)
}
} else {
ForEach(vuServer.connectedClients) { client in
ClientRowView(client: client, onDisconnect: {
vuServer.disconnectClient(client)
})
}
}
}
// Statistics
if vuServer.isRunning {
Section("Statistics") {
HStack {
Text("Received")
Spacer()
Text(formatBytes(vuServer.totalBytesReceived))
.foregroundColor(.secondary)
.font(.system(.body, design: .monospaced))
}
HStack {
Text("Sent")
Spacer()
Text(formatBytes(vuServer.totalBytesSent))
.foregroundColor(.secondary)
.font(.system(.body, design: .monospaced))
}
if vuServer.externalControlActive {
HStack {
Image(systemName: "arrow.down.circle.fill")
.foregroundColor(.orange)
Text("External Control Active")
.foregroundColor(.orange)
Spacer()
Button("Release") {
vuServer.externalControlActive = false
vuServer.receivedDialValues = nil
}
.buttonStyle(.borderless)
}
}
if !vuServer.lastReceivedCommand.isEmpty {
VStack(alignment: .leading) {
Text("Last Command")
Text(vuServer.lastReceivedCommand)
.font(.system(.caption, design: .monospaced))
.foregroundColor(.cyan)
.lineLimit(3)
}
}
}
}
// Protocol Reference
Section("Protocol Reference") {
DisclosureGroup("VU Protocol") {
VStack(alignment: .leading, spacing: 4) {
Text("Send values: #channel:percentage")
Text("Example: #0:75 (dial 0 at 75%)")
Text("Channels: 0-3")
Text("Values: 0-100")
Text("Commands: ?, STATUS, RELEASE")
}
.font(.system(size: 11, design: .monospaced))
.foregroundColor(.secondary)
}
DisclosureGroup("JSON Protocol") {
VStack(alignment: .leading, spacing: 4) {
Text("{\"dials\":[v1,v2,v3,v4]}")
Text("or {\"d0\":v,\"d1\":v,...}")
Text("Values: 0-255")
Text("Commands: {\"cmd\":\"status\"}")
}
.font(.system(size: 11, design: .monospaced))
.foregroundColor(.secondary)
}
DisclosureGroup("Raw Bytes") {
VStack(alignment: .leading, spacing: 4) {
Text("Frame: [0xAA][D1][D2][D3][D4][0x55]")
Text("Values: 0-255 per byte")
}
.font(.system(size: 11, design: .monospaced))
.foregroundColor(.secondary)
}
}
// Test Connection
Section("Test") {
VStack(alignment: .leading, spacing: 8) {
Text("Test with netcat:")
.font(.caption)
.foregroundColor(.secondary)
Text("echo '#0:50' | nc localhost \(vuServer.options.port)")
.font(.system(size: 10, design: .monospaced))
.padding(8)
.background(Color.black.opacity(0.3))
.cornerRadius(4)
Button("Copy Command") {
NSPasteboard.general.clearContents()
NSPasteboard.general.setString("echo '#0:50' | nc localhost \(vuServer.options.port)", forType: .string)
}
.buttonStyle(.borderless)
}
}
}
.formStyle(.grouped)
}
private func formatBytes(_ bytes: UInt64) -> String {
if bytes < 1024 { return "\(bytes) B" }
if bytes < 1024 * 1024 { return String(format: "%.1f KB", Double(bytes) / 1024) }
return String(format: "%.1f MB", Double(bytes) / (1024 * 1024))
}
}
// MARK: - Client Row View
struct ClientRowView: View {
let client: ConnectedClient
let onDisconnect: () -> Void
var body: some View {
HStack {
VStack(alignment: .leading, spacing: 2) {
Text(client.address)
.font(.system(.body, design: .monospaced))
HStack(spacing: 10) {
Text("RX: \(formatBytes(client.bytesReceived))")
Text("TX: \(formatBytes(client.bytesSent))")
}
.font(.caption)
.foregroundColor(.secondary)
}
Spacer()
Text(timeAgo(client.lastActivity))
.font(.caption)
.foregroundColor(.secondary)
Button(action: onDisconnect) {
Image(systemName: "xmark.circle.fill")
.foregroundColor(.red)
}
.buttonStyle(.borderless)
}
}
private func formatBytes(_ bytes: UInt64) -> String {
if bytes < 1024 { return "\(bytes)B" }
if bytes < 1024 * 1024 { return String(format: "%.1fK", Double(bytes) / 1024) }
return String(format: "%.1fM", Double(bytes) / (1024 * 1024))
}
private func timeAgo(_ date: Date) -> String {
let seconds = Int(-date.timeIntervalSinceNow)
if seconds < 60 { return "\(seconds)s" }
if seconds < 3600 { return "\(seconds / 60)m" }
return "\(seconds / 3600)h"
}
}
// MARK: - Server Settings Sheet
struct ServerSettingsSheet: View {
@EnvironmentObject var vuServer: VUServer
@Environment(\.dismiss) var dismiss
var body: some View {
VStack(spacing: 0) {
// Header
HStack {
Text("VU Server Settings")
.font(.headline)
Spacer()
Button("Done") { dismiss() }
}
.padding()
.background(Color(nsColor: .windowBackgroundColor))
Divider()
// Settings content
ServerSettingsView()
.environmentObject(vuServer)
}
.frame(width: 500, height: 650)
}
}
// MARK: - Button Style
struct ServerButtonStyle: ButtonStyle {
let isRunning: Bool
func makeBody(configuration: Configuration) -> some View {
configuration.label
.font(.system(size: 12, weight: .semibold))
.foregroundColor(.white)
.padding(.vertical, 8)
.background(
RoundedRectangle(cornerRadius: 8)
.fill(isRunning ? Color.red.opacity(0.7) : Color.cyan.opacity(0.7))
.opacity(configuration.isPressed ? 0.6 : 1.0)
)
}
}
// MARK: - Preview
#Preview {
ServerSettingsView()
.environmentObject(VUServer())
.frame(width: 500, height: 700)
}
@@ -0,0 +1,155 @@
//
// SettingsView.swift
// AudioVUMeter
//
// Settings window for configuring audio device, hardware output, and preferences
//
import SwiftUI
struct SettingsView: View {
@EnvironmentObject var audioEngine: AudioEngine
@EnvironmentObject var serialManager: SerialManager
@EnvironmentObject var vuServer: VUServer
@AppStorage("showPeakIndicator") private var showPeakIndicator = true
@AppStorage("meterStyle") private var meterStyle = "classic"
@AppStorage("updateRate") private var updateRate = 30.0
var body: some View {
TabView {
// Audio Settings
Form {
Section("Audio Device") {
Picker("Input Device", selection: $audioEngine.selectedDeviceID) {
ForEach(audioEngine.availableDevices, id: \.id) { device in
HStack {
Text(device.name)
Spacer()
Text("\(device.inputChannels) ch")
.foregroundColor(.secondary)
.font(.caption)
}
.tag(device.id)
}
}
.onChange(of: audioEngine.selectedDeviceID) { _ in
audioEngine.switchDevice()
}
Button("Refresh Devices") {
audioEngine.refreshDeviceList()
}
}
Section("Levels") {
HStack {
Text("Reference Level")
Spacer()
Text("\(Int(audioEngine.referenceLevel)) dB")
.foregroundColor(.secondary)
}
Slider(value: $audioEngine.referenceLevel, in: -60...0, step: 1)
HStack {
Text("Peak Hold Time")
Spacer()
Text("\(String(format: "%.1f", audioEngine.peakHoldTime)) s")
.foregroundColor(.secondary)
}
Slider(value: $audioEngine.peakHoldTime, in: 0.5...10, step: 0.5)
}
}
.tabItem {
Label("Audio", systemImage: "waveform")
}
// Hardware Settings
HardwareSettingsView()
.environmentObject(serialManager)
.tabItem {
Label("Hardware", systemImage: "cable.connector")
}
// Server Settings
ServerSettingsView()
.environmentObject(vuServer)
.tabItem {
Label("Server", systemImage: "server.rack")
}
// Display Settings
Form {
Section("Meter Display") {
Toggle("Show Peak Indicator", isOn: $showPeakIndicator)
Picker("Meter Style", selection: $meterStyle) {
Text("Classic").tag("classic")
Text("Modern").tag("modern")
Text("Minimal").tag("minimal")
}
}
Section("Performance") {
HStack {
Text("Update Rate")
Spacer()
Text("\(Int(updateRate)) fps")
.foregroundColor(.secondary)
}
Slider(value: $updateRate, in: 10...60, step: 5)
}
}
.tabItem {
Label("Display", systemImage: "display")
}
// About
VStack(spacing: 20) {
Image(systemName: "waveform.circle.fill")
.font(.system(size: 64))
.foregroundColor(.accentColor)
Text("Audio VU Meter")
.font(.title)
.fontWeight(.bold)
Text("Version 1.2.0")
.foregroundColor(.secondary)
Divider()
.frame(width: 200)
VStack(spacing: 8) {
Text("A macOS audio level meter with system monitoring")
Text("and physical VU meter hardware support.")
}
.multilineTextAlignment(.center)
.foregroundColor(.secondary)
.frame(width: 300)
Spacer()
VStack(spacing: 4) {
Text("Supports BlackHole virtual audio device,")
Text("USB/Serial VU meter hardware,")
Text("and TCP server for external apps")
}
.font(.caption)
.foregroundColor(.secondary)
}
.padding()
.tabItem {
Label("About", systemImage: "info.circle")
}
}
.frame(width: 500, height: 500)
}
}
#Preview {
SettingsView()
.environmentObject(AudioEngine())
.environmentObject(SerialManager())
.environmentObject(VUServer())
}
+251
View File
@@ -0,0 +1,251 @@
//
// SplashView.swift
// AudioVUMeter
//
// Splash screen shown at app startup
// Presented by Gnafzgi Software
//
import SwiftUI
struct SplashView: View {
@State private var isAnimating = false
@State private var showApp = false
@State private var logoScale: CGFloat = 0.5
@State private var logoOpacity: Double = 0
@State private var textOpacity: Double = 0
@State private var subtitleOpacity: Double = 0
@State private var waveOffset: CGFloat = 0
let onComplete: () -> Void
var body: some View {
ZStack {
// Background gradient
LinearGradient(
gradient: Gradient(colors: [
Color(red: 0.05, green: 0.05, blue: 0.1),
Color(red: 0.1, green: 0.08, blue: 0.15),
Color(red: 0.05, green: 0.05, blue: 0.1)
]),
startPoint: .topLeading,
endPoint: .bottomTrailing
)
.ignoresSafeArea()
// Animated wave background
WaveBackground(offset: waveOffset)
.opacity(0.3)
VStack(spacing: 30) {
Spacer()
// Animated VU Meter Icon
ZStack {
// Glow effect
Circle()
.fill(
RadialGradient(
gradient: Gradient(colors: [
Color.green.opacity(0.4),
Color.clear
]),
center: .center,
startRadius: 30,
endRadius: 80
)
)
.frame(width: 160, height: 160)
.blur(radius: 20)
.scaleEffect(isAnimating ? 1.2 : 1.0)
// Main icon
Image(systemName: "waveform.circle.fill")
.font(.system(size: 100))
.foregroundStyle(
LinearGradient(
colors: [.green, .cyan, .blue],
startPoint: .topLeading,
endPoint: .bottomTrailing
)
)
.shadow(color: .green.opacity(0.5), radius: 20)
}
.scaleEffect(logoScale)
.opacity(logoOpacity)
// App Title
VStack(spacing: 8) {
Text("Audio VU Meter")
.font(.system(size: 36, weight: .bold, design: .rounded))
.foregroundStyle(
LinearGradient(
colors: [.white, .gray.opacity(0.8)],
startPoint: .top,
endPoint: .bottom
)
)
Text("Professional Audio Monitoring")
.font(.system(size: 14, weight: .medium, design: .rounded))
.foregroundColor(.gray)
}
.opacity(textOpacity)
Spacer()
// Presented by
VStack(spacing: 6) {
Text("presented by")
.font(.system(size: 11, weight: .regular, design: .rounded))
.foregroundColor(.gray.opacity(0.6))
.tracking(2)
Text("GNAFZGI SOFTWARE")
.font(.system(size: 16, weight: .bold, design: .rounded))
.foregroundStyle(
LinearGradient(
colors: [.cyan, .blue],
startPoint: .leading,
endPoint: .trailing
)
)
.tracking(3)
}
.opacity(subtitleOpacity)
.padding(.bottom, 50)
}
// Version badge
VStack {
Spacer()
HStack {
Spacer()
Text("v1.3")
.font(.system(size: 10, weight: .medium, design: .monospaced))
.foregroundColor(.gray.opacity(0.5))
.padding(8)
}
}
}
.frame(width: 400, height: 500)
.onAppear {
startAnimations()
}
}
private func startAnimations() {
// Wave animation (continuous)
withAnimation(.linear(duration: 8).repeatForever(autoreverses: false)) {
waveOffset = 1
}
// Logo animation
withAnimation(.spring(response: 0.8, dampingFraction: 0.6).delay(0.2)) {
logoScale = 1.0
logoOpacity = 1.0
}
// Pulse animation
withAnimation(.easeInOut(duration: 1.5).repeatForever(autoreverses: true).delay(0.5)) {
isAnimating = true
}
// Title animation
withAnimation(.easeOut(duration: 0.8).delay(0.6)) {
textOpacity = 1.0
}
// Subtitle animation
withAnimation(.easeOut(duration: 0.8).delay(1.0)) {
subtitleOpacity = 1.0
}
// Auto-dismiss after delay
DispatchQueue.main.asyncAfter(deadline: .now() + 2.5) {
withAnimation(.easeOut(duration: 0.3)) {
onComplete()
}
}
}
}
// MARK: - Wave Background
struct WaveBackground: View {
let offset: CGFloat
var body: some View {
GeometryReader { geometry in
ZStack {
// First wave
WavePath(offset: offset, amplitude: 20, frequency: 1.5)
.stroke(
LinearGradient(
colors: [.green.opacity(0.3), .cyan.opacity(0.2)],
startPoint: .leading,
endPoint: .trailing
),
lineWidth: 2
)
// Second wave
WavePath(offset: offset + 0.3, amplitude: 15, frequency: 2)
.stroke(
LinearGradient(
colors: [.blue.opacity(0.2), .purple.opacity(0.2)],
startPoint: .leading,
endPoint: .trailing
),
lineWidth: 1.5
)
// Third wave
WavePath(offset: offset + 0.6, amplitude: 25, frequency: 1)
.stroke(
LinearGradient(
colors: [.cyan.opacity(0.15), .green.opacity(0.1)],
startPoint: .leading,
endPoint: .trailing
),
lineWidth: 1
)
}
}
}
}
// MARK: - Wave Path
struct WavePath: Shape {
var offset: CGFloat
var amplitude: CGFloat
var frequency: CGFloat
var animatableData: CGFloat {
get { offset }
set { offset = newValue }
}
func path(in rect: CGRect) -> Path {
var path = Path()
let midY = rect.midY
path.move(to: CGPoint(x: 0, y: midY))
for x in stride(from: 0, through: rect.width, by: 2) {
let relativeX = x / rect.width
let sine = sin((relativeX + offset) * .pi * 2 * frequency)
let y = midY + sine * amplitude
path.addLine(to: CGPoint(x: x, y: y))
}
return path
}
}
// MARK: - Preview
#Preview {
SplashView {
print("Splash complete")
}
}
@@ -0,0 +1,278 @@
//
// SystemMonitor.swift
// AudioVUMeter
//
// System resource monitoring for CPU, RAM, Disk, and Network
// Uses mach kernel APIs for accurate system statistics
//
import Foundation
import Darwin
/// System resource monitor class
class SystemMonitor: ObservableObject {
// MARK: - Published Properties
@Published var cpuUsage: Double = 0
@Published var memoryUsage: Double = 0
@Published var diskActivity: Double = 0
@Published var networkActivity: Double = 0
// Additional details
@Published var cpuUserUsage: Double = 0
@Published var cpuSystemUsage: Double = 0
@Published var memoryUsed: UInt64 = 0
@Published var memoryTotal: UInt64 = 0
@Published var networkBytesIn: UInt64 = 0
@Published var networkBytesOut: UInt64 = 0
// MARK: - Private Properties
private var updateTimer: Timer?
private var previousCPUInfo: host_cpu_load_info?
private var previousNetworkBytes: (in: UInt64, out: UInt64) = (0, 0)
private var previousDiskBytes: (read: UInt64, write: UInt64) = (0, 0)
private let updateInterval: TimeInterval = 0.5
// MARK: - Public Methods
/// Start monitoring system resources
func startMonitoring() {
// Get initial values
previousCPUInfo = getCPULoadInfo()
previousNetworkBytes = getNetworkBytes()
previousDiskBytes = getDiskBytes()
// Start update timer
updateTimer = Timer.scheduledTimer(withTimeInterval: updateInterval, repeats: true) { [weak self] _ in
self?.updateMetrics()
}
// Initial update
updateMetrics()
}
/// Stop monitoring
func stopMonitoring() {
updateTimer?.invalidate()
updateTimer = nil
}
// MARK: - Private Methods
private func updateMetrics() {
DispatchQueue.global(qos: .background).async { [weak self] in
guard let self = self else { return }
let cpu = self.calculateCPUUsage()
let memory = self.calculateMemoryUsage()
let disk = self.calculateDiskActivity()
let network = self.calculateNetworkActivity()
DispatchQueue.main.async {
self.cpuUsage = cpu.total
self.cpuUserUsage = cpu.user
self.cpuSystemUsage = cpu.system
self.memoryUsage = memory.percentage
self.memoryUsed = memory.used
self.memoryTotal = memory.total
self.diskActivity = disk
self.networkActivity = network.percentage
self.networkBytesIn = network.bytesIn
self.networkBytesOut = network.bytesOut
}
}
}
// MARK: - CPU Monitoring
private func getCPULoadInfo() -> host_cpu_load_info? {
var cpuLoadInfo = host_cpu_load_info()
var count = mach_msg_type_number_t(MemoryLayout<host_cpu_load_info>.stride / MemoryLayout<integer_t>.stride)
let result = withUnsafeMutablePointer(to: &cpuLoadInfo) {
$0.withMemoryRebound(to: integer_t.self, capacity: Int(count)) {
host_statistics(mach_host_self(), HOST_CPU_LOAD_INFO, $0, &count)
}
}
return result == KERN_SUCCESS ? cpuLoadInfo : nil
}
private func calculateCPUUsage() -> (total: Double, user: Double, system: Double) {
guard let currentInfo = getCPULoadInfo(),
let previousInfo = previousCPUInfo else {
return (0, 0, 0)
}
let userDiff = Double(currentInfo.cpu_ticks.0 - previousInfo.cpu_ticks.0)
let systemDiff = Double(currentInfo.cpu_ticks.1 - previousInfo.cpu_ticks.1)
let idleDiff = Double(currentInfo.cpu_ticks.2 - previousInfo.cpu_ticks.2)
let niceDiff = Double(currentInfo.cpu_ticks.3 - previousInfo.cpu_ticks.3)
let totalTicks = userDiff + systemDiff + idleDiff + niceDiff
guard totalTicks > 0 else { return (0, 0, 0) }
let userPercent = (userDiff / totalTicks) * 100
let systemPercent = (systemDiff / totalTicks) * 100
let totalPercent = ((userDiff + systemDiff + niceDiff) / totalTicks) * 100
previousCPUInfo = currentInfo
return (min(totalPercent, 100), min(userPercent, 100), min(systemPercent, 100))
}
// MARK: - Memory Monitoring
private func calculateMemoryUsage() -> (percentage: Double, used: UInt64, total: UInt64) {
var stats = vm_statistics64()
var count = mach_msg_type_number_t(MemoryLayout<vm_statistics64>.stride / MemoryLayout<integer_t>.stride)
let result = withUnsafeMutablePointer(to: &stats) {
$0.withMemoryRebound(to: integer_t.self, capacity: Int(count)) {
host_statistics64(mach_host_self(), HOST_VM_INFO64, $0, &count)
}
}
guard result == KERN_SUCCESS else {
return (0, 0, 0)
}
let pageSize = UInt64(vm_kernel_page_size)
let totalMemory = ProcessInfo.processInfo.physicalMemory
// Calculate used memory
let activeMemory = UInt64(stats.active_count) * pageSize
let wiredMemory = UInt64(stats.wire_count) * pageSize
let compressedMemory = UInt64(stats.compressor_page_count) * pageSize
let usedMemory = activeMemory + wiredMemory + compressedMemory
let percentage = (Double(usedMemory) / Double(totalMemory)) * 100
return (min(percentage, 100), usedMemory, totalMemory)
}
// MARK: - Disk Monitoring
private func getDiskBytes() -> (read: UInt64, write: UInt64) {
// Use IOKit for disk statistics
// Simplified implementation - returns approximate values
var readBytes: UInt64 = 0
var writeBytes: UInt64 = 0
// Get disk statistics from system
let task = Process()
task.launchPath = "/usr/bin/iostat"
task.arguments = ["-d", "-c", "1"]
let pipe = Pipe()
task.standardOutput = pipe
do {
try task.run()
task.waitUntilExit()
let data = pipe.fileHandleForReading.readDataToEndOfFile()
if let output = String(data: data, encoding: .utf8) {
// Parse iostat output
let lines = output.components(separatedBy: "\n")
if lines.count > 2 {
let values = lines[2].split(separator: " ").compactMap { Double($0) }
if values.count >= 3 {
// KB/t, tps, MB/s
readBytes = UInt64(values.last ?? 0 * 1024 * 1024)
}
}
}
} catch {
// Fallback to simulated values
}
return (readBytes, writeBytes)
}
private func calculateDiskActivity() -> Double {
let currentBytes = getDiskBytes()
let readDiff = currentBytes.read > previousDiskBytes.read ?
currentBytes.read - previousDiskBytes.read : 0
let writeDiff = currentBytes.write > previousDiskBytes.write ?
currentBytes.write - previousDiskBytes.write : 0
previousDiskBytes = currentBytes
// Normalize to percentage (assuming 100MB/s as max)
let totalBytes = Double(readDiff + writeDiff)
let maxBytesPerInterval = 100.0 * 1024 * 1024 * updateInterval
let percentage = (totalBytes / maxBytesPerInterval) * 100
return min(percentage, 100)
}
// MARK: - Network Monitoring
private func getNetworkBytes() -> (in: UInt64, out: UInt64) {
var ifaddr: UnsafeMutablePointer<ifaddrs>?
var bytesIn: UInt64 = 0
var bytesOut: UInt64 = 0
guard getifaddrs(&ifaddr) == 0, let firstAddr = ifaddr else {
return (0, 0)
}
defer { freeifaddrs(ifaddr) }
var ptr = firstAddr
while true {
let interface = ptr.pointee
// Check for data link layer
if interface.ifa_addr.pointee.sa_family == UInt8(AF_LINK) {
// Get network interface data
if let data = interface.ifa_data {
let networkData = data.assumingMemoryBound(to: if_data.self).pointee
bytesIn += UInt64(networkData.ifi_ibytes)
bytesOut += UInt64(networkData.ifi_obytes)
}
}
guard let next = interface.ifa_next else { break }
ptr = next
}
return (bytesIn, bytesOut)
}
private func calculateNetworkActivity() -> (percentage: Double, bytesIn: UInt64, bytesOut: UInt64) {
let currentBytes = getNetworkBytes()
let bytesInDiff = currentBytes.in > previousNetworkBytes.in ?
currentBytes.in - previousNetworkBytes.in : 0
let bytesOutDiff = currentBytes.out > previousNetworkBytes.out ?
currentBytes.out - previousNetworkBytes.out : 0
previousNetworkBytes = currentBytes
// Calculate rate in bytes per second
let totalBytesPerSecond = Double(bytesInDiff + bytesOutDiff) / updateInterval
// Normalize to percentage (assuming 100 Mbps as reference)
let maxBytesPerSecond = 100.0 * 1024 * 1024 / 8 // 100 Mbps in bytes
let percentage = (totalBytesPerSecond / maxBytesPerSecond) * 100
return (min(percentage, 100), bytesInDiff, bytesOutDiff)
}
}
// MARK: - Memory Formatter Extension
extension SystemMonitor {
/// Format bytes to human readable string
static func formatBytes(_ bytes: UInt64) -> String {
let formatter = ByteCountFormatter()
formatter.countStyle = .memory
return formatter.string(fromByteCount: Int64(bytes))
}
}
+256
View File
@@ -0,0 +1,256 @@
//
// VUMeterView.swift
// AudioVUMeter
//
// Classic VU Meter visualization component
//
import SwiftUI
enum MeterColorScheme {
case audio
case cpu
case ram
case disk
case network
var gradient: [Color] {
switch self {
case .audio:
return [.green, .yellow, .orange, .red]
case .cpu:
return [.blue, .cyan, .yellow, .red]
case .ram:
return [.purple, .pink, .orange, .red]
case .disk:
return [.teal, .green, .yellow, .orange]
case .network:
return [.indigo, .blue, .cyan, .green]
}
}
var accentColor: Color {
switch self {
case .audio: return .green
case .cpu: return .blue
case .ram: return .purple
case .disk: return .teal
case .network: return .indigo
}
}
}
// MARK: - Vertical VU Meter (for Audio)
struct VUMeterView: View {
let level: Double // 0.0 to 1.0
let peakLevel: Double
let label: String
let colorScheme: MeterColorScheme
@State private var animatedLevel: Double = 0
private let segmentCount = 20
private let meterHeight: CGFloat = 200
private let meterWidth: CGFloat = 35
var body: some View {
VStack(spacing: 8) {
// Label
Text(label)
.font(.system(size: 14, weight: .bold, design: .monospaced))
.foregroundColor(.white)
// Meter
ZStack(alignment: .bottom) {
// Background
RoundedRectangle(cornerRadius: 4)
.fill(Color.black.opacity(0.5))
.frame(width: meterWidth, height: meterHeight)
// Segments
VStack(spacing: 2) {
ForEach((0..<segmentCount).reversed(), id: \.self) { index in
let segmentThreshold = Double(index) / Double(segmentCount)
let isLit = animatedLevel > segmentThreshold
RoundedRectangle(cornerRadius: 2)
.fill(segmentColor(for: index, isLit: isLit))
.frame(width: meterWidth - 6, height: (meterHeight - CGFloat(segmentCount + 1) * 2) / CGFloat(segmentCount))
.shadow(color: isLit ? segmentColor(for: index, isLit: true).opacity(0.5) : .clear, radius: 3)
}
}
.padding(3)
// Peak indicator
if peakLevel > 0 {
let peakPosition = meterHeight * CGFloat(1 - peakLevel)
Rectangle()
.fill(Color.red)
.frame(width: meterWidth - 2, height: 3)
.offset(y: -meterHeight + peakPosition + meterHeight)
}
// dB Scale markers
HStack {
VStack(alignment: .trailing, spacing: 0) {
ForEach([0, -6, -12, -20, -40, -60], id: \.self) { db in
Text("\(db)")
.font(.system(size: 8, design: .monospaced))
.foregroundColor(.gray)
if db != -60 {
Spacer()
}
}
}
.frame(height: meterHeight)
.offset(x: -meterWidth/2 - 15)
Spacer()
}
}
.frame(width: meterWidth + 30, height: meterHeight)
}
.onChange(of: level) { newValue in
withAnimation(.easeOut(duration: 0.05)) {
animatedLevel = newValue
}
}
.onAppear {
animatedLevel = level
}
}
private func segmentColor(for index: Int, isLit: Bool) -> Color {
if !isLit {
return Color.gray.opacity(0.2)
}
let position = Double(index) / Double(segmentCount)
let colors = colorScheme.gradient
if position > 0.9 { return colors[3] } // Red zone
if position > 0.75 { return colors[2] } // Orange zone
if position > 0.5 { return colors[1] } // Yellow zone
return colors[0] // Green zone
}
}
// MARK: - Circular System Meter
struct SystemMeterView: View {
let value: Double // 0.0 to 100.0
let label: String
let unit: String
let colorScheme: MeterColorScheme
@State private var animatedValue: Double = 0
private let meterSize: CGFloat = 70
var body: some View {
VStack(spacing: 5) {
ZStack {
// Background circle
Circle()
.stroke(Color.gray.opacity(0.2), lineWidth: 8)
.frame(width: meterSize, height: meterSize)
// Progress arc
Circle()
.trim(from: 0, to: CGFloat(animatedValue / 100))
.stroke(
AngularGradient(
gradient: Gradient(colors: colorScheme.gradient),
center: .center,
startAngle: .degrees(0),
endAngle: .degrees(360)
),
style: StrokeStyle(lineWidth: 8, lineCap: .round)
)
.frame(width: meterSize, height: meterSize)
.rotationEffect(.degrees(-90))
// Value display
VStack(spacing: 0) {
Text(String(format: "%.0f", animatedValue))
.font(.system(size: 18, weight: .bold, design: .monospaced))
.foregroundColor(.white)
Text(unit)
.font(.system(size: 10, design: .monospaced))
.foregroundColor(.gray)
}
}
Text(label)
.font(.system(size: 11, weight: .semibold, design: .monospaced))
.foregroundColor(colorScheme.accentColor)
}
.onChange(of: value) { newValue in
withAnimation(.easeOut(duration: 0.3)) {
animatedValue = newValue
}
}
.onAppear {
animatedValue = value
}
}
}
// MARK: - Horizontal Bar Meter
struct HorizontalMeterView: View {
let value: Double
let label: String
let colorScheme: MeterColorScheme
@State private var animatedValue: Double = 0
var body: some View {
VStack(alignment: .leading, spacing: 4) {
HStack {
Text(label)
.font(.system(size: 11, weight: .semibold, design: .monospaced))
.foregroundColor(.gray)
Spacer()
Text(String(format: "%.1f%%", animatedValue))
.font(.system(size: 11, weight: .bold, design: .monospaced))
.foregroundColor(.white)
}
GeometryReader { geometry in
ZStack(alignment: .leading) {
// Background
RoundedRectangle(cornerRadius: 4)
.fill(Color.gray.opacity(0.2))
// Fill
RoundedRectangle(cornerRadius: 4)
.fill(
LinearGradient(
gradient: Gradient(colors: colorScheme.gradient),
startPoint: .leading,
endPoint: .trailing
)
)
.frame(width: geometry.size.width * CGFloat(animatedValue / 100))
}
}
.frame(height: 12)
}
.onChange(of: value) { newValue in
withAnimation(.easeOut(duration: 0.3)) {
animatedValue = newValue
}
}
.onAppear {
animatedValue = value
}
}
}
#Preview {
HStack(spacing: 30) {
VUMeterView(level: 0.7, peakLevel: 0.9, label: "L", colorScheme: .audio)
VUMeterView(level: 0.5, peakLevel: 0.8, label: "R", colorScheme: .audio)
}
.padding()
.background(Color.black)
}
+568
View File
@@ -0,0 +1,568 @@
//
// VUServer.swift
// AudioVUMeter
//
// TCP Server for external applications to send VU meter data
// Allows other apps to control the physical VU meters remotely
//
import Foundation
import Network
/// Server protocol for incoming data
enum ServerProtocol: String, CaseIterable, Identifiable {
case vuProtocol = "VU Protocol (#channel:value)"
case json = "JSON ({\"dials\":[...]})"
case rawBytes = "Raw Bytes (binary)"
var id: String { rawValue }
}
/// Connected client info
struct ConnectedClient: Identifiable {
let id: UUID
let address: String
let connectedAt: Date
var lastActivity: Date
var bytesReceived: UInt64
var bytesSent: UInt64
init(address: String) {
self.id = UUID()
self.address = address
self.connectedAt = Date()
self.lastActivity = Date()
self.bytesReceived = 0
self.bytesSent = 0
}
}
/// Server options
struct ServerOptions: Codable {
var enabled: Bool = false
var port: UInt16 = 9876
var allowRemote: Bool = false // Only localhost by default
var requireAuth: Bool = false
var authToken: String = ""
var broadcastLevels: Bool = true // Send current levels to clients
var broadcastInterval: Double = 0.1 // 10 Hz
var maxClients: Int = 5
var protocol_: String = ServerProtocol.vuProtocol.rawValue
var serverProtocol: ServerProtocol {
get { ServerProtocol(rawValue: protocol_) ?? .vuProtocol }
set { protocol_ = newValue.rawValue }
}
}
/// VU Meter Server for external app connections
class VUServer: ObservableObject {
// MARK: - Published Properties
@Published var isRunning = false
@Published var options = ServerOptions()
@Published var connectedClients: [ConnectedClient] = []
@Published var lastError: String?
@Published var totalBytesReceived: UInt64 = 0
@Published var totalBytesSent: UInt64 = 0
@Published var lastReceivedCommand: String = ""
// Received dial values from clients (override local values when set)
@Published var receivedDialValues: [Int]? = nil // nil = use local values
@Published var externalControlActive = false
// MARK: - Private Properties
private var listener: NWListener?
private var connections: [UUID: NWConnection] = [:]
private let queue = DispatchQueue(label: "vu.server", qos: .userInteractive)
private var broadcastTimer: Timer?
// Reference to serial manager for broadcasting
weak var serialManager: SerialManager?
// MARK: - Initialization
init() {
loadOptions()
}
deinit {
stop()
}
// MARK: - Server Control
/// Start the server
func start() {
guard !isRunning else { return }
do {
// Configure parameters
let parameters = NWParameters.tcp
parameters.allowLocalEndpointReuse = true
// Create listener
let port = NWEndpoint.Port(rawValue: options.port)!
listener = try NWListener(using: parameters, on: port)
listener?.stateUpdateHandler = { [weak self] state in
DispatchQueue.main.async {
self?.handleListenerState(state)
}
}
listener?.newConnectionHandler = { [weak self] connection in
self?.handleNewConnection(connection)
}
listener?.start(queue: queue)
DispatchQueue.main.async {
self.isRunning = true
self.lastError = nil
}
// Start broadcast timer if enabled
if options.broadcastLevels {
startBroadcastTimer()
}
print("VU Server started on port \(options.port)")
} catch {
DispatchQueue.main.async {
self.lastError = "Failed to start server: \(error.localizedDescription)"
self.isRunning = false
}
}
}
/// Stop the server
func stop() {
stopBroadcastTimer()
// Close all connections
for (_, connection) in connections {
connection.cancel()
}
connections.removeAll()
// Stop listener
listener?.cancel()
listener = nil
DispatchQueue.main.async {
self.isRunning = false
self.connectedClients.removeAll()
self.externalControlActive = false
self.receivedDialValues = nil
}
print("VU Server stopped")
}
/// Toggle server state
func toggle() {
if isRunning {
stop()
} else {
start()
}
}
/// Restart server (after options change)
func restart() {
if isRunning {
stop()
DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
self.start()
}
}
}
// MARK: - Connection Handling
private func handleListenerState(_ state: NWListener.State) {
switch state {
case .ready:
print("Server ready on port \(options.port)")
case .failed(let error):
lastError = "Server failed: \(error.localizedDescription)"
isRunning = false
case .cancelled:
isRunning = false
default:
break
}
}
private func handleNewConnection(_ connection: NWConnection) {
let clientID = UUID()
// Check max clients
if connections.count >= options.maxClients {
connection.cancel()
return
}
// Check if remote connections are allowed
if !options.allowRemote {
if let endpoint = connection.currentPath?.remoteEndpoint,
case let .hostPort(host, _) = endpoint {
let hostStr = "\(host)"
if !hostStr.contains("127.0.0.1") && !hostStr.contains("localhost") && !hostStr.contains("::1") {
connection.cancel()
return
}
}
}
connections[clientID] = connection
// Get client address
var address = "Unknown"
if let endpoint = connection.currentPath?.remoteEndpoint,
case let .hostPort(host, port) = endpoint {
address = "\(host):\(port)"
}
let client = ConnectedClient(address: address)
DispatchQueue.main.async {
self.connectedClients.append(client)
}
connection.stateUpdateHandler = { [weak self] state in
self?.handleConnectionState(clientID: clientID, state: state)
}
connection.start(queue: queue)
// Start receiving data
receiveData(clientID: clientID, connection: connection)
// Send welcome message
let welcome = "VU-Server Ready\n"
sendData(welcome.data(using: .utf8)!, to: clientID)
}
private func handleConnectionState(clientID: UUID, state: NWConnection.State) {
switch state {
case .ready:
print("Client connected: \(clientID)")
case .failed(_), .cancelled:
removeClient(clientID: clientID)
default:
break
}
}
private func removeClient(clientID: UUID) {
connections[clientID]?.cancel()
connections.removeValue(forKey: clientID)
DispatchQueue.main.async {
self.connectedClients.removeAll { $0.id == clientID }
// If no more clients, disable external control
if self.connectedClients.isEmpty {
self.externalControlActive = false
self.receivedDialValues = nil
}
}
}
// MARK: - Data Handling
private func receiveData(clientID: UUID, connection: NWConnection) {
connection.receive(minimumIncompleteLength: 1, maximumLength: 1024) { [weak self] data, _, isComplete, error in
guard let self = self else { return }
if let data = data, !data.isEmpty {
DispatchQueue.main.async {
self.totalBytesReceived += UInt64(data.count)
if let index = self.connectedClients.firstIndex(where: { $0.id == clientID }) {
self.connectedClients[index].bytesReceived += UInt64(data.count)
self.connectedClients[index].lastActivity = Date()
}
}
self.processReceivedData(data, from: clientID)
}
if let error = error {
print("Receive error: \(error)")
self.removeClient(clientID: clientID)
return
}
if isComplete {
self.removeClient(clientID: clientID)
return
}
// Continue receiving
self.receiveData(clientID: clientID, connection: connection)
}
}
private func processReceivedData(_ data: Data, from clientID: UUID) {
// Try to parse based on protocol
switch options.serverProtocol {
case .vuProtocol:
parseVUProtocol(data, from: clientID)
case .json:
parseJSON(data, from: clientID)
case .rawBytes:
parseRawBytes(data, from: clientID)
}
}
/// Parse VU Protocol: #channel:value\n
private func parseVUProtocol(_ data: Data, from clientID: UUID) {
guard let string = String(data: data, encoding: .utf8) else { return }
DispatchQueue.main.async {
self.lastReceivedCommand = string.trimmingCharacters(in: .whitespacesAndNewlines)
}
// Parse commands line by line
let lines = string.components(separatedBy: .newlines)
var values = receivedDialValues ?? [0, 0, 0, 0]
var hasUpdate = false
for line in lines {
let trimmed = line.trimmingCharacters(in: .whitespaces)
// Handle special commands
if trimmed == "?" || trimmed == "STATUS" {
sendStatus(to: clientID)
continue
}
if trimmed == "RELEASE" {
// Release external control
DispatchQueue.main.async {
self.externalControlActive = false
self.receivedDialValues = nil
}
sendData("OK:RELEASED\n".data(using: .utf8)!, to: clientID)
continue
}
// Parse #channel:value format
if trimmed.hasPrefix("#") {
let parts = trimmed.dropFirst().components(separatedBy: ":")
if parts.count == 2,
let channel = Int(parts[0]),
let value = Int(parts[1]),
channel >= 0 && channel < 4 {
// Value is percentage 0-100, convert to 0-255
let byteValue = (value * 255) / 100
values[channel] = max(0, min(255, byteValue))
hasUpdate = true
}
}
// Also support CH1:value format
if trimmed.hasPrefix("CH") {
let parts = trimmed.dropFirst(2).components(separatedBy: ":")
if parts.count == 2,
let channel = Int(parts[0]),
let value = Int(parts[1]),
channel >= 1 && channel <= 4 {
values[channel - 1] = max(0, min(255, value))
hasUpdate = true
}
}
}
if hasUpdate {
DispatchQueue.main.async {
self.receivedDialValues = values
self.externalControlActive = true
}
}
}
/// Parse JSON: {"dials":[v1,v2,v3,v4]} or {"d0":v,"d1":v,...}
private func parseJSON(_ data: Data, from clientID: UUID) {
guard let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any] else { return }
DispatchQueue.main.async {
if let str = String(data: data, encoding: .utf8) {
self.lastReceivedCommand = str.trimmingCharacters(in: .whitespacesAndNewlines)
}
}
var values = receivedDialValues ?? [0, 0, 0, 0]
var hasUpdate = false
// Array format
if let dials = json["dials"] as? [Int] {
for (i, v) in dials.prefix(4).enumerated() {
values[i] = max(0, min(255, v))
}
hasUpdate = true
}
// Individual dial format
for i in 0..<4 {
if let v = json["d\(i)"] as? Int {
values[i] = max(0, min(255, v))
hasUpdate = true
}
}
// Command handling
if let cmd = json["cmd"] as? String {
switch cmd {
case "status":
sendStatus(to: clientID)
case "release":
DispatchQueue.main.async {
self.externalControlActive = false
self.receivedDialValues = nil
}
default:
break
}
}
if hasUpdate {
DispatchQueue.main.async {
self.receivedDialValues = values
self.externalControlActive = true
}
}
}
/// Parse raw bytes: [0xAA, d1, d2, d3, d4, 0x55]
private func parseRawBytes(_ data: Data, from clientID: UUID) {
DispatchQueue.main.async {
self.lastReceivedCommand = data.map { String(format: "%02X", $0) }.joined(separator: " ")
}
// Look for frame: 0xAA ... 0x55
var values = receivedDialValues ?? [0, 0, 0, 0]
let bytes = Array(data)
var i = 0
while i < bytes.count {
if bytes[i] == 0xAA && i + 5 < bytes.count && bytes[i + 5] == 0x55 {
// Found valid frame
for j in 0..<4 {
values[j] = Int(bytes[i + 1 + j])
}
DispatchQueue.main.async {
self.receivedDialValues = values
self.externalControlActive = true
}
i += 6
} else {
i += 1
}
}
}
// MARK: - Send Data
private func sendData(_ data: Data, to clientID: UUID) {
guard let connection = connections[clientID] else { return }
connection.send(content: data, completion: .contentProcessed { [weak self] error in
if error == nil {
DispatchQueue.main.async {
self?.totalBytesSent += UInt64(data.count)
if let index = self?.connectedClients.firstIndex(where: { $0.id == clientID }) {
self?.connectedClients[index].bytesSent += UInt64(data.count)
}
}
}
})
}
private func sendStatus(to clientID: UUID) {
guard let sm = serialManager else { return }
let status: [String: Any] = [
"connected": sm.isConnected,
"dials": sm.dialValues,
"port": sm.selectedPortPath,
"external": externalControlActive
]
if let data = try? JSONSerialization.data(withJSONObject: status, options: []),
let string = String(data: data, encoding: .utf8) {
sendData((string + "\n").data(using: .utf8)!, to: clientID)
}
}
/// Broadcast current levels to all clients
func broadcastLevels() {
guard !connections.isEmpty, let sm = serialManager else { return }
let message: String
switch options.serverProtocol {
case .vuProtocol:
message = sm.dialValues.enumerated()
.map { "#\($0.offset):\(($0.element * 100) / 255)" }
.joined(separator: "\n") + "\n"
case .json:
message = "{\"dials\":[\(sm.dialValues.map(String.init).joined(separator: ","))]}\n"
case .rawBytes:
// Don't broadcast for raw bytes
return
}
guard let data = message.data(using: .utf8) else { return }
for clientID in connections.keys {
sendData(data, to: clientID)
}
}
// MARK: - Broadcast Timer
private func startBroadcastTimer() {
stopBroadcastTimer()
DispatchQueue.main.async {
self.broadcastTimer = Timer.scheduledTimer(withTimeInterval: self.options.broadcastInterval, repeats: true) { [weak self] _ in
self?.broadcastLevels()
}
}
}
private func stopBroadcastTimer() {
broadcastTimer?.invalidate()
broadcastTimer = nil
}
// MARK: - Persistence
private func loadOptions() {
if let data = UserDefaults.standard.data(forKey: "VUServerOptions"),
let loaded = try? JSONDecoder().decode(ServerOptions.self, from: data) {
options = loaded
}
}
func saveOptions() {
if let data = try? JSONEncoder().encode(options) {
UserDefaults.standard.set(data, forKey: "VUServerOptions")
}
}
// MARK: - Disconnect Client
func disconnectClient(_ client: ConnectedClient) {
removeClient(clientID: client.id)
}
}
+230
View File
@@ -0,0 +1,230 @@
# Audio VU Meter for macOS
A native macOS SwiftUI application that displays real-time audio levels from BlackHole (or any audio input device) as a classic VU meter, along with system resource monitoring. **Now with physical VU meter hardware support!**
![macOS](https://img.shields.io/badge/macOS-13.0+-blue.svg)
![Swift](https://img.shields.io/badge/Swift-5.0-orange.svg)
![License](https://img.shields.io/badge/License-MIT-green.svg)
## Features
### Audio VU Meter
- **Real-time audio level monitoring** - Displays Left and Right channel levels
- **dB scale display** - Shows audio levels in decibels (-60 dB to 0 dB)
- **Peak hold indicators** - Visual peak markers with configurable hold time
- **BlackHole integration** - Automatically detects and selects BlackHole virtual audio device
- **Multi-device support** - Switch between any available audio input device
### System Resource Monitors
- **CPU Usage** - Real-time CPU utilization percentage
- **RAM Usage** - Memory consumption monitoring
- **Disk Activity** - Disk I/O activity indicator
- **Network Activity** - Network throughput monitoring
### Physical VU Meter Hardware Support
- **4 Physical Dials** - Support for up to 4 physical VU meter dials
- **Flexible Channel Mapping** - Assign any metric to any dial:
- Audio Left/Right channels
- Audio Peak or Mono (L+R)
- CPU, RAM, Disk, Network usage
- **Multiple Serial Protocols**:
- Raw Bytes: `[0xAA] [D1] [D2] [D3] [D4] [0x55]`
- Text Commands: `CH1:val;CH2:val;CH3:val;CH4:val\n`
- JSON: `{"dials":[d1,d2,d3,d4]}`
- VU-Server Compatible: `#0:val\n#1:val\n...`
- **Configurable per dial**: Min/max values, inversion, smoothing
- **Auto-detection** of USB serial devices
## Requirements
- macOS 13.0 (Ventura) or later
- Xcode 15.0 or later (for building)
- [BlackHole](https://existential.audio/blackhole/) virtual audio driver (recommended)
- USB/Serial VU meter hardware (optional)
## Installation
### Using BlackHole
1. Install BlackHole from [existential.audio/blackhole](https://existential.audio/blackhole/)
2. Configure BlackHole as a multi-output device in Audio MIDI Setup
3. Build and run Audio VU Meter
4. The app will automatically detect and select BlackHole
### Building from Source
1. Clone the repository
2. Open `AudioVUMeter.xcodeproj` in Xcode
3. Build and run (Cmd+R)
```bash
git clone <repository-url>
cd AudioVUMeter
open AudioVUMeter.xcodeproj
```
## Usage
### Main Window
- **Audio Levels**: The vertical VU meters show Left (L) and Right (R) channel audio levels
- **dB Readings**: Numeric display of current audio levels in decibels
- **System Meters**: Circular gauges showing CPU, RAM, Disk, and Network usage
- **Hardware Output**: Shows status of connected physical VU meters
### Controls
- **Start/Stop**: Toggle audio capture on/off
- **Reset**: Clear peak hold indicators
- **Settings** (gear icon): Access device selection and preferences
- **Hardware** (cable icon): Configure physical VU meter connection
### Hardware Setup
1. Connect your USB/Serial VU meter hardware
2. Click the cable icon or go to Settings -> Hardware
3. Select your serial port from the dropdown
4. Choose the appropriate baud rate (default: 115200)
5. Select the communication protocol your hardware uses
6. Assign channels to each dial (Audio L, R, CPU, RAM, etc.)
7. Click "Connect"
### Settings
- **Input Device**: Select audio input source (BlackHole, microphone, etc.)
- **Reference Level**: Adjust the 0 dB reference point
- **Peak Hold Time**: Configure how long peak indicators remain visible
- **Hardware**: Serial port, protocol, and dial assignments
## Architecture
```
AudioVUMeter/
├── AudioVUMeterApp.swift # App entry point
├── ContentView.swift # Main UI layout
├── VUMeterView.swift # VU meter components
├── AudioEngine.swift # Core Audio capture engine
├── SystemMonitor.swift # System resource monitoring
├── SerialManager.swift # USB/Serial communication
├── HardwareView.swift # Hardware configuration UI
├── SettingsView.swift # Settings window
└── Assets.xcassets/ # App icons and colors
```
### Key Components
- **AudioEngine**: Uses AVAudioEngine to capture audio from the selected input device, calculates RMS levels, and converts to dB
- **SystemMonitor**: Uses Mach kernel APIs to retrieve CPU, memory, disk, and network statistics
- **SerialManager**: Handles USB/Serial communication with physical VU meter hardware
- **VUMeterView**: SwiftUI views for classic vertical VU meters with segment-based display
- **SystemMeterView**: Circular gauge components for system metrics
## Hardware Protocol Reference
### Raw Bytes Protocol
```
Start: 0xAA
Data: [Dial1] [Dial2] [Dial3] [Dial4] (0-255 each)
End: 0x55
```
### Text Command Protocol
```
CH1:128;CH2:64;CH3:200;CH4:32\n
```
### JSON Protocol
```json
{"dials":[128,64,200,32]}
```
### VU-Server Compatible Protocol
```
#0:50
#1:75
#2:30
#3:90
```
Values are percentages (0-100)
## BlackHole Setup Guide
1. **Install BlackHole**: Download and install from [existential.audio](https://existential.audio/blackhole/)
2. **Create Multi-Output Device**:
- Open Audio MIDI Setup (Applications -> Utilities)
- Click the `+` button -> Create Multi-Output Device
- Check both your speakers and BlackHole
- Set as default output
3. **Route Audio**:
- System audio will now go to both speakers and BlackHole
- Audio VU Meter captures from BlackHole input
## Compatible Hardware
This app is designed to work with:
- [VU Dials by Sasa Karanovic](https://github.com/SasaKaranovic/VU-Server)
- Arduino-based VU meters with serial interface
- Any USB/Serial device accepting the supported protocols
## API Reference
### AudioEngine
```swift
// Start/stop audio capture
audioEngine.start()
audioEngine.stop()
// Reset peak indicators
audioEngine.resetPeaks()
// Switch audio device
audioEngine.selectedDeviceID = deviceID
audioEngine.switchDevice()
// Access levels
audioEngine.leftLevel // 0.0 to 1.0
audioEngine.rightLevel // 0.0 to 1.0
audioEngine.leftLevelDB // -60 to 0 dB
audioEngine.rightLevelDB // -60 to 0 dB
```
### SystemMonitor
```swift
// Start/stop monitoring
systemMonitor.startMonitoring()
systemMonitor.stopMonitoring()
// Access metrics (0-100%)
systemMonitor.cpuUsage
systemMonitor.memoryUsage
systemMonitor.diskActivity
systemMonitor.networkActivity
```
### SerialManager
```swift
// Connection
serialManager.connect()
serialManager.disconnect()
// Configuration
serialManager.selectedPortPath = "/dev/cu.usbserial-XXX"
serialManager.baudRate = 115200
serialManager.selectedProtocol = .vuServer
// Dial assignment
serialManager.dialConfigs[0].dialChannel = .audioLeft
serialManager.dialConfigs[1].dialChannel = .audioRight
serialManager.dialConfigs[2].dialChannel = .cpu
serialManager.dialConfigs[3].dialChannel = .ram
```
## License
MIT License - See LICENSE file for details.
## Credits
Inspired by [VU-Server](https://github.com/SasaKaranovic/VU-Server) by Sasa Karanovic.