BrimDeck README

项目的 README,来自 github.com/MoFeng2223/BrimDeck。合并为一个 markdown 文件:README.md。

English 简体中文

BrimDeck icon

BrimDeck - A Dynamic Island for Windows

BrimDeck is a Dynamic Island for Windows 11 that brings your AI coding tool quotas and usage, the music you are playing, system readings and wireless device batteries together at the top of the screen, with a clipboard history and a file transfer.
It stays collapsed at the top of the screen and opens only when you need it.
A native Windows app built with C# and WPF, designed for performance and smoothness.

Download Latest release License Interface languages

Features · Install · Quick start · Privacy · FAQ · Community · Contributing · 简体中文

BrimDeck opens from the notch at the top of the screen into the AI usage panel, switches to the music page, the system monitor page, the clipboard and file transfer page and the device batteries page, then collapses

Why BrimDeck

Features

Collapsed styles

BrimDeck sits at the top center of the screen and comes in three styles: Notch (default), Capsule and Indicator.

Notch
Notch (default)
Capsule
Capsule
Indicator
Indicator

AI usage

AI usage page: quotas of Claude, Codex, Cursor and Antigravity in four columns Model details page: tokens and cost by app and model

You can choose the quota providers and set the quota and usage source of each column separately. See Supported tools.

Music

Music page: cover, title, lyrics, progress bar and playback controls

Works with players that use Windows media controls, with extra support for NetEase Cloud Music, QQ Music, Apple Music and KuGou Music. See Supported players.

System monitor

System monitor page: CPU usage, temperature and each core, GPU, memory, network speed, drives, system power and battery, and the busiest apps

For where each reading comes from and its limits, see System monitor readings. PCs whose CPU temperature or power cannot be read can turn on enhanced sensors.

The page is adapted from ftop by Nongfsq (MIT License), a system monitor for macOS.

Device batteries

Device batteries page: a battery ring each for a mouse, a keyboard, a headset, AirPods and a controller, with the charge, name and state under it

For the supported connections, brands and models, see Supported devices.

Clipboard and file transfer

Clipboard and file transfer page: copied text, a link, code, a picture and a color on the left; held files with their sizes on the right

For how to use it and its settings, see Clipboard and file transfer.

Panel themes

The same AI usage page in the Dark, Light, Island Holiday 2, Pixel Blocks and Cyberpunk: Edgerunners themes, and in an example custom theme

More settings

Install

Requires Windows 11 (x64). Windows 10 (version 2004 or later) has limited support.

  1. Download one of these files from Releases:
    • Installer: BrimDeck-<version>-Setup.exe. Run it and follow the steps.
    • Portable: BrimDeck-<version>-Portable-x64.zip. Extract it and run BrimDeck.exe in the BrimDeck folder.
  2. If Windows shows "Windows protected your PC", select "More info", then "Run anyway".

Both versions update from within the app, and both keep settings and data in %LOCALAPPDATA%\BrimDeck.

Quick start

  1. After you install and start BrimDeck, the panel appears at the top center of the primary display, showing Claude and Codex by default.
  2. Move the pointer over the panel to open it; move away or press Esc to close it.
  3. Use the page switch at the top left of the open panel to move between AI usage, music, the system monitor, the clipboard and file transfer, and device batteries; pages you do not need can be turned off or reordered under Settings › Expanded view.
  4. Select the settings button at the top right of the open panel to add tools or change settings. You can also right-click the open panel, double-click the tray icon, or right-click the tray icon.

Uninstall

To remove settings and data as well, also delete %LOCALAPPDATA%\BrimDeck. If you turned on enhanced sensors, uninstalling the installed version removes the sensor service too; with the portable version, turn it off under Settings › Enhanced sensors first.

Privacy

For the files BrimDeck reads and the addresses it connects to, see Data and privacy.

FAQ

A tool shows "Not connected" or "Waiting for update". What should I do? Make sure the tool is signed in on this PC; for example, Antigravity needs its desktop app running for its quota to be read. When BrimDeck cannot read the data, it shows the actual status and never makes up numbers.

Is the cost shown what I actually pay? No. Costs come from the amounts reported by each service or from public model prices, and are meant to show how much you use. Your actual subscription charges are on each provider's bill.

Why does the system monitor show no CPU temperature or power? On many PCs Windows does not provide either. Turn on enhanced sensors under Settings › Enhanced sensors, or run HWiNFO or LibreHardwareMonitor alongside. See Enhanced sensors.

My mouse, keyboard or headset shows no battery. Why? The device has to be connected and be one of the connections or models listed in Supported devices. For a device that is not listed, you are welcome to report its model in Issues.

Animations or the equalizer bars never move. Why? BrimDeck's animations and equalizer bars need two settings turned on: BrimDeck's Settings › General › Hover and animation › Animate expanding and collapsing, and Windows Settings › Accessibility › Visual effects › Animation effects. If either is off, the expand animation, the equalizer bars and scrolling text all stop.

Community

QQ group: 1132738200

Contributing

You are welcome to report problems, suggest features or ask for more tools, players and devices in Issues, and to contribute through pull requests.

License

BrimDeck is licensed under the Apache License 2.0. Third-party licenses are listed in ThirdPartyNotices.txt.

BrimDeck (MoFeng2223/BrimDeck)

正在搜索数据库…

这是什么?BrimDeck 是一款面向 Windows 11 的类 Dynamic Island 面板,位于屏幕顶部,把 AI 编程工具的配额、音乐控制、系统读数、设备电量,以及剪贴板和文件传输,集中在一个地方显示。
这是应用还是库?它是一款使用 C# 和 WPF 开发的原生 Windows 桌面应用,而不是可以导入到你自己代码中的库。
我需要登录或添加 API 密钥吗?通常不需要。它会自动识别这台电脑上已经登录的 Claude、Codex、Cursor 等工具。只有你自己手动输入时才需要 API 密钥,并且密钥会由 Windows 加密保存。
配额数字一定准确吗?不一定。如果某个工具未登录,或其数据无法读取,面板会如实显示“未连接”或“等待更新”等状态,而不会猜测数值。Antigravity 需要其桌面应用处于运行状态,才能读取配额。
它会上传我的数据吗?它只读取应用已经保存的登录状态和使用记录,从不修改或结束任何登录。对话内容不会被上传。只有在读取配额和用量、更新价格、获取歌词和封面以及检查更新时,它才会联网。
它会追踪哪些 AI 编程工具?明确支持 Claude、Codex、Cursor 和 Antigravity,也支持其他工具,同时最多可追踪 7 个工具。每一列都会显示套餐、配额用量、重置倒计时,以及今天和最近 7 天的 Token 与费用汇总。
它可以控制哪些音乐播放器?任何使用 Windows 媒体控制的播放器都可以使用,并额外支持网易云音乐、QQ 音乐、Apple Music 和酷狗音乐。你可以固定某一个播放器,也可以隐藏不想显示的应用。
剪贴板历史会保存在我的电脑上吗?会。历史记录由 Windows 加密保存在这台电脑上,BrimDeck 退出时会清除,但“收藏”内容或设置为保留的分类除外。你选择的应用可以排除在记录之外。
它会弹出在全屏游戏上方吗?不会。在你玩全屏游戏或观看全屏视频时,它会自动隐藏,因此不会意外弹出。你可以在设置中调整此项,鼠标穿透模式也会阻止鼠标悬停时将其打开。
大小
253.1 MB
星标
801
时长
2个月
提交 · 90 天