status-trio README

项目的 README,来自 github.com/lingyired/status-trio。合并为一个 markdown 文件:README.md。

Eight Status Trio Dock icon states with symmetrically arranged dark and light backgrounds, including Wi-Fi, Bluetooth audio, battery, dots, and arc states

Status Trio app icon

Status Trio

lingyired/status-trio | Trendshift

Three system signals. One native macOS status icon — in your menu bar or the Dock.

Download for macOS — universal build, macOS 13 target; Ventura runtime validation pending

Want to see it in action first? Open statustrio.lingai.net to simulate every icon state in your browser.

Latest release Build and Release macOS workflow status License: Apache-2.0

macOS 13 deployment target; Ventura runtime validation pending Universal binary for Apple Silicon and Intel

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Español · Français · Deutsch · Português (Brasil) · Русский

Status Trio menu bar icon showing the Wi-Fi glyph while connected to Wi-Fi, with its status popover open

Status Trio is a native macOS status app that combines Wi-Fi, battery, and volume into one compact, configurable icon, shown in the menu bar, in the Dock, or in both. Its popover goes deeper than the icon: a Wi-Fi panel for nearby networks and link details, a Bluetooth panel for paired devices, a Battery Details page, and the audio devices that are playing. It is inspired by the iPhone Duo's combined status bar icon for Wi-Fi, Battery, and Cellular Data, adapted for Mac with Volume instead of Cellular Data.

Status Trio is an independent project and is not affiliated with Apple.

Highlights

Install

Install from the official Homebrew Cask:

brew install --cask status-trio

To update an existing Homebrew installation:

brew upgrade --cask status-trio

Or download the latest StatusTrio-*.dmg from GitHub Releases, open it, and drag Status Trio.app into /Applications.

The official release is signed with Developer ID and notarized by Apple. Open it normally after installation; no quarantine-removal command is needed. In-app updates use Sparkle with EdDSA signature verification.

Input, audio, and everyday controls

Bluetooth audio

Pick Bluetooth Device as the middle icon under Settings › App Icon › Middle Icon and the middle glyph becomes that device's own symbol while it plays — AirPods, headphones, speakers, and other devices supply their own — and the volume dots or arc can turn blue. Show network problems instead, on by default, keeps the network icon while the connection itself is in trouble. The same picker also offers Network, Current Input Source, Battery Percentage, and Power (Watts):

Status Trio menu bar icon showing the AirPods glyph while AirPods are connected, with its status popover open

The popover's Bluetooth row reports live state: the names of connected devices and, for AirPods, left, right, and case battery. The Bluetooth panel lists paired devices and their connection state: tap a device to connect it, tap a connected one to disconnect — keyboards, mice, trackpads and gamepads ask for confirmation in the row first. The panel is off by default, is enabled under Settings › Status Panel, and asks for Bluetooth permission on first use. Settings › Bluetooth also controls whether the battery levels are read — on by default — lists the paired devices so you can drag them into the order the panel shows and set how many appear, and scales the Bluetooth icon from 100% to 180%.

Dock icon

The same live icon can live in the Dock instead of the menu bar, or in both places at once:

Status Trio live icon in the Dock with dark appearance
Dock icon in dark appearance

Status Trio live icon in the Dock with light appearance
Dock icon in light appearance

Status Trio in the Dock with the Bluetooth panel shown, light appearance
Bluetooth panel preview

The Dock icon draws the same combined icon as the menu bar, so with Bluetooth Device selected as the middle icon the device glyph takes over the middle there too. Its background can follow the system icon style or be pinned to a fixed shade:

Status Trio Dock icon in dark, light, and clear backgrounds, in two rows: the Wi-Fi state and Bluetooth audio replacing the Wi-Fi icon with blue volume dots

Icon states

Every state the combined icon can show, drawn by the app's own renderer — battery indicators on top, Wi-Fi (or the Bluetooth audio device that can replace it, when that option is on) in the middle, and volume dots or the arc at the bottom, turning blue while a Bluetooth device is playing:

Status Trio icon states: charging, plugged in, percentage, low battery, and Low Power Mode at the top; Wi-Fi signal, hotspot, temporary, shared, and wired states in the middle; Bluetooth audio replacing the Wi-Fi icon, keeping Wi-Fi during a network error, and blue volume dots and arc below that; volume dots and arc styles for every level at the bottom

The same states rendered for a dark menu bar:

The same Status Trio icon states in dark appearance: white glyphs on dark chips, green charging, red low battery and yellow Low Power Mode accents, and the brighter blue the app uses for Bluetooth audio on a dark menu bar

Requirements

Run from source

git clone https://github.com/lingyired/status-trio.git
cd status-trio
swift run StatusTrio

Build a local app

Build an ad-hoc-signed app bundle and launch it:

bash scripts/build-app.sh release

The bundle is created at dist/StatusTrio.app. To build without quitting or launching an existing instance, run:

bash scripts/build-app.sh release no-open

The ad-hoc-signed bundle is intended for local personal use. Gatekeeper may reject it if the bundle is transferred with quarantine metadata.

Usage

