dimble README

The project's README from github.com/fif7y/dimble. As one markdown file: README.md.

Pelmet, a calm menu bar for macOS

Website: pelmet.fif7y.com Download latest release Requires macOS 27 or later License: GPL-3.0 Pelmet on AlternativeTo Sponsor Pelmet

Pelmet hides the icons you don't need until you do. Hover, click or press a shortcut and they slide back in. Small on purpose (three sections, an editor, ⌘-drag in the bar) and native all the way down. macOS does the hiding. Built for the menu bar Apple rebuilt in macOS 27. Free, open source, no account, no analytics.

[!TIP] Beta channel now available. Fixes and new features land there first, a stable release rolls them up every week or two. Turn on "Get beta releases" in Settings › About (0.2.41 or later), or download the latest beta:

Latest beta

The menu bar: hidden icons tuck away behind the chevron, then return on hover
Collapsed, and a hover later.

Choose what stays

Three sections, one rule: Visible is always there, Hidden comes back on a hover or a click, and Always Hidden only appears when you ask for it (double-click or ⌥-click the chevron). Arrange them in the layout editor (real app-icon previews, drag-and-drop ordering), or skip the window entirely and ⌘-drag icons across the chevron right in the menu bar. Pelmet adopts the move either way.

The layout editor: dragging an icon from Always Hidden to Hidden, both sections reflowing
The layout editor. Drag icons between Visible, Hidden and Always Hidden.

System icons hide too. Sound, Battery and friends behave like any other icon. The few macOS protects (Clock, Control Center) are shown locked in the editor rather than pretended away, and anything macOS groups together gets an honest badge instead of a fake handle. Siri and Time Machine, which macOS only hides as a pair, come as Pelmet's own items so each can go wherever you like.

Reveal on your terms

Every way back in is a setting: hover (with a delay from 0.1 to 0.5 seconds), a click on empty menu bar space, a double-click for the always-hidden section, or the chevron itself. Pick how it looks (Instant, Smooth or Fade) and how it ends, either auto-rehide after a delay you set (instant to 5 seconds) or the moment you click somewhere else.

Behavior settings: Instant/Smooth/Fade animation cards with a live preview, reveal on hover with a stepped delay slider, click and double-click reveals, auto-rehide after a stepped delay, system extras
Your rules for revealing, and for putting everything back.

And the rest

General settings: launch at login, the menu bar icon toggle with six icon styles, display language picker, Accessibility and Screen Recording permission status
General. Pick the icon Pelmet wears, or your language.

How it works

macOS 27's menu bar can hide items natively. It's the mechanism behind the system's assessment (exam lockdown) mode. Pelmet drives that mechanism directly. It asserts a configuration listing what should stay visible, and macOS itself hides the rest and reflows the bar. That's why hiding feels like part of the system. It is the system.

The catch: this API lives in a private Apple framework (MenuBarClientCore). It isn't documented or guaranteed, so a macOS update could change or remove it. Pelmet resolves it at runtime and fails soft. If the API ever disappears, Pelmet simply reports hiding as unavailable rather than breaking your menu bar. Everything else (item positions, clicks, previews) uses public APIs: Accessibility and ScreenCaptureKit.

Install

Download the latest DMG from Releases, drag Pelmet to Applications, and launch it. Or with Homebrew:

brew install fif7y/tap/pelmet

Requires macOS 27 (Golden Gate). Earlier versions of macOS use a different menu bar architecture that Pelmet doesn't target.

On first launch Pelmet asks for one permission:

Screen Recording is optional, offered next to Accessibility in onboarding and skippable. The animation styles use it: macOS shows and hides icons with an animation of its own, and Pelmet's Instant, Smooth and Fade play over it using two stills of the menu bar. Nothing is recorded or kept. Without it, icons show and hide the way macOS does it.

Pelmet is notarized by Apple and ships with the hardened runtime. It isn't sandboxed, managing the menu bar requires APIs the App Store sandbox forbids.

More in the FAQ.

Build from source

Requires Xcode with the macOS 27 SDK and xcodegen.

git clone https://github.com/fif7y/pelmet.git
cd pelmet
xcodegen
xcodebuild -project Pelmet.xcodeproj -scheme Pelmet -configuration Release build

The engine logic lives in two local Swift packages, Packages/PelmetCore (section model, rehide state machine) and Packages/PelmetEngine (menu bar convergence), each with its own test suite:

swift test --package-path Packages/PelmetCore
swift test --package-path Packages/PelmetEngine

