Status Trio는 Wi-Fi, 배터리, 볼륨을 하나의 간결하고 설정 가능한 아이콘으로 결합해 메뉴 막대, Dock 또는 두 곳 모두에 표시하는 네이티브 macOS 상태 앱입니다. 팝오버는 아이콘보다 더 깊이 들어갑니다. 주변 네트워크와 링크 세부 정보를 보여 주는 Wi-Fi 패널, 페어링된 기기를 보여 주는 Bluetooth 패널, 배터리 세부 정보 페이지, 그리고 재생 중인 오디오 기기를 제공합니다. iPhone Duo가 Wi-Fi, 배터리, 셀룰러 데이터를 하나의 상태 막대 아이콘으로 결합한 데서 영감을 받았으며, Mac에서는 셀룰러 데이터 대신 볼륨을 사용하도록 각색했습니다.
> Status Trio는 독립적인 프로젝트이며 Apple과 제휴 관계가 없습니다.
## 주요 기능
- **하나의 아이콘, 세 가지 신호** — 배터리, Wi-Fi, 볼륨이 메뉴 막대, Dock 또는 두 곳 모두에서 하나의 아이콘을 공유하며, 재생 중인 Bluetooth 기기는 자신의 기호로 가운데 자리를 차지할 수 있습니다.
- **Bluetooth** — 재생 중에는 볼륨 표시기가 파란색으로 바뀝니다. 패널에는 탭하면 연결하거나 해제할 수 있는 페어링된 기기가 표시되고, 배터리 잔량은 기본적으로 표시되며, 사용자가 켜기 전까지는 꺼져 있습니다.
- **배터리** — 잔량 백분율, 충전 중 또는 전원 연결 상태, 완전 충전까지 남은 시간, 잔량이 부족할 때의 색상을 보여 줍니다. 해당 행을 열면 어댑터 정격 출력, 전압, 전류, 사이클 수, 저전력 모드를 확인할 수 있습니다.
- **Wi-Fi** — 현재 연결된 네트워크와 신호 세기를 보여 줍니다. 열면 주변 네트워크를 보고, 링크 세부 정보를 확인하거나 Wi-Fi를 끌 수 있습니다. 네트워크 간 전환은 시스템 설정의 Wi-Fi 패널에서 이루어집니다.
- **볼륨** — 음량, 음소거, 출력 장치를 점 또는 호로 그립니다. 패널 전체 또는 컨트롤만 스크롤할 수 있고, 볼륨을 높이는 스크롤 방향을 선택할 수 있습니다.
- **원하는 대로 설정** — 아이콘 크기, 기호 배율, 외부 링 두께, 상태 색상, 그리고 팝오버에 표시할 섹션과 그 순서를 직접 정할 수 있습니다.
- **메뉴 막대, Dock 또는 둘 다** — Dock 아이콘은 시스템 스타일을 따르거나 어두운 색 또는 밝은 색으로 고정할 수 있습니다.
- **macOS 네이티브** — 왼쪽 클릭으로 팝오버가 열리고 오른쪽 클릭으로 메뉴가 열리며, 첫 실행 시 아이콘 알아보기 가이드가 아이콘의 각 부분을 설명합니다. 원한다면 Ethernet, 핫스팟 또는 인터넷 공유에서도 Wi-Fi 기호를 유지할 수 있습니다.
- **항상 최신 상태 유지** — 상태는 시스템 이벤트에서 가져오고 느린 폴링을 대체 수단으로 사용하며, Sparkle은 서명된 피드를 통해 앱을 업데이트합니다.
- **함께 제공되는 기능** — 열두 개 언어와 선택적 로그인 시 실행 기능입니다.
## 설치
Homebrew 공식 Cask로 설치:
```bash
brew install --cask status-trio
```
Homebrew로 설치한 버전 업데이트:
```bash
brew upgrade --cask status-trio
```
또는 [GitHub Releases](https://github.com/lingyired/status-trio/releases/latest)에서 최신 `StatusTrio-*.dmg`를 내려받아 열고 `Status Trio.app`을 `/Applications`로 드래그하세요.
공식 릴리스는 Developer ID로 서명되었으며 Apple 공증을 받았습니다. 설치 후 일반적인 방법으로 열면 됩니다. 격리 속성 제거 명령은 필요하지 않습니다. 앱 내 업데이트는 Sparkle과 EdDSA 서명 검증을 사용합니다.
## 입력 소스와 오디오 제어
- **입력 소스 아이콘**: 메뉴 막대와 Dock 중앙에 현재 입력기를 표시할 수 있습니다. **설정 › 네트워크**에서 선택하며 패널에서 활성화된 입력 소스를 선택하여 전환할 수 있습니다.
- **전역 단축키**: **설정 › 일반**에서 지정하면 다른 앱에서도 패널을 열고 닫을 수 있습니다. 기본값은 미지정입니다.
- **Bluetooth 제어**: 패널에서 Bluetooth 켜기/끄기, 기기 연결/해제, 지원되는 AirPods와 HUAWEI FreeBuds의 듣기 모드를 제어합니다. 선택적인 Apple 기기 배터리 행은 Bluetooth 설정에서 구성하며 기기와 연결에 따라 지원 여부가 달라집니다.
- **오디오 입력과 출력**: 스피커와 마이크를 선택하고 입력·출력 음량을 조절합니다. 호환 외장 디스플레이 스피커는 DDC로 제어하며 하드웨어와 연결에 따라 지원 여부가 달라집니다.
- **충전과 외관**: 메뉴 막대와 Dock의 충전 효과를 지원합니다. macOS 26 이상에서는 Finder와 Launchpad의 앱 아이콘도 시스템의 밝고 어두운 외관을 따릅니다.
## main의 새 기능 (미출시)
다음 기능은 `main` 소스에 포함되지만 현재 GitHub / Homebrew 공개 버전 **1.7.5**에는 포함되지 않습니다:
- **전력 흐름과 CPU 에너지 영향**: 충전기 입력, 배터리 충전, 시스템 전력의 추정값을 표시합니다. 선택 목록은 CPU 에너지 기준으로 최대 5개 앱을 표시하며 카운터가 없으면 CPU 활동량으로 대체합니다. 전체 앱 에너지나 macOS 기본 고에너지 목록이 아닙니다. 활성화하면 주기적인 백그라운드 샘플링이 시작되고 비활성화하면 중단됩니다. [설명](docs/battery-power-flow.md).
- **지금 완전히 충전 및 취소**: macOS 26.4 이상을 실행하는 지원 Apple Silicon Mac에서 선택적으로 활성화할 수 있으며 기본값은 꺼짐입니다. 비공개 PowerUI 인터페이스로 충전 한도를 해제합니다. **완충 또는 전원 재연결 후에도 한도가 100%로 남을 수 있으며 자동 복원되지 않습니다.** 취소로 복원을 요청하거나 시스템 설정에서 한도를 확인하고 복원하세요. 동작은 macOS에 따라 달라집니다. [동작과 검증](docs/charge-to-full-now-poc.md).
## Bluetooth 오디오
Bluetooth로 오디오를 재생하는 동안 **설정 › Bluetooth** 아래의 두 스위치로 가운데 기호를 해당 기기 고유의 심볼로 바꿀 수 있고 — AirPods, 헤드폰, 스피커 및 기타 기기는 각자의 심볼을 제공합니다 — 볼륨 점 또는 호를 파란색으로 표시할 수 있습니다. 둘 다 기본적으로 꺼져 있습니다. 기본적으로 켜져 있는 **네트워크 오류 우선**은 연결 자체에 문제가 있는 동안 네트워크 아이콘을 유지합니다:
팝오버의 Bluetooth 행은 실시간 상태를 알려 줍니다. 연결된 기기의 이름과 AirPods의 경우 왼쪽, 오른쪽, 케이스 배터리입니다. Bluetooth 패널은 페어링된 기기와 그 연결 상태를 나열합니다. 기기를 탭하면 연결되고, 연결된 기기를 탭하면 연결이 해제됩니다 — 키보드, 마우스, 트랙패드, 게임패드는 먼저 행에서 확인을 요청합니다. 기본적으로 꺼져 있고 **설정 › 상태 패널**에서 활성화하며, 처음 사용할 때 Bluetooth 권한을 요청합니다. **설정 › Bluetooth**에서는 배터리 잔량을 읽을지 여부를 제어하고 — 기본적으로 켜져 있습니다 — 페어링된 기기를 나열해 드래그로 표시 순서를 정하고 몇 대를 표시할지 선택할 수 있게 하며, Bluetooth 아이콘을 100%에서 180%까지 조절합니다.
## Dock 아이콘
동일한 실시간 아이콘을 메뉴 막대 대신 Dock에 표시하거나 두 곳에 동시에 표시할 수 있습니다:
어두운 색 모양의 Dock 아이콘
밝은 색 모양의 Dock 아이콘
Bluetooth 패널 미리보기
Dock 아이콘은 메뉴 막대와 동일한 결합 아이콘을 그리므로, Bluetooth 오디오 교체를 켜면 그곳에서도 기기 기호가 가운데를 차지합니다. 배경은 시스템 아이콘 스타일을 따르거나 고정된 명암으로 지정할 수 있습니다:
## 아이콘 상태
결합 아이콘이 표시할 수 있는 모든 상태를 앱 자체 렌더러로 그린 것입니다. 위쪽에는 배터리 표시기, 가운데에는 Wi-Fi(해당 옵션이 켜져 있으면 이를 대체할 수 있는 Bluetooth 오디오 기기), 아래쪽에는 볼륨 점 또는 호가 있으며, Bluetooth 기기가 재생 중일 때는 파란색으로 바뀝니다:
어두운 메뉴 막대용으로 렌더링한 동일한 상태:
## 요구 사항
- 앱을 실행하려면 macOS 13 배포 대상(Ventura 런타임 검증 대기 중)이 필요합니다.
- 빌드하려면 macOS 26 SDK(Xcode 26 이상)가 포함된 Swift 6 툴체인이 필요합니다. 이전 SDK로 빌드하면
아무 알림 없이 Tahoe 이전 팝오버 모양이 만들어지므로, SDK가 26보다 이전이면 `scripts/build-app.sh`가 실패합니다.
## 소스에서 실행
```bash
git clone https://github.com/lingyired/status-trio.git
cd status-trio
swift run StatusTrio
```
## 로컬 앱 빌드
Ad-hoc 서명된 앱 번들을 빌드하고 실행합니다:
```bash
bash scripts/build-app.sh release
```
번들은 `dist/StatusTrio.app`에 생성됩니다. 실행 중인 인스턴스를 종료하거나 새로 실행하지 않고 빌드하려면 다음을 실행하십시오:
```bash
bash scripts/build-app.sh release no-open
```
Ad-hoc 서명된 번들은 로컬 개인 사용을 위한 것입니다. 번들이 격리 메타데이터와 함께 전송되면 Gatekeeper가 이를 거부할 수 있습니다.
## 사용 방법
- 메뉴 막대 아이콘이나 Dock 아이콘을 **왼쪽 클릭**하면 상태 팝오버가 열립니다.
- 두 아이콘 중 하나를 **오른쪽 클릭**하면 버전과 종료 동작을 포함한 네이티브 메뉴가 열립니다.
- 팝오버에서 Wi-Fi 행이나 배터리 행을 선택하면 해당 페이지가 열립니다: 주변 네트워크와 링크 세부 정보, 또는 배터리 세부 정보입니다. Bluetooth 행은 페이지를 열지 않고 페어링된 기기를 그 자리에 나열합니다 — 탭하면 연결하거나 해제할 수 있고, 기기가 모두 표시되지 않으면 **펼치기** 컨트롤이 나타납니다.
- **설정**을 열어 아이콘을 표시할 위치(메뉴 막대, Dock 또는 둘 다)를 선택하고 크기, 색상, 외부 링 두께, 패널 섹션과 그 순서, 스크롤로 조절하는 동작, 언어, 업데이트 확인, 로그인 시 실행을 변경할 수 있습니다.
- **설정 › 앱 아이콘 › 가이드 열기**에서 언제든지 **아이콘 알아보기** 가이드를 다시 열 수 있습니다.
- 요청이 표시되면 현재 Wi-Fi 네트워크 이름 표시를 허용하십시오. macOS는 이 선택적 정보를 위해 위치 접근 권한을 요청합니다.
## 알려진 제한 사항
macOS와 이 프로젝트가 의도적으로 그은 두 가지 경계가 있습니다. 둘 다 [알려진 제한 사항](docs/known-limitations.md)에 설명되어 있습니다.
- **네트워크 전환은 시스템 설정에서 이루어집니다.** 팝오버에서 네트워크를 선택하면 Wi-Fi 패널이 열립니다. Status Trio는 Wi-Fi 암호를 읽거나 저장하지 않습니다. macOS가 저장된 암호로 연결할 수 있는 공개 API를 제공하지 않으며, 다른 모든 방법은 결국 앱이 암호를 보관하게 되기 때문입니다.
- **충전 한도 제어는 버전에 따라 다릅니다.** 공개 버전 1.7.5는 시스템 설정을 사용합니다. `main`의 선택 기능은 비공개 인터페이스를 사용하며 복원을 요청하려면 직접 취소해야 합니다. [설명](docs/charge-to-full-now-poc.md). 저전력 모드는 별도의 [선택적 권한 Helper](docs/privileged-helper.md)를 사용합니다.
## 언어
Status Trio는 기본적으로 macOS의 선호 언어를 따르며 English, 简体中文, 繁體中文, 日本語, 한국어, Español, Français, Deutsch, Italiano, Português (Brasil), Русский, العربية를 지원합니다.
## 개인정보 보호
Status Trio는 시스템 상태를 로컬에서 읽습니다. 익명 사용 통계는 사용자가 활성화한 경우에만 자사 서비스로 전송합니다. 업그레이드 시 기본값은 꺼짐이며 새 설치는 온보딩에서 선택합니다. 전송 항목은 무작위 설치 ID, 앱과 macOS 버전, 언어, 아이콘 위치이며 이름, 계정, 네트워크 정보, 하드웨어 식별자는 포함하지 않습니다. [개인정보 설명](docs/privacy-telemetry.md). Wi-Fi 암호를 읽거나 저장하지 않고 키체인 접근을 요청하지 않습니다. 위치 권한은 선택적인 Wi-Fi 이름과 세부 정보에 사용하며 Bluetooth 패널 활성화 시 Bluetooth 권한을 요청합니다. `main`의 완충 제어는 활성화된 경우에만 비공개 PowerUI 인터페이스를 사용합니다. 제한은 앞의 설명을 참조하세요.
## 개발
테스트 스위트를 실행합니다:
```bash
bash scripts/verify-local.sh quick BatteryMonitorTests
bash scripts/verify-local.sh docs
bash scripts/verify-local.sh full
```
헬퍼를 통해 특정 XCTest 필터를 실행합니다:
```bash
bash scripts/test.sh BatteryMonitorTests
```
기본 설치와 함께 워크트리 앱을 빌드하려면:
```bash
bash scripts/build-worktree.sh release
```
헬퍼는 현재 브랜치에서 개발용 번들 식별자와 표시 이름을 도출합니다. 두 값 모두 재정의할 수 있습니다:
```bash
BUNDLE_ID=com.lingsmbp.StatusTrio.dev.settings-redesign \
APP_NAME="Status Trio (Settings Redesign)" \
bash scripts/build-worktree.sh release
```
단일 인스턴스 잠금은 번들 식별자를 기준으로 적용되므로, 식별자가 다른 빌드는 동시에 실행할 수 있습니다.
## 기술 기준
- Swift 6
- SwiftUI + AppKit
- macOS 13 deployment target (Ventura runtime validation pending)
- Dock 아이콘이 표시되는 동안 일반 활성화 정책으로 전환하는 `LSUIElement` 메뉴 막대 액세서리
- 업데이트 확인을 위한 Sparkle
## 문서
- [알려진 제한 사항](docs/known-limitations.md)
- [자동화된 GitHub Actions 릴리스](docs/github-actions-release.md)
- [Status Trio 디자인 명세](docs/superpowers/specs/2026-09-12-status-trio-design.md)
- [메뉴 막대 아이콘 SVG](status-menubar.svg)
- [데이터 기반 아이콘 데모](status-menubar-demo.html)
## 라이선스
Copyright 2026 lingyired.
Apache License, Version 2.0에 따라 라이선스가 부여됩니다. [LICENSE](LICENSE) 및 [NOTICE](NOTICE)를 참조하십시오.
## 작성자
[lingyired](https://github.com/lingyired)가 만들고 유지 관리합니다.
웹사이트: [https://statustrio.lingai.net/](https://statustrio.lingai.net/)
## Star History
