GainMesh v1.3.17

GainMesh 1.3.17

안정성

• macOS 오디오 시스템(coreaudiod)이 재시작되면 스피커가 완전히 무음이 되고 앱을 다시 실행해야 했던 문제를 고쳤습니다. 이제 재시작·오디오 엔진 소실·콜백 정지를 감지해 자동으로 다시 연결합니다(유한 재시도, 사용자가 정지한 경우는 복구하지 않음).
• 재시작·충돌 후 앱을 종료하거나 정지하면 시스템 출력이 가상 GainMesh 장치에 남아 무음이 지속되던 문제를 고쳤습니다. 이제 항상 실제 스피커로 되돌립니다.
• 이미 사라진 오디오 객체 때문에 엔진이 다시 시작되지 못하던 문제를 고쳤습니다.
• 새 macOS 빌드 도구 환경에서 번역을 찾지 못해 영어로 표시될 수 있던 문제를 고쳤습니다.

성능 (CPU 절감)

• EQ를 스피커 채널마다 반복 계산하지 않고 원본에서 한 번만 계산합니다. 스피커 4대 기준 오디오 처리 비용이 약 3분의 1로 줄었습니다. 사용하지 않는 EQ 밴드는 계산을 건너뜁니다(출력은 비트 단위로 동일).
• 곡 정보 조회를 2–5초마다 프로세스를 새로 띄우던 방식에서, 상주 도우미가 변경 시에만 알려주는 방식으로 바꿨습니다.
• 무음일 때 노치 비주얼라이저 화면 갱신을 멈추고 스펙트럼 분석 빈도를 낮춥니다.
• 노치 비주얼(특히 워터폴·매트릭스 계열) 그리기 비용을 절반 이하로 줄였습니다.

UI/UX

• 메뉴 막대 아이콘이 재생 중·정지·복구 중·오류 상태를 구분해 보여줍니다.
• 자동 복구 중에는 패널에 "오디오 다시 연결 중" 상태와 "지금 다시 연결" 버튼을 표시합니다(12개 언어).
• 노치 배경을 모든 상태에서 완전한 검은색으로 통일해 비주얼이 배경화면에 묻히지 않습니다.
• 펼친 노치 카드의 앨범 아트를 누르면 재생 중인 앱(없으면 Apple Music)이 열립니다.

업데이트

• 새 버전이 나오면 한 번 알림을 띄우고, "다운로드"를 누르면 공증된 설치 패키지를 받아 서명(팀 8YKYNYSV6L)을 확인한 뒤 macOS 설치 프로그램을 바로 엽니다. 검증에 실패하면 다운로드 페이지를 엽니다.

설치

1. GainMesh-1.3.17.dmg를 다운로드해 엽니다(또는 GainMesh-1.3.17.pkg를 바로 실행).
2. Install GainMesh.pkg를 실행합니다.
3. 설치 프로그램이 재시작을 요청하면 Mac을 재시작합니다.

1.3.16 사용자는 앱이 하루 한 번 새 버전을 확인해 메뉴에 알려 줍니다. 1.3.17부터는 알림에서 바로 공증된 설치 패키지를 받아 서명을 검증한 뒤 설치 프로그램을 엽니다.

Apple Developer ID 서명, Apple 공증, 스테이플 검증을 완료했습니다.

SHA-256

• DMG: 82cc1606581f23be278502af0da84d01f09557e865a75e19a5193bc1563f9bfa
• PKG: 8680438156f49f4abd3542ae09323aff52268e66c527e872665f731ba1e05eba

---

English

Stability

• Fixed total silence after macOS restarted its audio service (coreaudiod); GainMesh now detects the restart, a lost engine or a stalled callback and reconnects automatically with bounded retries (a user-stopped session stays stopped).
• Quitting or stopping after a restart/crash no longer leaves system output on the virtual GainMesh device.
• Engine restarts are no longer blocked by audio objects that Core Audio already destroyed.
• Fixed translations falling back to English with newer SwiftPM toolchains.

Performance

• The equalizer runs once on the source instead of once per speaker channel (~3× cheaper with four speakers); identity EQ bands are skipped with bit-identical output.
• Now-playing metadata comes from one resident helper that reports only changes, instead of launching a script every 2–5 s.
• The notch visualizer parks its display link and slows spectrum sampling during silence; drawing cost is less than half.