UI strings live in Pelmet/Resources/Localizable.xcstrings, generated from the translation table in scripts/gen-xcstrings.py. Edit the script, re-run it, commit both. English keys must match the code literals exactly.

Why "Pelmet"

pelmet (n.), a narrow border of cloth or wood, fitted across the top of a window to conceal the curtain fittings. Now also the same thing, for your menu bar.

Licenses & acknowledgements

Pelmet was inspired by Ice, the open-source menu bar manager for earlier versions of macOS. Apple's macOS 27 rebuild of the menu bar doesn't carry the old architecture forward, so Pelmet was rebuilt from scratch for the new one (no code is shared between the projects).

Pelmet's only third-party dependency is Sparkle (in-app updates), used under the MIT-style Sparkle license. Everything else is custom code on top of Apple's system frameworks.

License

© 2026 Gabriel Faucon. Licensed under the GNU General Public License v3.0. Use it, fork it. Distributed derivatives must remain open under the same license.

Pelmet is an independent project, not affiliated with or endorsed by Apple Inc. Apple, macOS, and the Mac are trademarks of Apple Inc.

dimble (fif7y/dimble)

Searching Database…

874 ·GitHub
Что это такое?Pelmet — бесплатный менеджер строки меню macOS с открытым исходным кодом: он прячет ненужные вам иконки, пока они не понадобятся, а при наведении курсора, клике или нажатии горячей клавиши они выезжают обратно.
Чем это отличается от Bartender или Ice?Он выполняет ту же роль (репозиторий помечен как альтернатива обоим), но написан с нуля для строки меню, которую Apple переработала в macOS 27, и не имеет общего кода с Ice. Скрытие выполняет сама macOS: Pelmet управляет штатным системным механизмом скрытия, поэтому ощущается как часть операционной системы.
Какие разрешения он запросит при первом запуске?Обязательно одно: Accessibility (универсальный доступ) — так Pelmet видит элементы строки меню и кликает по скрытым, не раскрывая всё сразу. Screen Recording (запись экрана) необязательна и нужна только для анимаций показа Instant, Smooth и Fade; ничего не записывается и не сохраняется.
Есть ли шанс, что обновление macOS всё сломает?Теоретически да: скрытие работает через закрытый недокументированный API Apple (MenuBarClientCore). Pelmet находит его во время выполнения и не падает — если API исчезнет, приложение просто сообщит, что скрытие недоступно, вместо того чтобы сломать вашу строку меню.
Он куда-нибудь отправляет мои данные?Нет — ни аккаунта, ни аналитики, ни сервера. Единственное соединение, которое он устанавливает, — это проверка собственных обновлений, которые доставляются через Sparkle с подписями EdDSA, проверяемыми по подписанному appcast.
Можно ли сделать форк, и что требует лицензия?Лицензия — GPL-3.0: пользуйтесь и делайте форки свободно, но распространяемые производные проекты должны оставаться открытыми под той же лицензией. Единственная сторонняя зависимость — Sparkle, используемая по лицензии типа MIT.
Как скрытые иконки возвращаются обратно?Как вам удобнее: наведением курсора (задержка от 0,1 до 0,5 секунды), кликом по пустому месту строки меню, двойным кликом для секции Always Hidden или по самому шеврону. Вы также выбираете анимацию (Instant, Smooth, Fade) и то, прячутся ли иконки снова через заданную вами задержку или сразу, как только вы кликнете в другом месте.
Может ли он скрывать системные иконки вроде Battery или Sound?Да — они ведут себя как любая другая иконка. Немногочисленные защищённые macOS иконки (Clock, Control Center) показываются в редакторе как заблокированные, для сгруппированных элементов честно выводится специальный значок, а Siri и Time Machine представлены собственными элементами Pelmet, поэтому каждую можно разместить отдельно.
Что ещё он умеет добавлять в строку меню?Встроенные замены, которые не пропадают при скрытии: элементы управления мультимедиа, AirDrop, индикатор камеры/микрофона, таймер, Focus, быстрое переключение пользователей и Shortcuts. Он также может добавить лаунчеры приложений (клик открывает любое приложение) и разделители с настраиваемой прозрачностью.
Работает ли он с несколькими мониторами?Да, для каждого монитора отдельно: любой монитор можно настроить так, чтобы он всегда показывал всё, или чтобы сворачивал иконки, а приоритет у того монитора, где сейчас курсор.
What are similar projects?Ice, Thaw, OpenYoink, macos-sysdata, Doll, FineTune, Sapphire, tendedero
Creator
fif7y
Size
25.7 MB
Stars
874
Age
1mo
Commits · 90 Days