Known limitations

Two boundaries macOS and this project draw deliberately. Both are explained in Known limitations.

Languages

Status Trio follows the macOS preferred language by default and includes English, Simplified Chinese, Traditional Chinese, Japanese, Korean, Spanish, French, German, Italian, Brazilian Portuguese, Russian, and Arabic.

Community

Status Trio has a Chinese-language community for questions, feedback, and release discussion.

Status Trio QQ group QR code    Status Trio WeChat group QR code

Privacy

Status Trio reads system status locally. Optional anonymous usage statistics are sent to the first-party service only after you enable them; upgrades start with statistics off, and new installs ask during onboarding. The heartbeat contains a random installation ID, app and macOS versions, language, and icon placement, with no names, account details, network details, or hardware identifiers. See telemetry and privacy. Status Trio does not read or store Wi-Fi passwords or request Keychain access. Location access is optional for the current Wi-Fi network name and details; Bluetooth access is requested when you enable the Bluetooth panel. The optional charge-to-full control uses a private PowerUI interface only when enabled; see known limitations for its behavior and limits.

Development

Run the risk-sized local verification (no GitHub Actions, signing, or release):

bash scripts/verify-local.sh quick BatteryMonitorTests
bash scripts/verify-local.sh docs
bash scripts/verify-local.sh full

Use quick for an isolated code change, docs for documentation or localization-only work, and full for state, concurrency, rendering, Helper, or build-pipeline changes. full builds a non-Universal development app bundle; it does not produce the release package.

When you need only a focused Swift test, keep using the existing test helper:

bash scripts/test.sh BatteryMonitorTests

Formal release verification is separate from daily development. A merged change is not a built artifact, and a built artifact is not a released version.

To build a worktree app alongside the main installation:

bash scripts/build-worktree.sh release

The helper derives a development bundle identifier and display name from the current branch. Both values can be overridden:

BUNDLE_ID=com.lingsmbp.StatusTrio.dev.settings-redesign \
APP_NAME="Status Trio (Settings Redesign)" \
bash scripts/build-worktree.sh release

The single-instance lock is scoped by bundle identifier, so differently identified builds can run at the same time.

Icon presentation API

For the three icon regions, update timing, Swift examples, and extension boundaries, see 三图形展示与更新 API. This documents the current internal API; an external plugin SDK is not implemented.

Technical baseline

Documentation

License

Copyright 2026 lingyired.

Status Trio is licensed under the Apache License, Version 2.0. See LICENSE and NOTICE.

Bundled third-party components carry their own licenses and do not change the project's Apache-2.0 license:

Author

Created and maintained by lingyired.
Website: https://statustrio.lingai.net/

Star History

Star History Chart

status-trio (lingyired/status-trio)

正在搜索数据库…

这是什么?这是一款原生 macOS 应用,可将 Wi-Fi、电池和音量合并到一个紧凑、可配置的状态图标中,图标可显示在菜单栏、程序坞,或两者同时显示。
图标在哪里?我该怎么点?图标位于菜单栏、程序坞,或两者同时显示。左键点击会打开状态弹出面板,右键点击会打开原生菜单,其中有版本和退出操作。
运行它需要什么?该应用面向 macOS 13 及更高版本,但在 Ventura 上的运行时验证仍未完成。从源代码构建需要 Swift 6 工具链以及 macOS 26 SDK 或更高版本。
我能直接在弹出面板里切换 Wi-Fi 网络吗?不能直接切换:选择某个网络会打开系统设置中的 Wi-Fi 面板。Status Trio 从不读取或存储 Wi-Fi 密码,因为 macOS 没有公开的 API 可用来通过已保存的密码连接网络。
它会把我的数据发送到别处吗?它只在本地读取系统状态。只有在你启用时才会发送匿名使用统计数据;升级用户默认关闭,新安装用户会在引导流程中被询问是否开启。
蓝牙面板是什么?它会列出已配对的设备,点按即可连接或断开,并显示电量。在 Settings › Status Panel 中启用之前它保持关闭,并且在蓝牙设备播放声音时,音量指示器会变为蓝色。
电池行显示什么?显示电量百分比、充电或接通电源状态、充满所需时间,电量低时会显示警告颜色。打开该行后,还会显示适配器功率、电压、电流、循环次数以及低电量模式。
中间图标能显示 Wi-Fi 以外的内容吗?可以。在 Settings › App Icon › Middle Icon 中,你可以选择 Bluetooth Device、Network、Current Input Source、Battery Percentage 或 Power (Watts)。
哪些功能只在 main 分支中,尚未发布?电池功率流、按应用统计的 CPU 能耗影响,以及适用于 macOS 26.4 或更高版本的 Apple 芯片 Mac 的 “Charge to Full Now” 按钮。这些功能都不在 1.7.5 版本中。
这个设计的灵感来自哪里?来自 iPhone Duo 合并后的状态栏图标,它包含 Wi-Fi、电池和蜂窝数据。本应用用音量替换了蜂窝数据。
作者
lingyired
大小
37.9 MB
星标
2K
时长
2个月
提交 · 90 天