UI/UX

• State-aware menu-bar icon (playing, stopped, reconnecting, attention).
• "Reconnecting audio" panel state with a "Reconnect now" action (12 languages).
• Solid black notch background in every state.
• Clicking the album art in the expanded notch opens the playing app (or Apple Music).

Updates

• New versions are announced once; "Download" fetches the notarized installer package, verifies its Developer ID Installer signature for team 8YKYNYSV6L and opens macOS Installer, falling back to the download page.

Open the DMG and run Install GainMesh.pkg (or run the PKG directly); restart if the installer asks.

GainMesh v1.3.16

GainMesh 1.3.16

맥의 모든 소리를, 원하는 스피커로 완벽하게 엮다.

주요 개선

• 화면 녹화에 Mac 시스템 소리를 함께 저장합니다. BlackHole이 필요 없습니다.
• 메뉴 막대와 MacBook 노치에 33가지 오디오 비주얼라이저 스타일을 추가했습니다.
• 곡 변경 시 앨범 이미지·곡명·비주얼을 더 빠르게 갱신합니다.
• 접힌 노치 비주얼의 밀도, 핀 고정, 그림자, 설정·핀 아이콘을 다듬었습니다.
• 노치 없는 Mac에서는 가짜 노치 없이 실제 메뉴 막대에 비주얼을 표시합니다.
• 입력·출력 이름을 GainMesh로 통일하고 Data Source Item 항목을 제거했습니다.

설치

1. GainMesh-1.3.16.dmg를 다운로드해 엽니다.
2. 안의 Install GainMesh.pkg를 실행합니다.
3. 설치 후 Mac을 재시작합니다.

Apple Developer ID 서명, Apple 공증, 스테이플 검증을 완료했습니다.

SHA-256: 1c575d642a25c840999c823492d3e671bf0059247deaa8785c09c920833f9e64

---

English

• System audio is now included in macOS screen recordings without BlackHole.
• Added 33 audio visualizer styles for the menu bar and MacBook notch.
• Improved track-change updates, compact notch rendering, pinning, shadows, and controls.
• Notchless Macs now use a true menu-bar visualizer instead of a synthetic notch.
• Unified the input/output device name as GainMesh and removed placeholder data-source items.

Open the DMG, run Install GainMesh.pkg, then restart your Mac.

GainMesh v1.2.4

Install

Download GainMesh-1.2.4.dmg, run Install GainMesh.pkg, and approve the administrator prompt. No restart — GainMesh reopens itself when the installer finishes.

Full guide: English · 한국어

Fixes in v1.2.4 — recommended for everyone on v1.2.3

• The notch visualizer no longer slows down, freezes or shrinks. Two faults were behind it. Every time the notch overlay was rebuilt — a display change, waking the Mac, or switching the setting off and on — a new spectrum analyzer was created while the old one kept running, so the work piled up until the animation stalled. And when frames were dropped, the animation replayed in slow motion instead of simply skipping. Both are fixed: one analyzer is kept for as long as the overlay exists, and the animation now keeps real time.
• Lighter on battery. The visualizer runs on a steady 30 Hz schedule instead of the display link, which macOS throttles unpredictably for a menu-bar panel, and it slows to a trickle while playback is paused. Idle CPU measured 14% before and 8.5% after.

Since v1.2.2

Installing, updating and uninstalling need no restart; the player card is narrower with the song title on its own line, a proper drop shadow, and a denser spectrum beside the notch.

Requires macOS 14.2 or later on Apple silicon. Signed with Apple Developer ID (team 8YKYNYSV6L) and notarized by Apple.

GainMesh v1.2.3

Install

Download GainMesh-1.2.3.dmg, run Install GainMesh.pkg, and approve the administrator prompt. No restart — GainMesh reopens itself when the installer finishes.

Full guide: English · 한국어

What's new in v1.2.3

• The player card fits the screen it's on. It is noticeably narrower — more so on a MacBook, where the notch already takes room — and the song title now gets a line of its own instead of being cut off by the playback buttons, which moved down beside the artist.
• A real drop shadow. The expanded card was drawn flat against the desktop; it now casts a soft shadow and reads as a card floating below the notch.
• A livelier spectrum beside the notch. The compact visualizer in the notch wing drew six wide bands that all moved together; it now packs twelve narrow ones that clearly react to the music.

