|
1 | | -# OverflowBar |
| 1 | +<div align="center"> |
| 2 | + <img src="assets/overflowbar-icon.png" alt="OverflowBar app icon" width="96" height="96" /> |
| 3 | + <h1>OverflowBar</h1> |
| 4 | + <p><strong>Give your menu bar a second row.</strong></p> |
| 5 | + <p>Move the menu bar icons you choose into a second row, then open their original menus and popovers from one place.</p> |
| 6 | + <p><a href="https://github.com/EvanProgramming/OverflowBar/releases/latest">Download for macOS</a> · <a href="#quick-start">Quick start</a> · <a href="#documentation">Documentation</a></p> |
| 7 | +</div> |
2 | 8 |
|
3 | | -OverflowBar v1.5 gives selected menu bar icons a second row. Open an icon there to use its original menu or popover. |
| 9 | +<p align="center"> |
| 10 | + <a href="https://github.com/EvanProgramming/OverflowBar/releases/latest"><img src="https://img.shields.io/github/v/release/EvanProgramming/OverflowBar?display_name=tag&color=333333" alt="Latest stable release" /></a> |
| 11 | + <a href="docs/INSTALLATION.md"><img src="https://img.shields.io/badge/macOS-15%20%26%2026-666666?logo=apple" alt="macOS 15 and 26 deployment targets" /></a> |
| 12 | + <a href="docs/INSTALLATION.md"><img src="https://img.shields.io/badge/Apple%20silicon%20%26%20Intel-universal-777777?logo=apple" alt="Universal Apple silicon and Intel build" /></a> |
| 13 | + <a href="LICENSE"><img src="https://img.shields.io/github/license/EvanProgramming/OverflowBar?color=555555" alt="GPL 3.0 license" /></a> |
| 14 | +</p> |
4 | 15 |
|
5 | | -**v1.5.0 is the latest stable release**, with an updated native menu bar engine. Existing users can install it through the signed in-app updater or download the [release](https://github.com/EvanProgramming/OverflowBar/releases/tag/v1.5.0). The previous stable [v1.0.19 release](https://github.com/EvanProgramming/OverflowBar/releases/tag/v1.0.19) remains available as a manual fallback. |
| 16 | +<p align="center"> |
| 17 | + <a href="docs/assets/second-row-open.png"><img src="docs/assets/second-row-open.png" alt="OverflowBar's second row open beneath the macOS menu bar" width="800" /></a> |
| 18 | +</p> |
6 | 19 |
|
7 | | -- Choose menu bar icons one at a time. |
8 | | -- Source-aware Tahoe discovery, including Control Center-hosted windows. |
9 | | -- Authenticated ad-hoc discovery and recyclable capture helpers. |
10 | | -- Open selected icons using Accessibility or supported menu bar actions. |
11 | | -- A scrollable panel with system materials and keyboard accessibility. |
12 | | -- Universal Intel/Apple Silicon build; macOS 15 target; macOS 27+ fails open. |
13 | | -- Ad-hoc signing and signed Sparkle updates; no paid certificate required. |
| 20 | +The second row keeps selected menu bar controls available while leaving their original menu-bar position clear. |
14 | 21 |
|
15 | | -Accessibility is required to hide selected icons and open their menus. Screen Recording enables live previews. Moving icons may briefly move the pointer; you can cancel an operation at any time. |
| 22 | +**A clearer menu bar, without replacing your controls.** Choose which status icons to tuck away, open their real menus from the second row, and restore them whenever you like. |
| 23 | + |
| 24 | +## Features |
| 25 | + |
| 26 | +- **Choose icons individually.** Select the status items OverflowBar can arrange. |
| 27 | +- **Use the original controls.** Open source-app menus, popovers, and supported toggles. |
| 28 | +- **See live previews.** Screen Recording enables captured previews; app icons remain available without it. |
| 29 | +- **Use the keyboard and recover easily.** Navigate the panel, cancel an operation, reset the selection, or quit to reveal the icons. |
| 30 | + |
| 31 | +## Installation |
| 32 | + |
| 33 | +1. [Download the v1.5.0 DMG](https://github.com/EvanProgramming/OverflowBar/releases/download/v1.5.0/OverflowBar-1.5.0.dmg) or choose the [latest stable release](https://github.com/EvanProgramming/OverflowBar/releases/latest). |
| 34 | +2. Drag OverflowBar into Applications, then open it. The current DMG is named OverflowBar-1.5.0.dmg. |
| 35 | +3. Follow setup and select the icons you want in the second row. |
| 36 | + |
| 37 | +If you prefer Homebrew, use the verified cask from this repository: |
| 38 | + |
| 39 | + brew tap EvanProgramming/overflowbar https://github.com/EvanProgramming/OverflowBar.git |
| 40 | + brew install --cask EvanProgramming/overflowbar/overflowbar |
| 41 | + |
| 42 | +The community build is ad-hoc signed and is not notarized. If macOS blocks an app you downloaded from the official release, follow Apple's [Open Anyway instructions](https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unknown-developer-mh40616/mac). |
| 43 | + |
| 44 | +OverflowBar targets macOS 15 and has a universal Apple silicon and Intel build. The macOS 26.4 release check covered a limited native-fixture workflow; macOS 15 hardware and Intel hardware were not available for physical testing. On macOS 27 and later, native icon management fails open and leaves icons accessible. See [installation and compatibility](docs/INSTALLATION.md) and [release validation](docs/RELEASE_CHECKS_V1.5.md). |
| 45 | + |
| 46 | +## Quick start |
| 47 | + |
| 48 | +1. Enable **Accessibility** to arrange selected icons and open their controls. |
| 49 | +2. Optionally enable **Screen Recording** for live icon previews. |
| 50 | +3. In **Choose Icons**, select the status items to move. |
| 51 | +4. Select **Hide Icons & Finish**. |
| 52 | +5. Click **Open OverflowBar** in the menu bar, then choose an icon. |
| 53 | + |
| 54 | +Turn off **Hide selected icons** to restore the selected icons. **Cancel** stops an active operation. **Reset Icon Selection** restores all icons and clears the selection; quitting reveals icons while keeping your saved choices. |
16 | 55 |
|
17 | 56 | ## Documentation |
18 | 57 |
|
19 | | -[Installation](docs/INSTALLATION.md) · [Usage](docs/USAGE.md) · [Architecture](docs/ARCHITECTURE.md) · [Privacy](PRIVACY.md) · [Release process](docs/RELEASING.md) · [Contributing](CONTRIBUTING.md) |
| 58 | +- [Installation](docs/INSTALLATION.md) · [Using OverflowBar](docs/USAGE.md) · [Permissions](docs/PERMISSIONS.md) |
| 59 | +- [Troubleshooting and FAQ](docs/TROUBLESHOOTING.md) · [Homebrew](docs/HOMEBREW.md) · [Privacy](PRIVACY.md) |
| 60 | +- [Architecture](docs/ARCHITECTURE.md) · [Development](docs/DEVELOPMENT.md) · [Contributing](CONTRIBUTING.md) |
| 61 | +- [Documentation index and release evidence](docs/README.md) |
| 62 | + |
| 63 | +## Contributing and license |
| 64 | + |
| 65 | +See the [contributing guide](CONTRIBUTING.md) for development setup and issue reports. Report security issues privately using [GitHub’s security reporting page](https://github.com/EvanProgramming/OverflowBar/security/advisories/new). OverflowBar is distributed under the [GPL-3.0 license](LICENSE); earlier code retains its [original MIT notice](LICENSE-MIT-ORIGINAL). Native-engine provenance is documented in [third-party notices](THIRD_PARTY_NOTICES.md). |
20 | 66 |
|
21 | | -v1.5 adopts [GPL-3.0](LICENSE). Exact Ice/Thaw source pins and local changes are recorded in [third-party notices](THIRD_PARTY_NOTICES.md). Earlier OverflowBar code retains its [original MIT notice](LICENSE-MIT-ORIGINAL). |
| 67 | +The native engine incorporates portions of [Ice](https://github.com/jordanbaird/Ice) and [Thaw](https://github.com/thaw-app/Thaw); see the preserved [licenses and attribution](THIRD_PARTY_NOTICES.md). |
0 commit comments