ISOLATE

Raw, zero-latency 4-stem audio isolation for macOS.
Powered by Demucs v4 Neural Engine CoreML & Nothing OS hardware aesthetics.

---

[ 01. HIGHLIGHTS ]

• 4-Stem Neural Isolation: Surgically separate any track into Vocals, Drums, Bass, and Other with Hybrid Demucs v4 on Apple Silicon Neural Engine (ANE / Metal CoreML).
• Tactical Hardware Mixer: Dynamic tactile faders, 1.2s peak-hold clip LEDs, dual decibel (0.0 dB) / linear percentage readouts, single-click [M] Mute, and exclusive [S] Solo routing.
• Rotary Stereo Pan Dials: Channel pan knobs (‹ C ›, ‹ 42L, 28R ›) featuring magnetic haptic center snap.
• Top Header Space & Telemetry HUD: 32-band real-time FFT spectrum visualizer, ANE neural status, chip telemetry (M1–M5 / A18 Pro), tempo / key indicators, and one-click stem macro toggles ([ ACAPELLA ], [ INSTRUMENTAL ], [ DRUMLESS ], [ KARAOKE ], [ D&B ], [ RESET ]).
• Live A-B Region Looper: Real-time loop boundary setting on the fly with dedicated hotkeys ([ and ]).
• macOS Menu Bar Mini Controller: Status bar controller with an animated 3-bar equalizer and native completion notifications.
• Resilient Multi-Token Library Search: Instant filtering across track names, artists, and filenames.
• Modern macOS 26 & 27 Design: Squircle app icon and zero-latency Nothing hardware aesthetic.

---

[ 02. INSTALLATION & PACKAGES ]

Option A: Instant 1-Line Terminal Install (Recommended)

Installs Isolate.app directly into /Applications and automatically removes the macOS quarantine attribute:

curl -fsSL https://raw.githubusercontent.com/TheConfidentCoder/Isolate/main/install.sh | bash

---

Option B: Homebrew Cask

brew install --cask TheConfidentCoder/isolate/isolate

Or tap the repository directly:

brew tap TheConfidentCoder/isolate https://github.com/TheConfidentCoder/Isolate
brew install --cask isolate

---

Option C: Pre-Built DMG Installer

1. Download Isolate.dmg from GitHub Releases.
2. Open the disk image and drag Isolate.app into Applications.
3. Launch Isolate.app.

Note

If macOS displays "Apple could not verify Isolate.app is free of malware":

• Option 1 (Instant Fix): Run xattr -cr /Applications/Isolate.app in Terminal.
• Option 2 (System Settings): Open System Settings → Privacy & Security → click Open Anyway.

---

Option D: Build from Source

Prerequisites

• macOS 14.0 (Sonoma) or newer
• Xcode 15.4 or Xcode 16+
• XcodeGen (brew install xcodegen)

# 1. Clone the repository
git clone https://github.com/TheConfidentCoder/Isolate.git
cd Isolate

# 2. Generate Xcode project
xcodegen generate

# 3. Build & Run
xcodebuild -scheme Isolate -configuration Release -destination 'platform=macOS' build
open build/Release/Isolate.app

---

[ 03. KEYBOARD SHORTCUTS ]

Action	Shortcut	Description
Play / Pause	Space	Toggle global audio playback
Solo Stem (1 - 4)	1 / 2 / 3 / 4	Exclusive solo for Vocals, Drums, Bass, Other
Mute Stem (V / D / B / O)	V / D / B / O	Toggle mute for individual stem channels
Set Loop In / Out	[ / ]	Mark A-B loop start and end points on the fly
Toggle Loop	L	Toggle active A-B region loop on/off
Acapella / Instrumental / Reset	A / I / R	Trigger stem macros immediately
Bypass Toggle	B	Toggle between raw original master and stem mix
Shortcut Cheat Sheet HUD	? or /	Toggle in-app floating Nothing OS shortcuts card
Export Stems	E	Export 4-stem multi-format audio bundle
Import Audio	⌘O	Open file picker for single or batch stem separation
Fader Reset to 100%	Double-Click	Double-click fader thumb or volume number to reset to unity
Dismiss / Close	Esc	Cancel / dismiss active modal card

---

[ 04. ARCHITECTURE ]

Isolate/
├── Sources/
│   ├── App/
│   │   ├── IsolateApp.swift        # App entry point, scene hierarchy, and modal cards
│   │   ├── AudioEngineManager.swift # Low-latency 4-track AVAudioEngine DSP graph
│   │   ├── DemucsEngine.swift      # CoreML Demucs v4 Neural Engine inference pipeline
│   │   ├── AppMoveHelper.swift     # Automatic /Applications installation & DMG eject
│   │   └── Haptics.swift           # Mechanical tactile feedback synthesis
│   ├── Player/
│   │   ├── PlayerView.swift        # Mixer channel strips, transport bar, FFT visualizer
│   │   ├── CustomFader.swift       # Hardware faders with drag gestures & haptic detents
│   │   └── SpectrumVisualizer.swift# Live Accelerate vDSP FFT dot-matrix visualizer
│   ├── Library/
│   │   ├── LibraryView.swift       # Track list, 3-dots action menu, rename, delete
│   │   └── TrackModel.swift        # SwiftData persistent schema
│   └── Resources/
│       ├── DotGothic16-Regular.ttf # Nothing OS dot-matrix typography
│       └── HTDemucs.mlmodelc/      # Quantized Demucs CoreML Neural Engine model
├── Casks/
│   └── isolate.rb                  # Official Homebrew Cask formula
├── scripts/
│   ├── package_release.sh          # Automated Release DMG & ZIP builder
│   └── generate_assets.swift       # Nothing OLED DMG wallpaper & icon generator
├── Tests/                          # XCTest unit test suite
└── .github/workflows/              # Automated CI/CD release workflow

[ Audio DSP & Neural Pipeline ]

flowchart TD
    A["Audio File (MP3 / WAV / FLAC / M4A)"] --> B["Demucs Neural Engine (ANE / Metal CoreML)"]
    B --> C["Vocals Stem (AVAudioPlayerNode)"]
    B --> D["Drums Stem (AVAudioPlayerNode)"]
    B --> E["Bass Stem (AVAudioPlayerNode)"]
    B --> F["Other Stem (AVAudioPlayerNode)"]
    
    C --> G["4-Channel Mixer & Rotary Pan Stage"]
    D --> G
    E --> G
    F --> G
    
    G --> H["Master Summing Bus & Limiter (-0.3 dBFS)"]
    H --> I["Real-Time 32-Band FFT Analyzer (vDSP)"]
    I --> J["Dynamic Island Visualizer (60 FPS Metal)"]
    H --> K["AVAudioEngine Output (Speaker / Headphones)"]
    
    G --> L["Multi-Format Exporter (WAV / MP3 / FLAC ZIP)"]

Loading

---

[ 05. CREDITS & LICENSE ]

• Demucs: Hybrid Transformer Demucs by Alexandre Défossez (Meta AI Research).
• Typography: DotGothic16 font by Fontworks Inc.
• License: Released under the MIT License.