Since v1.2.2

No restart is required to install, update or uninstall, and the notch player no longer clips into a MacBook's display cutout.

Requires macOS 14.2 or later on Apple silicon. Signed with Apple Developer ID (team 8YKYNYSV6L) and notarized by Apple.

GainMesh v1.2.2

Install

Download GainMesh-1.2.2.dmg, run Install GainMesh.pkg, and approve the administrator prompt. That is all — no restart, and GainMesh reopens itself when the installer finishes.

Full guide: English · 한국어

Fixes in v1.2.2

• No restart, ever. Installing, updating and uninstalling all finish without rebooting your Mac. Core Audio only needs its daemon reloaded to pick up the GainMesh driver, so the installer does exactly that and reopens the app afterwards.
• The notch player no longer clips on MacBooks. The expanded card drew its spectrum into the display cutout, which sliced it in half. Everything now starts below the cutout.

From v1.2.1 and v1.2.0

The notch companion with six visualizer styles and six color palettes, real album artwork, the player with a draggable timeline, the equalizer status card, visible update alerts, and the tidied settings are all included.

Requires macOS 14.2 or later on Apple silicon. Signed with Apple Developer ID (team 8YKYNYSV6L) and notarized by Apple.

GainMesh v1.2.1

Install

Download GainMesh-1.2.1.dmg, run Install GainMesh.pkg, and approve the administrator prompt. A restart is now only required when the audio driver itself changes — app-only updates finish without one.

Full guide: English · 한국어

New in v1.2.1

• No more forced restarts. The installer now ships the app and the audio driver as separate components and checks which driver your Mac already runs. If it matches, the driver is skipped and the update installs without a restart. Updating from an older build still restarts once, because that is when the new driver lands.
• The notch fits your Mac. On a MacBook with a notch, the display cutout has no pixels, so GainMesh now hugs the housing exactly: while music plays, album art slides out on the left and a compact spectrum on the right. On external displays without a notch, the spectrum fills the whole band beside the artwork. Nothing playing, nothing showing.
• Real album artwork. macOS 26 stopped handing artwork to third-party apps, so GainMesh asks the Music app directly. The first time, macOS asks for your permission.
• Play works from a stopped player. Pressing play with nothing loaded now starts your music instead of doing nothing.
• Settings tidied up. Every row uses the same layout — label on the left, control on the right — and the scrollbar no longer overlaps switches and menus.
• Versioned downloads. Release files now carry their version: GainMesh-1.2.1.dmg.

Since v1.2.0

The notch companion, its six visualizer styles and six color palettes, the equalizer status card, visible update alerts, the pinned equalizer header, and the slim scrollbars all arrived in v1.2.0 and are included here.

Requires macOS 14.2 or later on Apple silicon. Signed with Apple Developer ID (team 8YKYNYSV6L) and notarized by Apple.

GainMesh v1.2.0

Install

Download GainMesh.dmg, run Install GainMesh.pkg, approve the administrator prompt, and restart your Mac. GainMesh starts on its own after the restart, in the menu bar.

Full guide: English · 한국어

New in v1.2.0 — the notch comes alive

• Notch music visualizer. A live spectrum dances around the notch (a drawn notch appears on Macs without one), reacting to whatever is playing through GainMesh. Six styles — Bars, LED matrix, Mirrored peaks, Dots, Wave, Rainbow — and six color palettes — Aurora, Ocean, Sunset, Neon, Candy, Rainbow — selectable in Settings. On by default; turn it off in Settings.
• Notch player. Hover the notch and it expands into a Liquid Glass player: artwork, track info, previous/play/next, and a draggable timeline with elapsed and remaining time. The whole surface grows out of the notch in one animation.
• EQ at a glance. The main screen shows the active equalizer state (preset name, Custom, or Bypassed) under the master volume — click it to open the editor.
• Update alerts you can see. Checking for updates now shows a proper dialog with a Download button, and the automatic check announces new versions the same way.
• Polish. The EQ editor keeps its header pinned with a clear pending-changes bar, the window is larger (560×520), scrollbars are slim and trackless, and holding a slider's arrow key adjusts continuously.

Requires macOS 14.2 or later on Apple silicon. Signed with Apple Developer ID (team 8YKYNYSV6L) and notarized by Apple.

