$ show losnoco/Cog
Cog is a native macOS audio player with an exceptionally broad format support, uniquely specializing in video-game music emulation and obscure audio codec playback. Its architecture is built on a clean, modular plugin system (CogDecoder, CogSource, CogContainer protocols) that integrates dozens of vendored emulator cores (vgmstream, GME, OpenMPT, lazyusf) and general decoders (FFmpeg, TagLib). The app features a composable DSP chain for real-time effects (equalizer, HRTF binaural, tempo/pitch shifting), high-performance threading primitives (CogSemaphore), and a modern Model Context Protocol (MCP) server for remote control by AI agents. This is a classic case of a well-crafted application core coupled with a massive, critical dependency on vendored third-party code; the plugin protocols, DSP nodes, synchronization primitives, and MCP bridge are high-quality, reusable components, while the collection of emulator cores introduces significant licensing and maintenance complexity.
The LLM identified 6 files worth highlighting for reuse:
Defines the core plugin protocol (CogDecoder, CogSource, CogContainer, CogMetadataReader) allowing the application to support any audio format via dynamically loaded bundles. This is a textbook example of the Strategy pattern in Objective-C, designed to enable robust extensibility without modifying core playback code. The interface is isolated enough to serve as a foundation for a new media player or a generic file-format handler.
Provides the abstract base class for all DSP effects and implements the chain-of-responsibility pattern. Well-crafted subclasses like DSPEqualizerNode, DSPHRTFNode, and DSPSignalsmithStretchNode can be composed in any order dynamically. This design allows the entire audio processing graph to be configured on-the-fly and is directly reusable in any audio toolkit.
A custom semaphore implementation optimized for low-latency audio real-time threads, using Mach semaphores and spin-waiting fallbacks when appropriate. It avoids expensive system calls in the common case, demonstrating deep familiarity with macOS kernel primitives and audio thread safety. This isolated utility can be extracted for any high-performance audio application on Apple platforms.
Implements head-related transfer function (HRTF) based binaural rendering from loaded HRTF datasets to create spatial audio over headphones. The implementation is a standalone DSP node that processes multichannel audio and applies real-time convolution filters, demonstrating non-obvious signal processing and spatial audio craftsmanship.
A reusable C++ header that provides saturating arithmetic casts for audio sample conversion (e.g., converting a float to int16 with clipping). This fundamental building block prevents overflow distortion and is isolated from the rest of the OpenMPT library, making it directly usable in any C++ audio or DSP project.
Bridges the Cog application to a Model Context Protocol (MCP) server over a Unix domain socket, enabling external tools (LLMs, scripts) to query playback state, search the library, and control the queue. This is a clean, modern implementation of the emerging MCP standard for desktop applications, showing a reusable pattern for adding remote control to any native macOS app.