GainMesh v1.1.10

Install

Download GainMesh.dmg, run Install GainMesh.pkg, approve the administrator prompt, and restart your Mac. GainMesh starts on its own after the restart, in the menu bar.

Full guide: English · 한국어

Fixes since v1.1.7 — please update

• Fixed: the app quit itself a few seconds after every launch. The silence watch added in v1.1.6 ran its audio callback with the wrong isolation, and Swift's runtime trapped the process the moment Core Audio called it. The app appeared briefly and vanished, and starting at login looked like it never ran. Every build from v1.1.6 to v1.1.9 is affected.
• Uninstall now works. It moved into the app: open the menu-bar icon, choose the … menu, then Uninstall GainMesh. The disk image's uninstaller was blocked by macOS with a "Move to Trash" dialog — a downloaded script cannot be opened by double-click, and a shell script cannot be notarized to avoid that. Inside the notarized app there is no such gate.
• Holding a slider arrow key now adjusts continuously and silently. It moved a single step per press before, and an interim build beeped once per key repeat.

Also since v1.1.5

• Bluetooth speakers reach full volume, run at their own sample rate for cleaner audio, and idle links are allowed to rest during silence.
• Per-speaker Reset button.

Requires macOS 14.2 or later on Apple silicon. Signed with Apple Developer ID (team 8YKYNYSV6L) and notarized by Apple.

GainMesh v1.1.7

Install

Download GainMesh.dmg, run Install GainMesh.pkg, approve the administrator prompt, and restart your Mac. GainMesh starts on its own after the restart, in the menu bar.

Full guide: English · 한국어

New in v1.1.7

• Sliders now keep moving while you hold an arrow key. Every slider only responded to the initial key press, so adjusting one by keyboard meant releasing and pressing again for each single step. Arrow keys and Page Up/Down now repeat while held.

Also in v1.1.6

• Bluetooth speakers reach full volume. GainMesh pins a selected speaker's hardware volume so its own slider is the only control that matters, but Bluetooth devices expose a different volume control than wired ones and were silently skipped — a Bluetooth speaker could sit far below full hardware volume while GainMesh showed 100%.
• Cleaner Bluetooth audio. Routing to a Bluetooth speaker through a wired display's clock added continuous crackle that a direct connection did not have. GainMesh now runs at the Bluetooth device's own sample rate when one is selected.
• Idle Bluetooth links can rest. After 10 seconds of confirmed silence GainMesh hands your speaker back to itself, and returns the moment anything plays.
• Per-speaker Reset button.

Requires macOS 14.2 or later on Apple silicon. Signed with Apple Developer ID (team 8YKYNYSV6L) and notarized by Apple.

GainMesh v1.1.6

Install

Download GainMesh.dmg, run Install GainMesh.pkg, approve the administrator prompt, and restart your Mac. GainMesh starts on its own after the restart, in the menu bar.

Full guide: English · 한국어

New in v1.1.6

• Bluetooth speakers now reach full volume. GainMesh normalizes a selected speaker's hardware volume so its own slider is the only control that matters — but Bluetooth devices expose a different volume control than wired ones, so this silently skipped them. A Bluetooth speaker could sit far below full hardware volume while GainMesh showed 100% or even the new 200% boost. Fixed: GainMesh now reaches and holds the correct control on Bluetooth devices too.
• Cleaner Bluetooth audio. Measured against direct playback: routing to a Bluetooth speaker through a wired display's clock added continuous crackle a direct connection did not have. GainMesh now runs the engine at the Bluetooth device's own sample rate when one is selected, removing that always-on conversion.
• Idle Bluetooth links can rest. GainMesh previously kept streaming even during silence, which some Bluetooth amplifiers and radios never got to sleep through — audible as idle hiss or static a direct connection did not have. After 10 seconds of confirmed silence, GainMesh now hands your speaker back to itself directly and silently returns the moment anything plays again.
• Per-speaker Reset button. Volume, balance and delay return to their defaults in one press.

Building on v1.1.5: 200% volume boost, ±5 s per-speaker delay in 1 ms steps, and an automatic update check switch in Settings.

Requires macOS 14.2 or later on Apple silicon. Signed with Apple Developer ID (team 8YKYNYSV6L) and notarized by Apple.