GitHub Swift Monthly Trending Repositories

permissionlesstech/bitchat

bluetooth mesh chat, IRC vibes

bitchat

A decentralized peer-to-peer messaging app with dual transport architecture: local Bluetooth mesh networks for offline communication and internet-based Nostr protocol for global reach. No accounts, no phone numbers, no central servers. It's the side-groupchat.

bitchat.free

📲 App Store

📲 Play Store

Getting a copy you can trust

Install from the App Store, or build from source you have verified. A compiled build from anywhere else cannot be verified — see Verifying bitchat for how to check source against the per-release hash manifest, and for what to do if that is the only build you can get.

This matters more than it usually would: this repository has been the target of takedown demands, and when a repository or releases page disappears, mirrors appear that nobody can check.

License

This project is released into the public domain. See the LICENSE file for details.

Features

Dual Transport Architecture: Bluetooth mesh for offline + Nostr protocol for internet-based messaging
Location-Based Channels: Geographic chat rooms using geohash coordinates over global Nostr relays
Intelligent Message Routing: Automatically chooses best transport (Bluetooth → Nostr fallback)
Decentralized Mesh Network: Automatic peer discovery and multi-hop message relay over Bluetooth LE
Privacy First: No accounts, no phone numbers, no servers. Note that the mesh does use a persistent per-device identifier derived from your identity key — see the whitepaper on identity and metadata for what a nearby radio can observe
Private Message End-to-End Encryption: Noise Protocol for mesh, BitChat private envelopes for Nostr fallback
IRC-Style Commands: Familiar /slap, /msg, /who style interface
Universal App: Native support for iOS and macOS
Emergency Wipe: Triple-tap to instantly clear all data
Performance Optimizations: LZ4 message compression, adaptive battery modes, and optimized networking

Technical Architecture

BitChat uses a hybrid messaging architecture with two complementary transport layers:

Bluetooth Mesh Network (Offline)

Local Communication: Direct peer-to-peer within Bluetooth range
Multi-hop Relay: Messages route through nearby devices (max 7 hops)
No Internet Required: Works completely offline in disaster scenarios
Noise Protocol Encryption: End-to-end encryption, with forward secrecy for live sessions (store-and-forward mail is sealed without it — see the whitepaper)
Binary Protocol: Compact packet format optimized for Bluetooth LE constraints
Automatic Discovery: Peer discovery and connection management
Adaptive Power: Battery-optimized duty cycling

Nostr Protocol (Internet)

Global Reach: Connect with users worldwide via internet relays
Location Channels: Geographic chat rooms using geohash coordinates
440+ Relay Network: Distributed across the globe for reliability
BitChat Private Envelopes: App-specific encrypted private messages over Nostr relays
Ephemeral Keys: Fresh cryptographic identity per geohash area

BitChat's private-envelope format is proprietary and is not NIP-17, NIP-44, or NIP-59 compatible. It uses Nostr as a relay transport but only interoperates with BitChat clients: private payloads travel inside kind-1059 events whose v2:-prefixed content is a BitChat-specific XChaCha20-Poly1305 construction, not NIP-44 encryption.

Channel Types

`mesh #bluetooth`

Transport: Bluetooth Low Energy mesh network
Scope: Local devices within multi-hop range
Internet: Not required
Use Case: Offline communication, protests, disasters, remote areas

Location Channels (`block #dr5rsj7`, `neighborhood #dr5rs`, `country #dr`)

Transport: Nostr protocol over internet
Scope: Geographic areas defined by geohash precision
- block (7 chars): City block level
- neighborhood (6 chars): District/neighborhood
- city (5 chars): City level
- province (4 chars): State/province
- region (2 chars): Country/large region
Internet: Required (connects to Nostr relays)
Use Case: Location-based community chat, local events, regional discussions

Direct Message Routing

Private messages use intelligent transport selection:

Bluetooth First (preferred when available)
- Direct connection with established Noise session
- Fastest and most private option
Nostr Fallback (when Bluetooth unavailable)
- Uses recipient's Nostr public key
- BitChat's app-specific private-envelope encryption
- Routes through global relay network
Smart Queuing (when neither available)
- Messages queued until transport becomes available
- Automatic delivery when connection established

For detailed protocol documentation, see the Technical Whitepaper.

Setup

Option 1: Using Xcode

open bitchat.xcodeproj

For a signed device build, create your ignored local configuration and replace the example team ID with your Apple Developer Team ID:

cp Configs/Local.xcconfig.example Configs/Local.xcconfig

Local.xcconfig.example derives unique app and App Group identifiers from that team ID. The entitlement files already reference $(APP_GROUP_ID), so tracked project or entitlement files do not need to be edited.

Useful command-line checks from the repository root:

# macOS Debug build without signing
xcodebuild -project bitchat.xcodeproj -scheme "bitchat (macOS)" \
  -configuration Debug CODE_SIGNING_ALLOWED=NO build

# Full SwiftPM test suite
swift test

# iOS simulator tests
xcodebuild -project bitchat.xcodeproj -scheme "bitchat (iOS)" \
  -sdk iphonesimulator \
  -destination 'platform=iOS Simulator,name=iPhone 17' test

If iPhone 17 is unavailable, choose an installed simulator from:

xcodebuild -showdestinations -project bitchat.xcodeproj -scheme "bitchat (iOS)"

Option 2: Using `just`

brew install just
just check
just run

just build and just run use the current bitchat (macOS) scheme and keep Xcode output in the ignored .DerivedData/ directory. They never patch source, project, configuration, or entitlement files.

just clean removes only .DerivedData/ and .build/. It does not invoke Git or restore tracked files, so uncommitted work is preserved. just test runs the SwiftPM suite and just test-ios runs the iPhone 17 simulator suite.

Localization

App localizations live in bitchat/Localizable.xcstrings.
Share extension strings are separate in bitchatShareExtension/Localization/Localizable.xcstrings.
Prefer keys that describe intent (app_info.features.offline.title) and reuse existing ones where possible.
Run xcodebuild -project bitchat.xcodeproj -scheme "bitchat (macOS)" -configuration Debug CODE_SIGNING_ALLOWED=NO build to compile-check any localization updates.

Ebullioscopic/Atoll

Dynamic Island for macOS

Atoll - DynamicIsland for macOS

Join our Discord community

Atoll turns the MacBook notch into a focused command surface for media, system insight, and quick utilities. It stays out of the way until needed, then expands with responsive, native SwiftUI animations.

Highlights

Media controls for Apple Music, Spotify, Cider, and more with inline previews.
Live Activities for media playback, Focus, screen recording, privacy indicators, downloads (beta), and battery/charging.
Lock screen widgets for media, timers, charging, Bluetooth devices, and weather.
Lightweight system insight for CPU, GPU, memory, network, and disk usage.
Productivity tools including timers, clipboard history, color picker, and calendar previews.
Customization for layouts, animations, hover behavior, and shortcut remapping.

Other Features

Gesture controls for opening/closing the notch and media navigation.
Parallax hover interactions with smooth transitions.
Lock screen appearance and positioning controls for panels and widgets.

Requirements

macOS 14.0 or later (optimised for macOS 15+).
MacBook with a notch (14/16‑inch MBP across Apple silicon generations).
Xcode 15+ to build from source.
Permissions as needed: Accessibility, Camera, Calendar, Screen Recording, Music.

Installation

Download the latest DMG here.
Open the DMG and drag Atoll into Applications.
Launch Atoll and grant the requested permissions.

Quick Start

Hover near the notch to expand; click to enter controls.
Use tabs for Media, Stats, Timers, Clipboard, and more.
Adjust layout, appearance, and shortcuts from Settings.
Add files to Shelf from Terminal: open -a Atoll /path/to/file.

Settings

Choose appearance, animation style, and per‑feature toggles.
Remap global shortcuts and adjust hover behaviour.
Enable lock screen widgets and select data sources.

Gesture Controls

Two-finger swipe down to open the notch when hover-to-open is disabled; swipe up to close.
Enable horizontal media gestures in Settings → General → Gesture control to turn the music pane into a trackpad for previous/next or ±10 second seeks.
Pick the gesture skip behaviour (track vs ±10s) independently from the skip button configuration so swipes can scrub while buttons change tracks—or vice versa.
Horizontal swipes trigger the same haptics and button animations you see in the notch, keeping visual feedback consistent with tap interactions.

Troubleshooting (Basics)

After granting Accessibility or Screen Recording, quit and relaunch the app.
If metrics are empty, enable categories in Settings → Stats.
Media not responding: verify player is active and Music permission is granted.

License

Atoll is released under the GPL v3 License. Refer to LICENSE for the full terms.

Acknowledgments

Atoll builds upon the work of several open-source projects and draws inspiration from innovative macOS applications:

Boring.Notch - foundational codebase that provided the initial media player integration, AirDrop surface implementation, file dock functionality, and calendar event display. Major architectural patterns and notch interaction models were adapted from this project.
Alcove - primary inspiration for the Minimalistic Mode interface design and the conceptual framework for lock screen widget integration that informed Atoll's compact layout strategy.
Stats - source implementation for CPU temperature monitoring via SMC (System Management Controller) access, frequency sampling through IOReport bindings, and per-core CPU utilisation tracking. The system metrics collection architecture derives from Stats project readers.
Open Meteo - weather apis for the lock screen widgets
SkyLightWindow - window rendering for Lock Screen Widgets
rtaudio - Live music visualizer using C++ was adapted from this project
SwiftTerm - Terminal tab implementation in the standard mode was adapted from this project
DynamicNotch - thanks DynamicNotch for letting us use their battery huds
Wick - Thanks Nate for allowing us to replicate the iOS like Timer design for the Lock Screen Widget
OpenUsage - LLM Usage Tracking features
OpenRouter - API for getting automated model pricing

Contributors

Star History

Updating Existing Clones

If you previously cloned DynamicIsland, update the remote to track the Atoll repository:

git remote set-url origin https://github.com/Ebullioscopic/Atoll.git

A heartfelt thanks to TheBoredTeam for being supportive and being totally awesome, Atoll would not have been possible without Boring.Notch

_{Backed by}
iOS Development Centre
Powered by Apple and Infosys
SRM Institute of Science and Technology, Chennai, India

Your support helps fund teaching children software development.

nikitabobko/AeroSpace

AeroSpace is an i3-like tiling window manager for macOS

AeroSpace Beta

AeroSpace is an i3-like tiling window manager for macOS

Videos:

Docs:

Key features

Tiling window manager based on a tree paradigm
i3 inspired
Fast workspaces switching without animations and without the necessity to disable SIP
AeroSpace employs its own emulation of virtual workspaces instead of relying on native macOS Spaces due to their considerable limitations
Plain text configuration (dotfiles friendly). See: default-config.toml
CLI first (manpages and shell completion included)
Doesn't require disabling SIP (System Integrity Protection)
Proper multi-monitor support (i3-like paradigm)

Installation

Install via Homebrew to get autoupdates (Preferred)

brew install --cask nikitabobko/tap/aerospace

In multi-monitor setup please make sure that monitors are properly arranged.

Other installation options: https://nikitabobko.github.io/AeroSpace/guide#installation

Note

By using AeroSpace, you acknowledge that it's not notarized.

Notarization is a "security" feature by Apple. You send binaries to Apple, and they either approve them or not. In reality, notarization is about building binaries the way Apple likes it.

I don't have anything against notarization as a concept. I specifically don't like the way Apple does notarization. I don't have time to deal with Apple.

Homebrew installation script is configured to automatically delete com.apple.quarantine attribute, that's why the app should work out of the box, without any warnings that "Apple cannot check AeroSpace for malicious software"

Community, discussions, issues

AeroSpace project doesn't accept Issues directly - we ask you to create a Discussion first. Please read CONTRIBUTING.md for more details.

Community discussions happen at GitHub Discussions. There you can discuss bugs, propose new features, ask your questions, show off your setup, or just chat.

There are 7 channels:

#all. RSS. Feed with all discussions.
#announcements. RSS. Only maintainers can post here. Highly moderated traffic.
#announcements-releases. RSS. Announcements about non-patch releases. Only maintainers can post here.
#feature-ideas. RSS.
#general. RSS.
#potential-bugs. RSS. If you think that you have encountered a bug, you can discuss your bugs here.
#questions-and-answers. RSS. Everyone is welcome to ask questions. Everyone is encouraged to answer other people's questions.

Project status

Public Beta. AeroSpace can be used as a daily driver, but expect breaking changes until 1.0 is reached.

What stops us from 1.0 release:

https://github.com/nikitabobko/AeroSpace/issues/131 Performance. Implement thread-per-application to circumvent macOS blocking AX API.
https://github.com/nikitabobko/AeroSpace/issues/1215 Big refactoring. Rewrite mutable double-linked core tree data structure to immutable single-linked persistent tree. Important for: stability and potential performance
- https://github.com/nikitabobko/AeroSpace/issues/1216 The big refactoring will help us to fix stability issue that windows may randomly jump to the focused workspace
- https://github.com/nikitabobko/AeroSpace/issues/68 The big refactoring will help us to support macOS native tabs
https://github.com/nikitabobko/AeroSpace/issues/278 Implement shell-like combinators. Ignore a lot of crazy fuss in the issue, We are most probably going with the minimal approach to only introduce common shell-combinators: ||, &&, ; and eval command to send multiple commands in one go.
https://github.com/nikitabobko/AeroSpace/issues/1012 Investigate a possibility to use CGEvent.tapCreate API for global hotkeys
- https://github.com/nikitabobko/AeroSpace/issues/28 Maybe it will allow to distinguish left and right modifiers. Maybe not

Big and important issues which will go after 1.0 release:

https://github.com/nikitabobko/AeroSpace/issues/2 sticky windows
https://github.com/nikitabobko/AeroSpace/issues/260 Dynamic TWM

Development

A notes on how to setup the project, build it, how to run the tests, etc. can be found here: dev-docs/development.md

Project values

Values

AeroSpace is targeted at advanced users and developers
Keyboard centric
Breaking changes (configuration files, CLI, behavior) are avoided as much as possible, but it must not let the software stagnate. Thus breaking changes can happen, but with careful considerations and helpful message. Semver major version is bumped in case of a breaking change (It's all guaranteed once AeroSpace reaches 1.0 version, until then breaking changes just happen)
AeroSpace doesn't use GUI, unless necessarily
- AeroSpace will never provide a GUI for configuration. For advanced users, it's easier to edit a configuration file in text editor rather than navigating through checkboxes in GUI.
- Status menu icon is ok, because visual feedback is needed
Provide practical features. Fancy appearance features are not practical (e.g. window borders, transparency, animations, etc.)
"dark magic" (aka "private APIs", "code injections", etc.) must be avoided as much as possible
- Right now, AeroSpace uses only a single private API to get window ID of accessibility object _AXUIElementGetWindow. Everything else is macOS public accessibility API.
- AeroSpace will never require you to disable SIP (System Integrity Protection).
- The goal is to make AeroSpace easily maintainable, and resistant to macOS updates.

Non Values

Play nicely with existing macOS features. If limitations are imposed then AeroSpace won't play nicely with existing macOS features (For example, AeroSpace doesn't acknowledge the existence of macOS Spaces, and it uses emulation of its own workspaces)
Ricing. AeroSpace provides only a very minimal support for ricing - gaps and a few callbacks for integrations with bars. The current maintainer doesn't care about ricing. Ricing issues are not a priority, and they are mostly ignored. The ricing stance can change only with the appearance of more maintainers.

macOS compatibility table

AeroSpace binary runs on: macOS 13+
AeroSpace debug build from sources is supported on: macOS 14+
AeroSpace release build from sources is supported on: macOS 15+ (Requires Xcode 26+)

Sponsorship

AeroSpace is developed and maintained in my free time. If you find it useful, consider sponsoring.

People who have write access

In alphabetical order:

Tip of the day

defaults write -g NSWindowShouldDragOnGesture -bool true

Now, you can move windows by holding ctrl+cmd and dragging any part of the window (not necessarily the window title)

Source: reddit

Related projects

Amethyst - tiling window manager à la xmonad
InstantSpaceSwitcher - Instant space switching by synthesizing trackpad gesture with an artificially high velocity
yabai - a tiling window manager for macOS based on binary space partitioning

jaywcjlove/awesome-mac

 This project is dedicated to collecting high-quality macOS software and organizing them systematically by different categories for easy search and use.

^{Special thanks to:}

ScreenSage Pro, record beautiful screen recordings in minutes on macOS

LIZHI.SHOP - Selected Software. 100% Genuine. Best Deals.

IP.IM Free IP address information query website

^{Using my app is also a way to support me:}

Awesome Mac

This project is dedicated to collecting high-quality macOS software and organizing them systematically by different categories for easy search and use. As it continues to grow, the project has far exceeded our initial expectations and has become more comprehensive and refined.

Feel free to star ⭐ and fork 🍴 to support the project!

If you have any suggestions, ideas, or discover excellent software, feel free to submit a PR to help improve this list. Please read the contributing guidelines before contributing. We also welcome you to continue following this awesome list to build a better macOS tool collection together.

Explanation

中文 | 한국어 | 日本語 | RSS | Awesome Command Line Apps | Awesome Swift macOS Apps

means open source. click the icon to see the item's repository;
means free to use, or free personal license;
means App store hyperlink;
means native app;
means hyperlink to a corresponding Awesome list for the item;

Reading and Writing Tools

Applications to edit text, I suggest the open-source editors

Text Editors

Aurora Editor - Lightweight Code Editor (IDE) for macOS.
Bootstrap Studio - A powerful desktop app for creating responsive websites using the Bootstrap framework.
Brackets - A modern, open source text editor that understands web design.
CodeEdit - A lightweight, natively-built editor. Open source. Free forever.
CotEditor - Lightweight plain-text editor for macOS.
Cursor - AI code editor with autocomplete, chat, and coding agent features.
Emacs - Popular Unix-based text editor for programmers and system administrators.
Haystack Editor - Code editor with a canvas UI for better code understanding.
Helix - A post-modern modal text editor.
Itsypad - A tiny, fast scratchpad and clipboard manager for macOS.
Lapce - Lightning-fast and powerful code editor.
LightTable - The next generation code editor.
LiteEdit - Fast, native macOS code editor under 1 MB — Swift and AppKit, no Electron.
MacVim - the text editor Vim - for macOS.
micro - Modern and intuitive terminal-based text editor.
Neovim - Vim-fork focused on extensibility and usability.
Nova - The beautiful, fast, flexible, native Mac code editor from Panic.
Plain Text Editor - Simple distraction-free notepad.
Sublime Text - Text editor with a fast interface and plugin ecosystem. For more plugins, check Sublime Text Plugins.
SubEthaEdit - Powerful editor for writing, coding, and collaboration anytime, anywhere!
TextMate - Editor that brings Apple's approach to operating systems into the world of text editors.
Tot - Tot is an elegant, simple way to collect & edit text. It’s your tiny text companion!
Vim - An old terminal-based editor. For common plugins, check Vim Common Plugins.
Vimr - Refined Vim Experience for OS X.
Windsurf - AI code editor with agentic coding, autocomplete, and MCP support.
Zed - A high-performance, multiplayer code editor from the creators of Atom and Tree-sitter.

Office

Keynote - Build stunning presentations.
LibreOffice - Free, open-source office software used and tested daily by a large community.
Microsoft Office - Unmistakably Office, designed for Mac.
Numbers - Create impressive spreadsheets.
OnlyOffice - Office suite with document, spreadsheet, and presentation editors.
Pages - Documents that stand apart.
SoftMaker Office - A complete office suite that aims for full compatibility with Microsoft Office documents.
WPS - Is a cross-platform office software suite.

Markdown Tools

Archimedes - Native macOS Markdown editor geared toward mathematical writing with inline LaTeX support.
Edmund - Minimal, native macOS Markdown editor with live preview; works with your existing files, no vault.
EME - Open-source Markdown editor with an interface like Chrome.
iA Writer - Writing app with an emphasis on simplicity and design.
Imark - Open-source Markdown reader that stores your comments inside the document itself as HTML comments.
LightPaper - Simple, beautiful, yet powerful text editor for your Mac.
MacDown - Open source Markdown editor for macOS with live preview and HTML/PDF export.
Marked 2 - This is the Markdown preview with an elegant and powerful set of tools for all writers.
MarkText - Next generation markdown editor, running on platforms of MacOS Windows and Linux.
MarkViewer - Markdown viewer and editor for macOS with AI-assisted editing.
Marp - Markdown presentation writer with cross-platform support.
Marxico - Delicate Markdown editor for Evernote. Reliable storage and sync.
MWeb - Pro Markdown writing, and static blog generator App.
Obsidian - A second brain, for you, forever.
Pixley Reader - Reader for Markdown specs, docs, and changelogs generated by AI tools.
Scratch - Lightweight, offline-first markdown notes app with WYSIWYG editing and local AI agent support.
Typora - Truly minimal Markdown editor featuring seamless live preview.
Ulysses - The Ultimate Writing App for Mac, iPad and iPhone.
Zettlr - A markdown editor for the 21st century.

Note-taking

Affine - Affine is the next-generation collaborative knowledge base for professionals.
Agenda - Date-focused note taking app for both planning and documenting your projects.
Anytype - Local-first note-taking and knowledge management app.
AppFlowy - Open-source alternative to Notion.
Bear Writer - Beautiful, flexible writing app for crafting notes and prose.
Boostnote - Note-taking app made for programmers.
Craft - Notetaking and writing made beautiful.
Dnote - A simple command line notebook with multi-device sync and a web interface.
Email Me - Email yourself and much more with just one tap, native on macOS, iOS and WatchOS.
Evernote - Infamous note-taking app, available on many platforms.
FSNotes - File System Notes is a modern notes manager, native on macOS and iOS.
Gooba - Writing app and task manager with a simple and interactive design.
Inkdrop - Notebook app for Markdown lovers built on top of Electron.
Joplin - Cross-platform open-source notepad with markdown support and to-do list management.
Knopo - Native macOS outliner for local-first notes stored as plain Markdown files.
Logseq - Privacy-first, open-source knowledge base.
MarginNote 4 - In-depth PDF and EPUB reading, learning, managing and note taking app.
massCode - Cross-platform open-source code snippets manager with markdown and mermaid support.
MiaoYan - Lightweight Markdown app to help you write great sentences.
Notable - The markdown-based note-taking app that doesn't suck.
Notebook - Note-taking app.
NoteGen - Open-source, local-first Markdown note-taking app that turns scattered records into structured notes with AI.
Notes - Clean, simple note-taking app.
NotePlan 3 - Your tasks, notes, and calendar, plain-text markdown files.
NotePlus - True Native Note and LLM Client
Noteship - Local-first note-taking app for turning notes into structured knowledge.
Notion - All-in-one workspace for notes, tasks, wikis, and databases.
OATS - Open-source local-first meeting-notes app for macOS with live transcription, speaker labels, AI summaries, and a fully offline on-device mode.
OneNote - Note-taking app by Microsoft.
OutlineEdit 3 - Fully-featured outline editor, for everyone who loves great structured notes.
Revu - Local-first spaced repetition app with FSRS scheduling and Anki import.
Saber - Cross platform stylus and text notetaking app. Supports image and pdf imports, can sync.
SideNotes - Quick notes on the screen side with Markdown support.
Standard Notes - An end-to-end encrypted notes app for digitalists and professionals.
Stik - Quick-capture markdown notes app with hotkeys and AI semantic search.
QOwnNotes - Open-source notepad with markdown support and todo list manager.
Quick Note - Colorful sticky notes in the Menu bar.
Quiver - Mix text, code, Markdown, and LaTeX in one note with live preview.
VNote - Open-source Markdown note-taking app with a polished editor.
Zettel - Minimal, distraction-free note-taking app with Markdown and hashtag-based organization.

Journaling

Day One - Excellent journaling app using text, photos, video, audio, location data, and more.
Journey - Journaling app with many features and with apps for every platform available.
Life Note - Journal with the greatest minds in human history.
linked - Link your thoughts to days, distraction free.

Writing

Retrotype - A fun and minimalist writing app that feels like a real typewriter.
novelWriter - Open-source plain text editor for writing novels with minimal markdown-like syntax.
Scrivener - The quintessential word processor for writers.
THORN - All you need to power personal writing and website building.

Ebooks

Calibre - Free, open-source e-book manager and reader.
BookShelves - Ebook reader and library manager with public-domain books and sync.
Clearview - Tabbed style e-book reader for PDF, EPUB (DRM free), CHM, and MOBI.
iChm - Ebook reader for CHM (Microsoft Compiled HTML help) files.
Kindle App - Amazon official reading app of kindle.
Klib - New way to manage highlights for Kindle and iBooks.
Koodo Reader - All-in-one eBook reader supporting over 15 formats.
Readest - Open-source ebook reader with a clean interface and powerful reading tools.
ReadAny - AI-powered e-book reader with semantic search, chat, and note management.
Scribus - Professional layout and publishing software.
Sigil - Multi-platform EPUB ebook Editor.
Simple Comic - EBook reader for PDF, CBZ, and CBR formats with Live Text search.

RSS

Elytra - A Simple & Private RSS Feed Reader with native rendering for macOS & iOS.
Feedy - An elegant and lightweight RSS client and news reader for your Mac.
Folo 🧡 Next generation information browser.
Leaf - A news reader for managing subscriptions and enjoying daily news.
NetNewsWire - It’s a free and open source feed reader for macOS.
Doughnut - Beautiful, open-source podcast catcher for Mac.
Papr - RSS reader with adjustable typography, keyboard-driven navigation, and highlight export to Readwise, Notion and Obsidian.
ReadKit - Bookmark and RSS management client.
Reeder 5 - News reader for Feedbin, Feedly, Feed Wrangler and so on.
Saga Reader - AI-powered web and RSS reader.
Unread - RSS reader with beautiful typography that supports Feedbin, Feedly and so on.
Vienna - RSS/Atom reader for Mac OS X.

Others

SwifDoo PDF - PDF editor/converter for editing, compressing, and password-protecting PDFs.
bindPDF - Combine multiple PDF files into a single PDF file using a friendly UI.
Capd - Open-source capture and bookmarking app for saving links, text, notes, and images with full-text search.
CHM Reader - Read Compiled HTML (.chm) documents on your Mac.
Chmox - Read CHM documents on your Mac.
Highlights - The PDF Reader for Research on Mac, iPad & iPhone.
PDF Auditor - PDF inspection tool for analyzing metadata, structure, and security risks.
PDF Expert - Read, annotate and edit PDFs, change text and images.
PDF Pals - Chat with PDF app for Mac. No file size limits!
PDFgear - AI-integrated PDF editor.
PDF Reader Pro - You Can view, create, sign, convert and compress any PDF documents.
Skim - PDF reader and note-taker for OS X.
SkyFonts - The simplest way to try, install, and manage fonts.
SmoothCSV - Fast, full-featured CSV editor with SQL queries.
Spillo - Powerful, beautiful and amazingly fast Pinboard client for OS X.
TabType - Free, open-source AI autocomplete for every Mac app — on-device ghost-text suggestions powered by a local LLM (MLX); nothing leaves your Mac.
Tad - Application for viewing and analyzing tabular data such as CSV files.
texifier - Great LaTeX editor for Mac with auto-update PDF and autocomplete LaTeX commands.
UPDF - Free PDF editor for reading, annotating, and editing PDFs.
Zotero - Free tool to collect, organize, annotate, cite, and share research.
Collate - Free tool to collect, summarize and query PDFs with AI. All offline and free.
PDFsail - All-in-one PDF tool for editing, converting, merging, compressing, and OCR.
TableTool - Effortless CSV Browser!
Heynote - A dedicated scratchpad for developers.

Developer Tools

IDEs

Android Studio - The official IDE for Android, based on Intellij IDEA.
Cate - Open-source IDE on an infinite zoomable canvas, with editor, terminal, browser, and AI agent panels arranged in a spatial workspace.
CodeRunner - Lightweight, multi-language programming text editor and IDE.
Deco IDE - The best IDE for building React Native apps.
Eclipse - Popular open-source IDE for Java with plugin support for many languages.
Espresso - The web editor for Mac is back. For people who make delightful, innovative and fast websites.
Fletch - Native IDE for AI coding agents, giving each agent a sandboxed clone of your repository plus a shared symbol and call-graph index, with diff review before merge.
BeagleEditor - A "beagleful" editor with features like syntax highlighting, plugins and... - A bit ugly, but it works
JetBrains Toolbox App - Manage installed JetBrains tools, download new ones and open recent projects.
- AppCode - Smart IDE for iOS/macOS development
- RustRover - A brand new JetBrains IDE for Rust Developers.
- CLion - Powerful C and C++ IDE. (Free for Students)
- DataGrip - Cross-Plaform IDE for Databases and SQL. FREE for Students, check here for more info.
- DataSpell - The IDE for Professional Data Scientists
- GoLand - Provides ergonomic environment for Go development.
- IntelliJ IDEA - Powerful IDE for JVM languages. (Free for Students)
- PHPStorm - The Lightning-Smart PHP IDE.
- PyCharm - Powerful Python IDE, which has professional version and community version.
- Rider - Cross-platform C# IDE with Resharper features.
- WebStorm - The smartest JavaScript IDE by JetBrains. FREE for Students, check here for more info.
Haskell for Mac - A Modern Development Environment for Haskell.
NetBeans IDE - Free, open-source IDE for Java and other languages.
Nimbalyst - A visual workspace for managing AI coding sessions, tasks, and project files.
Nova - Beautiful, fast, flexible Mac code editor from Panic.
Orca - An open-source IDE for running parallel AI coding agents (Claude Code, Codex, Cursor, Gemini, OpenCode), each in its own isolated git worktree.
Trae - AI-powered IDE for coding and software development.
Visual Studio Code - Microsoft's free & open-source editor, TypeScript friendly, VSCode Plugins.
VSCodium - Community-driven libre binaries of VS Code.
Windsurf - The first agentic IDE where developers and AI flow together for a magical coding experience.
Xcode - Essential IDE for iOS/macOS development.
Zed - A high-performance, multiplayer code editor from the creators of Atom and Tree-sitter.
Spyder - Powerful scientific environment written in Python, for Python.

Developer Utilities

AXe - CLI tool for controlling iOS Simulators through Accessibility APIs and HID automation.
BetterRename - The most powerful and complete Mac file renaming application on the market.
Beyond Compare - Compare files and folders with powerful commands.
Bidbar - Manage bash commands from the menu bar and run them with keyboard shortcuts.
Cacher - Cloud-based code snippet manager with Gist sync and multi-platform support.
CodeKit - Web development tool for compiling and auto-refreshing.
CodeMenu - Advanced snippets manager with IDE integration, natural language search, and more.
CoilPad - Native macOS Python scratchpad designed for instant prototyping and interactive learning.
Conduktor - Kafka desktop client.
Swifka - Read-only Kafka monitor for safely inspecting topics, messages, and consumer state.
Configs - Configuration file manager for quickly viewing, editing and managing config files.
CubicBezier - CubicBezier Generator for macOS.
Cutter - Powerful multi-platform reverse engineering tool.
DevHub - Feature-rich offline app for developers.
Dash - Awesome API documentation browser and code snippet manager.
Deeplink Buddy - Deeplink managers, made by developer for developers.
DiffMerge - Application to visually compare and merge files.
EnvPane - OS X preference pane for environment variables.
FinderGo - Open terminal quickly from Finder.
Tintpad - Menu bar launcher that opens your terminal at the right repo with a coding agent (Claude Code, Codex) already running.
FlyEnv - Local development environment manager for languages, databases, and services.
Finicky - Set rules to decide which browser opens each link.
Gas Mask - Simple hosts file manager for Mac OS X.
Gemini - Intelligent duplicate file finder.
GraphCode - Runs coding-agent sessions as a graph, where each node is a live terminal you can attach to mid-run and each edge a hand-off that fires unattended. Claude Code, Copilot CLI, Codex.
Hex Fiend - Fast and clever open source hex editor.
Hosts.prefpane - System preference pane to manage your hosts file.
Icon Preview - Preview your app icon and menu bar icon.
iHosts - The only /etc/hosts editor on Mac App Store.
Itsyconnect - App Store Connect client for metadata, TestFlight, reviews, analytics, and localization.
SaneHosts - Hosts-based ad and tracker blocker.
ILLA Cloud - Low-code internal tool builder.
ImHex - Hex Editor for reverse engineers and programmers.
Integrity - Free website link checker for Mac.
JsonStudio - Local-first JSON workspace for formatting, editing, diffing, converting, validating, and extracting JSON from logs.
Kaleidoscope - Compare text, images, and folders.
Koala - GUI application for Less, Sass, Compass and CoffeeScript compilation.
Loca Studio - Analyze, review, and edit app translations.
LINQPad - .NET scratchpad for running code, queries, and database exploration.
Loupe - Accessibility inspector that generates AI-agent-ready output.
MacSystemColors - Mac app that shows all system colors in light and dark mode for Cocoa developers.
Medio - A native, lightweight text diff tool with a clean UI and real-time highlighting.
MJML - Create responsive emails with a semantic syntax and rich components.
NameQuick - AI-powered file renaming tool for macOS
PaintCode - Vector drawing app that generates Objective-C or Swift code in real time.
Pasteboard Viewer - Inspect the system pasteboards.
Poirot - Companion app for browsing Claude Code sessions, reviewing diffs, and rerunning commands.
Muxy - AI-native GUI for managing AI coding sessions, projects, with split panes, Git integration, and AI usage tracking.
PortKiller - Tool for inspecting ports, managing forwards and tunnels, and stopping bound processes.
PPRows - Application to calculate how many lines of code you write.
ProcessSpy - A clean and powerful process monitor.
PushMate - Solves common push notification problems on macOS.
Responsively - A must-have devtool for web developers for quicker responsive web development.
SCM Breeze - Set of shell scripts (for bash and zsh) that enhance your interaction with git.
SecureCRT - Terminal emulation which supports SSH, Telnet or other protocols.
Site Sucker - Automatically downloads websites.
SnippetsLab - Easy-to-use code snippets manager.
Solarized - Clean and beautiful color theme. Works well with iTerm, JetBrains products, Vim etc.
SSH Keys Manager - Native macOS app for managing local SSH keys and Git identities.
StarUML - Powerful UML app.
Swiftify - Objective-C to Swift code converter and Xcode & Finder extensions.
SwiftPlantUML - Generate and view class diagrams from Xcode for Swift code.
SwitchHosts - Free and open-source app for hosts management & switching.
Switzy - Open-source tool for switching Git identities and managing SSH keys.
SYM - GUI Application to symbolicate iOS crash log.
Testpiler - Tool for converting XCTest test suites to Swift Testing.
TeXstudio - Integrated writing environment for creating LaTeX documents.
Touch Bar Simulator - Use the Touch Bar on any Mac.
Visual Paradigm - All-in-one UML, SysML, BPMN modeling platform.
Woodpecker - View iOS app's Sandbox files, UserDefaults, Keychain items on a Mac.
WWDC - The Mac OS unofficial WWDC app.
Xcodes - Install and switch between multiple versions of Xcode.
XCSnippetsApp - Explore, view, and edit Swift and iOS code snippets for Xcode.
zeplin - Collaboration tool for work between designers and developers.
ZOC Terminal - Terminal emulator which supports SSH, telnet, connections and other protocols.
Nib Unlocker - .nib to .xib converter

Regular Expression Editors

Patterns - Regular expression editor.
Regex - Regular expression testing tool with an emphasis on simplicity.
RegExRX - Development tool for regular expressions.
RegexMate - A regular expression testing tool with a built-in quick reference guide.

API Development and Analysis

bruno - Bruno is a offline-only, fast and git-friendly opensource API client.
Cocoa Rest Client - Free, open-source, native Apple OS X app for testing HTTP/REST endpoints.
Echolon - Open-source API client and Postman alternative.
HTTPie - HTTPie is making APIs simple and intuitive for those building the tools of our time.
Hoppscotch - A lightweight, fast, and full-featured API debugging tool.
Insomnia - The most intuitive cross-platform REST API Client.
Katalon Studio - Simplify API, Web, and Mobile Automation Tests.
Maestro - End-to-end testing framework for mobile and web apps.
Mockoon - Create mock APIs in seconds.
Paw - Advanced HTTP client.
Postman - GUI platform for API development.
Reqable - Next-Gen API Development Tool, Advanced API Debugging Proxy and REST Client.
ReqRes - Native macOS app to monitor, debug, and mock HTTP(S) requests and responses.
Requestly - Open-source, lightweight Git-Friendly API Client built for modern developers.
Trayce - Lightweight tool to monitor Docker container traffic with a built-in .bru HTTP client.
Yaak - A modern API client supporting multiple protocols, offline usage, and Git integration.

Network Analysis

Charles - HTTP proxy/monitor to view HTTP and HTTPS traffic.
James - Open-source proxy tool for checking and mapping requests with http as well as https.
Little Snitch - Network monitor with a world map for visualizing network connections.
mitmproxy - Interactive intercepting HTTP proxy for penetration testers and software developers.
Proxie - HTTP debugging proxy.
Proxyman - Modern and intuitive HTTP debugging proxy for macOS.
Rockxy - Open-source HTTP(S) debugging proxy for intercepting, inspecting, modifying, and replaying requests.
Sniffnet - Application to comfortably monitor your network traffic.
WiFi Lens - Native open-source Wi-Fi analyzer and network diagnostics app with real-time spectrum scanning, channel congestion visualization, and BLE device tracking.
Wireshark - The world’s foremost and widely-used network protocol analyzer.
Apidog - All-in-One workspace for API Design, Documentation, Debug, Mock, Test.

Frameworks For Hybrid Applications

AppJS - Lightweight JavaScript UI library for creating mobile webapps that behave like native apps.
DMG Maker - DMG creation tool with polished visuals and CLI support.
create-dmg - Create a good-looking DMG for your macOS app in seconds.
Rilmazafone - Design DMG installers on a WYSIWYG canvas and build exactly what you drew, no scripts.
Electrino - Desktop runtime for web apps using the system's browser engine.
Electron - Build cross platform desktop application with JavaScript, HTML and CSS.
ionic - Build native and web apps with Angular and open web technologies.
MacGap - Lightweight JavaScript API for OS X integration.
nw.js - Build desktop apps with HTML and JavaScript.
Qt - Cross-platform application framework.
React Native for Ubuntu - Build Ubuntu desktop apps using React Native.
React Native macOS - Build OS X desktop apps using React Native and Cocoa.
react-desktop - React UI Components for macOS Sierra.
ReactXP - Microsoft platform for Web, iOS, Android, and Windows UWP.
Tauri - Create small, fast, secure, cross-platform applications

Version Control

Cornerstone - Powerful version control with a gorgeous interface.
Fork - Fast and friendly Git client for Mac.
Git Cola - Powerful, Fast, Lightweight and Friendly Git GUI. For those caffeine adicting users.
Gitbar - Open-source，display GitHub contribution statistics on your menu bar.
GitButler - Change management with parallel and stacked branches, unlimited undo, agent integrations.
GitFinder - Fast and lightweight Git client for Mac with Finder integration.
Gitfox - Commit faster, improve your code quality with superior diffs - and look good doing it.
GitHub Desktop - The official GitHub GUI.
GitKraken - The most popular Git GUI for Windows, Mac and Linux.
GitUp - A simple & powerful Git client。
GitX-dev - Fork of Pieter's nice git GUI for OS X. Includes branch/tag sidebar and various fixes.
Hub - Command-line wrapper for Git that makes you better at GitHub.
RelaGit - The elegant solution to graphical version control. Built by developers, for developers.
SmartGit - Git client with support.
SourceTree - Free Git & Mercurial client for Windows or Mac.
Sublime Merge - Git client, from the makers of Sublime Text.
Changes - GUI Git client. Replace the Git CLI with a clear UI and AI assist.
Tower2 - The most powerful Git client for Mac and Windows.
Vershd - The free for personal use effortless Git GUI, for Windows, Mac, & Linux.
Versions - Mac Subversion (SVN) Client.

Virtualization

Docker - Powerful, performs operating-system-level virtualization.
Berthly - Native GUI for Apple's container tool, with menu bar monitoring and drag-and-drop image builds.
Gantry - Docker management client for local and SSH remote hosts with built-in MCP server support for agent workflows.
Cocoa-Way - Wayland compositor for running Linux GUI apps without a virtual machine.
GhostVM - Virtualization tool for creating and managing isolated macOS virtual machine workspaces.
MacVirtue - Run free and unlimited Virtual Machines on your Mac.
Mocker - Container manager built on Apple's Containerization framework.
Multipass - Ubuntu VMs on demand for any workstation.
OrbStack - Fast, light, and simple way to run Docker containers and Linux machines on macOS.
Parallels - Powerful, easy-to-use VM. No free upgrade for each new Mac OS.
Podman Desktop - Open-source graphical tool for managing containers and Kubernetes.
Rancher Desktop - Container management and Kubernetes on the desktop.
Lima - Lima launches Linux virtual machines with automatic file sharing and port forwarding.
QEMU - A free and open-source emulator and virtualizer that can perform hardware virtualization.
UTM - UTM is an easy-to-use GUI for QEMU and can run ARM64, x64 and other VMs on M1 Macs.
Vagrant - Tool for building and distributing development environments.
Veertu - The lightest VM on Mac. Responsive, sandboxed & native way to run VM on your Mac.
Virtual Box - Powerful x86 and AMD64/Intel64 virtualization product.
VMware Fusion - Powerful, commercial VM developed by VMware.

Databases

Apache Directory Studio - LDAP browser and Active Directory client.
Another Redis Desktop Manager - A faster, better and more stable redis desktop manager.
Base 2 - Application for creating, designing, editing and browsing SQLite 3 database files.
Beekeeper Studio - Smooth SQL editor and database manager
Bdash - Modern SQL client application, supports MySQL, PostgreSQL (Redshift) and BigQuery.
Chrome MySQL Admin - Powerful Chrome app to manage your MySQL.
Core Data Editor - Core Data Editor lets you easily view, edit and analyze applications‘ data.
Dataflare - Simple database client supporting Postgres, MySQL, DuckDB, libSQL, Cloudflare D1, and more.
DB Browser for SQLite - Official home of the DB Browser for SQLite.
DBeaver - Universal SQL Client.
DB Pro - Database client for querying and managing SQL databases.
ElectroCRUD - Modern MySQL CRUD application.
FastoNoSQL - Cross-platform GUI client for various key-value databases.
FastoRedis - Cross-platform professional GUI management tool for Redis.
JackDB - Secure, collaborative environment for your queries and data-driven insights.
MDB Explorer - MDB tool to open, read, export your MDB files to other formats and databases.
Medis - GUI Manager for Redis.
Mingo - Easy to use MongoDB GUI with mind-blowing features.
mongoDB.app - The easiest way to get started with mongoDB on the Mac.
MongoDB - Scalable, flexible document database with querying and indexing.
MySQL Workbench - The official MySQL GUI.
Navicat Data Modeler - Cost-effective database design tool for high-quality data models.
neo4j - The leading graph database!
Paul - AI-first PostgreSQL client for getting fast answers from your database with read-only access by default.
pgMagic🪄 - Chat to Postgres in natural language or SQL.
pgModeler - pgModeler is an open source data modeling tool designed for PostgreSQL.
Postgres.app - The easiest way to get started with PostgreSQL on the Mac.
Postico - Modern PostgreSQL client for Mac.
PSequel - PostgreSQL GUI tool for Mac OS X.
Redis Insight - Official Redis tool for browsing, debugging, and visualizing data.
RedisClient - Redis client application on mac, windows and linux.
RedisDesktopManager - Cross-platform GUI management tool for Redis.
Sequel Pro - MySQL database management for Mac OS X.
Sequel Ace - The maintained "sequel" to the longtime macOS tool Sequel Pro.
SQLight - SQLite database manager tool.
SQLPro Studio - Simple, powerful database manager for macOS.
Studio 3T - the Ultimate GUI for MongoDB.
SurrealDB - A scalable, distributed, collaborative, document-graph database, for the realtime web.
TablePlus - Supports: PostgreSQL, MySQL, RedShift, MariaDB... High-end security ensured.
TablePro - Fast database client with AI-assisted SQL editing and support for major SQL/NoSQL engines.
TrailBase - Open-source backend platform with type-safe APIs, auth, and admin tools built on SQLite.
redis-pro - Small, easy to use Redis management, written with SwiftUI, support Dark mode.

Terminal Apps

alacritty - A cross-platform, GPU-accelerated terminal emulator.
Awal Terminal - AI-native terminal emulator with multi-provider profiles and voice input.
Command Book - A terminal companion for long-running terminal commands (freemium)
electerm - Terminal, SSH, and SFTP client.
Ghostty - Fast GPU-accelerated terminal emulator.
hyper - A terminal built on web technologies.
iTerm2 - iTerm2 is an amazing terminal emulator for OS X.
kitty - A cross-platform, fast, feature full, GPU based terminal emulator.
KubeSwitch - The fastest way to switch between Kubernetes contexts and namespaces on macOS.
Tabby (formerly Terminus) - Free terminal tool, built with TypeScript, heavily inspired by Hyper.
Termius - A beautiful SSH and SFTP client for Mac. It is also available for mobile.
tty7 - A GPU-rendered, daemon-backed terminal in pure Rust with sessions that stay alive without tmux.
Vesta - Native macOS terminal built on libghostty for running coding agents in parallel.
Warp - Warp is a blazingly fast, rust-based terminal reimagined from the ground up to work like a modern app.
Wave - Open-source terminal with built-in file previews, web browsing, and AI tools.
WezTerm - A GPU-accelerated cross-platform terminal emulator and multiplexer implemented in Rust.

Design and Product

Design Tools

Acorn - Great Mac OS X picture and photo editor, built for humans.
Affinity Designer - Professional graphic design software for Mac.
Affinity Photo - Professional image editing software for Mac.
Alchemy - Experimental, open-source drawing application with an emphasis on creating conceptual art.
Amadine - Vector drawing app with an intuitive interface for graphic designers.
Art Text 3 - Graphic design software for lettering, typography, and text effects.
Blender - Free and open 3D creation software.
Colorpicker - Colorpicker is a complete open-source colors manipulation tool with picking!
darktable - darktable is an open source photography workflow application and raw developer.
Droply - Offline batch background remover for images.
Draw.io Drawio is a diagramming and whiteboarding desktop app
Figma - The collaborative interface design tool, for vector graphics and UI prototyping.
FontForge - Free, open-source font editor.
GIMP - The GNU Image Manipulation Program.
inklet - Turn your Mac trackpad into drawing board.
Inkscape - Professional vector graphics editor.
ItsPaint - Native paint and screenshot markup: step badges, pixelate redaction, Instant Alpha. No account or telemetry.
Krita - Open-source digital painting software for concept artists, digital painters, and illustrators.
macSVG - Designing HTML5 SVG art and animation.
MagicaVoxel - Free, lightweight 8-bit voxel editor and interactive path tracing renderer.
MakeHuman - Powerful and free 3D human modeler.
Monodraw - Powerful ASCII art editor designed for the Mac.
Nik Collection - Nik Collection by DxO.
Paintbrush - Bitmap image editor.
Pencil2D - A easy, intuitive tool to make 2D hand-drawn animations.
Pixelmator - Full-featured image editor for Mac.
Pixen - Native pixel art and animation editor for Mac.
Principle - Application for designing animated and interactive user interfaces.
Pika - An open-source color picker app.
RawTherapee - A powerful cross-platform raw photo processing program!
ScreenToLayers - Easily export your screen into a layered PSD file.
Sketch - Professional digital design for mac.
- Sketch Cache Cleaner - Deletes hidden Sketch history files.
- Measure Plugin - Make it a fun to create spec for developers and teammates.
- Sketch Toolbox Plugin Manager - Simple plugin manager for Sketch.
- User Flows Plugin - Generating flow diagrams from Artboards.
SketchBook - Drawing software for concept design, comic art, and digital sketching.
Sparkle - Pro visual web design.
System Color Picker - The macOS color picker as an app with more features.
Tayasui Sketches - Professional drawing software.
Vectornator: Design Software - The Most Intuitive and Precise Illustration Software in the Galaxy.
Vectr - Free graphics editor used to create vector graphics easily and intuitively.
Nugget - Video editing software designed for motion effects and versatility.
Lunacy - Vector design tool with built-in assets and real-time collaboration.

Prototyping and Mind-Mapping Tools

Adobe XD - Tool for designing and prototyping websites and mobile apps.
Axure RP 8 - Prototypes, specifications and diagrams in one tool.
Balsamiq Mockups - Wire-framing tool that helps you work faster and smarter.
Flinto - Quickly create interactive prototypes of mobile, desktop, or web apps.
Framer - Tool for interactive prototyping.
Justinmind - Prototyping platform for web and mobile apps.
Kite - Powerful animation and prototyping application for Mac & iOS.
Lighten - The best way to clarify thinking, boost productivity, brainstorm, and visualize concepts.
Marvel - Simple design, prototyping and collaboration.
MindNode - Mind-mapping software with an emphasis on simplicity and ease-of-use.
MockFlow - Online prototyping suite for web-design and usability testing.
Mockplus - Prototype faster, smarter and easier.
OmniGraffle - Diagramming and graphic design for Mac, iPhone, and iPad.
Origami Studio - Tool for designing modern interfaces, built and used by designers at Facebook.
pencil - Free, open-source tool for making diagrams and GUI prototyping.
ProtoPie - Create the most advanced prototypes as easy as Pie.
QuikFlow - Create flowcharts with a mind-mapping workflow.
Scapple - Practical mind-mapping software with free whiteboard-like layout.
SimpleMind - The world leader in cross platform Mind Mapping tools.
WriteMapper - Get from idea to final draft in no time.
XMind - The most popular mind-mapping tool on the planet.
Simple Diagrams - Diagramming tool for quick hand-drawn-style sketches.
yGraph Editor - High quality diagrams made easy.

Screenshot Tools

capcap - Native menu bar screenshot tool with double-tap Command capture, annotation, scrolling capture, beautify, pinning, and image-host upload.
CleanShot X - Discover a superior way to capture your Mac's screen.
CloudApp - Work at the speed of sight.
Dropbox - Dropbox app offers easy screenshot capturing and sharing
Flameshot - Powerful yet simple to use screenshot software.
Lightshot - The fastest way to take a customizable screenshot.
macshot - Screenshot and annotation tool with screen recording, scrolling capture, and OCR.
Scap - Screenshot annotation and canvas tool with blur, mosaic, and watermark features.
Shottr - Screen capture application with features like Scrolling capture, OCR and markup.
Skitch - Screen capture application with a powerful annotation capabilities.
Snip - Application for sharing captured images on QQ Mail.
Snipaste - Simple but powerful snipping tool.
Teampaper Snap - Let your screenshots speak up.
Tuji - Take a screenshot, annotate it, and beautify it.
Xnip - Handy Screenshot App.

Screen Recording

BetterCapture - Free and open source screen recorder with professional encoding support.
Capty - Screen capture and recording tool with built-in editing and annotations.
Capso - Open-source screenshot and screen recording tool with annotations, OCR, and webcam overlays.
Gifox - Gif Recording and Sharing.
Kap - Open-source screen-recorder built with web technology.
KeyCastr - KeyCastr, an open-source keystroke visualizer.
Kyapchar - Simple screen and microphone audio recorder for Mac.
Licecap - Screen recorder that exports directly to GIF.
Monosnap - Make screenshots. Draw on it. Shoot video and share your files. It's fast, easy and free.
OBS Studio - A free and open source software for live streaming and screen recording.
OpenScreen - Open-source tool for creating polished screen demos and walkthrough videos.
Quick Recorder - A lightweight and high-performance screen recorder for macOS
Recordly - Open-source screen recorder and editor for polished demos, tutorials, and product videos.
Reframed - Screen recorder with a built-in editor.
Screen Studio - Screen recorder for polished videos with automatic motion effects.
ScreenKite - Native screen recorder and editor with auto-zoom, AI enhancements, device mockups, and teleprompter.
ScreenSage Pro - A screen recording tool for creating polished videos in minutes.
Screenize - Open-source screen recorder with auto-zoom, cursor effects, and timeline editing.
Screenpipe - Local screen and microphone recorder with AI search.
Snagit - Screen Capture and Recording Software. Simple and Powerful.
Tight Studio - Screen recorder with smart zoom, captions, and AI voiceovers.
Zappy - Zappy is a screenshot and screen recording app all in one. Has some simple editing tools built in.

Other Tools

Amazing AI - Generate images from text using Stable Diffusion.
APNGb - PNG image assembler/disassembler app.
Aspect - Photo organization app with peer-to-peer sync.
Assetizr - Resizing images and optimising them for web and mobile applications.
Lap - Local photo manager for browsing and organizing personal media libraries offline.
Couleurs - Simple app for grabbing and tweaking the colors you see on your screen.
CompressO - Open-source tool for compressing videos and images to smaller sizes.
Diffusion Bee - The easiest way to generate AI art on your computer with Stable Diffusion.
Eagle App - Asset manager for images, videos, audio, fonts, and design files.
ExifCleaner - Remove exif metadata from images and videos with drag and drop.
HEIC Converter - Convert HEIC images to JPEG or PNG.
Iconset - Free, cross-platform and fast SVG icon organizer and manager for Mac and Windows.
Iconjar - Icon management tool to organize or search your icons.
IconKit - App icon generator.
Image2icon - Create and personalize icons from your pictures.
ImageAlpha - Compress images with PNG format and remove transparency.
ImageOptim - Compress images and remove EXIF information.
iPic - Easily upload images with Markdown supported.
JPEGmini - Reduce image size by up to 80%, without compromising quality.
Mark Man - Measure & Spec Fast.
Mottie - A native Lottie animation player with Quick Look extension for dotLottie files.
Nucleo - Icon manager. Import, export, customize and convert icon libraries.
Preset Brewery - Tool to convert Lightroom presets to Adobe Camera Raw.
qView - qView is an image viewer designed with minimalism and usability in mind.
Resize Master - Batch resize and watermark your images fast and easy.
RightFont - Preview, sync, install and manage fonts on Mac, Dropbox or Google Drive.
Snagit - Simple, Powerful Screen Capture Software and Screen Recorder.
svgus - Organize, clean and transform your SVGs.
TinyPNG4Mac - Open-source tool to compress images.
Tropy - Research Photo Management.
PicGo - Support for common cdn image hosting tool.
AppIconBuilder - Export icons for multi-platform
uPic - macOS native app, powerful terse image hosting client.
Zipic - Batch image compression tool with presets and automation.

AI Tools

Agent Teams AI - Open-source desktop app for coordinating autonomous AI coding agents through team messaging, task boards, and code review.
Agenttrace - Local-first TUI for inspecting AI coding agent sessions, costs, tokens, latency, tool failures, health, and diffs.
AppleAi - Access multiple AI assistants from your menu bar with one shortcut.
Apple On-Device OpenAI - Runs Apple on-device models behind an OpenAI-compatible API.
AQBot - Open-source desktop AI workspace for multi-provider chat, agent workflows, knowledge bases, MCP tools, and an OpenAI-compatible API gateway.
Atomic Chat - Open-source AI chat client for local and cloud models with MCP support.
BitFun - Open-source AI agent that gives each task its own interactive workspace with chat linked to live state.
BoltAI - A beautiful & powerful ChatGPT app for Mac. Stay ahead by integrating AI into your workflow today.
ChatGPT - A conversational AI system that listens, learns, and challenges
Claude - Your AI partner on desktop. Fast, focused, and designed for deep work.
Claude God - Monitor Claude usage, costs, and session stats.
Claude Usage - Menu bar app for Claude Code that keeps per-pane context (in the status line) and session/weekly usage always visible — no usage or context command to run.
Claude Usage Monitor - Track Claude usage with a live counter.
Claudoscope - Tool for browsing and analyzing Claude Code sessions.
ClawdHome - Manage multiple isolated OpenClaw gateway instances from one control panel.
clawpypaste - Menu bar block picker and session browser for Claude Code.
Cherry Studio - A desktop client that supports multiple large language model (LLM) providers.
Chatbox - User-friendly Desktop Client App for AI Models/LLMs (GPT, Claude, Gemini, Ollama...).
CodexBar - Show usage stats for OpenAI Codex and Claude Code, without having to login.
Cursor Voice - Voice assistant that lives by your cursor, sees your screen, and can control apps via the OpenAI Realtime API.
Desktop Control - GPU-accelerated CLI for AI agents to control any macOS app via screen, mouse, and keyboard.
Fazm - Open-source voice-controlled AI agent for apps, files, and workflows.
Flock - Terminal multiplexer for running multiple Claude Code and shell sessions in one workspace.
Fluent - AI assistant that works across apps with model and context integration.
Gemini Collector - Back up Google Gemini conversations, attachments, and AI-generated media locally as JSON.
GroAsk - Menu bar launcher that sends selected text to AI assistants and CLI agents.
RecurseChat - Local-first AI chat app with customizable workflows.
Runtime - AI taskmate and take control of the web & your office tools
TokenMeter - Track Claude Code usage, rate limits, costs, and activity heatmaps.
TokenTracker - Local-first menu bar app and CLI that tracks token usage and cost across 20+ AI coding tools.
Tura - Tura is a local, open-source coding agent for developers who are tired of vague skill claims, token-saving extensions with no evidence, and agents that change a repository before understanding it.
Usage4Claude - Real-time monitoring of Claude usage quotas across time windows and plans.
Jan - An open-source alternative to ChatGPT that runs entirely offline on your computer.
LingShu - Open-source, model-agnostic macOS agent for verified code, documents, slides, and computer actions.
LokalBot - On-device meeting notes, dictation, inline autocomplete, and searchable work memory for macOS.
Maestro - Multi-agent AI coding tool with spec-driven workflows.
MiniClaw - Local-first personal AI agent with memory and automation tools.
Off Grid AI Desktop - Private, local-first AI for your Mac: local LLM chat, image generation, voice dictation, and memory search, all on-device.
Orchard - MCP server that connects AI assistants to Apple apps.
Prevail - Local-first AI life OS: any model per life-domain over a plain-markdown vault on your Mac. Signed and notarized.
Witsy - desktop AI assistant / universal MCP client.
remio - Local-first AI chat client that answers from your knowledge base.
Warden - A Native Swift macOS app that lets you run multiple LLM models using your own API keys.

Communication

Collaboration and Team Tools

Adium - Free instant messaging application for Mac OS X. Connect to AIM, MSN, SMPP, Yahoo and more.
BlurScreen App - Instantly blur sensitive on-screen content for recording or screen sharing.
Caprine - Third-party privacy-focused Facebook Messenger app.
DingTalk - Team communication and collaboration platform.
Discord - Voice, text, and community chat platform.
Element - Create, share communicate. Chat and call securely.
Ferdium - Messaging workspace that combines multiple web apps in one place.
Franz - Messaging app that combines multiple chat services in one place.
Gitter - Chat platform for developers and GitHub communities.
Keybase - Secure groups, files, and chat for everyone!
Krisp - An AI-powered noise cancelling app that mutes background noise during calls.
Lark - The Next-Gen Collaboration Suite. All your chats, meetings, calendars, docs, and emails in one place.
LimeChat - Open-source IRC client for Mac OS X.
Mastodon - Your self-hosted, globally interconnected microblogging community
Matrix - An open network for secure, decentralised communication!
Mattermost - Open-source team collaboration platform.
Misskey - 🌎 A completely free and open interplanetary microblogging platform 🚀
Muzzle - A simple mac app to silence embarrassing notifications while screensharing.
Presentify - A mac app to draw on your screen while on calls, highlight your cursor, and more.
Rambox - Messaging and emailing app that combines common web applications into one.
Signal Desktop - Fast, simple, secure. Privacy that fits in your pocket.
Slack - Awesome tool for team collaboration and communication.
Stack - Workspace browser for organizing multiple web apps on one screen.
Teams - Free online meetings and video calls
Teambition - Team collaboration tool for tasks, schedules, files, and discussions.
Telegram - Messaging app with a focus on speed and security.
Textual - Internet Relay Chat (IRC) client.
Unite - The only native GroupMe app for Mac.
Wavebox - Browser workspace for organizing web apps and team tools.
WeChat - Official WeChat app for Mac.
WeeChat - The extensible command-line chat client.
WhatsApp Desktop - Available in the Mac App Store, Whatsapp for Desktop.
Mezon - A new way to communicate with your team. It's free, faster, better organized, better for WFH.

Email Clients

Airmail - Fast email client. For both Mac OS and iOS.
CanaryMail - Secure email app for Mac and iPhone with built-in PGP Support and AI assistance.
ElectronMail - An Electron-based unofficial desktop client for ProtonMail.
Foxmail - Fast email client.
MailTags - Use tags to organize email and schedule.
Mailspring - A beautiful, fast, and fully open source mail client.
N1 - Extensible, open-source mail app, free for developers and $7/month for Pro.
Nylas Mail - Extensible desktop mail app built on the modern web.
Polymail - Simple, beautiful and powerful email client.
Postbox - Powerful, simple and beautiful email client, need to pay for a license.
Spark - Fast email client. For both Mac OS and iOS.
ThunderBird - Software that makes email easier.
Tutanota - Encrypted email focused on security and privacy.
Edison Mail - A customisable, simple, and beautiful email client.
Skiff Mail - Encrypted & Decentralized Email -- available on web, iOS/Android, and macOS.

File Sharing

Cyberduck - Free FTP, SFTP, WebDAV, S3, Backblaze B2, Azure and OpenStack Swift browser.
Dropshare - File sharing tool for screenshots, screen recordings, and other files.
Flow - Award-winning, beautiful, fast, and reliable FTP + SFTP client.
LocalSend - An open-source cross-platform alternative to AirDrop.
NearDrop - An unofficial Google Nearby Share/Quick Share app for macOS.
Rclone UI - The GUI for Rclone & S3.
Transmit - Highly flexible and intuitive FTP client, supports SFTP, S3 and iDisk/WebDAV.

Data Recovery Tools

Data Rescue - Comprehensive and professional data recovery tool for most cases.
DiskWarrior - The world’s most advanced repair and recovery tool for Mac.
R-Studio for Mac - Data recovery tool for damaged, deleted, or formatted disks.
SuperDuper! - Painless fully bootable disk backups.
Disk Drill - Free data recovery tool. Also has a PRO version.

Audio and Video Tools

Adapter - Free audio, video and image conversion software.
Aegisub - Open-source subtitle editor with timing and styling tools.
Audio Profile Manager - Audio device manager for saving input and output setups.
Ardour - Cross-platform audio software for multi-track recording and editing.
Audacity - Free, open-source, cross-platform audio software for multi-track recording and editing.
Audio Hijack - Record any application's audio, including VoIP calls from Skype, web streams from Safari, and much more.
BeMyEars - Live captioning tool with on-device transcription and multilingual support.
BlackHole - Freemium, open-source virtual output/input audio driver for recording/routing internal audio.
Camera Preview - Preview your webcam, take photos, and use it as a mirror.
Carol - A minimal and beautiful lyrics app for macOS.
Cog - Free, open-source audio player.
DaVinci Resolve - Free, cross-platform video editing, color grading, video effects and audio editing software.
Elmedia Player - Media player with broad audio and video format support.
Fader - Menu bar volume mixer with per-app volume, one-click output switching, and Bluetooth headphone control.
FineTune - Per-app volume controller with multi-device output and 10-band EQ.
FreeTube - Open source desktop YouTube client built with privacy in mind.
Gifski - Convert videos to high-quality GIFs.
HandBrake - Video transcoder for converting media to modern formats.
Hydrogen - Professional yet simple and intuitive pattern-based drum programming for GNU/Linux.
ffWorks - Comprehensive Media Tool for macOS. Making High Quality Video Encoding Accessible for Everyone.
IINA - The modern video player for macOS. Based on mpv, the powerful media player project.
Jellyfin - The Free Software Media System.
Kaset - Native YouTube Music client for macOS.
Kodi - Open-source media center for video, music, pictures, and more.
LMMS - Open-source digital audio workstation for music production.
LosslessCut - Cross platform tool for quick and lossless video and audio trimming using ffmpeg.
LyricGlow - Synced lyrics player with word-by-word glow effects.
LyricsX - Lyrics for iTunes, Spotify and Vox.
MacMusicPlayer - A clean, lightweight music player for macOS users.
MacYTDL - A macOS GUI front-end for the youtube-dl video downloader.
Marker Data - The avant-garde Marker extraction application crafted for Final Cut Pro.
Metadatics - Advanced Audio Metadata Editor.
Mp3tag - A powerful and easy-to-use tool to edit metadata of audio files.
Mixxx - The most advanced free DJ software.
Movie Catcher - Tool for finding, streaming, and offline downloading movies.
mpv - Free, open-source, and cross-platform media player.
MuseScore - Free, open-source music notation software.
Museeks - A simple, clean and cross-platform music player.
Muxie - Last.fm scrobbler for Apple Music, Spotify Desktop, iPod Classic, Rockbox devices and some others.
Natron - Open-source node-based compositing software.
Nuclear - Streaming music player that finds free music for you.
Perian - (No longer under active development) ~~Let QuickTime play all the common formats of free plug-ins~~.
MusicBrainz Picard - Cross-platform music tagger written in Python.
MyMedia - Display and watch your local movie and TV show library.
Playback - Experimental video player.
Plug - Discover and listen to music from Hype Machine.
Petrichor - Offline music player with broad format support, lyrics, playlists, and queue management.
Popcorn Time - Streaming app for browsing and watching torrent-based movies.
Potplayer X- a Video Audio Player.
Pulp - Audio sample manager.
Sangeet - A beautiful audiophile music player with 10-band EQ, karaoke mode, and time-synced lyrics.
ScreenFlow - Screencasting and video editing software.
Shotcut - Free open-source video editor.
Sonora - Minimal, beautifully designed music player.
Spotifly - Lightweight Spotify player focused on fast playback control.
SpotMenu - Spotify and iTunes in your menu bar.
Stremio - Media center for movies, TV, live channels, and streaming sources.
Stringed 2 - Music practice software designed to help users learn how to play their favorite songs.
Synfig Studio - Synfig Studio is free, open-source 2D animation software.
trax - Music library manager with audio conversion and tag editing.
Tiny Player - As the name suggests, a tiny player.
Tuneful - Controller for Spotify and Apple Music from the menu bar or mini player.
VLC - Open-source multimedia player for most audio, video, and streaming formats.
VOX Player - High-definition audio player for Mac and iPhone. Music just sounds better!
VidCrop - A simple video cropping tool that supports multiple formats and precise trimming.
XLD - Tool to decode, convert and play various 'lossless' audio files.
Recordia - Record audio directly from the menu bar or with a global keyboard shortcut.
Omniplayer - Best media player on Mac, support almost all format.
Kaset - Open-source YouTube Music client with library, lyrics, podcasts, and playback controls.
YouTube Music - Desktop player for YouTube Music with plugin support.
YouTube Music Desktop - Free cross platform Desktop Player for YouTube Music.
YPlayer - A multifunctional app for live captions, audio/video transcription, and subtitle translation.
Musicer - A lightweight local music player that supports multiple formats for enjoying music anytime.
Fmusic - A fmusic is a open source music player on SwiftUI.

Audio Record and Process

CapSoftware - An open-source alternative to Loom. Beautiful, shareable screen recording tool.
GarageBand - Digital audio workstation for recording and music production.
Logic Pro X - Professional digital audio workstation for music and audio production.
Segue - Broadcast audio playout with crossfade, trim, ramp timers, and pause beds for live radio and podcasts.
Stargate DAW - An all-in-one digital audio workstation (DAW) and plugin suite.
SystemEQ for Mac - Free, open-source system-wide parametric equalizer with AutoEQ presets, hearing calibration, and real-time visualization.

Download Management Tools

aria2 - Lightweight multi-protocol & multi-source command-line download utility.
Downie - Video downloader for macOS with support for YouTube and other 1200 sites.
Deluge - Deluge is a lightweight, Free Software, cross-platform BitTorrent client.
FOLX - Free download manager for Mac OS X with a true Mac-style interface.
Free Download Manager - A powerful, easy-to-use, and completely free download accelerator and manager.
Harbor - Open-source download manager for HTTP(S), magnet links, and .torrent files.
JDownloader - Open-source download manager for links, files, and hosted content.
Motrix - Download manager for HTTP, FTP, BitTorrent, magnet links, and more.
Neat Download Manager - Lightweight download manager with an optimized transfer engine.
qBittorrent - A project aims to provide an open-source software alternative to µTorrent.
Shuttle - Easy Download Manager for any links.
Swads - Synology Download Station Client, modern, native, and intuitively redesign.
Transmission - Fast, easy, free BitTorrent Client.
XGetter - Media downloader for video and audio from major websites.
You-Get - Tiny command-line utility to download media contents (videos, audios, images) from the web.
youtube-dl - Command-line program to download videos from YouTube.com and other video sites

Cloud Storage

I recommend using online storage with Mac clients

Arq - Cloud storage backup client that supports AWS, GCP, DropBox, and more.
Carbonite - Carbonite can protect your Mac from all of the most common forms of data loss.
Dropbox - Cloud storage and file synchronization service.
Mega - Free cloud service, offers 50GB free storage.
NextCloud - Actively maintained fork of ownCloud, faster and completely open-source
ownCloud - Cloud storage.
Seafile - Reliable and High Speed File Sync and Share.

Input Methods

Kawa - Better input source switcher for OS X.
LangSwitcher - Keyboard layout converter for mistyped text.
Rocket - Makes typing emoji faster and easier using Slack-style shortcuts.
Touch Emoji - Emoji picker for MacBook Pro Touch Bar.
Type2Phone - Use Your Mac as Keyboard for iPhone, iPad & Apple TV.
betterglobekey - Make macOS Globe key great again!
InputSourcePro - Tool for automatically switching input sources by app or website.

Voice-to-Text

Aiko - High-quality on-device transcription.
Azex Speech - Voice input tuned for mixed Chinese-English dictation in AI and crypto work.
buzz - Transcribes and translates audio offline on your personal computer. Powered by OpenAI's Whisper.
EnviousWispr - Sub-second dictation running Whisper/Parakeet locally with privacy-first AI text polish.
FnKey - Push-to-talk voice input tool that pastes transcribed text instantly.
OpenDictation - Open-source dictation utility with local and cloud speech-to-text.
OpenQuack - Privacy-first voice dictation tool that transcribes locally with WhisperKit and inserts text at the cursor with a hotkey.
OpenTypeless - Open-source AI voice input that types polished text into any app.
Ottex - AI dictation tool that formats text for the app or site you are using.
Presspeech - Native push-to-talk local dictation app for Apple Silicon Macs using Parakeet TDT v3 (CoreML/ANE).
Spokenly - Voice-to-text with 100+ languages, offline mode, and AI-powered formatting.
Tambourine - Open-source, customizable AI voice dictation that works in any app.
TypeWhisper - Local Whisper-based speech-to-text with a global hotkey.
VoiceInk - Real-time speech-to-text app.
VoxFlow - Open-source voice input workspace with local and cloud ASR, OCR, history, and coding-agent workflows.
Voxt - Hold-to-talk voice input tool with AI transcription rules per app and URL, and built-in translation.
Whispering - Multi-provider speech-to-text with AI transformations and keyboard shortcuts.
Willow Voice - AI dictation with automatic editing, style-matching, and noise optimization.

Browsers

Arc - Browser with a distinctive workspace-style interface.
Brave - Web browser with an emphasis on privacy and speed.
ChatGPT Atlas - Browser with ChatGPT built in.
Chrome - Chrome, developed by Google
Chromium - Open-source browser project behind Google Chrome.
- ungoogled-chromium - A lightweight approach to removing Google web service dependency.
Firefox - A free and open-source web browser developed by Mozilla.
- LibreWolf - A fork of Firefox, focused on privacy, security and freedom.
Helium - Privacy-focused Chromium browser with built-in ad blocking.
Microsoft Edge - Microsoft Edge, based on Chromium, but built by MS
Min - Fast, minimal browser that protects your privacy.
Opera - Experience faster, distraction-free browsing with Ad blocking, and browse privately.
Ora - Open-source browser with spaces, tab management, and a vertical sidebar.
Orion - Lightweight WebKit-based browser with support for Chrome and Firefox extensions.
qutebrowser - A keyboard-driven, vim-like browser based on Python and Qt.
Safari - Native browser for Macs.
Tabbit - An AI-native browser that understands your context, chats with webpages, and automates tasks.
Tor Browser - Privacy browser designed for anonymous web browsing.
Mullvad Browser - Privacy browser focused on anti-fingerprinting protection.
Web - Minimal AI browser for macOS, built with SwiftUI.
Vivaldi - The browser that puts you in control.
Yandex - The quick and secure browser from Yandex for computers.
Zen - A beautifully designed, privacy-focused, and feature-rich browser

Translation Tools

(Or you could just use the Mac OS built-in dictionary)

DeepL - Best quality translations
Easydict - A concise dictionary and translator for looking up words and translating text.
Grammarly - Refine your english
iTranslate - Translation app for text and web pages in multiple languages.
Live Translator - Real-time on-screen translation of any system audio (YouTube, podcasts, meetings) using OpenAI or Gemini.
Ludwig - Linguistic search engine that helps you to write better in English.
Mate Translate - Translate in Safari and any app on macOS between 103 languages.
MoePeek - Translation tool with text selection, OCR, clipboard, and manual input support.
Nani - Fast AI translation with explanations.
OpenAI Translator - Translation app and browser extension powered by AI models.
ScreenTranslate - Capture any area or select text to translate instantly, fully on-device.
Translatium - Translation app for words, phrases, and images in 100+ languages.

Education

Leafy - Look up any word on screen with ⌥A, including in PDFs and images, and save it to a searchable local library.
Wokabulary - Collect, practice, and organize your individual foreign language vocabulary.

Finance

Pulse - Native menu bar market tracker for US, Hong Kong and China stocks, crypto, indices, ETFs and portfolio P&L.
SubManager - Subscription tracker with renewal reminders.
SubList - Track subscriptions, renewals, and spending in one place with reminders, analytics, and iCloud sync.
StockDock - Menu bar app for real-time stocks, ETFs, crypto and portfolio P&L. Privacy-first, no account, multi-currency.

Encryption

Cryptomator - Multi-platform transparent client-side encryption of your files in the cloud.
Deadbolt - Open-source file encryption tool.

Security Tools

Antivirus One - Security scanner for malware, adware, and web threats.
BlockBlock - Me: "Please alert me whenever anything is persistently installed." BlockBlock: "You got it"
ClearanceKit - Policy-based file access control tool for protected paths.
Dylib Hijack Scanner - Utility for scanning apps vulnerable to dylib hijacking.
KextViewer - View all modules on that are loaded in the OS kernel.
KnockKnock - See what's persistently installed on your Mac.
LinkLiar - Link-Layer MAC spoofing GUI for macOS.
LockDown - Open-source tool for El Capitan that audits and remediates security configuration settings.
Lockpaw - Menu bar screen guard for macOS — lock and unlock your screen with a hotkey.
MakLock - Lock any macOS app with Touch ID, Apple Watch proximity, or password. Full-screen blur overlay on all monitors.
LuLu - LuLu is the free macOS firewall that aims to block unauthorized (outgoing) network traffic.
MalwareBytes - Malware scanner and removal tool.
Mana Security - vulnerability management app for individuals.
Vulert - Dependency vulnerability monitoring service for open-source packages.
NoxKey - Keychain-based secret manager for API keys and tokens with Touch ID.
OverSight - Tool for monitoring microphone and webcam access.
ParetoSecurity - A MenuBar app to automatically audit your Mac for basic security hygiene.
PureSnitch - Open-source application firewall with a Little Snitch-style world map, rule manager, DNS over HTTPS, and pf-based blocking, with no telemetry.
RansomWhere? - Generic Ransomware Detection.
Santa - Binary and file access authorization system.
stronghold - Easily configure MacOS security settings from the terminal.
Suspicious Package - An application for inspecting macOS installer packages.
swiftGuard - Tool for protecting USB ports from unauthorized access.
TaskExplorer - Explore all processes running on your Mac with TaskExplorer.
TouchBridge - Authenticate with your phone's fingerprint as a free Touch ID keyboard alternative.
What's Your Sign? - Finder extension for viewing a file's code-signing information.

Proxy and VPN Tools

Algo - Personal IPSEC VPN in the cloud.
ClashBar - mihomo-powered menu bar proxy client.
ClashX Guide - Guides and troubleshooting tools for ClashX.
Cloudflare WARP - Secure network service that routes traffic through Cloudflare.
DashVPN - Smart-routing proxy client with support for VLESS, Shadowsocks, and HTTPS subscriptions.
Hiddify - Multi-platform proxy client for managing subscriptions and multiple proxy protocols.
Jumper VPN - VPN Client for Mac and other platforms, secure, fast VPN proxy.
Lantern - Free application that delivers fast, reliable and secure access to the open internet.
Mullvad VPN - Privacy-focused VPN service with anonymous accounts and flat-rate access.
Outline - Outline makes it easy to create a VPN server, giving anyone access to the free and open internet.
RerouteMe - An easy one-click macOS Proxy Configuration app.
ShadowsocksX-NG - Next generation of ShadowsocksX.
ShadowsocksX - Secure socks5 proxy, designed to protect your internet traffic.
Shimo - VPN Client for Mac.
SpechtLite - Rule-based proxy app for macOS.
Surge - Web developer tool and proxy utility for iOS 9.
tinc - Secure mesh VPN software.
TrustTunnel - A modern, open-source VPN protocol originally developed by AdGuard VPN.
Tunnelbear - Simple VPN service for secure browsing and location switching.
Tunnelblick - Free, open-source graphic user interface for OpenVPN on OS X.
VPN Bypass - Menu bar app to route specific domains and services around your VPN.
Windscribe - VPN and proxy service with ad blocking and flexible server switching.
Tailscale - Mesh VPN for securely connecting devices, services, and users.

Utilities

DNS Easy Switcher - Menu bar tool for switching DNS providers or custom resolvers.
Dropshelf - A drag and drop helper app for macOS.
Dropover - Temporary shelf for collecting and moving dragged files, text, and links.
cmd+x - Launch Activity Monitor with Ctrl+Opt+Delete, cut and move files in Finder with Cmd+X.

Clipboard Tools

Buffer - Lightweight native clipboard manager with bookmarks and OCR for images.
CleanClip - The cleanest Clipboard Manager on macOS, ever!
Clipboard - Easy-to-use terminal clipboard manager for all platforms.
ClipMenu - Clipboard manager for Mac OS X.
Clippy - Smart clipboard manager with content-aware previews, AI transformations, a built-in screenshot editor, and file converter.
ClipHistory - Lightweight native clipboard manager with instant hotkey popup, search, pinning, and text/image history.
ClipTools - Clipboard utility set for quick copy, paste, and text cleanup tasks.
Clipy - Clipy is a Clipboard extension app for macOS. Based on ClipMenu.
CopyQ - Clipboard Manager with Advanced Features.
iCopy - Clipboard management, quick reply, efficiency multiplier artifact
iPaste - Lightweight and efficient clipboard tool.
Paste Quick - A simple, privacy-first clipboard manager.
Paste - Smart clipboard history & snippets manager.
PasteBar - Limitless, Free Clipboard Manager for Mac and Windows.
PasteBot - Powerful clipboard manager.
Pure Paste - Paste as plain text by default.
SaneClip - Clipboard manager with history, privacy protections, and sensitive data detection.
SnippetCraft - System-wide text expansion, snippet management, and clipboard history for macOS.
Flycut - Clean and simple clipboard manager for developers.
Maccy - Lightweight clipboard manager for macOS.
Nimclip - Local-first clipboard history manager with search, tags, and image support.
OneClip - A simple and professional macOS clipboard manager.
uPaste - Clipboard history and snippets manager for organizing reusable copied content.
Yippy - Clipboard manager with user-friendly UI.
ClipFlow - Free clipboard history manager with terminal-style navigation.
Pesty - Free and open-source clipboard manager inspired by Paste, with a slide-up color-coded strip, pinboards, and search.

Menu Bar Tools

Agent Island - MacBook notch companion for Claude Code and Codex sessions, showing live status and auto-resuming selected long-running tasks.
Anvil - Tool for serving local static sites and Rack apps with simple URLs.
Atoll - Turns the notch into a Dynamic Island-style hub for media controls, live activities, and quick utilities.
Bartender - Organize or hide menu bar icons on your Mac.
cctop - Open-source menu bar monitor that shows live status for AI coding sessions (Claude Code, Codex, opencode, pi) and jumps to the right terminal pane or editor window.
ChargeMonitor - Menu bar battery monitor with real-time charging stats and energy impact insights.
CodexIsland - Turns the MacBook notch into a Dynamic Island-style live activity for Claude Code and Codex CLI rate limits and spend, computed locally with no telemetry.
SaneBar - Privacy-first menu bar manager with hidden zones and automation rules.
Sharptooth - Menu bar tool for managing Bluetooth devices with hotkeys and automation.
BeardedSpice - Control web players and supported apps with your keyboard media keys.
Boring Notch - Turn your MacBook notch into a music and file control center.
Bye AppQuit - A minimal menu bar app to quickly view and kill running processes.
DayBar - An application that can display the local date and reminder events in the menu bar.
Droppy - Turns your screen's notch (or Dynamic Island) into a multifunctional tool.
Dato - A better menu bar clock with calendar, events, and time zones.
Dozer - Hide MacOS menubar items.
DynamicHorizon - Adds media controls, notifications, and system indicators to the notch area.
Eye Timer - Take Breaks to prevent Eye Strain timer for Mac.
Repose - Menu bar break timer that dims your screen and pauses during calls.
Fishing Funds - Display real-time trends of Chinese funds in the menubar.
GoogleDriveSync - A menu bar app for seamless Google Drive syncing.
Folder Peek - Quickly access documents, files, folders, and apps from the menu bar.
Hidden - A ultra-light MacOS utility that helps hide menu bar icons.
Hue in the Menu - Philips Hue light management in the menu bar with multi-room support.
Ice - Menu bar manager for hiding icons and organizing layouts.
Itsycal - Tiny calendar for your Mac's menu bar.
Itsyhome - Control your HomeKit and Home Assistant smart home from the menu bar.
Itsytv - Control your Apple TV from the menu bar.
KeyStats - Menu bar tracker for daily keystrokes, clicks, movement, and scrolling.
Later - Save all your Mac apps for later with one click.
LuxShot - Native and privacy-first menu bar OCR tool.
MacTools - Open-source menu bar toolkit with plugins for display controls, system toggles, cleanup, device status, and everyday utilities.
Mask This - Menu bar app that masks sensitive information in the clipboard.
MeetingBar - Menu bar app for your calendar meetings
Menu Bar Calendar - A monthly calendar right in your menu bar.
MenubarCC - Menu bar crab that shows your Claude Code sessions at a glance: walking while Claude works, bouncing when it needs you.
MenubarX - A powerful Mac menu bar browser, pin webpage like an App.
MenuScores - A menu bar app that delivers real-time sports news and scores.
Mole Widget - Lightweight system monitor with live CPU, memory, disk, network, battery, and process stats in a resizable desktop widget managed from the menu bar.
MonitorControl - Control external display brightness and volume directly.
muxbar - Menu bar app for tmux session management — list, attach, kill sessions, live preview, and a closed-lid mode for in-bag work.
mysa - A macOS menu bar app for quick breathing breaks, with a frosted screen overlay and handwritten quotes.
NetFluss - Native menu bar app for real-time upload/download speeds and top bandwidth-using apps.
NotchNook - Customizes your Mac's menu bar to seamlessly integrate with the notch design.
Notchly - Lightweight Dynamic Island for macOS with AI coding agent notifications.
One Thing - Put a single task or goal in your menu bar.
One Switch - Mac menu bar app that adds various switches to the Mac's menu bar.
OnlySwitch - ⚙️ All-in-One menu bar app, hide 💻MacBook Pro's notch, dark mode, AirPods, Shortcuts
Pandan - Time awareness in your menu bar.
Peninsula - Dynamic Peninsula for macOS, focusing on window switching, notifications, and file storage.
PowerMeister - Conserve energy and improve Battery-Life on your MacBook.
Profisor - Switch Xcode provisioning profiles for the current project from the menu bar.
Quickgif - Quickly Find and Share GIFs.
Reminders MenuBar - Simple macOS menu bar app to view and interact with reminders.
RewriteBar - A macOS menu bar app that helps you write your text with the assistance of AI.
Second Clock - Show a second clock for a different time zone in your menu bar.
Thaw - A powerful menu bar management tool for hiding and showing menu bar items.
SketchyBar - A highly customizable macOS status bar replacement.
Spaced - Organize your menu bar items into groups.
Streaker - GitHub contribution streak tracking menubar app.
SwiftBar - Powerful macOS menu bar customization tool.
Tactile - Adds subtle trackpad haptic taps over clickable elements, with optional visual cues for accessibility.
TextSniper - Simple yet powerful OCR app in your Menu Bar. Instantly copy and paste text from anywhere.
Today - View today’s schedule and calendar events from the menu bar.
TomatoBar - World's neatest Pomodoro timer for macOS menu bar.
TypeCue - Types a prepared script into any app, one hotkey press per line, as real keystrokes at a human pace, for demo recordings and live presentations.
UTC Time - Show the time in UTC in the menu bar or a widget.
Vanilla - Hide menu bar icons on your Mac.
Vorssaint - Open-source menu bar toolkit for per-app volume, system monitoring, window control, clipboard history, keeping awake, and app cleanup.
Week Number - The current week number in your menu bar.
Work Hours - Simple app that tracks your work hours from the menu bar.
Xbar - Put the output from any script or program into your macOS Menu Bar (the BitBar reboot).
FunKey - Keyboard sound tool that adds mechanical-style typing audio.

Cleanup and Uninstall

AppCleaner - Thoroughly uninstall apps.
App Uninstaller - Lightweight app uninstaller with drag-and-drop support. Built with Swift and SwiftUI.
CleanMyMac - Delete megatons of junk, malware, and make your Mac faster & more organized
Mac Clean - Free, open-source cleaner, optimizer, and malware scanner.
Cleaner One - Disk cleaning and Mac optimization.
Cleaner for Xcode - Remove unwanted Xcode files.
ClearDisk - Visualize and clean developer caches to quickly reclaim disk space.
DaisyDisk - Disk usage analyzer and cleaner.
Harbofly - Menu bar app that auto-discovers and frees the disk space dev build artifacts and caches hog (DerivedData, node_modules, SPM/Homebrew caches). Zero telemetry, notarized.
Mac Cache Cleaner - Cache cleaner for Mac
MacOSCleaner - Free, open-source macOS cleaner with disk analyzer, app uninstaller, and smart cleanup.
MacSift - Open-source disk cleaner that groups files by app and moves them to the Trash.
OmniDiskSweeper - Scans files by size so you can quickly find space hogs.
Pearcleaner - A free, source-available and fair-code licensed mac app cleaner.
PureMac - Free, open-source macOS cleaner with no telemetry. Cleans system and user caches, Xcode junk, Homebrew cache, mail attachments, and finds large or old files. Supports scheduled auto-cleaning.

File Organization Tools

AppPorts - Move apps to external storage while keeping working launch links in /Applications.
BetterZip - Archive tool supports ZIP, TAR, TGZ, TBZ, TXZ (new), 7-ZIP, RAR.
eZip - Lightweight archive tool for ZIP, RAR, 7Z, and other common formats.
Fileside - A modern, tiling file manager with unlimited panes.
Folders File Manager - A file manager with an expandable folder tree, similar to that of Windows Explorer.
Hazel - Automated file organization for your Mac. Responsibly and beautifully designed.
Keka - Open-source compression and extraction tool with broad format support.
muCommander - Lightweight file manager with a dual-pane interface.
Modal File Manager - Dual-pane file manager with Vim-style hotkeys and customizable extensions.
Oka Unarchiver - Archive utility with RAR support, batch extraction, and password-protected archives.
PDF Archiver - Nice tool for tagging and archiving tasks.
Rapidmg 1-Click extracting apps from DMG images to the "Applications" folder.
Shuffle - Fast, GPU-rendered file manager and Finder alternative built in Rust.
The Unarchiver - Unarchive many different kinds of archive files.
Unarchive One - Archive utility for extracting and compressing many common formats.
Marta - File Manager for macOS written entirely in Swift

General Tools

AirServer - Most advanced screen mirroring software receiver for Mac, PC and Xbox One.
Cadran - Renders 22 customizable clock faces on your Mac desktop wallpaper and screensaver.
DNS Optimizer - A DNS changer and performance‑benchmarking tool for Apple devices (macOS & iOS).
DevKnife - A native Mac app for dozens of daily dev tasks, from network scans to JSON formatting.
DevToysMac - Offline toolbox that helps developers in daily tasks.
DevUtils.app - Developer toolbox for formatting, converting, and debugging everyday data.
Deskmark - Add watermarks to the desktop, ideal for recording videos.
Etcher - Flash OS images to SD cards & USB drives, safely and easily.
Equinox - Create dynamic wallpapers for macOS.
HTTrack - Useful tool for downloading a whole website and offline browsing.
Latest - A tiny app that checks if all your apps from any source are up to date.
Lungo - Prevent your Mac from going to sleep.
LaunchNext - Classic Launchpad experience, relive old macOS.
lo-rain - Create a customizable rain over your desktop and apps, with splash over the dock.
Memo - Simple and elegant app. Unlock memos even more quickly using Touch ID.
Numi - Beautiful calculator app for Mac.
NextDNS - The new firewall for the modern Internet.
OpenDisplay - Use a spare iPhone or iPad as a second display for your Mac, wired (USB) or over WiFi, with touch input.
Phosphene - Use any video as your macOS wallpaper on the desktop and the lock screen, picked directly from System Settings.
Plash - Make any website your desktop wallpaper.
rem - An open source approach to locally record and enable searching everything you view on your Mac.
Rewind - Searchable history of your screen and audio activity.
SlowQuitApps - An OS X app that adds a global delay of 1 second to the Cmd-Q shortcut.
Speediness - Check your internet speed.
Ultra TabSaver - The Open Source Tab Manager for Safari
Upscayl - Free and open-source AI image upscaling tool.
Vidwall - Easily import MP4/MOV videos as system wallpapers and lock screen animations.
WaifuX - Open-source ACG app for wallpapers, animated backgrounds, and anime videos.
CapsLockNoDelay - Removes caps-lock key activation delay for fast typers.
Seodisias - SEO crawler that audits sites for technical issues and optimization opportunities.

To-Do Lists

2Do - Nice todo app.
Day-O 2 - Menu bar clock replacement with built-in calendar.
Fantastical - The calendar app you won't be able to live without.
Focus - Beautiful pomodoro-based time manager.
Focused Work: Focus Timer - A simple, flexible Focus Timer.
Lunatask - An all-in-one encrypted to-do list, habit and mood tracker, journaling and notes app.
Microsoft To-Do - Microsoft's successor to Wunderlist.
Nozbe - GTD task manager for individuals and teams.
OmniFocus - Nice GTD app, made by OmniGroups.
One Task - Conquer one task at a time.
Super Productivity - Task manager with timeboxing and time tracking.
Taskade - Real-time collaborative editor for teams.
TaskPaper - Plain text to-do lists.
Things - Delightful and easy to use task manager. (Award-winning App)
Todoist - Cross-platform todo list app.
Tomato 2 - Beautiful and simple Pomodoro timer.
TickTick - Simple and effective to-do list and task manager that helps you organize all aspects of life.

Productivity

1440 Minutes Left Today - Show how many minutes are left in the day from your menu bar.
ActivityWatch - Cross-platform, extensible, and privacy-focused time-tracker.
Alfred - Launcher and automation tool with hotkeys, snippets, and search.
Atomic - A habit tracker app to build good habits, break bad ones, and stay on top of your daily routines.
Better Launchpad - Customizable app launcher with fast search.
BetterMouse - Customize scrolling, acceleration, buttons, and gestures for third-party mice.
BetterTouchTool - Customize gestures, shortcuts, and input actions across trackpads, mice, and keyboards.
Cerebro - Open-source productivity booster with a brain.
Choosy - UI, URL API and a browser extension set for managing rules where and how to open links.
CurrentKey - Add custom names and icons to Spaces and track app usage time.
CursorSense - Mouse & trackpad driver that lets you tweak the acceleration curve and more.
Day Progress - Time remaining today in your menu bar.
Dropzone - Create a popup grid of customizable actions. Scriptable in Ruby & Python.
escrcpy -📱 Graphical Scrcpy to display and control Android devices, powered by Electron.
Focalboard - Open source, self-hosted alternative to Trello, Notion, and Asana.
Focus Firewall - A minimalist focus app to block social media and other distractions during work.
FnKeyboard - Quick access to function keys from the menu bar.
Freeter - Organize apps, links, and files by project in one workspace.
Hammerspoon - Tool for powerful OSX automation with the Lua scripting engine.
HapticKey - Add haptic feedback when using the Touch Bar.
HazeOver - App that dims your background app windows so you can focus more on your main task!
Hook for Mac - Link related files, emails, and notes for quick navigation.
Hungrymark - Bookmark files, folders, and links for quick menu bar access.
Hyperkey - Turn Caps Lock or another modifier into a Hyper key.
iCMD - Global fuzzy menu search with Vim-style navigation.
Journey Navigation - Route planner with weather, traffic, and turn-by-turn guidance.
Karabiner - Powerful and stable keyboard customizer for OS X.
Keyboard Cowboy - The missing keyboard shortcut utility for macOS.
Keyboard Maestro - Automate repetitive tasks with triggers and macros.
Keytty - App to keep your hands on the keyboard. Move, click, scroll, drag and more with a few strokes.
Launchy - An app launcher and switcher that utilizes a radial menu.
Lazy - Keyboard-driven commands to manage your surroundings directly from your mac.
Linear Mouse - Full control of mouse. Change the speed, scrolling direction, pointer type and much more.
Macaify - Fast use of ChatGPT, lightweight, clean, keyboard-first.
Mac Mouse Fix - A simple way to make your mouse better.
Memo Widget - Sticky notes on your desktop.
MindMac - AI chat client for multiple providers in one place.
Mos - Simple tool can offer the smooth scrolling and reverse the mouse scrolling direction on your Mac.
MacPacker - Archive manager that supports previewing and extracting archive files
Magic Switch - Switch Magic Keyboard, Mouse, and Trackpad between multiple Macs.
nnScreenshots - Capture periodic screenshots to review your day and fill timesheets.
OmniPlan - The best way to visualize, maintain, and simplify your projects. Project Management made easy.
OpenIn - Take control of installed apps on your Mac
PaletteBrain - Access the power of ChatGPT across all your Mac applications with the press of a shortcut.
Pie Menu – Control your tools with a radial menu customized for your active app.
Perplexity - Search and discovery with AI.
Pomodoro Cycle - Pomodoro tracker
ProBoard - Use one board to manage all your project information efficiently.
Qbserve - Automatic time tracking with projects, timesheets, and productivity insights.
Raycast - Launcher and command palette with extensions, snippets, notes, and AI.
SuperCmd - Open-source launcher with Raycast-compatible extensions, voice workflows, text-to-speech, memory, and AI actions.
Rustcast - Workflow launcher for modes, quick app access, file search, clipboard history, and more.
RescueTime - Track time usage and get productivity reports.
SuperCorners - Turn Hot Corners into custom workflow triggers.
Rize - AI time tracker that helps you focus and build better work habits.
RightMenu Master - Add more useful actions to the Finder right-click menu.
Selectric - Private search across email, documents, and chat apps.
SensibleSideButtons - Make mouse side buttons work for back and forward in more apps.
skhd - Simple hotkey daemon for macOS.
Strategr - Time-boxing planner for structuring your day.
StrokeMouse - Custom mouse gestures that can trigger keyboard shortcuts, open apps, perform window actions, run shell commands, or execute AppleScript after drawing a stroke.
SwiftBiu - Text productivity tool with a customizable action bar and AI extensions.
Table Habit – Habit tracker with growth charts and offline-first sync.
Time Out - Easy break reminders, with micro-break and flexible customization if you want it.
TimeScribe - Simple and free working time recording.
Timing - Automatic time tracking with productivity insights and billing-friendly records.
Textream - Free teleprompter with real-time word tracking and voice-activated scrolling.
Trace - Open-source spotlight alternative and shortcut toolkit.
Trello - A collaboration tool that organizes your projects into Kanban boards.
Ukelele - Unicode Keyboard Layout Editor.
Velja - Browser picker that lets you open links in a specific browser or a desktop app.
Wox - Open-source cross-platform launcher with fast local search and plugin extensibility.
xScope - Toolset for measuring, inspecting, and testing on-screen layouts and graphics.
Z - Jump to frequently used directories by typing part of the path.

Window Management

AeroSpace - i3-like tiling window manager for macOS.
AltTab - Open source window switcher with window previews.
Amethyst - Tiling window manager.
Assignee - Simple, instant app switcher.
Convoker - Type an app name, press Enter, all its windows come to you.
contexts - App switcher for faster window and app switching across multiple screens.
Dimsum - Minimalist menu bar app that dims inactive windows to highlight the focused one.
DockDoor - Free and open source window peeking & alt-tab for macOS.
Dockit - An application that can dock any window to the edge of the screen.
Dissolv - Hide and close inactive apps.
Divvy - Window management at its finest with its amazing Divvy Grid system.
Hummingbird - Easily move and resize windows without mouse clicks, from anywhere within a window.
IntelliDock - Hides the Dock, Automatically.
JankyBorders - A lightweight window border system for macOS.
Loop - Window management made elegant. Freeware
MacsyZones - Organize your windows with ease and boost your productivity.
Lasso - Intuitive and easy to use grid-based window manager.
Magnet - Window manager that keeps your workspace organized.
MakeItHome - Pointer-driven launcher for screen-edge quick actions and app switching.
Moom - Window management tool for moving, resizing, and saving layouts.
Nudge - Window manager with keyboard shortcuts and drag-to-edge snapping.
Omni - Notorized Niri and Hyprland inspired tiling window manager with animations.
Plonk - Menu bar window manager with snap zones, hotkeys, and saved workspaces that relaunch your apps and put every window back on its monitor; an AI agent can drive it over MCP.
rcmd - Use the ⌘ Right Command key to switch applications based on their name.
Rectangle-app - Rectangle is a window management app based on Spectacle, written in Swift.
ShiftIt - Managing window size and position in OSX.
ShortcutCycle - Switch between context-based app groups with a single hotkey.
Sidebar - The modern Dock replacement for your Mac.
SizeUp - Powerful, keyboard-centric window management.
Slate - Scriptable window manager configured with JavaScript.
Snapback - Save and restore entire window layouts with one keystroke.
Swift Shift - Move and resize windows with keyboard shortcuts and mouse gestures.
StreamWindow - 3D window manager with intuitive views and fluid transitions.
Tiles - Snap and rearrange windows with screen edges, shortcuts, or the menu bar.
Topit - Pin any window to the top of your screen
Total Spaces - Workspace manager with hotkeys and spatial overview.
yabai - Keyboard-driven tiling window manager.

Password Management

1Password - Cross-platform password management tool.
Bitwarden - Open source password management tool for Mac OS, iOS and browsers.
Buttercup - The Password Manager You Deserve
Dashlane - Cloud-based password manager with award-winning design.
Enpass - Cross-platform password management tool with cloud integration.
Keyzer - Simple password manager that supports saving portable password files.
Keeweb - Free, cross-platform password manager compatible with KeePass.
KeepassXC - Free, open source, cross-platform password manager.
MacPass - Open-source KeePass Mac OS client.
SafeInCloud - Cross Platform password management, low cost app!
Strongbox - KeePass-compatible password manager with Password Safe support.
Swifty - Free Offline-first Password Manager for MacOS, Windows and Linux.

Finder Tools

Command X - Cut and paste files in Finder.
Default Folder X - Quick access to your files and folders in every app.
FileMinutes - Find files and take actions, all in one.
FinderFix - Finally, a lasting solution for Finder windows size and position. .
SaneClick - Finder extension that adds right-click actions for file tasks, conversion, and developer tools.
FlowVision - RWaterfall-style Image Viewer for macOS.
fman - The first dual-pane file manager to integrate features from Sublime Text.
ForkLift - The most advanced dual pane file manager and file transfer client for macOS.
Path Finder - File management app.
QSpace - A clean and efficient Multi-view File Manager.
RClick - Add new functionality to the macOS Finder context menu.
SwiftyMenu - Finder extension for opening selected files or folders with custom app shortcuts.
TotalFinder - Chrome-styled Finder substitute.
XtraFinder - Adds tabs and cut to Mac Finder.

Quality of Life Improvements

Actions - Provides many useful actions for the Shortcuts app.
AI Actions - AI actions for the Shortcuts app.
Crisp - Manage external displays from the menu bar: HiDPI scaling, DDC brightness, color, and presets.
DisplayBuddy - Control external display brightness, contrast, and input source.
Dimly - Control brightness across mixed monitor setups from one menu bar app.
f.lux - Makes the color of your computer's display adapt to the time of day.
Grayscale Mode - Toggle a grayscale screen filter from the menu bar or a shortcut.
Hyperduck - Receive links from your iOS & visionOS devices.
KeyCastr - Open-source keystroke visualizer.
Luminescent - Bring back Keyboard Backlight Shortcuts for the MacBook.
MaCursor - Custom cursor themes for macOS.
Lunar - Help you adujst brightness, contrast and volumn of your external display.
Shifty - A macOS menu bar app that gives you more control over Night Shift.
Snap - Launch an app in a snap. Ridiculously easy shortcut management.
Shareful - Supercharge the system share menu with copy, save, and open actions.
Mouse Jiggler for Mac - Prevent Mac from sleep with Mac Mouse Mover.

System Related Tools

Adrafinil - Keep your Mac awake only while AI agents are still working, then let it sleep normally.
AlDente - Battery charge limiter for MacBooks.
Amphetamine - Keep your Mac awake.
AdBlock One - Free ad blocker for Safari.
Apple Silicon App Test - Check Apple Silicon app compatibility.
AirBattery - View all device batteries in the Dock, menu bar, or widgets.
Background Music - Control app volumes and record system audio.
Battery Hog - Shows what is draining the battery: live watts, per-app energy, charge history, and drain insights. 100% local.
coconutBattery - Mac battery information and statistics.
Dayflow - Screen activity timeline with AI support.
DockAnchor - Lock the macOS Dock to a single screen in a multi-monitor setup.
everythingByMdfind - Fast file search using Spotlight.
ExtendFS - Read-only access to Linux ext2/3/4 in macOS Sequoia and later without a kernel extension.
gfxCardStatus - Monitor graphics card usage and battery impact.
GrandPerspective - Visualize disk usage with tree maps.
Gray - Per-app light/dark mode switcher.
HandShaker - Manage Android phone content on Mac.
iStat Menus - Advanced system monitor for menubar.
iStats - Command-line system information tool.
Juice - Enhanced battery information display.
KeepingYouAwake - Caffeine alternative with dark mode support.
macUSB - A bootable macOS / OS X installer creator for Apple Silicon Macs.
MagicQuit - Automatically quit inactive apps to reduce clutter and free resources.
MiddleDrag - Three-finger trackpad gestures for middle-click and middle-drag on macOS.
Monity - System monitoring widget for OS X.
Mounty - Tiny tool to re-mount write-protected NTFS volumes under Mac OS X 10.9+ in read-write mode.
NitroShare - Cross-platform network file transfer utility.
OnyX - System maintenance utility for cleanup, verification, and hidden settings.
Paragon NTFS - Read/write access to NTFS in macOS Sierra.
stats - free Mac system monitor for the menubar.
Sensei - Performance toolkit for monitoring, cleanup, and hardware diagnostics.
SiliconScope - Sudoless Apple Silicon system monitor (menu bar + dashboard) with first-class ANE, Media Engine and memory-bandwidth tracking plus an E/P-core breakdown — the chip-level signals Activity Monitor doesn't show.
Sleepless - Keeps your laptop awake with lid-closed support, auto-off timer, and battery-floor cutoff.
Sleepr - Sleepr brings back sleep timer on macOS.
Sloth - Shows all open files, directories, sockets, pipes and devices in use by all running processes.
SteerMouse - Customize mouse buttons, wheel behavior, and cursor speed.
SwiftQuit - Enables automatic quitting of macOS apps when closing their windows.
SwiftMTP - Open-source MTP device manager for browsing and transferring files between Mac and Android devices.
Core Tunnel - Application for managing SSH connections.
TG Pro - Temperature monitoring, fan control & hardware diagnostics to help keep your Mac cool and healthy.
Time Machine Inspector - Find out what's hogging up your Time Machine backups.
Tuxera NTFS - Full read-write compatibility with NTFS-formatted drives on a Mac.
Overkill - Stop iTunes from opening when you connect your iPhone.

Gaming Software

OpenEmu - Retro game emulator frontend for multiple console systems.
PlayCover - Run iOS apps and games on Apple Silicon Macs with mouse, keyboard and controller support.
Porting Kit - Install Windows® Games inside your Mac.
PPSSPP - A awesome PSP emulator for any OS you can dream of!
RPCS3 - The Open-source PlayStation 3 Emulator
Ryubing - A fork of the discontinued Switch emulator, Ryujinx.
Suyu - A familiar, open source, and powerful Nintendo Switch emulator.
Whisky - A tool for running Windows apps on macOS, built with SwiftUI and supporting D3DMetal and DXVK backends.
ConsoleMini - Controller-first big-picture launcher that turns a Mac mini into a PS1-PS4 + retro console (wraps DuckStation, PCSX2, RPCS3, shadPS4, PPSSPP, RetroArch, mGBA, Flycast).

Remote Login Software

AnyDesk - Provides remote access across multiple machines.
MoonProxy - GUI desktop client for FRP that puts local services on the internet with one click.
Moonlight - GameStream client for PCs (Windows, Mac, Linux, and Steam Link).
Parsec - Low-latency remote desktop and game streaming tool.
RealVNC - The original and best software for remote access across desktop and mobile.
RoyalTSX - Remote connection manager for multiple protocols.
RustDesk - Yet another remote desktop software.
Steam Link - The Steam Link app allows you to play your Steam games across all your computers.
Sunshine - Self-hosted game stream host for Moonlight.
TeamViewer - Remote support and screen sharing tool.
Windows App - Connect to a remote PC or virtual apps and desktops made available by your admin.

QuickLook Plugins

CSV Quick Look - Quick Look extension for CSV and TSV files with virtual scrolling, sorting, filtering, and dark mode.
QLMarkdown - Quick Look extension for Markdown files. -
FluxMarkdown - Quick Look extension for Markdown previews with Mermaid, KaTeX, GFM, TOC, and charts.
markdown-quicklook - Quick Look plugin for rendered Markdown previews with syntax highlighting.
Torrent Preview - Quick Look extension for previewing .torrent files, trackers, and metadata.
quick-look-plugins - List of useful Quick Look plugins for developers
Syntax Highlight - Quick Look extension for highlight source code files. -

Third Party App Markets

If you come across websites offering pirated software or cracks, please post HERE. We love apps, but only authentic ones. 😃

Package Managers

Here are some of the major software download sites, there are a number of OSX Mac software sites

Applite - User-friendly GUI app for Homebrew Casks. Install, update, and uninstall apps with a single click.
Cork - An intuitive and complete Homebrew GUI written in SwiftUI that supports all Homebrew features.
Homebrew - The missing package manager for macOS.
MacPorts - Package manager for installing and maintaining open-source software.
MacUpdate Desktop - Simplifies finding, buying and installing apps for your Mac.

Mac App Download Sites

Here are some of the major software download sites, there are a number of OSX Mac software sites

Genuine Sites

alternativeTo - Also a very nice community. If you are looking for some alternative apps FOR Windows or another platform, check this site.
Slant - Platform for comparing software and browsing community recommendations.
Also, Quora, Reddit, you know the drill.
App Shopper：https://appshopper.com/
Buy software, once - The place to find all the software you can buy one time, and own for a lifetime.
Open Alternative - Discover Open Source Alternatives to Popular Software. A curated collection of the best open source alternatives to everyday SaaS products. Save money with reliable tools hand-picked for you.
MacUpdate：https://www.macupdate.com/
Other sites like MacStories, LifeHacker, ProductHunt are great resources.

Pirated software download site blocklist

Refuse piracy from me. Software vendors can go to these places rights.

AppKed：~~https://www.macbed.com~~
Softasm：~~https://softasm.com/~~
Appstorrent：~~https://appstorrent.ru/~~

⬆ back to top

Contributors

This project exists thanks to all the people who contribute.

License

This work is licensed under a Creative Commons Attribution 4.0 International License.

momenbasel/PureMac

Free, open-source macOS cleaner. CleanMyMac alternative with zero telemetry. Native SwiftUI, scheduled auto-cleaning, Xcode/Homebrew/system cache cleanup. MIT licensed.

PureMac

Reclaim your Mac.
Free, open-source uninstaller and cleaner for macOS. No subscription, no telemetry, no upsell.

Install - Why this exists - How it compares - Our promise - What it does - Permissions - Contributing

_{Want more open source? Try Pesty - a free, native clipboard manager for macOS.}

Install

brew install --cask puremac

Or download the signed, notarized .dmg from Releases and drag PureMac into /Applications. No Gatekeeper warnings, no quarantine workaround.

Build from source

brew install xcodegen
git clone https://github.com/momenbasel/PureMac.git
cd PureMac
xcodegen generate
xcodebuild -project PureMac.xcodeproj -scheme PureMac -configuration Release \
  -derivedDataPath build build
open build/Build/Products/Release/PureMac.app

How it compares

	PureMac	CleanMyMac	Pearcleaner	Mole	OnyX
Price	Free	$40+/yr	Free	CLI free / GUI paid	Free
Open source	Yes (MIT)	No	Source-available¹	CLI only	No
Native Mac GUI	Yes	Yes	Yes	Terminal-first	Yes
No telemetry	Yes	No	Yes	Yes	Yes
No subscription	Yes	No	Yes	—	Yes
Signed + notarized	Yes	Yes	Yes	—	Yes
App uninstaller + orphans	Yes	Yes	Yes	Partial	No
Trash-only (recoverable)	Yes	Partial	Yes	Partial	No
Honest about purgeable space	Yes	No	n/a	n/a	n/a

_{¹ Pearcleaner is Apache 2.0 + Commons Clause - source-available but not OSI-approved (you may not sell it). PureMac is true MIT. Comparison reflects publicly documented features as of 2026; corrections welcome via PR.}

Our promise

A Mac cleaner asks for the deepest permission macOS grants - Full Disk Access - and then deletes your files. That demands a level of trust the category has spent twenty years burning. Here's the contract PureMac holds itself to, and you can verify every line of it in the source:

Trash, never rm. Everything PureMac removes goes to the Trash via FileManager.trashItem. If it was wrong, you drag it back. Nothing is shredded or unlinked.
No telemetry, ever. No analytics, no crash reporting, no "anonymous usage stats," no network calls to us. The app doesn't know you exist.
No fake urgency. No dramatized "47 GB of junk detected!" badge, no red alarm counters, no "your Mac is at risk." We show you neutral facts and let you decide.
No overpromising. We don't claim to "reclaim purgeable space," "boost RAM," or "speed up your Mac" - things no app can reliably do. See the purgeable-space note below.
You review before anything is removed. Nothing is auto-deleted. Every item shows its real path with Reveal-in-Finder, and high-risk system paths are hard-excluded in code.
Auditable. It's MIT. The exact code that decides what gets removed is in PureMac/Services and PureMac/Logic/Scanning. Read it. Fork it. Ship your own.

If PureMac ever adds telemetry, a paywall on core features, or a fear-based scan, it will have become the thing it was built to replace. Hold us to this.

Why this exists

Apple sells base-model Macs with 256 GB SSDs that you can't upgrade. The Mac mini, the Air, every entry-level MacBook Pro - the drive is soldered down. The next storage tier costs more than a midrange Windows laptop. Once you've paid it, every gigabyte you've already bought matters.

Most Mac cleaners are subscription apps that hide their disk usage behind a paywall, ship telemetry by default, and trade on FUD ("47 GB of junk detected!"). PureMac is the opposite:

One-time install. No subscription, no trial, no account.
No telemetry. It never phones home. It doesn't even know you exist.
Open source under MIT. Read the code, fork it, audit it.
Honest scans. "Junk" means actually-junk: cache directories the OS itself would purge, orphaned files left by apps you've already deleted, broken installer receipts, that 4 GB Xcode DerivedData blob from 2023.
Real uninstalls. Drag an app, see every preference plist, cache folder, container, launch agent and log file it dropped across your library, remove all of it at once.

What it does

App Uninstaller

Discovers everything in /Applications and ~/Applications, then uses a 10-level matching engine (bundle ID, team identifier, entitlements, Spotlight metadata, container discovery, company-name heuristics, partial path matches) to find every file the app dropped on your disk. Three sensitivity tiers - Strict, Enhanced, Deep - let you choose how aggressive that match is. Apple system apps are excluded from the uninstall list automatically. You can also right-click any app in Finder and choose Services → Uninstall with PureMac to jump straight into its related-files scan.

Orphan Finder

Walks ~/Library and surfaces files left behind by apps that no longer exist on disk. The matcher compares against bundle identifiers and normalized names of every installed app, so a leftover ~/Library/Containers/com.foo.bar from an app you deleted in 2022 shows up clearly.

System Cleaner

Smart Scan runs every category in parallel. Each category is its own deliberate scanner:

System Junk - system caches, logs, temp files
User Cache - dynamically discovered, no hardcoded app list
AI Apps - Ollama and LM Studio logs, caches, opt-in history cleanup
Mail Files - downloaded mail attachments
Trash Bins - empties all bins, including external volumes
Large & Old Files - >100 MB or older than 1 year (never auto-selected)
Xcode Junk - DerivedData, Archives, simulator caches
Brew Cache - respects custom HOMEBREW_CACHE
Node Cache - npm, yarn classic, pnpm content-addressable store
Docker Cache - images, containers, build cache

On "purgeable space": PureMac shows your APFS purgeable space in the storage breakdown for transparency, but it deliberately does not list it as junk to delete. Purgeable space is reserved and reclaimed by macOS itself - no third-party app can reliably free it, and even the Finder's purgeable figure is known to be inaccurate. Cleaners that claim to "reclaim purgeable space" are overpromising. We'd rather be honest than impressive.

Scheduled Cleaning

Optional. Configurable interval (hourly to monthly), with auto-clean threshold so background runs only fire when there's something meaningful to remove.

Permissions

PureMac needs Full Disk Access to read the locations macOS hides from every app by default - Mail downloads, Safari data, the TCC database, protected app containers. Without it, the cleanup categories miss roughly 70% of what they could find and app uninstalls leave behind everything in ~/Library/Containers.

The first-launch onboarding walks you through granting it with an animated preview of the exact toggle you need to flip. If you skip it, the dashboard surfaces a single-click "Set up" pill. If a cleanup fails because of a permission issue, PureMac opens System Settings, reveals its bundle in Finder so you can drag it into the FDA list, polls the permission state every second, and auto-retries the failed batch the moment you grant access. You never have to re-select anything.

What PureMac does not do:

It does not collect telemetry, crash reports, or usage analytics.
It does not require a network connection to operate.
It does not move data anywhere except the Trash.

Troubleshooting

Launchpad / Dock shows a stale or dull PureMac icon

macOS aggressively caches app icons in LaunchServices. After a Homebrew reinstall or upgrade the Dock and Launchpad can keep showing the old cached icon. PureMac's cask now runs lsregister -f on install to refresh it automatically, but if a stale icon persists, reset the cache manually:

# Clear the icon caches and rebuild the LaunchServices database
sudo rm -rfv /Library/Caches/com.apple.iconservices.store
sudo find /private/var/folders/ \( -name com.apple.dock.iconcache -or -name com.apple.iconservices \) -exec rm -rfv {} \; 2>/dev/null
/System/Library/Frameworks/CoreServices.framework/Versions/A/Frameworks/LaunchServices.framework/Versions/A/Support/lsregister \
  -kill -r -domain local -domain user -domain system
killall Dock; killall Finder

Give it a minute to re-seed, then open PureMac once. If it still sticks, a restart (or Safe Mode boot) forces a full rebuild.

Screenshots

Smart Care	Live scan

Scan breakdown	App Uninstaller

System Junk	Xcode Junk

User Cache	Onboarding

Architecture

PureMac/
  Logic/Scanning/     - Heuristic scan engine, locations database, conditions
  Logic/Utilities/    - Structured logging
  Models/             - Data models, typed errors
  Services/           - Scan engine, cleaning engine, permission coordinator, scheduler
  ViewModels/         - Centralized app state
  Views/              - Native SwiftUI views
    Apps/             - App uninstaller views
    Components/       - Shared components (FDA demo, permission sheet, theme)
    Orphans/          - Orphan finder
    Settings/         - Native Form-based settings

Key components:

AppPathFinder - 10-level heuristic matching engine for discovering app-related files
Locations - 120+ macOS filesystem search paths
Conditions - 25 per-app matching rules for edge cases (Xcode, Chrome, VS Code, etc.)
PermissionCoordinator - Single source of truth for FDA prompts, polling, and post-grant retries
FullDiskAccessManager - TCC probe + registration; broad probe paths (Mail, Safari, Messages, AddressBook, Calendars) so macOS catalogs the bundle reliably
CleaningEngine - Symlink-resistant deletion with an allow-list, NSAppleScript-based admin escalation for root-owned items, NUL-separated path staging for xargs

Security

Symlink attack prevention: paths are resolved before validation, re-resolved immediately before unlink to close TOCTOU windows.
Allow-list cleaning: a path that doesn't sit inside an explicit safe-root is refused, even for the user-level pass.
Admin escalation is gated by a narrower allow-list (app bundles, package receipts, launch plists) than the normal cleaner — root-owned items can only be removed inside those roots.
System app protection: Apple's bundles cannot be uninstalled, regardless of selection.
All destructive operations require explicit confirmation by default. The toggle that disables that confirmation is buried in Settings.

If you find a vulnerability, please open a private security advisory rather than a public issue.

Contributing

Pull requests welcome. See CONTRIBUTING.md.

Especially welcome:

Per-category size and date filter presets
Wider XCTest coverage for AppState and the scan engine
Translations beyond the current set (en, ar, es, ja, pt-BR, zh-Hans, zh-Hant)
App icon design

Acknowledgments

@nguyenhuy158 - Search and filter feature (#18, #29)
@edufalcao - Cleaning safety guards and confirmation dialogs (#30)
@zeck00 - UI overhaul (#31), app uninstaller with system app protection (#32), onboarding experience (#33)
@0x-man - Symlink security vulnerability report (#25)
@ansidev - Checkbox interaction bug report (#34)
@fengcheng01 - App uninstaller feature request (#28)
@scholzfuni - Modularization proposal (#23)
@Zonharo - In-app auto-update request (#94)

Star History

If PureMac saved you some disk space, a star helps other people find it.

More open source

Pesty - a free, open-source clipboard manager for macOS. Color-coded history, pinboards, instant search, keyboard-fast paste. Signed, notarized, brew install --cask momenbasel/pesty/pesty.

License

MIT. See LICENSE. Use it, fork it, ship it under your own name if you want - the only thing the license asks is that the notice stays.

duongductrong/Snapzy

An open-source native macOS screenshot and screen recording app. A CleanShot X alternative.

Snapzy

Native macOS screenshots, recording, annotation, and editing from the menu bar.

Built with SwiftUI, AppKit, ScreenCaptureKit, Vision, and Sparkle.

🇺🇸 English • 🇻🇳 Tiếng Việt • 🇨🇳 简体中文 • 🇯🇵 日本語

Features • Install • Raycast • Shortcuts • Development • Documentation • Community • Security • Contributing • Contributors • Acknowledgments

Features

Screenshot: fullscreen or selected-area capture with manual/application window mode toggle (Application Capture, default A), including already open third-party menu-bar popovers that would normally close when capture begins (restored visually for selection and saved with transparent rounded corners), area capture with inline annotate (annotate before saving), scrolling capture with live stitched preview, OCR text extraction with Apple Vision or custom OpenAI-compatible endpoints and a native result notification, transparent object cutout capture with optional safe auto-crop, window shadow capture (macOS 14+), multi-format export (PNG/JPG/WebP), hide desktop icons/widgets, quick screenshot during recording
Screen Recording: video or GIF output, system audio + microphone, mouse click highlights, keystroke overlays, live on-screen annotations, remember last area, GIF resizing, Smart Camera metadata for Follow Mouse edits
Annotation Editor: shapes, arrows, text, watermarks, filled rectangles, blur/pixelate, automatic local sensitive-data redaction, OCR text extraction from the image context menu, counters, highlighter with text snapping (⌘ to bypass), crop with edge-snapping (⌘ to bypass) and one-key auto-crop to content (A), remove background with crop-aware auto-crop support, mockup backgrounds with 3D renderer, zoom/pan (pinch + keyboard), drag-to-app with optional keep-editing and editor reactivation behavior, configurable tool/action shortcuts
After Capture Settings: per-mode action matrix for save, Quick Access, clipboard copy, and annotate plus a separate global remove-background auto-crop toggle (enabled by default)
Video Editor: trim with visual timeline + frame strip, zoom segments with auto-focus (Follow Mouse), wallpaper backgrounds + padding, custom export dimensions, animated GIF viewer, undo/redo
Quick Access: floating panel after every capture with copy, edit, drag-to-app, two-finger swipe dismiss, open, and delete actions, plus configurable keyboard shortcuts that fire on the card you are hovering
Capture History: floating history panel + full browser for recent screenshots, videos, and GIFs with type/time filters, filename search, quick copy/open/delete actions, one-click reopen in Annotate or Video Editor, editable annotation restore for committed screenshot edits, configurable panel layout, and retention policies
Shortcuts: fully configurable global shortcuts for capture, recording, and annotation tools, with per-shortcut on/off control and system conflict detection
Onboarding: splash screen, first-run language selection, guided permissions setup, and shortcut configuration for first-time users
Localization: 🇺🇸 English, 🇻🇳 Vietnamese, 🇨🇳 Simplified Chinese, 🇹🇼 Traditional Chinese, 🇪🇸 Spanish, 🇯🇵 Japanese, 🇰🇷 Korean, 🇷🇺 Russian, 🇫🇷 French, and 🇩🇪 German app localization with native macOS per-app language support
Cloud Upload: privacy-first bring-your-own-storage via AWS S3 or Cloudflare R2 — no third-party servers, manual upload from Quick Access for screenshots, videos, and GIFs, or from Annotate for screenshots, credentials stored in the macOS Keychain with optional password protection, manual encrypted credential import/export for faster setup on another Mac, upload history, configurable auto-expiration (1–90 days or permanent), lifecycle rules, custom domain support
Advanced Settings: TOML export/import, one-time config folder grant, debounced background sync, safe sync-before-open, and launch-time auto-apply for portable preferences, dotfiles, backup, and machine-to-machine setup via ~/.config/snapzy/config.toml
Updates & Diagnostics: in-app updates via Sparkle, problem reporting with diagnostic log bundles, cache management
Platform: menu-bar app, appearance theming (light/dark/system), App Sandbox with secure file-access bookmarks

Install

Requires macOS 13.0 or later.

Homebrew

brew install --cask snapzy

Shell script

# Install a specific version
curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/v1.30.1/install.sh | bash

Download a release

Go to Releases
Download the latest packaged app asset, typically Snapzy-v<version>.dmg
Move Snapzy.app to /Applications
Launch Snapzy
Grant Screen Recording permission when prompted in System Settings
Re-launch Snapzy after granting Screen Recording if macOS asks for it
Grant Microphone permission too if you want voice input in recordings

Snapzy is signed and notarized by Apple. macOS will open it without any extra steps.

Uninstall

To completely remove Snapzy, reset all permissions, and clean up app data:

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/master/uninstall.sh | bash

Or if you cloned the repo:

./uninstall.sh

This will remove the app from /Applications, delete preferences and caches, and reset TCC permissions (Screen Recording, Microphone, Accessibility). You may need to log out or reboot for permission changes to fully take effect.

Reset Permissions

If you only want to reset TCC permissions (Screen Recording, Microphone, Accessibility) without uninstalling the app:

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/master/reset-permissions.sh | bash

Or if you cloned the repo:

./reset-permissions.sh

Raycast

Control Snapzy directly from Raycast using the official extension:

Shortcuts

Action	Shortcut
Fullscreen screenshot	`⇧⌘3`
Area screenshot	`⇧⌘4`
↳ Toggle manual/app window mode (`Application Capture`)	`A`
Repeat last area screenshot	`⌃⌘⇧4`
Area screenshot + inline annotate	`⇧⌘7`
Scrolling screenshot	`⇧⌘6`
Screen recording (start/stop toggle)	`⇧⌘5`
Pause/Resume recording (optional, recommended `⌘⇧Space`)	unset
OCR text capture	`⇧⌘2`
Object cutout capture	`⇧⌘1`
Smart element capture	`⌥⇧4`
Open Annotate	`⇧⌘A`
Open Video Editor	`⇧⌘E`
Open Cloud Uploads	`⇧⌘L`
Show shortcuts list	`⇧⌘K`

Quick Access card actions

Hover a Quick Access card, then press the key. Active only while the pointer is over a card.

Action	Shortcut
Copy	`⌘C`
Save / Open	`⌘S`
Edit	`⌘E`
Upload to cloud	`⌘U`
Pin to screen	`⌘P`
Delete	`⌘⌫`
Close	`⌘W`

Automation

Snapzy registers the snapzy:// URL scheme so launchers and automation tools (such as the Raycast Extension, Alfred, or custom scripts) can trigger capture actions. This integration can be toggled on or off under Settings -> Advanced -> URL Scheme integration.

Action	URL
Fullscreen screenshot	`snapzy://capture/fullscreen`
Area screenshot	`snapzy://capture/area`
Repeat area screenshot	`snapzy://capture/repeat-area`
Application window	`snapzy://capture/application`
Active window	`snapzy://capture/active-window`
Area annotate	`snapzy://capture/area-annotate`
Scrolling screenshot	`snapzy://capture/scrolling`
OCR text capture	`snapzy://capture/ocr`
Smart element capture	`snapzy://capture/smart-element`
Object cutout capture	`snapzy://capture/object-cutout`
Screen recording	`snapzy://record/screen`
Application recording	`snapzy://record/application`
Open Annotate	`snapzy://open/annotate`
Combine images	`snapzy://open/combine`
Open Video Editor	`snapzy://open/video-editor`
Open Cloud Uploads	`snapzy://open/cloud-uploads`
Open Capture History	`snapzy://open/history`
Show shortcuts list	`snapzy://show/shortcuts`
Open Settings	`snapzy://settings`
Open Settings tab	`snapzy://settings?tab=annotate`

snapzy://open/combine opens the image picker. Automation tools can skip the picker by passing two or more URL-encoded local paths as repeated file parameters:

open 'snapzy://open/combine?file=/tmp/first.png&file=/tmp/second.png'

Development

For local setup, source builds, and first-time development workflow, start with docs/DEVELOPMENT.md.

If you need archive, export, or DMG packaging commands, see docs/BUILD.md. If you want the contribution workflow, see CONTRIBUTING.md.

Documentation

Ask DeepWiki (interactive docs assistant)
Docs map for humans and agents
Project structure and runtime architecture
App lifecycle, onboarding, and menu bar
Capture: screenshot flows · scrolling capture · recording · post-capture routing
Editors: Quick Access · capture history · Annotate · Video Editor
Platform: cloud upload · shortcuts & URL scheme · settings reference · updates & diagnostics
TOML configuration export/import
Build and packaging guide
Release and update workflow
Local Sparkle update testing

Community

Join the Snapzy Discord community for support, feedback, and discussion: https://discord.gg/xkWDAuJkZu

Featured On

Benchmark

OCR

Benchmark date: April 19, 2026. Current OCR numbers come from scripts/run-ocr-readme-benchmark.sh on a clean synthetic wrapped UI/article-text corpus with 12 samples / language across 10 supported languages. Character accuracy is the primary signal, exact match is intentionally strict, and no-output on this corpus is 0% for all languages below.

Language	Character Accuracy	Exact Match
English	100.0%	100.0%
Vietnamese	100.0%	100.0%
Simplified Chinese	99.3%	75.0%
Traditional Chinese	99.0%	66.7%
Spanish	99.9%	91.7%
Japanese	99.4%	66.7%
Korean	99.7%	83.3%
Russian	100.0%	100.0%
French	99.3%	33.3%
German	99.8%	75.0%

Real-world screenshots can score lower, especially with emoji, low-contrast footers, unusual punctuation, gradients, blur, or decorative fonts.

Security

Snapzy runs inside the macOS App Sandbox with minimal entitlements. Network requests are limited to Sparkle update checks, local loopback OAuth callback redirection, user-initiated cloud uploads to your own cloud storage (AWS S3, Cloudflare R2, or Google Drive), and optional user-initiated OCR model downloads from HTTPS/Hugging Face sources the user explicitly defines. Snapzy bundles no OCR models and its model catalog ships empty, so no model is referenced or fetched unless you add one. Model manifests are validated locally and importing metadata performs no download. The default built-in OCR engine runs entirely on-device; if you explicitly add a custom OCR endpoint in Settings, OCR requests (including the captured image) go to that endpoint. Cloud credentials and OAuth tokens are stored exclusively in the macOS Keychain, can be further protected with an optional password (SHA-256 hashed, never stored in plaintext), and can only be transferred via a manual encrypted export/import flow protected by a user-supplied archive passphrase. Custom OCR endpoint API keys are likewise stored only in the macOS Keychain and are never included in config or credential exports. Snapzy collects no telemetry.

To report a vulnerability, please use a GitHub Security Advisory or contact the maintainer privately. See SECURITY.md for full details.

Contributing

Contributions are welcome. Read CONTRIBUTING.md before opening a pull request.

Contributors

Thanks to all the people who contribute to Snapzy!

Star History

Acknowledgments

Snapzy is inspired by CleanShot X, an advanced screenshot and screen recording application for macOS.

License

BSD 3-Clause License. See LICENSE.

altic-dev/FluidVoice

Fastest and only macOS Dictation app with on-device STT and custom trained AI enhancement model. A local Wispr Flow alternative. ⭐ helps a ton :) Windows & iOS waitlist open. Linux soon.

FluidVoice

Open source voice-to-text dictation app for macOS with on-device AI enhancement.

Install with Homebrew: brew install --cask fluidvoice

Manual download: latest release

Note

FluidVoice is on macOS today. iOS and Windows are on the way — join the waitlist to get notified when we launch: altic.dev/fluid/waitlist

Important

This project is free and open source under GPLv3. If FluidVoice is useful to you, please star the repository — it helps visibility and keeps development going.

Support FluidVoice

If FluidVoice helps you, you can support continued development and future platform work for iOS and Windows on GitHub Sponsors.

What's New in 1.6.0

Insanely fast Parakeet — rebuilt Parakeet implementation with pretty much zero delay between speaking and seeing words on screen
Fluid Intelligence — fully local AI model for on-device dictation enhancement. No cloud, no API keys, no data leaving your Mac
Better Theming — adaptive light/dark theme with a compact toolbar switcher
Refreshed Onboarding — language-first voice engine setup, real dictation tryout, and AI enhancement setup in one clean pass

Warning

Based on early feedback, Fluid Intelligence may cause you to unsubscribe from other dictation apps and save money. You've been warned.

Fluid Intelligence

FluidVoice is fully open source under GPLv3. Fluid Intelligence is a separate, privately maintained local AI runtime that powers advanced on-device dictation enhancement — smart formatting, context-aware capitalization, and post-processing — all running locally on your Mac.

The app works great on its own with any supported speech model and optional cloud AI providers. Fluid Intelligence adds a fully local, private AI layer for users who want on-device enhancement without sending data anywhere.

We're keeping Fluid Intelligence private for now so we can sustainably offer the core dictation experience for free. This may change in the future.

Fluid Intelligence Sneak Peek

Email Template	Flowers

Change Time & Name	Emoji

Hyphens & Numbers

Demo

Command Mode — Take any action on your Mac using FluidVoice

https://github.com/user-attachments/assets/ffb47afd-1621-432a-bdca-baa4b8526301

Write Mode — Write or rewrite text in any text box in any app

https://github.com/user-attachments/assets/c57ef6d5-f0a1-4a3f-a121-637533442c24

Features

Fluid Intelligence — on-device AI enhancement for smart formatting, context-aware capitalization, and post-processing, all running locally on your Mac with zero data leaving your machine
Command Mode — control your Mac by voice: launch apps, run shortcuts, trigger system actions, and automate workflows without touching the keyboard
Write Mode — write or rewrite text directly in any text field across any app. Select text and rewrite it, or dictate new content inline
Live Preview — real-time transcription overlay with notch support, so you see words appear as you speak
Multiple Speech Models — Nemotron Speech 3.5, Parakeet Flash, Parakeet TDT v3 & v2, Cohere Transcribe, Apple Speech, and Whisper. Pick the model that fits your language and latency needs
AI Enhancement — optional post-processing via OpenAI, Groq, custom providers, or local Fluid Intelligence for cleaner, more accurate transcripts
Audio History — optional local recording history with budget controls and ZIP export, so you can review past dictations without cloud storage
Today-Usage Stats — daily usage tracking at a glance with a stats header card and toolbar pill
Adaptive Theming — light/dark theme that follows your system, with a compact toolbar switcher
Global Hotkey — instant voice capture from anywhere, no app switching needed
Smart Typing — direct insertion into any app via accessibility APIs for reliable, app-independent text entry
Menu Bar Integration — quick access, status, and settings from the menu bar
Auto-Updates — seamless updates with an optional beta channel for early previews
Per-App Configuration — assign different prompt sets to different apps, so your dictation adapts to whatever you're working in. Fully optional
Notch-Aware Overlay — transcription overlay that fits cleanly around the MacBook notch, or use a standard overlay if your Mac doesn't have one
Local-First — your voice and text never leave your machine unless you opt in to a cloud AI provider
Fastest Parakeet on Mac — one of the fastest native implementations of Parakeet on macOS, with near-instant transcription and minimal latency
Configurable Overlay — choose from pill-shaped to large overlay sizes to show live preview, or keep it minimal. Everything is optional
Everything is Optional — AI enhancement, Fluid Intelligence, audio history, analytics, and beta builds are all opt-in. The core dictation experience works out of the box with zero configuration beyond permissions and a hotkey

Supported Models

Model	Best for	Language support	Download size	Hardware
Nemotron Speech 3.5 — Ultra Fast Low Latency	Streaming-capable multilingual dictation	~40 languages	~670 MB	Apple Silicon
Nemotron 3.5 Multilingual	Higher-accuracy multilingual dictation	~40 languages	~530 MB	Apple Silicon
Parakeet Flash (Beta)	Lowest-latency live English dictation	English	~250 MB	Apple Silicon
Parakeet TDT v3	Fast default multilingual dictation	25 languages	~500 MB	Apple Silicon
Parakeet TDT v2	Fastest English-only dictation	English	~500 MB	Apple Silicon
Cohere Transcribe	High-accuracy multilingual dictation	14 languages	~1.4 GB	Apple Silicon
Apple Speech	Zero-download native macOS speech	System languages	Built-in	Apple Silicon + Intel
Whisper Tiny / Base / Small / Medium / Large	Broad compatibility, including Intel Macs	99 languages	~75 MB to ~2.9 GB	Apple Silicon + Intel

Parakeet TDT v3 Languages

Bulgarian, Croatian, Czech, Danish, Dutch, English, Estonian, Finnish, French, German, Greek, Hungarian, Italian, Latvian, Lithuanian, Maltese, Polish, Portuguese, Romanian, Russian, Slovak, Slovenian, Spanish, Swedish, and Ukrainian.

Parakeet TDT v2 Languages

English.

Cohere Transcribe Languages

English, French, German, Italian, Spanish, Portuguese, Greek, Dutch, Polish, Mandarin, Japanese, Korean, Vietnamese, and Arabic.

Apple Speech Languages

System language support depends on the macOS speech recognition languages available on your machine.

Whisper Language Support

Whisper supports up to 99 languages, depending on the model size you choose.

Quick Start

Install with Homebrew:
```
brew install --cask fluidvoice
```
Or download the latest release.
Grant permissions — FluidVoice will ask for microphone and accessibility access. Both are required for dictation and typing into other apps.
Set your hotkey — pick a global hotkey in settings that triggers voice capture from anywhere.
Go through onboarding — choose your voice model based on your language and latency needs. Models range from zero-download Apple Speech to high-accuracy Nemotron and Whisper.
(Optional) Enable Fluid Intelligence — download the local AI model during onboarding for on-device dictation enhancement. Everything runs locally, no data leaves your Mac.
(Optional) Bring your own AI provider — add an OpenAI, Groq, or custom provider API key for cloud-based enhancement. Keys are stored securely in macOS Keychain. Select "Always allow" for key access.
(Optional) Opt in to beta builds — Settings → Automatic Updates → Beta Releases for early access to new features.

Requirements

macOS 15.0 (Sequoia) or later
Apple Silicon Mac for all models
Intel Macs supported via Whisper models (from 1.5.1+)
~1 GB disk space for a voice model
~3.5 GB disk space for the Fluid Intelligence model (optional)
Microphone access
Accessibility permissions for typing

Building from Source

git clone https://github.com/altic-dev/FluidVoice.git
cd FluidVoice
open Fluid.xcodeproj

Build and run in Xcode. All dependencies are managed via Swift Package Manager.

Run a signed Debug build using the script:

./build.sh

The signed build is written to DerivedData/Build/Products/Debug/FluidVoice Debug.app. Keep launching that product after each rebuild so macOS can preserve its Accessibility authorization.

For CI or contributors who do not have a signing identity, use the explicit unsigned fallback:

./build.sh unsigned

Unsigned builds are tied to a specific executable version and may require Accessibility permission to be removed and granted again after rebuilding.

Contributing

Contributions are welcome! Please create an issue first to discuss major changes before submitting a pull request.

Development Setup

Clone and open in Xcode as above.
Signing: FluidVoice → Signing & Capabilities → Automatically manage signing → pick your Team (Personal Team is fine). If you have certificates for multiple teams, select one without changing the project by running FLUIDVOICE_DEVELOPMENT_TEAM=YOUR_TEAM_ID ./build.sh.
Build and run — SPM handles dependencies.

(Optional) Pre-commit hook to prevent accidental team ID commits:

cp scripts/check-team-id.sh .git/hooks/pre-commit
chmod +x .git/hooks/pre-commit

Pull Request Guidelines

One feature or fix per PR — keep changes focused and atomic
Create an issue first so work is trackable before review
Discuss non-trivial changes before opening a PR
Follow the PR template
Test thoroughly on your machine
Never commit personal team IDs or API keys
Check git diff before committing

Run Integration Tests

xcodebuild test -project Fluid.xcodeproj -scheme Fluid -destination 'platform=macOS'

CI uses unsigned builds:

xcodebuild test -project Fluid.xcodeproj -scheme Fluid -destination 'platform=macOS' CODE_SIGNING_REQUIRED=NO CODE_SIGNING_ALLOWED=NO

Privacy & Analytics

FluidVoice is local-first. Your voice, audio, and transcribed text never leave your machine unless you explicitly opt in to a cloud AI provider.

What's Collected (Opt-In)

Anonymous analytics are enabled by default to track app health and feature usage. You can disable at any time from Settings → Share Anonymous Analytics.

Collected:

App version, build, macOS version
Low-cardinality feature/config flags (e.g. app mode, major settings)
Approximate usage ranges (not exact values)
High-level success/error outcomes

Not Collected:

Voice, raw audio, or transcribed text
Selected text, prompts, or AI responses
Terminal commands, window titles, file paths, clipboard, or typed content
Any personal or private information

Community

Join our Discord: https://discord.gg/VUPHaKSvYV

Follow development on X: @ALTIC_DEV

License

From 2026-02-23 onward, this project is licensed under the GNU General Public License, Version 3.0 (GPLv3).

Versions published before this date were licensed under Apache License 2.0.

steipete/CodexBar

Show usage stats for OpenAI Codex and Claude Code, without having to login.

CodexBar 🎚️ — May your tokens never run out.

Every AI coding limit, in your menu bar.

Tiny macOS 14+ menu bar app that keeps AI coding-provider limits visible and shows when each window resets. Codex, OpenAI, Claude, Cursor, Gemini, Copilot, Grok, GroqCloud, ElevenLabs, Deepgram, z.ai, MiniMax, Kiro, Zed, Vertex AI, Augment, OpenRouter, LiteLLM, LLM Proxy, Codebuff, Command Code, ClinePass, AWS Bedrock, and many newer coding providers. One status item per provider, or Merge Icons mode with a provider switcher. No Dock icon, minimal UI, dynamic bar icons.

Why

Plan around resets. Per-provider session, weekly, and monthly windows with countdowns to the next reset — stop guessing whether to start that long task.
Credits, spend, and cost scans. Credit balances, Admin API spend dashboards, provider billing summaries, and local cost scans where the source exposes enough detail.
Live status. Provider status polling surfaces incident badges in the menu and an indicator overlay on the bar icon.
Privacy-first. Reuses existing provider sessions — OAuth, device flow, API keys, browser cookies, local files — so no passwords are stored.

Install

Requirements

macOS 14+ (Sonoma)

GitHub Releases

Download: https://github.com/steipete/CodexBar/releases

Homebrew

brew install --cask codexbar

CLI Tarballs (macOS/Linux)

Homebrew formula (Linux today):

brew install steipete/tap/codexbar

Arch Linux AUR package:

yay -S codexbar-cli

Or download release tarballs from GitHub Releases:

macOS: CodexBarCLI-v<tag>-macos-arm64.tar.gz, CodexBarCLI-v<tag>-macos-x86_64.tar.gz
Linux (glibc): CodexBarCLI-v<tag>-linux-aarch64.tar.gz, CodexBarCLI-v<tag>-linux-x86_64.tar.gz
Linux (static musl): CodexBarCLI-v<tag>-linux-musl-aarch64.tar.gz, CodexBarCLI-v<tag>-linux-musl-x86_64.tar.gz

First run

Open Settings → Providers and enable what you use.
Install/sign in to the provider sources you rely on: CLIs, browser sessions, OAuth/device flow, API keys, local app files, or provider apps depending on the provider.
Optional: Settings → Providers → Codex → OpenAI cookies (Automatic or Manual) to add dashboard extras.

Set API keys from the CLI

Provider toggles and API keys live in the resolved CodexBar config file. New installs use ~/.config/codexbar/config.json; existing ~/.codexbar/config.json installs still load from the legacy path. You can script the same provider list that Settings → Providers uses:

codexbar config providers
codexbar config enable --provider grok
codexbar config disable --provider cursor

For API-key providers, store a key without opening Settings:

printf '%s' "$ELEVENLABS_API_KEY" | codexbar config set-api-key --provider elevenlabs --stdin

set-api-key trims the piped value, stores it with restrictive config-file permissions, and enables the provider by default. Use --no-enable to only save the key, or --api-key <key> for one-off local scripts where shell history is not a concern. See CLI configuration for the full flow.

Providers

Codex — OAuth API or local Codex CLI, plus optional OpenAI web dashboard extras.
OpenAI — Admin API key usage/cost graphs with legacy credit-balance fallback.
Azure OpenAI — API key, endpoint, and deployment validation probe.
Claude — OAuth API, browser cookies, or CLI PTY fallback; session and weekly usage where available.
Cursor — Browser session cookies for plan + usage + billing resets.
OpenCode — Browser cookies for workspace subscription usage.
OpenCode Go — Browser or local SQLite data for Go usage windows.
Alibaba Coding Plan — Web cookies or API key for coding-plan quotas.
Alibaba Token Plan — Bailian browser/manual cookies for token-plan credits.
Qwen Cloud — 5-hour and weekly individual Token Plan usage via browser/manual cookies.
Gemini — OAuth-backed quota API using Gemini CLI credentials (no browser cookies).
Antigravity — Local language server probe, agy CLI HTTPS source, and Google OAuth fallback (experimental).
Droid — Browser cookies + WorkOS token flows for Factory usage + billing.
Copilot — GitHub device flow + Copilot internal usage API.
Devin — Chrome localStorage session or manual Bearer token for daily and weekly quotas.
z.ai — API token for personal/team quota, MCP, 5-hour, and hourly usage windows.
Manus — Browser session_id auth for credit balance, monthly credits, and daily refresh tracking.
MiniMax — API token, cookie header, or browser cookies for coding-plan usage.
T3 Chat — Browser cookies capture for Base and Overage usage buckets.
ZoomMate — Chrome cookie auto-import or manual cURL capture for credits usage.
Kimi — Auth token (JWT from kimi-auth cookie) for weekly quota + 5‑hour rate limit.
Kilo — API token with CLI-auth fallback for Kilo Pass usage.
Kiro — CLI-based usage; monthly credits + bonus credits.
Vertex AI — Google Cloud gcloud OAuth with token cost tracking from local Claude logs.
Augment — Augment CLI or browser cookies for credits tracking and usage monitoring.
Amp — Browser cookie-based authentication with Amp Free usage tracking.
Ollama — API key access plus browser cookies for Ollama Cloud usage windows.
Synthetic — API key quota endpoint for rolling five-hour, weekly token, and search-hourly usage.
JetBrains AI — Local XML-based quota from JetBrains IDE configuration; monthly credits tracking.
Warp — API token for GraphQL request limits and monthly credits.
ElevenLabs — API key for character credits and voice slot usage.
OpenRouter — API token for credit-based usage tracking across multiple AI providers.
Windsurf — Browser localStorage session import or local SQLite cache for plan usage.
Zed — Zed editor Keychain session for plan, edit-prediction quota, billing cycle, and overdue invoices.
Perplexity — Account usage credits from Perplexity usage data.
Xiaomi MiMo — Browser cookies for balance and token-plan usage.
Doubao — API key for Volcengine Ark request-limit probes.
Sakana AI — Manual Cookie header for 5-hour and weekly quota windows.
Abacus AI — Browser cookie auth for ChatLLM/RouteLLM compute credit tracking.
Mistral — Browser cookies for API spend, credit balance, and monthly-plan usage.
DeepSeek — API key for credit balance tracking (paid vs. granted breakdown).
Fireworks — API key + account slug for 30-day spend from the billing summary API.
DeepInfra — API key for prepaid balance, current-month spend, and spending-limit tracking.
Moonshot / Kimi API — API key for Moonshot/Kimi API account balance tracking.
Venice — API key for DIEM or USD balance tracking.
Codebuff — API token (or ~/.config/manicode/credentials.json) for credit balance + weekly rate limit.
Crof — API key for dollar credit balance and optional request quota tracking.
Command Code — Browser or manual cookies for monthly USD credits from Command Code billing.
Qoder — Browser or manual cookies for Qoder big model credit usage.
StepFun — Username + password login for Step Plan rate limits (5‑hour + weekly windows) and subscription plan name.
AWS Bedrock — AWS access keys or a named AWS profile (SSO/assume-role via the AWS CLI) for Cost Explorer spend, monthly budgets, and optional CloudWatch Claude activity.
Grok — Grok CLI billing RPC plus grok.com browser-session fallback.
GroqCloud — API key for Enterprise Prometheus request/token/cache-hit metrics.
LLM Proxy — API key + base URL for aggregate proxy quota stats and provider breakdowns.
ClawRouter — API key for monthly budget, spend, requests, tokens, and routed-provider usage.
sub2api — Self-hosted gateway key quota, subscription limits, wallet balance, and per-key usage.
Wayfinder — Local router gateway polling for health, per-route breakdown, savings, and decision latency.
LiteLLM — Virtual key + proxy URL for personal and team budget/spend tracking.
Deepgram — API key usage summaries across speech, agent, token, and TTS metrics.
Poe — API key for current point balance and recent points history.
Chutes — API key for subscription usage, rolling and monthly quota windows, and pay-as-you-go quotas.
Neuralwatt — API key for subscription kWh usage and prepaid credit balance.
ZenMux — Management API key for rolling five-hour and seven-day quota windows plus PAYG balance.
xAI — Management API key + team ID for prepaid credit balance and daily platform spend.
IBM Bob — API key for monthly Bobcoin budget and usage across subscription teams.
Open to new providers: provider authoring guide.

Icon & Screenshot

The menu bar icon is a tiny usage meter. Bar meaning is provider-specific, and errors/stale data can dim the icon or show an incident indicator.

Features

Multi-provider menu bar with per-provider toggles (Settings → Providers).
Provider-specific usage meters with reset countdowns.
Optional Codex web dashboard enrichments (code review remaining, usage breakdown, credits history).
Inline spend and usage charts for API-backed providers such as OpenAI, Claude Admin API, OpenRouter, LiteLLM, z.ai, MiniMax, Mistral, and AWS Bedrock.
Configurable cost-usage scans for Codex + Claude, plus reused chart UI for supported provider histories. Codex history uses a WAL-enabled SQLite store capped at 25,000 retained session entries and 256 MiB.
A persistent Settings → Usage & Spend view for local 7/30-day estimates, grouped by native currency and limited to providers that expose cost history.
Provider status polling with incident badges in the menu and icon overlay.
Merge Icons mode to combine providers into one status item + switcher.
Display controls for provider icons, labels, bars, reset-time style, and highest-usage auto-selection.
Fresh installs default to Adaptive refresh. Existing users keep every valid stored choice, while legacy unset or invalid preferences resolve to 5 minutes. Manual and fixed 1m, 2m, 5m, 15m, and 30m alternatives remain available.
Bundled CLI (codexbar) for scripts and CI (including codexbar cost --provider codex, claude, or both for local cost usage); macOS and Linux CLI builds available.
WidgetKit widgets for supported providers.
Localized app and website with a shared 21-language catalog, automatic website detection, persistent pickers, and RTL support.
Optional session quota notifications and weekly-reset confetti.
Privacy-first: on-device parsing by default; browser cookies are opt-in and reused (no passwords stored).

Privacy note

Wondering if CodexBar scans your disk? It doesn’t crawl your filesystem; it reads a small set of known locations (browser cookies/local storage, provider config files, local JSONL logs) when the related features are enabled. Plain Adaptive refresh never inspects local agent activity. The separate Adaptive (agent-aware) option asks before inspecting the running-process list (including command lines) to identify Codex/Claude and reading bounded known-session metadata. Declining returns to plain Adaptive. When allowed with Agent Sessions hidden, CodexBar retains only the latest activity time and discards session paths and identities. Provider tokens and token-account settings live in the CodexBar config file with restrictive file permissions. See the discussion and audit notes in issue #12.

macOS permissions (why they’re needed)

Full Disk Access (optional): only required to read Safari cookies/local storage for web-based providers. If you don’t grant it, use another supported browser, manual cookies/API keys, OAuth, or CLI/local sources where that provider supports them.
Keychain access (prompted by macOS):
- Chromium cookie import needs the browser “Safe Storage” key to decrypt cookies.
- Claude OAuth bootstrap may read the Claude CLI Keychain item when CodexBar has no usable cached credentials.
- CodexBar may use Keychain for browser cookie decryption, cached cookie headers, and OAuth/device-flow credentials where those sources require it.
- How do I prevent those keychain alerts?
  - Open Keychain Access.app → login keychain → search the prompted item (for Claude OAuth, usually “Claude Code-credentials”).
  - Open the item → Access Control → add CodexBar.app under “Always allow access by these applications”.
  - Prefer adding just CodexBar (avoid “Allow all applications” unless you want it wide open).
  - Relaunch CodexBar after saving.
  - Reference screenshot:
- How to do the same for the browser?
  - Find the browser’s “Safe Storage” key (e.g., “Chrome Safe Storage”, “Brave Safe Storage”, “Microsoft Edge Safe Storage”).
  - Open the item → Access Control → add CodexBar.app under “Always allow access by these applications”.
  - This removes the prompt when CodexBar decrypts cookies for that browser.
- Last resort — stop all Keychain reads entirely: if "Always Allow" doesn't stick (e.g., macOS resets the ACL after a Chromium update or a partition_id reset), open CodexBar → Settings → Advanced → Keychain access and enable Disable Keychain access. CodexBar will no longer touch the Keychain. Browser-cookie-based providers will be skipped, but Claude/Codex OAuth via the CLI still works (it reads ~/.codex / ~/.claude config files, not the Keychain).
- Prompt after uninstall? Deleting the app prevents a new launch from that bundle, but an already-running CodexBar process can keep requesting Keychain access until it quits. Check for that process, a Login Item, another installed copy, or a prompt that names a different requesting binary/path. See Keychain prompt troubleshooting for safe checks and what to include in a support report without sharing secrets.
Files & Folders prompts (folder/volume access): CodexBar launches provider CLIs and local probes for some providers. If those helpers read a project directory or external drive, macOS may ask CodexBar for that folder/volume (e.g., Desktop or an external volume). This is driven by the helper’s working directory, not background disk scanning.
What we do not request in the background: no Screen Recording or Accessibility permissions; user-triggered helper actions may ask macOS for Automation permission to open Terminal. No passwords are stored (browser cookies are reused when you opt in).

Docs

Providers overview: docs/providers.md
Provider authoring: docs/provider.md
Issue labeling guide: docs/ISSUE_LABELING.md
UI & icon notes: docs/ui.md
CLI reference: docs/cli.md
Configuration: docs/configuration.md
Keychain prompts: docs/keychain-prompts.md
CLI configuration: docs/cli-configuration.md
Widgets: docs/widgets.md
Architecture: docs/architecture.md
Refresh loop: docs/refresh-loop.md
Status polling: docs/status.md
Sparkle updates: docs/sparkle.md
Packaging: docs/packaging.md
Development: docs/DEVELOPMENT.md
Release checklist: docs/RELEASING.md
Changelog: CHANGELOG.md

Getting started (dev)

Clone the repo and open it in Xcode or run the scripts directly.
Launch once, then toggle providers in Settings → Providers.
Install/sign in to provider sources you rely on (CLIs, browser cookies, OAuth/device flow, API keys, or local app/config files).
Optional: set OpenAI cookies (Automatic or Manual) for Codex dashboard extras.

Build from source

Requires macOS 14+ and Swift 6.2+.

./Scripts/package_app.sh        # builds CodexBar.app in-place with ad-hoc signing
open CodexBar.app

Dev loop:

./Scripts/compile_and_run.sh
./Scripts/compile_and_run.sh --test  # also run the sharded test suite before packaging/relaunching
make check                           # SwiftFormat + SwiftLint
make docs-list                       # list docs with frontmatter summaries

CLI install:

# after installing CodexBar.app in /Applications
./bin/install-codexbar-cli.sh

✂️ Trimmy — “Paste once, run once.” Flatten multi-line shell snippets so they paste and run.
🧳 MCPorter — TypeScript toolkit + CLI for Model Context Protocol servers.
🧿 oracle — Ask the oracle when you're stuck. Invoke GPT-5 Pro with a custom context and files.

Looking for a Windows version?

Win-CodexBar

Linux desktop integration?

codexbar-waybar — Waybar custom module + GTK4 popover for Hyprland / Sway / other Wayland compositors, built on top of the bundled Linux CLI.
codexbar-cosmic-applet — Native COSMIC (System76) desktop panel applet with a tab per provider, pace projections, and cost/token stats, built on top of the bundled Linux CLI.
Codexbar GNOME — GNOME Shell extension that brings CodexBar usage into the desktop panel.
codexbar-cinnamon-applet — Linux Mint Cinnamon panel applet powered by CodexBar's JSON output.
noctalia-codex-usage — Noctalia/Quickshell plugin that shows Codex 5-hour and weekly usage limits, built on top of the bundled Linux CLI.
KodexBar — KDE Plasma widget that shows CodexBar usage in the Plasma panel, built on top of the bundled Linux CLI.
codexbar-plasmoid — KDE Plasma 6 widget for CodexBar's meter icon, provider switcher, quota windows, pace, credits, local cost, and status, powered by the bundled Linux CLI.
CodexBar Plasma — KDE Plasma 6 widget with multi-provider views, account selection, cost history, notifications, configurable providers, and installable .plasmoid releases, powered by the bundled Linux CLI.
CodexBar Meter — Noctalia v5 bar widget and panel showing every enabled provider's quota windows, credits, and pace, installable from Noctalia's plugin store, built on the bundled Linux CLI.

Status bar & terminal integration

showy-quota — always-on AI plan quota strips for SketchyBar, tmux, and Zellij (standalone WASM plugin), built on codexbar serve / the bundled CLI.

Credits

Inspired by ccusage (MIT), specifically the cost usage tracking.

License

MIT • Peter Steinberger (steipete)

ronitsingh10/FineTune

FineTune, a macOS menu bar app for per-app volume control, multi-device output, audio routing, and 10-band EQ. Free and open-source alternative to SoundSource.

FineTune

Control the volume of every app independently, boost quiet ones up to 4x, route audio to different speakers, and shape your sound with EQ and headphone correction. Lives in your menu bar. Free and open-source.

English · 简体中文

Install

Homebrew (recommended)

brew install --cask finetune

Manual — Download latest release

Quick Start

Install FineTune and launch it from your Applications folder
Grant Screen & System Audio Recording permission when prompted
Click the FineTune icon in your menu bar. Apps playing audio appear automatically.

That's it. Adjust sliders, route audio, and explore EQ from the menu bar.

Tip: Want FineTune to auto-switch to a specific device when you connect it? Open edit mode (pencil icon) and drag it above the built-in speakers. This is a one-time setup. Your preferred order is saved permanently.

Features

🎚 Volume Control

Per-app volume — Individual sliders and mute for each application
Per-app volume boost — 2x / 3x / 4x gain presets
Pinned apps — Keep apps visible in the menu bar even when they're not playing, so you can configure volume, EQ, and routing in advance
Ignore apps — Completely disengage FineTune from specific apps. Tears down the audio tap so the app returns to normal macOS audio
Scroll-wheel volume — Hover any slider in the popup, the HUD, or the EQ panel and scroll to adjust.

⌨️ Keyboard

Global volume hotkeys — Bind your own keys to App Volume Up, App Volume Down, and App Mute from Settings → Shortcuts. The "app" is whichever is currently making sound, so volume-down while a YouTube tab plays behind a foreground Terminal turns down YouTube, not the terminal. If nothing is audible, the hotkey falls through to the frontmost app.
Toggle the popup from anywhere — Bind a hotkey to Toggle FineTune Popup and the menu bar opens or closes on demand, including from full-screen apps.
Configurable step size — Pick Coarse / Normal / Fine / Extra-Fine under Settings → Shortcuts → Volume Step. The same setting governs the F10–F12 media keys, the global hotkeys, and the popup's arrow-key navigation.
Hold to ramp, auto-unmute on volume-up — Holding App Volume Up or Down emits repeats the way macOS does for arrow keys. Volume-up while muted unmutes and sets the new level in one keystroke.
Drive the popup with the keyboard — Once the popup is open, ↑ / ↓ move between rows, ← / → adjusts the focused row's volume (Shift = 2× step), M toggles mute, Return / Space activates, Tab switches between Output and Input device tabs, Esc closes. The focused row autoscrolls to center as you arrow through.

🔀 Audio Routing

Multi-device output — Route audio to multiple devices simultaneously
Audio routing — Send apps to different outputs or follow system default
Device priority — Choose which device FineTune switches to when a new device connects; auto-fallback on disconnect
Auto-restore — When a device reconnects, apps automatically return to it with their volume, routing, and EQ intact

🎛 EQ & Correction

10-band EQ — 20 presets across 5 categories
User EQ presets — Save, rename, and manage custom EQ configurations per app
AutoEQ headphone correction — Search thousands of headphone profiles or import your own ParametricEQ.txt files for per-device frequency response correction
Loudness compensation — Automatic bass and treble correction at low volumes using ISO 226:2023 equal-loudness contours, with real-time level management to keep perceived loudness consistent

🖥 Devices & System

Input device control — Monitor and adjust microphone levels
Alert volume — Control macOS notification and alert volume from settings
Smart volume backend — FineTune auto-picks hardware, DDC, or software volume per device. If the hardware slider on a USB DAC or HDMI output doesn't actually control level, force software volume from the device inspector and FineTune remembers the choice for that device
Device inspector — Tap the info button on any device row for sample rate (with picker), transport, UID copy, hog-mode banner, and the software-volume override
Hide devices — Eye toggle in edit mode hides output and input devices you don't want in the list, mirroring the app-hide flow
Bluetooth device management — Connect paired devices directly from the menu bar
Monitor speaker control — Adjust volume on external displays via DDC
Media keys & Volume HUD — Opt-in F10–F12 control for the default output device, with a Tahoe-style or Classic-style on-screen HUD. The write goes through FineTune's volume pipeline, so keys keep working on USB interfaces and HDMI outputs where macOS's own keys are greyed out because the hardware slider is broken.
Dynamic menu bar icon — Pick from four styles in Settings (Default, Speaker, Waveform, Equalizer). The Speaker style tracks volume live (zero / low / mid / high glyphs) and switches to a slashed speaker when muted. All styles briefly flash the new output's SF Symbol on device switch. Changing style applies instantly, no relaunch required.
Menu bar app — Lightweight, always accessible
URL schemes — Automate volume, mute, device routing, and more from scripts

🎨 Appearance

Light or Dark theme — Settings → General → Theme matches macOS or locks FineTune to Light or Dark. The menu bar popup, every popover, and the volume HUD switch immediately.
Popup density — Settings → General → Popup Size picks Compact / Comfortable / Spacious with a live tile preview. Compact fits more apps on small screens; Spacious gives bigger hit areas for trackpads.

Documentation

AutoEQ & Headphone Correction — Apply frequency correction from the AutoEQ project, import EqualizerAPO profiles, or browse autoeq.app
URL Schemes — Automate FineTune from Terminal, Shortcuts, Raycast, or scripts
Troubleshooting — Permission issues, missing apps, audio problems

Contributing

Star this repo — Help others discover FineTune
Report bugs — Open an issue
Contribute code — See CONTRIBUTING.md

Build from Source

git clone https://github.com/ronitsingh10/FineTune.git
cd FineTune
open FineTune.xcodeproj

Requirements

macOS 15.0 (Sequoia) or later
Audio capture permission (prompted on first launch)

Support

FineTune is free and open source, forever. If it made your day a little easier, you can buy me a coffee — but genuinely not expected 🙏

License

GPL v3

robinebers/openusage

Burning through your subscriptions too fast? Paying for stuff you never use? Stop guessing. OpenUsage is free and open source.

OpenUsage

Track your AI coding subscriptions from the macOS menu bar — native Swift edition.

OpenUsage shows how much of your AI coding plans you've used: session and weekly limits, credits, and spend, all in one popover. Pin your most important metrics straight into the menu bar.

Installation

Homebrew:

brew install --cask openusage

Direct download: grab the latest universal DMG from the releases page, open it, and drag OpenUsage to your Applications folder.

Either way, the app updates itself in place via signed, notarized Sparkle updates. Requires macOS 15 (Sequoia) or later.

Supported Providers

Antigravity — shared Gemini and Claude pool quotas, 5-hour and weekly windows
Claude — session, weekly, model-specific limits, extra usage, local daily spend
Codex — session, weekly, credits, local daily spend
Copilot — AI credits, extra usage, organization billing, chat and completions
Cursor — credits, total/auto/API usage, requests, on-demand, per-day spend
Devin — weekly and daily quota, extra usage balance
Grok — weekly shared pool, pay-as-you-go, local daily spend
OpenCode — Go session/weekly/monthly caps, Zen spend, local daily spend
OpenRouter — credit balance, daily/weekly/monthly spend (API key)
Z.ai — session, weekly, web-search quotas (GLM Coding Plan, API key)

Most providers read the credentials already on your machine (keychain, auth files, app state) — no extra login. OpenRouter and Z.ai are the exceptions: they have no local credential to reuse, so you supply an API key (see OpenRouter setup or Z.ai setup). Credentials are used only for the corresponding provider requests. OpenUsage's separate anonymous summaries and public pricing downloads are documented under Privacy & usage data.

Features

Menu bar pins. Pin metrics to the menu bar (up to 2 per provider); render as compact text or mini bars. The strip hides metrics with no data instead of showing placeholders.
Dashboard popover. Provider-grouped meters with live reset countdowns and pace indicators. Click usage or reset values to flip their display everywhere; right-click a row to hide or star it, refresh its provider, or open Customize.
Global shortcut. Toggle the popover from anywhere — record any combo in Settings.
Customize. Turn providers and metrics on or off, choose which rows stay Always Visible or On Demand, and drag-reorder both.
Stale-while-revalidate. Cached values display instantly at launch; refresh runs every 5 minutes.
One-shot CLI. Agents can read stable limit JSON through the same five-minute cache with openusage, or bypass freshness with openusage --force; the menu-bar app does not need to be running.
Local HTTP API. Other apps can read machine-friendly limits from 127.0.0.1:6736/v1/limits; the legacy /v1/usage UI contract remains supported. It is loopback-only and never serves credentials; note that browser pages can read it too — see the privacy note.
Proxy support. Route provider requests through SOCKS5 or HTTP(S) via ~/.openusage/config.json.
Native settings. Launch at login, global shortcut, icon style, theme, density, 12/24-hour time — see Settings.
Automatic updates. Signed, notarized in-app updates via Sparkle, with an optional beta channel.

Documentation

Behavior docs live in docs/: the dashboard, menu bar pins, settings, refresh & caching, the CLI, the local HTTP API, the proxy, and one page per provider.

For working on the code, see the developer docs: architecture, adding a provider, and debugging & capturing logs.

Requirements

macOS 15 (Sequoia) or later
Universal binary — runs natively on both Apple Silicon and Intel Macs

The Today / Yesterday / Last 30 Days spend tiles are computed natively from local CLI logs (Claude, Codex, and Grok) or Cursor's usage export — no Node.js or other runtime needed. Dollars are estimated with dynamically refreshed model pricing.

Building

swift build            # debug build
swift test             # run the test suite
./script/build_and_run.sh   # build and launch the dev app from dist/ (no install)

Architecture

SwiftPM package, SwiftUI content hosted in an AppKit-owned NSStatusItem + custom key-capable NSPanel, Swift 6 strict concurrency. The app and CLI share one module: providers implement a small ProviderRuntime protocol (auth store → usage client → mapper → ProviderSnapshot), and both surfaces read the same normalized data — see the architecture overview for how the pieces fit together and AGENTS.md for engineering conventions.

Releasing

Releases are automated: pushing a v* tag on main builds, signs, notarizes, and publishes a new version. A plain tag (v0.7.1) ships to everyone; a pre-release suffix (v0.7.1-beta.1) ships to the beta channel. The pipeline lives in .github/workflows/release.yml, and the step-by-step is in the release-swift skill.

Release setup (one-time)

The release workflow needs these repository secrets (Settings → Secrets and variables → Actions):

Secret	What it is
`APPLE_CERTIFICATE`	base64 of your Developer ID Application `.p12`
`APPLE_CERTIFICATE_PASSWORD`	the password set when exporting that `.p12`
`APPLE_ID`	the Apple ID email used for notarization
`APPLE_PASSWORD`	an app-specific password for that Apple ID
`APPLE_TEAM_ID`	your Apple Developer team ID
`APPLE_DEVELOPER_ID_ICLOUD_PROFILE`	base64 Developer ID provisioning profile for the production iCloud container
`SPARKLE_PUBLIC_KEY`	base64 EdDSA public key, baked into the build as `SUPublicEDKey`
`SPARKLE_PRIVATE_KEY`	base64 EdDSA private key used to sign the DMG
`POSTHOG_CLI_API_KEY`	PostHog personal API key used to upload dSYMs for crash symbolication
`POSTHOG_CLI_PROJECT_ID`	numeric PostHog project ID the dSYMs upload to

Export the Developer ID Application cert (with its private key) from Keychain Access as a .p12, then base64 -i DeveloperID.p12 | pbcopy. App-specific passwords come from appleid.apple.com → Sign-In and Security → App-Specific Passwords. Generate the Sparkle EdDSA key pair once with Sparkle's generate_keys tool; the public and private values must be a matching pair or signing is silently skipped.

For iCloud Sync, store the original development and Developer ID provisioning profiles in 1Password as secure documents. Install the development profile on each registered Mac; base64-encode the Developer ID profile and store it only in the APPLE_DEVELOPER_ID_ICLOUD_PROFILE Actions secret. See iCloud Sync for the container identifiers, build command, and file-inspection command.

The two POSTHOG_CLI_* secrets are only used to upload debug symbols (dSYMs) so PostHog can symbolicate crash reports: POSTHOG_CLI_API_KEY is a PostHog personal API key (PostHog → Settings → Personal API keys) and POSTHOG_CLI_PROJECT_ID is the numeric ID from your project URL. The upload host is hardcoded in the workflow (https://us.i.posthog.com), so there is no POSTHOG_CLI_HOST secret. Unlike the secrets above these don't block a release — if POSTHOG_CLI_API_KEY is unset the workflow skips the upload with a warning and the release still ships, but crash reports for that version show raw addresses instead of symbolicated stack traces.

The repository must be public (Sparkle fetches the DMG and appcast anonymously), and the appcast is served from GitHub Pages — confirm Settings → Pages points at the gh-pages branch after the first release.

Contributing

Issues are welcome. Pull requests are strict and issue-first: external PRs must link an issue a maintainer has approved with the approved label, and automation closes anything that doesn't follow the rules — so most external PRs are closed by design. Read CONTRIBUTING.md before opening one. Report security issues privately per SECURITY.md. The OpenUsage name and logo are covered by the trademark policy.

License

MIT

TelegramMessenger/Telegram-iOS

Telegram-iOS

Telegram iOS Source Code Compilation Guide

We welcome all developers to use our API and source code to create applications on our platform. There are several things we require from all developers for the moment.

Creating your Telegram Application

Obtain your own api_id for your application.
Please do not use the name Telegram for your app — or make sure your users understand that it is unofficial.
Kindly do not use our standard logo (white paper plane in a blue circle) as your app's logo.
Please study our security guidelines and take good care of your users' data and privacy.
Please remember to publish your code too in order to comply with the licences.

Quick Compilation Guide

Get the Code

git clone --recursive -j8 https://github.com/TelegramMessenger/Telegram-iOS.git

Setup Xcode

Install Xcode (directly from https://developer.apple.com/download/applications or using the App Store).

Adjust Configuration

Generate a random identifier:

openssl rand -hex 8

Create a new Xcode project. Use Telegram as the Product Name. Use org.{identifier from step 1} as the Organization Identifier.
Open Keychain Access and navigate to Certificates. Locate Apple Development: your@email.address (XXXXXXXXXX) and double tap the certificate. Under Details, locate Organizational Unit. This is the Team ID.
Edit build-system/template_minimal_development_configuration.json. Use data from the previous steps.

Generate an Xcode project

python3 build-system/Make/Make.py \
    --cacheDir="$HOME/telegram-bazel-cache" \
    generateProject \
    --configurationPath=build-system/template_minimal_development_configuration.json \
    --xcodeManagedCodesigning

Advanced Compilation Guide

Xcode

Copy and edit build-system/appstore-configuration.json.
Copy build-system/fake-codesigning. Create and download provisioning profiles, using the profiles folder as a reference for the entitlements.
Generate an Xcode project:

python3 build-system/Make/Make.py \
    --cacheDir="$HOME/telegram-bazel-cache" \
    generateProject \
    --configurationPath=configuration_from_step_1.json \
    --codesigningInformationPath=directory_from_step_2

IPA

Repeat the steps from the previous section. Use distribution provisioning profiles.
Run:

python3 build-system/Make/Make.py \
    --cacheDir="$HOME/telegram-bazel-cache" \
    build \
    --configurationPath=...see previous section... \
    --codesigningInformationPath=...see previous section... \
    --buildNumber=100001 \
    --configuration=release_arm64

FAQ

Xcode is stuck at "build-request.json not updated yet"

Occasionally, you might observe the following message in your build log:

"/Users/xxx/Library/Developer/Xcode/DerivedData/Telegram-xxx/Build/Intermediates.noindex/XCBuildData/xxx.xcbuilddata/build-request.json" not updated yet, waiting...

Should this occur, simply cancel the ongoing build and initiate a new one.

Telegram_xcodeproj: no such package

Following a system restart, the auto-generated Xcode project might encounter a build failure accompanied by this error:

ERROR: Skipping '@rules_xcodeproj_generated//generator/Telegram/Telegram_xcodeproj:Telegram_xcodeproj': no such package '@rules_xcodeproj_generated//generator/Telegram/Telegram_xcodeproj': BUILD file not found in directory 'generator/Telegram/Telegram_xcodeproj' of external repository @rules_xcodeproj_generated. Add a BUILD file to a directory to mark it as a package.

If you encounter this issue, re-run the project generation steps in the README.

Tips

Codesigning is not required for simulator-only builds

Add --disableProvisioningProfiles:

python3 build-system/Make/Make.py \
    --cacheDir="$HOME/telegram-bazel-cache" \
    generateProject \
    --configurationPath=path-to-configuration.json \
    --codesigningInformationPath=path-to-provisioning-data \
    --disableProvisioningProfiles

Versions

Each release is built using a specific Xcode version (see versions.json). The helper script checks the versions of the installed software and reports an error if they don't match the ones specified in versions.json. It is possible to bypass these checks:

python3 build-system/Make/Make.py --overrideXcodeVersion build ... # Don't check the version of Xcode

Beingpax/VoiceInk

The best open-source alternative to Superwhisper & Wispr Flow. Voice-to-text app for macOS with no subscription

VoiceInk

Voice to text app for macOS to transcribe what you say to text almost instantly

Website • YouTube

VoiceInk is a native macOS application that transcribes what you say to text almost instantly. You can find all the information and download the app from here.

After dedicating the past 5 months to developing this app, I've decided to open source it for the greater good.

My goal is to make it the most efficient and privacy-focused voice-to-text solution for macOS that is a joy to use. While the source code is now open for experienced developers to build and contribute, purchasing a license helps support continued development and gives you access to automatic updates, priority support, and upcoming features.

Features

🎙️ Accurate Transcription: Local AI models that transcribe your voice to text with 99% accuracy, almost instantly
🔒 Privacy First: 100% offline processing ensures your data never leaves your device
⚡ Modes: Intelligent app detection automatically applies your perfect pre-configured settings based on the app/ URL you're on
🧠 Context Aware: Smart AI that understands your screen content and adapts to the context
🎯 Global Shortcuts: Configurable keyboard shortcuts for quick recording and push-to-talk functionality
📝 Personal Dictionary: Train the AI to understand your unique terminology with custom words, industry terms, and smart text replacements
🔄 Smart Modes: Instantly switch between AI-powered modes optimized for different writing styles and contexts
🤖 AI Assistant: Built-in voice assistant mode for a quick chatGPT like conversational assistant

Get Started

Download

Get the latest version with a free trial from tryvoiceink.com. Your purchase helps me work on VoiceInk full-time and continuously improve it with new features and updates.

Homebrew

Alternatively, you can install VoiceInk via brew:

brew install --cask voiceink

Build from Source

As an open-source project, you can build VoiceInk yourself by following the instructions in BUILDING.md. However, the compiled version includes additional benefits like automatic updates, priority support via Discord and email, and helps fund ongoing development.

Requirements

macOS 14.4 or later

Documentation

Building from Source - Detailed instructions for building the project
Contributing Guidelines - How to contribute to VoiceInk
Code of Conduct - Our community standards

Contributing

This project is not accepting pull requests at this time. You're welcome to fork and modify VoiceInk for your own use.

You can still contribute by:

Reporting bugs via issues
Suggesting features or enhancements
Improving documentation via issues

For more details, see our Contributing Guidelines. For build instructions, see our Building Guide.

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Support

If you encounter any issues or have questions, please:

Check the existing issues in the GitHub repository
Create a new issue if your problem isn't already reported
Provide as much detail as possible about your environment and the problem

Acknowledgments

Core Technology

whisper.cpp - High-performance inference of OpenAI's Whisper model
FluidAudio - Used for Parakeet model implementation
TranscribeCpp for Swift - SwiftPM distribution of transcribe.cpp, used for Cohere Transcribe

Essential Dependencies

Sparkle - Keeping VoiceInk up to date
KeyboardShortcuts - User-customizable keyboard shortcuts
LaunchAtLogin - Launch at login functionality
MediaRemoteAdapter - Media playback control during recording
Zip - File compression and decompression utilities
SelectedTextKit - A modern macOS library for getting selected text
Swift Atomics - Low-level atomic operations for thread-safe concurrent programming

Made with ❤️ by Pax

Alamofire/Alamofire

Elegant HTTP Networking in Swift

Alamofire is an HTTP networking library written in Swift.

Features
Component Libraries
Requirements
Migration Guides
Communication
Installation
Contributing
Usage
- Introduction - Making Requests, Response Handling, Response Validation, Response Caching
- HTTP - HTTP Methods, Parameters and Parameter Encoder, HTTP Headers, Authentication
- Large Data - Downloading Data to a File, Uploading Data to a Server
- Tools - Statistical Metrics, cURL Command Output
Advanced Usage
- URL Session - Session Manager, Session Delegate, Request
- Routing - Routing Requests, Adapting and Retrying Requests
- Model Objects - Custom Response Handlers
- Advanced Concurrency - Swift Concurrency and Combine
- Connection - Security, Network Reachability
Open Radars
FAQ
Credits
Donations
License

Features

Write Requests Fast!

Alamofire's compact syntax and extensive feature set allow requests with powerful features like automatic retry to be written in just a few lines of code.

// Automatic String to URL conversion, Swift concurrency support, and automatic retry.
let response = await AF.request("https://httpbin.org/get", interceptor: .retryPolicy)
                       // Automatic HTTP Basic Auth.
                       .authenticate(username: "user", password: "pass")
                       // Caching customization.
                       .cacheResponse(using: .cache)
                       // Redirect customization.
                       .redirect(using: .follow)
                       // Validate response code and Content-Type.
                       .validate()
                       // Produce a cURL command for the request.
                       .cURLDescription { description in
                         print(description)
                       }
                       // Automatic Decodable support with background parsing.
                       .serializingDecodable(DecodableType.self)
                       // Await the full response with metrics and a parsed body.
                       .response
// Detailed response description for easy debugging.
debugPrint(response)

Component Libraries

In order to keep Alamofire focused specifically on core networking implementations, additional component libraries have been created by the Alamofire Software Foundation to bring additional functionality to the Alamofire ecosystem.

AlamofireImage - An image library including image response serializers, UIImage and UIImageView extensions, custom image filters, an auto-purging in-memory cache, and a priority-based image downloading system.
AlamofireNetworkActivityIndicator - Controls the visibility of the network activity indicator on iOS using Alamofire. It contains configurable delay timers to help mitigate flicker and can support URLSession instances not managed by Alamofire.

Requirements

Platform	Minimum Swift Version	Installation	Status
iOS 10.0+ / macOS 10.12+ / tvOS 10.0+ / watchOS 3.0+	6.0 / Xcode 16.0	CocoaPods, Carthage, Swift Package Manager, Manual	Fully Tested
Linux	Latest Only	Swift Package Manager	Building But Unsupported
Windows	Latest Only	Swift Package Manager	Building But Unsupported
Android	Latest Only	Swift Package Manager	Building But Unsupported

Known Issues on Linux and Windows

Alamofire builds on Linux, Windows, and Android but there are missing features and many issues in the underlying swift-corelibs-foundation that prevent full functionality and may cause crashes. These include:

ServerTrustManager and associated certificate functionality is unavailable, so there is no certificate pinning and no client certificate support.
Various methods of HTTP authentication may crash, including HTTP Basic and HTTP Digest. Crashes may occur if responses contain server challenges.
Cache control through CachedResponseHandler and associated APIs is unavailable, as the underlying delegate methods aren't called.
URLSessionTaskMetrics are never gathered.
WebSocketRequest is not available.

Due to these issues, Alamofire is unsupported on Linux, Windows, and Android. Please report any crashes to the Swift bug reporter.

Migration Guides

Communication

If you need help with making network requests using Alamofire, use Stack Overflow and tag alamofire.
If you need to find or understand an API, check our documentation or Apple's documentation for URLSession, on top of which Alamofire is built.
If you need help with an Alamofire feature, use our forum on swift.org.
If you'd like to discuss Alamofire best practices, use our forum on swift.org.
If you'd like to discuss a feature request, use our forum on swift.org.
If you found a bug, open an issue here on GitHub and follow the guide. The more detail the better!

Installation

Swift Package Manager

The Swift Package Manager is a tool for automating the distribution of Swift code and is integrated into the swift compiler.

Once you have your Swift package set up, adding Alamofire as a dependency is as easy as adding it to the dependencies value of your Package.swift or the Package list in Xcode.

dependencies: [
    .package(url: "https://github.com/Alamofire/Alamofire.git", .upToNextMajor(from: "5.11.0"))
]

Normally you'll want to depend on the Alamofire target:

.product(name: "Alamofire", package: "Alamofire")

But if you want to force Alamofire to be dynamically linked (do not do this unless you're sure you need it), you can depend on the AlamofireDynamic target:

.product(name: "AlamofireDynamic", package: "Alamofire")

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. For usage and installation instructions, visit their website. To integrate Alamofire into your Xcode project using CocoaPods, specify it in your Podfile:

pod 'Alamofire'

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. To integrate Alamofire into your Xcode project using Carthage, specify it in your Cartfile:

github "Alamofire/Alamofire"

Manually

If you prefer not to use any of the aforementioned dependency managers, you can integrate Alamofire into your project manually.

Embedded Framework

Open up Terminal, cd into your top-level project directory, and run the following command "if" your project is not initialized as a git repository:
```
$ git init
```

Add Alamofire as a git submodule by running the following command:

$ git submodule add https://github.com/Alamofire/Alamofire.git

Open the new Alamofire folder, and drag the Alamofire.xcodeproj into the Project Navigator of your application's Xcode project.

It should appear nested underneath your application's blue project icon. Whether it is above or below all the other Xcode groups does not matter.
Select the Alamofire.xcodeproj in the Project Navigator and verify the deployment target matches that of your application target.
Next, select your application project in the Project Navigator (blue project icon) to navigate to the target configuration window and select the application target under the "Targets" heading in the sidebar.
In the tab bar at the top of that window, open the "General" panel.
Click on the + button under the "Embedded Binaries" section.
You will see two different Alamofire.xcodeproj folders each with two different versions of the Alamofire.framework nested inside a Products folder.

It does not matter which Products folder you choose from, but it does matter whether you choose the top or bottom Alamofire.framework.
Select the top Alamofire.framework for iOS and the bottom one for macOS.

You can verify which one you selected by inspecting the build log for your project. The build target for Alamofire will be listed as Alamofire iOS, Alamofire macOS, Alamofire tvOS, or Alamofire watchOS.
And that's it!

The Alamofire.framework is automagically added as a target dependency, linked framework and embedded framework in a copy files build phase which is all you need to build on the simulator and a device.

Contributing

Before contributing to Alamofire, please read the instructions detailed in our contribution guide.

Open Radars

The following radars have some effect on the current implementation of Alamofire.

rdar://21349340 - Compiler throwing warning due to toll-free bridging issue in the test case
rdar://26870455 - Background URL Session Configurations do not work in the simulator
rdar://26849668 - Some URLProtocol APIs do not properly handle URLRequest

Resolved Radars

The following radars have been resolved over time after being filed against the Alamofire project.

rdar://26761490 - Swift string interpolation causing memory leak with common usage.
- (Resolved): 9/1/17 in Xcode 9 beta 6.
rdar://36082113 - URLSessionTaskMetrics failing to link on watchOS 3.0+
- (Resolved): Just add CFNetwork to your linked frameworks.
FB7624529 - urlSession(_:task:didFinishCollecting:) never called on watchOS
- (Resolved): Metrics now collected on watchOS 7+.

FAQ

What's the origin of the name Alamofire?

Alamofire is named after the Alamo Fire flower, a hybrid variant of the Bluebonnet, the official state flower of Texas.

Credits

Alamofire is owned and maintained by the Alamofire Software Foundation. You can follow them on Twitter at @AlamofireSF for project updates and releases.

Security Disclosure

If you believe you have identified a security vulnerability with Alamofire, you should report it as soon as possible via email to security@alamofire.org. Please do not post it to a public issue tracker.

Sponsorship

The ASF is looking to raise money to officially stay registered as a federal non-profit organization. Registering will allow Foundation members to gain some legal protections and also allow us to put donations to use, tax-free. Sponsoring the ASF will enable us to:

Pay our yearly legal fees to keep the non-profit in good status
Pay for our mail servers to help us stay on top of all questions and security issues
Potentially fund test servers to make it easier for us to test the edge cases
Potentially fund developers to work on one of our projects full-time

The community adoption of the ASF libraries has been amazing. We are greatly humbled by your enthusiasm around the projects and want to continue to do everything we can to move the needle forward. With your continued support, the ASF will be able to improve its reach and also provide better legal safety for the core members. If you use any of our libraries for work, see if your employers would be interested in donating. Any amount you can donate, whether once or monthly, to help us reach our goal would be greatly appreciated.

Sponsor Alamofire

Supporters

MacStadium provides Alamofire with a free, hosted Mac mini.

License

Alamofire is released under the MIT license. See LICENSE for details.

darrylmorley/whatcable

macOS menu bar app that tells you, in plain English, what each USB-C cable plugged into your Mac can actually do

WhatCable

What can this USB-C cable actually do?

Website: whatcable.uk (overview, screenshots, and CLI docs)

A small macOS menu bar app that tells you, in plain English, what each USB-C cable plugged into your Mac can actually do, and why your Mac might be charging slowly.

USB-C hides a lot under one connector. Anything from a USB 2.0 charge-only cable to a 240W / 40 Gbps Thunderbolt 4 cable, all looking identical in your drawer. macOS already exposes the relevant info via IOKit; WhatCable surfaces it as a friendly menu bar popover.

What it shows

Per port, in plain English:

At-a-glance headline: Thunderbolt / USB4, USB device, Display connected, Charging only, Slow USB / charge-only cable, Nothing connected
Charging diagnostic: when something's plugged in, a banner identifies the bottleneck:
- "Cable is limiting charging speed" (cable rated below the charger)
- "Charging at 30W (charger can do up to 96W)" (Mac is asking for less, e.g. battery near full)
- "Charging well at 96W" (everything matches)
- "Battery full, not charging" (plugged in, battery full, so the Mac isn't drawing power)
Mid-session fault warnings: if a cable develops trouble while it's plugged in (a power overcurrent, or the connection dropping and coming back), a banner appears on the port. It reads the port's own fault counters, so it catches faults that only show up once a cable is under load.
Data-speed diagnostic: a plain-English verdict on what's limiting the link, the Mac port, the cable, or the device. For example "Cable is limiting data speed", "Device runs at 10 Gbps, this is the fastest it supports, not a cable problem", or "Running slower than expected" when the link came up degraded. Shown inline, in the CLI, and in JSON.
Cable e-marker info: the cable's actual speed (USB 2.0, 5 / 10 / 20 / 40 / 80 Gbps), current rating (3 A / 5 A up to 60W / 100W / 240W), and the chip's vendor
USB-IF certification: cables that carry a certificate ID (XID) get a "USB-IF certified" line naming the manufacturer. The ID is read off the cable itself and matched against a list of USB-IF certifications bundled with the app, which is where the manufacturer name comes from. Nothing is looked up over the network. A cable advertising an ID that USB-IF doesn't publish gets a neutral "certified but unlisted" line instead. Certification is voluntary and Apple's own cables land there, so it's a fact about the ID, never a verdict on the cable. The raw XID is in the JSON output.
Cable trust signals: an orange card appears when the e-marker reports values that look unusual against the USB-PD spec, like a zero vendor ID, a reserved bit pattern in the speed / current / cable-latency fields, or a VID that isn't in USB-IF's published list. Wording is hedged on purpose: a flag means "this looks unusual," not "this cable is fake."
Charger PDO list: every voltage profile the charger advertises (5V / 9V / 12V / 15V / 20V…) with the currently negotiated profile highlighted in real time
Connected device identity: vendor name and product type, decoded from the PD Discover Identity response
Connected devices: each device is shown inside the thing it's actually plugged into, so a dock chained off a display reads as a chain instead of a flat pile. Hubs are hidden by default, since they're plumbing and make up about half of a typical list. Any device left sitting behind a hidden hub says "via N hubs" so nothing disappears without explanation, and a Show N hubs control brings them back for that port. Devices are grouped by USB controller when a port has more than one, and named by their maker where the name alone wouldn't tell two apart. The CLI still prints everything.
Thunderbolt fabric: when a Thunderbolt / USB4 link is active, shows per-lane speed, generation (TB3, TB4, TB5), and the full switch topology for multi-hop connections through docks, plus the active tunnels riding that link so you can see which protocol is going where
Cable identification: if the cable's e-marker fingerprint matches a known cable in the bundled database, the brand and model are shown alongside the raw specs
Active transports: USB 2 / USB 3 / Thunderbolt / DisplayPort
Desktop widget: small, medium, and large WidgetKit widgets showing live cable status on your desktop
⌥-click the menu bar icon (or flip the toggle in Settings) to reveal the underlying IOKit properties for engineers

Click the gear icon in the popover header to open Settings, where you can:

Hide empty ports
Launch at login
Run as a regular Dock app instead of a menu bar icon
Pick the menu bar icon, and show the live charging wattage next to it as either a number or a small fill bar
Adjust the font size and the window opacity
Show technical details (the same raw IOKit data that ⌥-click reveals)
Skip deep USB probing, a compatibility switch for the few KVM switches and hubs that misbehave when WhatCable reads capability info from the devices behind them
Switch language (English, Armenian, Brazilian Portuguese, Dutch, French, German, Hindi, Italian, Japanese, Korean, Latvian, Norwegian, Polish, Russian, Simplified Chinese, Spanish, Traditional Chinese, Turkish, Ukrainian, or follow your system default)
Get notifications when cables are connected or disconnected, and when an app update is available
Contribute anonymised port and power diagnostics to improve hardware coverage (opt-in, manual)

Right-click the menu bar icon for Refresh, a Keep window open toggle (handy for screenshots and demos), and Settings…. The Pro screens (Power Monitor, Negotiation Diagnostics, Display Diagnostics, Saved Cables) and Licence… live here too. Below those: Check for Updates…, Contribute Diagnostic Data…, About, WhatCable on GitHub, and Quit.

WhatCable Pro

WhatCable is free and open source. If you find it useful, you can support the project by picking up WhatCable Pro. Pro is for finding the weak link in a connection and keeping the evidence: live measurements, per-connection diagnostics, and a history of how each cable performs. It unlocks:

Cable history: add a cable, give it a name, and WhatCable keeps a record of how it actually performs over time. It recognises the cable on later connections and builds a timeline: when you last used it, what it negotiated, whether it's been misbehaving. A saved-cables list, an all-time summary per cable, and a verdict right on the port card.
Live power metering and PD contract inspection
Power Monitor with a live system power-input graph
Negotiation Diagnostics: the full per-connection breakdown, what the Mac port, cable, and device each support vs what was negotiated, side by side with the weak link highlighted, plus an e-marker vs Thunderbolt-controller cross-check
Display Diagnostics: reads your monitor's live display mode straight from macOS and compares it against what the DisplayPort link is carrying, so a screen stuck below its top resolution or refresh has an explanation. Shows the true resolution even on 5K and 6K displays, confirms full quality when a screen reaches its top mode via compression (DSC), and names any HDMI or DisplayPort adapter in the chain
Port health counters and cable resistance estimation
Terminal dashboard: a live full-screen view of every port, power, and Thunderbolt for the SSH and tmux crowd. Three screens (Overview, Negotiation, Power), Tab to switch, with a plain cable-health verdict per port. Run whatcable --dashboard
Pin diagrams and liquid detection status
Pro screens open inside the app, with an optional detach into their own window
Works even on Macs that don't expose live per-port metering

One-time purchase, works on up to 2 Macs. See whatcable.uk/pro for details.

Install

Visit whatcable.uk for an overview and screenshots, or install directly below.

Download the latest WhatCable.zip from the Releases page, unzip, and drag WhatCable.app to /Applications.

The app is signed with a Developer ID and notarised by Apple, so there are no Gatekeeper warnings.

It's not on the Mac App Store on purpose. Most of what WhatCable reads would in fact survive the App Sandbox: we tested it, and the IOKit registry reads come back identical either way. What the sandbox does block is the SMC access behind Pro's live power metering, and the bundled whatcable CLI doesn't fit the store's install model. So it ships signed and notarised outside the store instead.

Requires macOS 14 (Sonoma) or later, Apple Silicon only. This is measured, not assumed: every Intel Mac in the community diagnostic corpus reports its USB-C port-controller services as empty, so the USB-PD state and cable e-marker data WhatCable depends on are not published on those machines through any public IOKit accessor. Thunderbolt fabric data is still present on Intel; it is the port-controller layer that is missing.

Note: The manual install gives you the menu bar app only. The whatcable CLI is bundled inside the .app and is not on your PATH by default. If you want to use it from the shell, see the Command-line interface section below for the one-line symlink. Or install via Homebrew, which sets up the CLI automatically.

Homebrew

brew install --cask darrylmorley/whatcable/whatcable

This installs the menu bar app and symlinks the whatcable CLI into your PATH.

Homebrew, CLI only (no menu bar app)

If you don't want the menu bar app, install just the command-line tool:

brew install darrylmorley/whatcable/whatcable-cli

Same signed and notarised binary, packaged on its own. Useful in terminal-only or scripting environments. Pick one of the two Homebrew installs (both ship the same whatcable binary).

Homebrew 6 may warn about untrusted third-party taps on first install. If an existing install starts complaining about an untrusted tap, run brew trust darrylmorley/whatcable or see https://docs.brew.sh/Tap-Trust for details.

Command-line interface

A whatcable binary ships alongside the menu bar app, driven by the same diagnostic engine:

$ whatcable

USB-C Port 1
  ✓ Charging well at 96W
  Cable: 5A, 100W, USB4 40 Gbps
  Charger: 5V / 9V / 15V / 20V PDOs

USB-C Port 2
  ! Cable is limiting charging speed
  Cable: 3A, 60W, USB 2.0
  Device: External SSD, USB 10 Gbps

Flags:

whatcable                # human-readable summary of every port
whatcable --json         # structured JSON, pipe into jq
whatcable --watch        # stream updates as cables come and go (Ctrl+C to exit)
whatcable --raw          # include underlying IOKit properties
whatcable --report       # open a pre-filled GitHub issue for the connected cable
whatcable --test-kit     # run diagnostic probes and submit anonymised data
whatcable --no-usb-probe # skip deep USB probing (for KVM switches and hubs that misbehave)
whatcable --desktop      # launch the GUI app in Dock mode
whatcable --popover      # launch the GUI app in menu bar mode
whatcable --version
whatcable --help

Pro from the command line:

whatcable --monitor                        # Pro: live power telemetry (Ctrl+C to exit)
whatcable --monitor-json                   # Pro: live power telemetry as newline-delimited JSON
whatcable --dashboard                      # Pro: full-screen TUI dashboard (Tab cycles screens, q quits)
whatcable --activate XXXX-XXXX-XXXX-XXXX   # validate and store a Pro licence
whatcable --licence                        # show current licence status
whatcable --deactivate                     # remove the stored licence
whatcable --pro                            # show Pro features, open purchase page

The CLI prints a one-line Pro hint at the end of plain text output for unlicensed users. Run whatcable --silence-pro-hints to hide it (or --show-pro-hints to bring it back). Suppressed automatically when output is piped, redirected, or used with --json.

If you installed the .app manually rather than via Homebrew, the CLI lives at WhatCable.app/Contents/Helpers/whatcable. Symlink it into your PATH if you want it on the shell:

ln -s /Applications/WhatCable.app/Contents/Helpers/whatcable /usr/local/bin/whatcable

The Homebrew install does this for you automatically.

How it works

WhatCable reads four families of IOKit services. No entitlements, no private APIs, no helper daemons:

Service	What it gives us
`AppleHPMInterfaceType10/11/12` (M3-era), `AppleHPMInterfaceType18` (MacBook Neo A-series), `AppleTCControllerType10/11` (M1 / M2)	Per-port state: connection, transports, plug orientation, e-marker presence. `Type11` is what M2 MacBook Air uses for its MagSafe 3 port.
`IOPortFeaturePowerSource`	Full PDO list from the connected source, with the live "winning" PDO
`IOPortTransportComponentCCUSBPDSOP`, `...SOPp`, `...SOPpp`	PD Discover Identity VDOs from the port partner (SOP), the cable's near-end e-marker (SOP'), and the far-end e-marker (SOP'') if present
XHCI controller subtree	Each connected USB device is paired to its physical port via the XHCI port node's `UsbIOPort` registry path, falling back to a bus-index derived from the controller's `locationID` upper byte and the port's `hpm` SPMI ancestor on machines that don't expose `UsbIOPort`.

Cable speed and power decoding follow the USB Power Delivery spec (aligned to USB-PD R3.2 V1.2, March 2026). Vendor names come from a bundled SQLite database (whatcable.db) that merges USB-IF's published vendor list, the community usb.ids list, and a curated set of cable fingerprints reported by users.

Build from source

swift build                  # compile everything
swift run WhatCable          # run the menu bar app (dev mode, no widget or bundle structure)
swift run whatcable-cli      # run the CLI
swift test                   # run the test suite

Requires Swift 5.9+ (Xcode 15+). Note: swift run WhatCable launches a working dev build but without the widget extension or proper .app bundle. For a distributable build, use the build scripts below.

Build a distributable .app

./scripts/smoke-test.sh

Builds, signs, notarises (if configured), and smoke-tests the app. Produces dist/WhatCable.app and dist/WhatCable.zip. Safe to run on any branch, any time. Does not touch the Homebrew tap.

Modes:

Configuration	Result
No `.env`	Ad-hoc signed. Works locally; Gatekeeper warns on other Macs.
`.env` with `DEVELOPER_ID`	Developer ID signed + hardened runtime.
`.env` with `DEVELOPER_ID` + `NOTARY_PROFILE`	Full notarisation + stapled ticket. Gatekeeper-clean for everyone.

Cutting a release:

# write release-notes/v<version>.md first, then:
./scripts/release.sh <version>

The wrapper does the whole pipeline: bumps the version, runs build-app.sh (which builds, signs, notarises, smoke-tests, and bumps the local cask), tags and pushes the commit, creates the GitHub release with the notes file, verifies the uploaded asset's sha matches the local zip, copies the notes into the tap, and pushes the tap. Use --dry-run first to validate state. Requires gh (auth'd) and the env vars from .env.example.

One-time setup for full notarisation:

# 1. Find your signing identity
security find-identity -v -p codesigning

# 2. Store notarytool credentials in the keychain
xcrun notarytool store-credentials "WhatCable-notary" \
    --apple-id "you@example.com" \
    --team-id "ABCDE12345" \
    --password "<app-specific-password>"   # generate at appleid.apple.com

# 3. Create your .env from the template
cp .env.example .env
# ...and fill in DEVELOPER_ID

Caveats

Cable e-marker info only appears for cables that carry one. Most USB-C cables under 60 W are unmarked. Any Thunderbolt / USB4 cable, any 5 A / 100 W+ cable, and most quality data cables will be e-marked.
Some cables only reveal their e-marker once something is plugged in at the other end. The chip in the cable's plug runs off VCONN (a small power rail your Mac feeds into the cable) and only answers when the host issues a "Discover Identity" message. With nothing attached, some Macs read the e-marker straight away, others wait until they see a real partner to negotiate with. If a cable shows up as basic when bare, plug a charger, dock, or device into the far end and check again.
WhatCable reads from the Mac's USB-C port, the connected device or charger, and the cable itself. It cross-checks what each part of the chain reports, so if a cable claims high specs but the negotiated result is lower, you'll see where the mismatch is. That said, software cannot verify what's physically inside the jacket. If a cable's e-marker chip claims 240W / 40 Gbps but the wiring can't deliver, the chip is lying, not WhatCable. The trust-signals card flags a small set of internal-consistency tells (zero VID, reserved bit patterns in the Cable VDO, a VID not in the USB-IF list). These are common in budget cables and don't necessarily mean anything is wrong. They're informational, not a verdict.
Desktop front USB-C ports show devices, but no cable detail. On Apple Silicon desktops (Mac mini, Studio), the front USB-C ports are plain USB behind an internal hub, not full USB-C ports with their own controller like the rear Thunderbolt ports. Anything plugged into them now appears under a Built-in USB ports section, but the Mac exposes no cable, power, or PD data for them, so there's no e-marker or charging detail to show. The rear Thunderbolt ports work fully.
PD spec coverage: the decoder is aligned to USB-PD R3.2 V1.2 (March 2026). Earlier 3.0 / 3.1 cables work fine.
Vendor name lookup uses a bundled database (thousands of USB-IF entries plus the community usb.ids list). VIDs assigned after the bundled snapshot will show as "Unregistered / unknown" and trip a trust-signal flag until the database is refreshed.

Linux port

@abrauchli built a Rust port for Linux called usbeehive. Install it with cargo install usbeehive. It reads from the kernel's typec sysfs interface rather than IOKit, so it's an independent implementation rather than a fork. It started life as a whatcable crate on crates.io before being renamed to avoid confusion with this repo. He's also working on usbee, a GNOME UI for it (early stage, but the basics work).

The other half of the question

WhatCable can tell you a charger negotiated 60W when your Mac wanted 96W. It cannot tell you what that has been doing to the battery on the other end of the cable, because that is a different part of the Mac and out of scope here.

WhatBattery covers that side: unrounded battery health, live charge and discharge in watts, per-cell readings from the pack, and what happened to the charge while the Mac was asleep. Same developer, same read-only approach, same Apple Silicon and macOS 14 floor.

WhatPort is the port-side companion: protocol, speed, lane status and live power draw for every port on your Mac at once, where WhatCable focuses on the cable in one of them.

Privacy

WhatCable reads USB-C port state directly from IOKit on your Mac. All of that happens locally. Nothing is sent anywhere automatically.

Cable reports: If you use the "Report this cable" button on an e-marked cable, WhatCable builds a pre-filled GitHub issue containing the cable's vendor ID, product ID, and capability flags (VDOs). Your browser opens with that data in the issue form. Nothing is submitted until you click the button in GitHub yourself. Once submitted, the issue is public.

Update checks: WhatCable checks the GitHub Releases API about once every six hours to see if a newer version is available. No personal data or hardware info is included in that request.

Diagnostic data: Settings has an opt-in Contribute Diagnostic Data button. When you press it, WhatCable collects anonymised USB-C port and power IOKit details from your Mac and submits them to help improve hardware coverage. It only runs when you click it; nothing is collected or sent unless you choose to.

Contributing

Issues and PRs welcome. The code is small and tries to stay readable.

Where to start:

Module	Role
`Sources/WhatCable/`	Main menu bar app UI (SwiftUI popover, settings, notifications)
`Sources/WhatCableCore/`	Shared diagnostic logic, PD bit decoding, text formatting
`Sources/WhatCableDarwinBackend/`	IOKit watchers (port state, PD identity, power sources, USB devices, Thunderbolt fabric)
`Sources/WhatCableAppKit/`	Plugin registry and extension points (hooks for Pro features, CLI commands, menu items)
`Sources/WhatCablePlugins/`	Pro features (power metering, licence, cable and display diagnostics, liquid detection)
`Sources/WhatCableWidget/`	WidgetKit extension (small/medium/large desktop widgets)
`Sources/WhatCableCLI/`	CLI binary, shares Core/Backend/Plugins with the app

Translations

Read TRANSLATIONS.md first: it covers the terminology policy (technical labels stay in English) and which languages have an active maintainer who reviews changes.

WhatCable uses .lproj/.strings files for localisation. Each module (WhatCable and WhatCableCore) has its own set under Sources/<module>/Resources/<lang>.lproj/Localizable.strings.

To add a new language:

Copy en.lproj/Localizable.strings from both modules into a new <lang>.lproj/ directory
Translate the values (leave the keys as-is)
Make sure format specifiers (%@, %lld, %1$@, etc.) match the English originals exactly
Run plutil -lint on your files to check for syntax errors
If the language has its own plural rules, copy en.lproj/Localizable.stringsdict in the WhatCable module and translate the one/few/many/other forms
Add the language code to CFBundleLocalizations in scripts/smoke-test.sh

The Settings language picker builds itself from the bundled .lproj resources, so a new language appears there automatically once the files are in place.

Diagnostic data

The single most helpful thing you can do is hit Contribute Diagnostic Data in Settings. It runs a short set of C probes that gather anonymised port and power data from your Mac, then submits the results. The whole process takes a few seconds, nothing is sent without your explicit click, and no personal information is included.

More device data means better hardware coverage, fewer edge-case bugs, and more accurate diagnostics for everyone. If you have unusual hardware (docks, hubs, TB5 gear, high-wattage chargers), your report is especially valuable.

Cable reports are also very welcome. If you have an e-marked cable, use the "Report this cable" button in the app (or whatcable --report from the CLI) to submit its fingerprint. These reports build the bundled cable database so WhatCable can show brand and model info for known cables. Every report you submit helps other users identify their cables at a glance.

Credits

Built by Darryl Morley.

Contributors:

@rolandgroen - option-click technical details, gear menu in popover
@0x687931 - UI polish, hardware matching, updater hardening, USB-C/MagSafe fix
@blech - USB device matching for hubs, settings view, Cmd+R refresh shortcut
@willhsieh - window/Dock mode
@hobostay - SIGTERM handling, charging threshold fix, installer temp file leak fix
@JimmFly - localisation infrastructure, Simplified Chinese translation
@IonBazan - i18n migration to .lproj/.strings, Polish translation, obsolete vendor IDs
@bovirus - Italian translation
@Vardan933 - Armenian translation
@jimmyorz - Traditional Chinese translation
@dohun0310 - Korean translation
@shpokas - Latvian translation
@abrauchli - screenshot fix
@durul - updater security audit
@nervous-inhuman - USB device matching and port state bug reports
@hgschmie - e-marker and Thunderbolt cable documentation that led to e-marker detection
@joeshaw - dual power source bug report, Thunderbolt data samples
@jlbyrne-76 - M4 Mac Mini front port e-marker bug report, cable reports
@stevetrease - M3 and M4 ioreg dumps, TB3 data samples
@jshier - M3 Ultra Thunderbolt data, AppleSmartBattery dumps
@NoFr1ends - TB5 hardware confirmation (JHL9580 dock, M5 Pro)
@iFindProblems - Dock mode bug reports
@NaiveTomcat - Power Monitor regression and MagSafe PD contract bug reports
@pandoratactful - active Thunderbolt cable e-marker mismatch report
@jesserobbins - grouping devices by USB controller, per-device serial and USB version in JSON output
@VailElla - cable report speed values read from the cable's own bits, CLI output sanitising, test-kit probe limits
@offyotto - stale power-contract wattage no longer reported as live
@dhruvsheth10 - refresh icon spins while a refresh runs
@hinaloe - charger wattage stuck at 3W with a second device attached, report and diagnostics
@asapuntz - KVM switch and hub compatibility report that led to the deep-probe switch
@CronoCX - desktop built-in USB port grouping report
@official-Cromatin - M1 Pro charging contract report, and the detail that found it in the SMC
@aguilaair - Power Monitor icon mismatch report
@cannotcollide - identifying the Apple Thunderbolt 4 Pro Cable behind a bad database row

Beta testers:

@jimmyorz, @aguilaair, @cannotcollide, @themadturk7, @Caruso8677, @Mostxlnt and @aldobalducci, who put four builds through their desks before v1.3.0

Sponsors:

Thanks to everyone who has filed cable reports, bug reports, and IOKit dumps. These contributions directly improve the cable database and help WhatCable handle more hardware correctly.

Inspired by every time someone has asked "is this cable any good?".

utmapp/UTM

Virtual machines for iOS and macOS

UTM

It is possible to invent a single machine which can be used to compute any computable sequence.

-- Alan Turing, 1936

UTM is a full featured system emulator and virtual machine host for iOS and macOS. It is based off of QEMU. In short, it allows you to run Windows, Linux, and more on your Mac, iPhone, and iPad. More information at https://getutm.app/ and https://mac.getutm.app/

Features

Full system emulation (MMU, devices, etc) using QEMU
30+ processors supported including x86_64, ARM64, and RISC-V
VGA graphics mode using SPICE and QXL
Text terminal mode
USB devices
JIT based acceleration using QEMU TCG
Frontend designed from scratch for macOS 11 and iOS 11+ using the latest and greatest APIs
Create, manage, run VMs directly from your device

Additional macOS Features

Hardware accelerated virtualization using Hypervisor.framework and QEMU
Boot macOS guests with Virtualization.framework on macOS 12+

UTM SE

UTM/QEMU requires dynamic code generation (JIT) for maximum performance. JIT on iOS devices require either a jailbroken device, or one of the various workarounds found for specific versions of iOS (see "Install" for more details).

UTM SE ("slow edition") uses a threaded interpreter which performs better than a traditional interpreter but still slower than JIT. This technique is similar to what iSH does for dynamic execution. As a result, UTM SE does not require jailbreaking or any JIT workarounds and can be sideloaded as a regular app.

To optimize for size and build times, only the following architectures are included in UTM SE: ARM, PPC, RISC-V, and x86 (all with both 32-bit and 64-bit variants).

Install

UTM (SE) for iOS: https://getutm.app/install/

UTM is also available for macOS: https://mac.getutm.app/

Development

macOS Development

iOS Development

iSH: emulates a usermode Linux terminal interface for running x86 Linux applications on iOS
a-shell: packages common Unix commands and utilities built natively for iOS and accessible through a terminal interface

License

UTM is distributed under the permissive Apache 2.0 license. However, it uses several (L)GPL components. Most are dynamically linked but the gstreamer plugins are statically linked and parts of the code are taken from qemu. Please be aware of this if you intend on redistributing this application.

Some icons made by Freepik from www.flaticon.com.

Additionally, UTM frontend depends on the following MIT/BSD License components:

Continuous integration hosting is provided by MacStadium

minh-ton/reynard-browser

An experimental Gecko-based web browser for iOS 13+.

Reynard Browser

Reynard is a Gecko-based web browser for iOS 13+.

Unlike other browsers on iOS that are forced to use Apple's WebKit engine (including Safari and all third-party browsers), Reynard uses Gecko. This is the same engine that powers the Firefox browser on desktop and Android devices.

This project is mainly for users on older iOS versions who are stuck with an outdated version of WebKit. Because WebKit is bundled with the OS, these devices cannot receive engine updates and often fail to load modern websites. By using Gecko, which is kept up to date independently, Reynard allows these sites to work again. Users on newer iOS versions can also use the browser if they want an alternative to WebKit, including Firefox add-ons and other Gecko-exclusive features.

Installation

The latest builds are available for download on the Releases page. Please note that this project is still in an early experimental state, so expect bugs and missing features.

TrollStore (iOS 14 - 16.6.1, 17.0)

For the best experience, I'd recommend sideloading Reynard via TrollStore using the Reynard-TrollStore.tipa build. This gives you automatic JIT enablement, better performance, and automatic app updates. For automatic app updates, make sure that the URL Scheme Enabled option is turned on in TrollStore.

AltStore or SideStore (iOS 17.4+)

You should use AltStore or SideStore to sideload the Reynard.ipa build when TrollStore is not available, especially on newer iOS versions. Please note that you must select the Keep App Extensions option during installation, as Reynard relies on its extensions to function and will not work without them.

You can also click here to add the AltSource for Reynard to AltStore or SideStore.

Important

LiveContainer is not supported due to its own limitations.
Sideloading methods that use a distribution certificate for signing are not supported.⁠
Other sideloading methods are untested, and no support will be provided for issues arising from them.

Jailbroken (iOS 13, 17.0.1 - 17.3.1)

Sideload the Reynard-Jailbroken.ipa build using Filza File Manager with AppSync Unified on a jailbroken device. You will also benefit from automatic JIT enablement and better performance.

Preview

iOS 14 (iPhone 6S Plus, 14.1)

These sites are known to break or render incorrectly on iOS 14. The screenshots below compare how they load in Safari versus Reynard.

github.com		chatgpt.com		apple.com
Safari	Reynard	Safari	Reynard	Safari	Reynard

iOS 15 (iPhone 7, 15.8.6)

iOS 26 (iPhone 13 mini, 26.1)

Reynard also works great on the latest version of iOS!

Building

Warning

Build instructions are included below for reference. Please be aware that I do not provide support for issues or errors encountered during the build process.

To build the project, you'll need Xcode, Python 3, Rust and Cargo, and ldid.

Clone the repository.

git clone --recursive https://github.com/minh-ton/reynard-browser
cd reynard-browser

Download Gecko and apply patches.

./tools/development/update-gecko.sh
./tools/development/apply-patches.sh

Build dependencies and the Gecko engine.

./tools/development/build-idevice.sh
./tools/development/build-gecko.sh

To run Reynard, open Reynard.xcodeproj in Xcode and build/run it from there.

Notes

This project initially started out of curiosity. I wanted to see if I could get Gecko to run without the BrowserEngineKit framework, so it could be further modified to run on iOS versions as far back as possible. I got it working, and since then, I’ve been focusing on developing engine patches for better UIKit integration, fixing bugs, and turning this into a full, usable browser.

If you’ve come across this repository and find it interesting, I’d love to get help or collaborate on it. I’m learning as I go here and don’t have much prior experience with iOS app development or with Gecko itself, so any contributions, feedback, or pointers would be greatly appreciated.

Acknowledgements

LiveContainer: app extension handling and NSExtension usage.
StikDebug and idevice: pairing-based JIT enablement support.
TrollStore: spawning a binary as root and JIT enablement.
Amethyst-iOS, dolphin-ios, DukeX, and MeloNX: Various utility functions, numerous private API usage, and JIT memory handling.
Pre-existing work on bringing Gecko to iOS using BrowserEngineKit: most of the difficult engine integration.

License

This project is licensed under the GNU General Public License v3.0, except for the patches directory containing the modifications to the Firefox Gecko engine and therefore is licensed under the Mozilla Public License 2.0.

tranvuongquocdat/SideScreen

Side Screen

Turn your Android tablet into a second display for macOS — USB-C or wireless over WiFi

About

Side Screen brings true second-display functionality to your Android tablet — over USB-C cable for the lowest latency, or wirelessly over WiFi after a one-time QR pair. Something macOS doesn't natively support either way.

While Apple's Sidecar only works with iPads, millions of Android tablets sit unused as potential workstations. Side Screen bridges that gap with hardware-accelerated H.265 streaming, sub-16ms pipeline latency on USB, and full touch input — making your tablet feel like a real monitor, not a laggy mirror.

Built entirely open-source, Side Screen is designed to be fast, lightweight, and seamlessly integrated.

For full details, features, and documentation, please visit sidescreen.dev

↑ Back to top

Features

USB-C or Wireless

Two ways to connect, same picture quality. USB-C plugs in the cable for the lowest possible latency — adb-reverse port forwarding is set up automatically. Wireless lets you scan a QR code from the Mac once and the tablet auto-reconnects on every future launch over WiFi (5 GHz strongly recommended). The auth token is generated locally and stays on your Mac; reset it any time to revoke access.

Virtual Display

Create a true virtual display on your Mac. Drag windows to your tablet like a real monitor — not mirroring, but extending.

Ultra-Low Latency

Hardware-accelerated H.265 encoding on Mac and decoding on Android. Async pipeline architecture delivers frames in under 30ms.

Touch Support

Use your tablet's touchscreen to interact with macOS. Touch prediction compensates for network latency, making taps and drags feel natural.

HiDPI (Retina) Support

Enable HiDPI mode to render at 2× resolution internally — text and icons are sharp at any logical resolution, just like a MacBook Retina display. Perfect for users with 2K/4K tablets who want a readable workspace without sacrificing sharpness.

Gaming Mode

Enable Gaming Boost for optimized settings: 1 Gbps bitrate, ultra-low latency encoding, 120 FPS.

Customizable

Configure resolution (up to 4K/8K), frame rate (30–120 FPS), bitrate (20–5000 Mbps), and quality presets from the Mac app.

Headless / portable Mac (new in 0.11.0)

Run a Mac with no display of its own — a Mac Studio or Mini on the go, or a laptop in clamshell — using the tablet as its only screen. Enable Launch at Login and Auto-start streaming, and the Mac boots straight into serving the tablet, with nothing to press on the Mac.

↑ Back to top

Requirements

	macOS Host	Android Client
OS	macOS 13 (Ventura)+	Android 8.0 (API 26)+
Hardware	Apple Silicon or Intel	H.265 hardware decoder
USB mode	USB-C port + `adb` (`brew install android-platform-tools`)	USB-C cable + USB Debugging enabled
Wireless mode	Same WiFi network as the tablet (5 GHz recommended)	Camera (for QR scan) + Google Play Services (for ML Kit barcode)

Installation

Download the latest release from GitHub Releases:

macOS: Download .dmg, open it, drag Side Screen to Applications
Android: Download .apk, install on your tablet (enable "Unknown sources" if needed). Port forwarding is handled automatically by the Mac app.

⚠️ macOS Gatekeeper If macOS says the app is "damaged", open Terminal and run:
sudo xattr -cr /Applications/SideScreen.app
Then open the app again. This is needed because the app is not notarized with an Apple Developer certificate.

⚠️ ADB Required The Mac app needs adb to communicate with your Android device. If the app doesn't show "Running" after launch, you likely need to install ADB:
Install Homebrew (if you don't have it):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Install ADB:
brew install --cask android-platform-tools

Build from source (for developers)

git clone https://github.com/tranvuongquocdat/SideScreen.git
cd SideScreen

# macOS
cd MacHost && swift build -c release

# Android
cd AndroidClient && ./gradlew assembleDebug

Usage

USB mode (default — lowest latency)

Connect tablet to Mac via USB-C
Launch Side Screen on Mac (runs in menu bar — port forwarding is set up automatically)
Open Side Screen on tablet → keep on the USB tab → tap Connect
Done — drag windows to your new display

Wireless mode (new in 0.8.0 — no cable)

Launch Side Screen on Mac → toggle to the Wireless tab → a QR code appears
Open Side Screen on tablet → switch to the Wireless tab → tap Scan QR Code → grant camera permission → aim at the QR on the Mac
The tablet remembers the Mac. Subsequent launches auto-reconnect — no rescan.

Wireless mode requires both devices to be on the same WiFi network. 5 GHz is strongly recommended — 2.4 GHz can introduce noticeable jitter on dynamic content. If you need to revoke access, click Reset Token (forget all) on the Mac and re-pair each tablet.

USB mode remains the lowest-latency option for drawing or fast-paced gaming. Wireless adds 10–50 ms depending on WiFi quality.

Headless mode (new in 0.11.0 — no Mac interaction)

In Settings → Startup, turn on Launch at Login and Auto-start streaming on launch, then pick the Startup mode (USB or Wireless). On your next login the server starts automatically — just open Side Screen on the tablet and tap Connect (USB) or Reconnect (Wireless).

First-time setup still needs a screen once to grant Screen Recording permission; after that the Mac runs fully headless. For wireless headless use, give the Mac a static IP or DHCP reservation, and consider enabling macOS Screen Sharing as a fallback way in.

Configuration

Setting	Options	Default
Resolution	720p to 8K, 30+ presets + custom	1920x1200
Frame Rate	30, 60, 90, 120 FPS	120
Bitrate	20–5000 Mbps	1000 Mbps
Quality	Ultra Low, Low, Medium, High	Ultra Low
HiDPI (Retina)	On/Off	Off
Gaming Boost	On/Off (1 Gbps, 120 Hz)	Off
Touch Input	On/Off	On

Troubleshooting

"SideScreen is damaged" on macOS

This happens because the app is not notarized by Apple. Run this command to fix it:

sudo xattr -cr /Applications/SideScreen.app

Then open the app again.

"Connection refused" on Android

The Mac app sets up adb reverse automatically when streaming starts. If it still fails, make sure adb is installed (via Android SDK or Homebrew: brew install android-platform-tools) and your device has USB debugging enabled.

High latency or stuttering

Lower resolution or frame rate
Ensure H.265 hardware codec support on your device
For USB mode, use a high-quality USB-C cable (not charge-only)
For wireless mode, ensure both devices are on 5 GHz WiFi, not 2.4 GHz; reduce refresh rate to 60 Hz if jitter persists

Wireless: "Couldn't reach Mac" / connection times out

Both devices must be on the same WiFi network (and same subnet — some mesh routers isolate "guest" devices)
Click Start on the Mac before scanning the QR — the listener only binds when the server is running
If the Mac changes WiFi or its LAN IP, scan a fresh QR (the cached one points to the old address)
macOS may prompt for Local Network permission on first wireless toggle — grant it; without it, LAN inbound is silently dropped

Wireless: "Re-pair required" after restart / reinstall

The Mac's auth token resets when you click Reset Token (forget all) or reinstall the app. Tap Scan QR Code on the Android client and scan the new QR shown on the Mac.

Virtual display not appearing

Grant Screen Recording permission: System Preferences → Privacy & Security → Screen Recording → Enable Side Screen

Contributing

Contributions are welcome!

⭐ Star this repo to help others discover it
🐛 Report bugs via Issues
💡 Suggest features via Issues
🔧 Submit PRs — see CONTRIBUTING.md

Support

If Side Screen is useful to you, consider supporting development:

🇻🇳 Vietnamese users — scan VietQR for a local bank transfer (no international fees) at sidescreen.dev/donate.

License

MIT License — free for personal and commercial use.

Made with ❤️ by Tran Vuong Quoc Dat

Report Bug · Request Feature · Discussions

MonitorControl/MonitorControl

🖥 Control your display's brightness & volume on your Mac as if it was a native Apple Display. Use Apple Keyboard keys or custom shortcuts. Shows the native macOS OSDs.

MonitorControl

Controls your external display brightness and volume and shows native OSD. Use menubar extra sliders or the keyboard, including native Apple keys!

Warning

MonitorControl v4.2.0 may crash on certain configurations running macOS 15 Sequoia or Tahoe. Additionally, this version will not automatically update to the latest app version. To resolve the issue and ensure future updates, please upgrade manually.

Download

Go to Releases and download the latest .dmg, or you can install via Homebrew:

brew install --cask monitorcontrol

Major features

Control your display's brightness, volume and contrast!
Shows native OSD for brightness and volume.
Supports multiple protocols to adjust brightness: DDC for external displays (brightness, contrast, volume), native Apple protocol for Apple and built-in displays, Gamma table control for software dimming, shade control for AirPlay, Sidecar and Display Link devices and other virtual screens.
Supports smooth brightness transitions.
Seamlessly combined hardware and software dimming extends dimming beyond the minimum brightness available on your display.
Synchronize brightness from built-in and Apple screens - replicate Ambient light sensor and touch bar induced changes to a non-Apple external display!
Sync up all your displays using a single slider or keyboard shortcuts.
Allows dimming to full black.
Support for custom keyboard shortcuts as well as standard brightness and media keys on Apple keyboards.
Dozens of customization options to tweak the inner workings of the app to suit your hardware and needs (don't forget to enable Show advanced settings in app Settings).
Simple, unobtrusive UI to blend in to the general aesthetics of macOS.
Completely FREE.

For additional features, more advanced brightness control with XDR/HDR brightness upscaling and support for more Mac models and displays, check out BetterDisplay!

Screenshots (Settings)

How to install and use the app

Download the app
Copy the MonitorControl app file from the .dmg file to your Applications folder
Click on the MonitorControl app
Add the app to Accessibility under System Settings » Privacy & Security as prompted (this is required only if you wish to use the native Apple keyboard brightness and media keys - if this is not the case, you can safely skip this step).
Use your keyboard or the sliders in the app menu (a brightness symbol in the macOS menubar as shown on the screenshot above) to control your displays.
Open Settings… for customization options (enable Show advanced settings for even more options).
You can set up custom keyboard shortcuts under the Keyboard in Settings (the app uses Apple media keys by default).
If you have any questions, go to Discussions!

macOS compatibility

MonitorControl version	macOS version
v4.0.0	Catalina 10.15*
v3.1.1	Mojave 10.14
v2.1.0	Sierra 10.12

* With some limitations - full functionality available on macOS 11 Big Sur or newer.

For macOS Sequoia and Tahoe 26 compatibility v4.3.3 or newer is required!

Please note that current versions have limited native macOS OSD support on macOS Tahoe - although the Control Center brightness or volume OSD appears, the OSD percentage value will not show or update.

Supported displays

Most modern LCD displays from all major manufacturers supported implemented DDC/CI protocol via USB-C, DisplayPort, HDMI, DVI or VGA to allow for hardware backlight and volume control.
Apple displays and built-in displays are supported using native protocols.
LCD and LED Televisions usually do not implement DDC, these are supported using software alternatives to dim the image.
DisplayLink, Airplay, Sidecar and other virtual screens are supported via shade (overlay) control.

Notable exceptions for hardware control compatibility:

DDC control using the built-in HDMI port of the 2018 Intel Mac mini, the built-in HDMI port of all M1 Macs (MacBook Pro 14" and 16", Mac Mini, Mac Studio) and the built-in HDMI port of the entry level M2 Mac mini are not supported. Use USB-C instead or get BetterDisplay for full DDC control over HDMI with these Macs as well for free. Software-only dimming is still available for these connections.
Some displays (notably EIZO) use MCCS over USB or an entirely custom protocol for control. These displays are supported with software dimming only.
DisplayLink docks and dongles do not allow for DDC control on Macs, only software dimming is available for these connections.

Contributing to the project

If you want, you can fork the code, make improvements and submit a pull request to improve the app. Accepting a PR is solely in the hands of the maintainer - before making fundamental changes expecting it to be accepted, please consult the maintainer of the project!

How to build

Required

Xcode
Swiftlint
SwiftFormat
BartyCrouch (for updating localizations)

Build steps

Clone the project via this Terminal command:

git clone https://github.com/MonitorControl/MonitorControl.git

If you want to clone one of the branches, add --single-branch --branch [branchname] after the clone option.
You're all set! Now open the MonitorControl.xcodeproj with Xcode! The dependencies will automatically get downloaded once you open the project. If they don't: File > Packages > Resolve Package Versions

Third party dependencies

Credits

@waydabber, maintainer, developer of BetterDisplay.
@the0neyouseek - honorary maintainer
@JoniVR - honorary maintainer
@alin23 - spearheaded M1 DDC support, developer of Lunar
@mathew-kurian (original developer)
@Tyilo (fork)
@Bensge - (used some code from his project NativeDisplayBrightness)
@nhurden (for the original MediaKeyTap)
@kfix (for ddcctl)
@reitermarkus (for Intel DDC support)
javierocasio (app icon background)

FluidInference/FluidAudio

Frontier CoreML audio models in your apps — text-to-speech, speech-to-text, voice activity detection, and speaker diarization. In Swift, powered by SOTA open source.

FluidAudio - Transcription, Text-to-speech, VAD, Speaker diarization with CoreML Models

FluidAudio is a Swift SDK for fully local, low-latency audio AI on Apple devices, with inference offloaded to the Apple Neural Engine (ANE), resulting in less memory and generally faster inference.

The SDK includes state-of-the-art speaker diarization, transcription, and voice activity detection via open-source models (MIT/Apache 2.0) that can be integrated with just a few lines of code. Models are optimized for background processing, ambient computing and always on workloads by running inference on the ANE, minimizing CPU usage and avoiding GPU/MPS entirely.

For custom use cases, feedback, additional model support, or platform requests, join our Discord. We're also bringing visual, language, and TTS models to device and will share updates there.

Below are some featured local AI apps using Fluid Audio models on macOS and iOS:

Want to convert your own model? Check möbius

Highlights

Automatic Speech Recognition (ASR): Parakeet TDT v3 (0.6b) and other TDT/CTC models for batch transcription supporting 25 European languages and Japanese, plus SenseVoice and Paraformer for Mandarin Chinese; Parakeet EOU (120m) for streaming ASR with end-of-utterance detection (English only). See all ASR models.
Inverse Text Normalization (ITN): Post-process ASR output to convert spoken-form to written-form ("two hundred" → "200"). See text-processing-rs
Text-to-Speech (TTS): Kokoro (82m) for parallel synthesis with SSML and pronunciation control across 9 languages (EN, ES, FR, HI, IT, JA, PT, ZH); PocketTTS for streaming TTS with voice cloning support (EN, DE, ES, FR, IT, PT — 6L and 24L variants)
Speaker Diarization (Online + Offline): Speaker separation and identification across audio streams. Streaming pipeline for real-time processing and offline batch pipeline with advanced clustering.
Speaker Embedding Extraction: Generate speaker embeddings for voice comparison and clustering, you can use this for speaker identification
Voice Activity Detection (VAD): Voice activity detection with Silero models
Apple Neural Engine: Models run efficiently on Apple's ANE for maximum performance with minimal power consumption
Open-Source Models: All models are publicly available on HuggingFace — converted and optimized by our team; permissive licenses. See full model catalog.

Video Demos

Link	Description
Spokenly Real-time ASR	Video demonstration of FluidAudio's transcription accuracy and speed
Senko Integration	Python Speaker diarization on Mac using FluidAudio's segmentation model
Kokoro TTS	Text-to-speech demo using FluidAudio's Kokoro and Silero models on iOS
Parakeet Realtime EOU	Parakeet streaming ASR with end-of-utterance detection on iOS
Sortformer Diarization	Sortformer for speaker diarization with overlapping speech on iOS
PocketTTS	Streaming text-to-speech using PocketTTS on iOS
Parakeet EOU Ultra-Low Latency	Real-time Parakeet EOU transcription on iOS demonstrating ultra-low latency speech-to-text
Action Phrase Live Production Control	Voice-controlled live production workflow using FluidAudio's ASR and speaker diarization to trigger cameras, graphics, and layouts with natural voice commands
talat - VAD, ASR, Speaker ID	A video demo showcasing FluidAudio's VAD, two different ASR models, and speaker diarization during a talat.app meeting recording
Kyutai PocketTTS on ANE	Kyutai labs PocketTTS in iOS running fast on the ANE & background-capable
Supertonic-3 on iPhone 17 Pro ANE	Supertonic-3 running on iPhone 17 Pro via ANE/CoreML with 2 minutes of audio generated in 3 seconds with low RAM & background support

Showcase

Make a PR if you want to add your app, please keep it in chronological order.

App	Description
Voice Ink	Local AI for instant, private transcription with near-perfect accuracy. Uses Parakeet ASR.
Spokenly	Mac dictation app for fast, accurate voice-to-text; supports real-time dictation and file transcription. Uses Parakeet ASR and speaker diarization.
Senko	A very fast and accurate speaker diarization pipeline. A good example for how to integrate FluidAudio into a Python app
Slipbox	Privacy-first meeting assistant for real-time conversation intelligence. Uses Parakeet ASR (iOS) and speaker diarization across platforms.
Whisper Mate	Transcribes movies and audio locally; records and transcribes in real time from speakers or system apps. Uses speaker diarization.
Altic/Fluid Voice	Lightweight Fully free and Open Source Voice to Text dictation for macOS built using FluidAudio. Never pay for dictation apps
Paraspeech	AI powered voice to text. Fully offline. No subscriptions.
mac-whisper-speedtest	Comparison of different local ASR, including one of the first versions of FluidAudio's ASR models
Starling	Open Source, fully local voice-to-text transcription with auto-paste at your cursor.
BoltAI	Write content 10x faster using parakeet models
Voxeoflow	Mac dictation app with real-time translation. Lightning-fast transcription in over 100 languages, instantly translated to your target language.
Speakmac	Mac app that lets you type anywhere on your Mac using your voice. Fully local, private dictation built on FluidAudio.
SamScribe	An open-source macOS app that captures and transcribes audio from your microphone and meeting applications (Zoom, Teams, Chrome) in real-time, with cross-session speaker recognition.
WhisKey	Privacy-first voice dictation keyboard for iOS and macOS. On-device transcription with 12+ languages, AI meeting summaries, and mindmap generation. Great for daily use and vibe-coding. Uses speaker diarization.
Dictate Anywhere	Native macOS dictation app with global Fn key activation. Dictate into any app with 25 language support. Uses Parakeet ASR.
hongbomiao.com	A personal R&D lab that facilitates knowledge sharing. Uses Parakeet ASR.
Hex	macOS app that lets you press-and-hold a hotkey to record your voice, transcribe it, and paste into any application. Uses Parakeet ASR.
Super Voice Assistant	Open-source macOS voice assistant with local transcription. Uses Parakeet ASR.
VoiceTypr	Open-source voice-to-text dictation for macOS and Windows. Uses Parakeet ASR.
Summit AI Notes	Local meeting transcription and summarization with speaker identification. Supports 100+ languages.
Ora	Local voice assistant for macOS with speech recognition and text-to-speech.
Flowstay	Easy text-to-speech, local post-processing and Claude Code integration for macOS. Free forever.
macos-speech-server	Wyoming (Home Assistant) and OpenAI compatible STT/transcription and TTS/speech API server.
Snaply	Free, Fast, 100% local AI dictation for Mac.
OpenOats	Open-source meeting note-taker that transcribes conversations in real time and surfaces relevant notes from your knowledge base. Uses FluidAudio for local transcription.
Enconvo	AI Agent Launcher for macOS with voice input, live captions, and text-to-speech. Uses Parakeet ASR for local speech recognition.
Meeting Transcriber	macOS menu bar app that auto-detects, records, and transcribes meetings (Teams, Zoom, Webex) with dual-track speaker diarization. Uses Parakeet ASR and speaker diarization.
Hitoku Draft	A local, private, voice writing assistant on your macOS menu bar. Uses Parakeet ASR.
Audite	macOS menu-bar app that records meetings and transcribes them locally into Markdown notes for Obsidian. Uses Parakeet ASR via FluidAudio on the Apple Neural Engine.
Muesli	Native macOS dictation and meeting transcription with ~0.13s latency. Captures microphone and system audio with automatic speaker diarization. Uses Parakeet TDT ASR.
NanoVoice	Free iOS voice keyboard for fast, private dictation in any app. Uses Parakeet ASR.
MiniWhisper	Open-source macOS menu bar for quick local voice-to-text with minimal setup. Pick a shortcut, start talking. Uses Parakeet ASR.
Talat	Privacy-focused AI meeting notes app. Records and transcribes meetings locally on your Mac with speaker identification and LLM-powered summaries. Featured in TechCrunch. Uses Parakeet ASR.
Volocal	Fully local voice AI on iOS. Uses streaming Parakeet EOU ASR and streaming PocketTTS.
VivaDicta	Open-source iOS voice-to-text app with system-wide AI voice keyboard — dictate and AI-process text in any app. 15+ AI providers, 40+ AI presets. Uses Parakeet ASR.
MimicScribe	macOS menu bar app combining Parakeet TDT streaming ASR, PyanNote Community 1 speaker diarization, and cloud LLMs to provide AI-generated talking points during meetings, derived from the live transcript and user-provided instructions. Features meeting summarization, natural language search, an MCP server for agent integration, and a keyboard- and voice-forward UI.
Action Phrase	Voice-controlled live production app for iOS, iPadOS, and macOS. Control cameras, graphics, layouts, and production workflows with natural voice commands. Integrates with popular tools including OBS, vMix, ProPresenter, Bitfocus Companion, and more. Uses Parakeet TDT ASR and Sortformer diarization.
Sayboard	Privacy-first AI voice keyboard for iOS. Local models, no servers, no tracking, no subscriptions, no ads, no in-app purchases. Fully offline and open-source.
Kesha Voice Kit	Local-first voice toolkit for CLI and LLM-agent workflows. Provides speech-to-text in 25 languages, text-to-speech, VAD, language detection, OpenClaw and MCP integrations, with FluidAudio powering Apple Silicon ASR and Kokoro TTS.
Dictato	Turn your voice into text anywhere on your Mac. Fully local, private, and offline — boost your own vocabulary and dictate in multiple languages. Uses Parakeet TDT ASR.
Utter	An ultra-minimal speech-to-text status bar utility for Mac. Register a hotkey and go.
Resonant	macOS voice workspace for dictation, meetings, and ambient work context. Uses FluidAudio for local transcription and speaker diarization.
Thoth	Privacy-first meeting recorder for Mac. Records both sides of any call with dual-channel audio, transcribes locally with speaker diarization, and summarizes with on-device AI or BYOK cloud. Available on the Mac App Store. Featured in MacGeneration. Uses Parakeet EOU and Parakeet TDT ASR.
Dettivo	Local-first Mac app for private dictation, transcripts, and meeting workflows in one place, with developer tooling across CLI, MCP, REST, and app automation. Uses FluidAudio Parakeet TDT ASR and offline speaker diarization.
Parleq	Privacy-first macOS dictation — press a hotkey, speak, paste cleaned-up text. On-device Parakeet TDT v3 ASR with CTC vocabulary boosting (audio never leaves the Mac), provider-pluggable LLM cleanup (Gemini/Vertex, Bedrock, Azure), and reference windows that bring on-screen context into the cleanup. Open source.
Local Narrator	Privacy-first iOS audiobook reader that reads EPUB and PDF books aloud with on-device text-to-speech. Uses FluidAudio Kokoro TTS for local English and Spanish narration.
Hedy	Privacy-first AI meeting coach for iOS, macOS, Android, and Windows. Real-time, fully on-device transcription with speaker diarization and AI-powered conversation insights. Uses Parakeet and Nemotron streaming ASR and speaker diarization on the Apple Neural Engine.
Parakey	Open-source (MIT) menu-bar push-to-talk dictation for macOS — hold a key, speak, release; the transcript pastes at the cursor in about 100 ms. Uses Parakeet TDT v3 ASR on the Apple Neural Engine via FluidAudio.
TypeWhisper	Speech-to-text and AI text processing for macOS. Uses FluidAudio's Parakeet ASR for local transcription.
evoglyph	Lightweight, privacy-first macOS menu-bar dictation — press a hotkey, speak, and cleaned-up text is injected at your cursor. Fully local: Parakeet TDT ASR with CTC vocabulary boosting and Silero VAD via FluidAudio on the Apple Neural Engine, plus on-device LLM cleanup. Audio never leaves the Mac.
echo99	Private call recorder for macOS. Menu-bar app that records the mic and system audio as separate tracks and transcribes them entirely on-device.
Presspeech	Open-source (MIT) menu-bar push-to-talk dictation for macOS — hold a key, speak, release; the transcript pastes at the cursor in about 100 ms. Uses Parakeet TDT v3 ASR on the Apple Neural Engine via FluidAudio.
Better Voice	macOS menu-bar app for on-device dictation and meeting notes that save to Apple Notes. Everything runs locally. Uses speaker diarization.
Logue	Privacy-first AI meeting notes and writing assistant for macOS. Records mic + system audio and transcribes locally on Apple Silicon, with speaker diarization, Smart Minutes, and an on-device AI writing editor — nothing leaves the Mac. Uses FluidAudio streaming Sortformer speaker diarization.

Installation

Add FluidAudio to your project using Swift Package Manager:

dependencies: [
    .package(url: "https://github.com/FluidInference/FluidAudio.git", from: "0.12.4"),
],

In Xcode:

Add the FluidAudio package to your project
In the "Add Package" dialog, select FluidAudio
Add it to your app target

In Package.swift:

.product(name: "FluidAudio", package: "FluidAudio")

CocoaPods: We recommend using cocoapods-spm for better SPM integration, but if needed, you can also use our podspec: pod 'FluidAudio', '~> 0.12.4'

Other Frameworks

Building with a different framework? Use one of our official wrappers:

Platform	Package	Install
React Native / Expo	@fluidinference/react-native-fluidaudio	`npm install @fluidinference/react-native-fluidaudio`
Rust / Tauri	fluidaudio-rs	`cargo add fluidaudio-rs`

Post-Processing Tools

Enhance ASR output with post-processing:

Tool	Description	Language
text-processing-rs	Inverse Text Normalization (ITN) and Text Normalization (TN) across 7 languages (EN, DE, ES, FR, HI, JA, ZH). 100% NeMo test compatibility (3,011 tests). Converts spoken-form ASR output to written form ("two hundred" → "200", "five dollars" → "$5"). Rust port of NVIDIA NeMo Text Processing with Swift wrapper.	Rust, Swift

Configuration

Quick Reference

Both solve the same problem: "I can't reach HuggingFace directly." They're alternative approaches - pick whichever matches your setup:

Scenario	Solution	Configuration
You have a local mirror or internal model server	Use Registry URL override	`REGISTRY_URL=https://your-mirror.com`
You're behind a corporate firewall with a proxy that can reach HuggingFace	Use Proxy configuration	`https_proxy=http://proxy.company.com:8080`

How they work:

Registry URL - App requests from your-mirror.com instead of huggingface.co
Proxy - App still requests huggingface.co, but traffic routes through proxy to reach it

In most cases, you only need one. (You'd use both only if your mirror is behind the proxy and unreachable without it.)

Model Registry URL - Change download destination

By default, FluidAudio downloads models from HuggingFace. You can override this to use a mirror, local server, or air-gapped environment.

Programmatic override (recommended for apps):

import FluidAudio

// Set custom registry before using any managers
ModelRegistry.baseURL = "https://your-mirror.example.com"

// Models will now download from the custom registry
let diarizer = DiarizerManager()

Environment Variables (recommended for CLI/testing):

# Use custom registry
export REGISTRY_URL=https://your-mirror.example.com
swift run fluidaudiocli transcribe audio.wav

# Or use the MODEL_REGISTRY_URL alias
export MODEL_REGISTRY_URL=https://models.internal.corp
swift run fluidaudiocli diarization-benchmark --auto-download

Xcode Scheme Configuration:

Edit Scheme → Run → Arguments
Go to Environment Variables tab
Click + and add: REGISTRY_URL = https://your-mirror.example.com
The custom registry will apply to all debug runs

Proxy Configuration - Route downloads through a proxy server

If you're behind a corporate firewall and cannot reach HuggingFace (or your registry) directly, configure a proxy to forward requests:

Set the https_proxy environment variable:

export https_proxy=http://proxy.company.com:8080
# or for authenticated proxies:
export https_proxy=http://user:password@proxy.company.com:8080

swift run fluidaudiocli transcribe audio.wav

Xcode Scheme Configuration for Proxy:

Edit Scheme → Run → Arguments
Go to Environment Variables tab
Click + and add: https_proxy = http://proxy.company.com:8080
FluidAudio will automatically route downloads through the proxy

Offline-only mode - Refuse every network fetch, bundle your own models

If your application ships pre-downloaded model assets and never wants FluidAudio to reach HuggingFace at runtime (privacy-sensitive desktop apps, air-gapped deployments, kiosk builds), set the static ModelHub.offlineMode flag at startup:

import FluidAudio

// Set once before any FluidAudio loader runs.
ModelHub.offlineMode = true

// Load via manual APIs that read from your bundled directory:
let asr = try await AsrModels.load(from: bundledModelURL, configuration: config)

When the flag is on:

fetchWithAuth, download, and fetchFile throw DownloadError.networkDisabled(operation:) instead of touching the network.
loadModels short-circuits its retry-with-redownload fallback so a corrupt-detected .mlmodelc surfaces the original load error instead of silently re-fetching.
If loadModels is invoked but required files are missing from the local directory, DownloadError.modelMissing(repo:missing:) is thrown with the missing file list so the caller can ship a fix.

The default is false — no behaviour change for existing callers. Combine with a custom ModelRegistry.baseURL only if you want offline-mode + a typed offline error rather than relying on a mirror URL.

Documentation

DeepWiki for auto-generated docs for this repo.

Documentation Index

Guides
- Audio Conversion for Inference
- Manual model download & loading options: ASR, Diarizer, VAD
- Routing Hugging Face (or compatible) requests through a proxy? Set https_proxy before running the download helpers (see Documentation/API.md).
Models
- Automatic Speech Recognition/Transcription
  - Getting Started
  - Last Chunk Handling
- Speaker Diarization
  - Speaker Diarization Guide
- VAD: Getting Started
  - Segmentation
  - Model Conversion Code
Benchmarks
API Reference
Command Line Guide

MCP Server

The repo is indexed by DeepWiki MCP server, so your coding tool can access the docs:

{
  "mcpServers": {
    "deepwiki": {
      "url": "https://mcp.deepwiki.com/mcp"
    }
  }
}

For claude code:

claude mcp add -s user -t http deepwiki https://mcp.deepwiki.com/mcp

Automatic Speech Recognition (ASR) / Transcription

Models:
- FluidInference/parakeet-tdt-0.6b-v3-coreml (multilingual, 25 European languages)
- FluidInference/parakeet-tdt-0.6b-v2-coreml (English-only, highest recall)
Processing Mode: Batch transcription for complete audio files
Real-time Factor: ~190x on M4 Pro (processes 1 hour of audio in ~19 seconds)
Streaming Support: Real-time streaming via SlidingWindowAsrManager with sliding window processing and cancellation support
Backend: Same Parakeet TDT v3 model powers our backend ASR

ASR Quick Start

import FluidAudio

// Batch transcription from an audio file
Task {
    // 1) Initialize ASR manager and load models
    let models = try await AsrModels.downloadAndLoad(version: .v3)  // Switch to .v2 for English-only work
    let asrManager = AsrManager(config: .default)
    try await asrManager.loadModels(models)

    // 3) Transcribe the audio 16hz, already converted
    let result = try await asrManager.transcribe(samples)

    // 3) Transcribe a file
    // let url = URL(fileURLWithPath: sample.audioPath)

    // 3) Transcribe AVAudioPCMBuffer
    // let result = try await asrManager.transcribe(audioBuffer)
    print("Transcription: \(result.text)")
}

# Transcribe an audio file (batch)
swift run fluidaudiocli transcribe audio.wav

# English-only run with higher recall
swift run fluidaudiocli transcribe audio.wav --model-version v2

Speaker Diarization

Offline Speaker Diarization Pipeline

Pyannote Community-1 pipeline (powerset segmentation + WeSpeaker + VBx) for offline speaker diarization. Use this for most use cases, see Benchmarks.md for benchmarks.

import FluidAudio

let config = OfflineDiarizerConfig()
let manager = OfflineDiarizerManager(config: config)
try await manager.prepareModels()  // Downloads + compiles Core ML bundles if they are missing

let samples = try AudioConverter().resampleAudioFile(path: "meeting.wav")
let result = try await manager.process(audio: samples)

for segment in result.segments {
    print("\(segment.speakerId) \(segment.startTimeSeconds)s → \(segment.endTimeSeconds)s")
}

For processing audio files, use the file-based API which automatically uses memory-mapped streaming for efficiency:

let url = URL(fileURLWithPath: "meeting.wav")
let result = try await manager.process(url)

for segment in result.segments {
    print("\(segment.speakerId) \(segment.startTimeSeconds)s → \(segment.endTimeSeconds)s")
}

# Process a meeting with full VBx clustering
swift run fluidaudiocli process ~/FluidAudioDatasets/ami_official/sdm/ES2004a.Mix-Headset.wav \
  --mode offline --threshold 0.6 --output es2004a_offline.json

# Run the AMI single-file benchmark with automatic downloads
swift run fluidaudiocli diarization-benchmark --mode offline --auto-download \
  --single-file ES2004a --threshold 0.6 --output offline_results.json

offline_results.json contains DER/JER/RTFx along with timing breakdowns for segmentation, embedding extraction, and VBx clustering. CI now runs this workflow on every PR to ensure the offline models stay healthy and the Hugging Face assets remain accessible.

LS-EEND (LongForm Streaming End-to-End Neural Diarization)

End-to-end streaming diarization with CoreML inference. Default choice for online diarization — single model, no clustering pipeline, up to 10 speakers, 100ms frame updates with 900ms tentative preview. Supports both streaming and complete-buffer processing. See Documentation/Diarization/GettingStarted.md for details.

import FluidAudio

Task {
    let diarizer = try await LSEENDDiarizer(variant: .dihard3)

    let samples = try await loadSamples16kMono(path: "path/to/meeting.wav")
    let timeline = try diarizer.processComplete(samples, sourceSampleRate: 16_000)

    for speaker in timeline.speakers.values {
        for segment in speaker.finalizedSegments {
            print("Speaker \(speaker.index): \(segment.startTime)s - \(segment.endTime)s")
        }
    }
}

Sortformer (End-to-End Neural Diarization)

End-to-end neural diarization using NVIDIA's Sortformer. Secondary streaming diarizer — trades LS-EEND's higher speaker capacity and benchmark results for better speaker identity stability. Limited to 4 speakers. No separate VAD, segmentation, or clustering needed. Licensed under NVIDIA Open Model License.

Both LS-EEND and Sortformer emit results into a DiarizerTimeline with ultra-low-latency updates. See Documentation/Diarization/Sortformer.md for usage and comparison.

Streaming/Online Speaker Diarization (Pyannote)

Pyannote 3.1 pipeline (segmentation + WeSpeaker embeddings) for online/streaming diarization. This is the third choice behind LS-EEND and Sortformer. It can be useful if you specifically want the classic multi-stage pipeline, but it is much slower than LS-EEND or Sortformer for live diarization.

Why use the WeSpeaker/Pyannote pipeline:

More modular pipeline if you want separate segmentation and embedding stages
Better fit when you need to integrate external speaker identification or clustering logic
Speaker pre-enrollment is reliable
Speaker database management is much easier
Purging or updating individual speakers is straightforward
Not recommended when low-latency live diarization is the priority

In most applications:

Use LS-EEND as the default online diarizer
Use Sortformer as the second choice when its stronger identity stability and participant focus matter more than the 4-speaker limit
Use the WeSpeaker/Pyannote pipeline only when you specifically need its modular design despite the speed cost

Tradeoffs:

Slower in both inference time and practical latency than LS-EEND or Sortformer
Needs larger chunks, with at least 5 seconds usually required for decent results
Unlike LS-EEND and Sortformer, speaker state is much easier to manipulate explicitly

import FluidAudio

// Diarize an audio file
Task {
    let models = try await DiarizerModels.downloadIfNeeded()
    let diarizer = DiarizerManager() 
    diarizer.initialize(models: models)

    // Prepare 16 kHz mono samples (see: Audio Conversion)
    let samples = try await loadSamples16kMono(path: "path/to/meeting.wav")

    // Run diarization
    let result = try diarizer.performCompleteDiarization(samples)
    for segment in result.segments {
        print("Speaker \(segment.speakerId): \(segment.startTimeSeconds)s - \(segment.endTimeSeconds)s")
    }
}

For diarization streaming see Documentation/Diarization/GettingStarted.md

swift run fluidaudiocli diarization-benchmark --single-file ES2004a \
  --chunk-seconds 3 --overlap-seconds 2

CLI

# Process an individual file and save JSON
swift run fluidaudiocli process meeting.wav --output results.json --threshold 0.6

Voice Activity Detection (VAD)

Silero VAD powers our on-device detector. The latest release surfaces the same timestamp extraction and streaming heuristics as the upstream PyTorch implementation. Ping us on Discord if you need help tuning it for your environment.

VAD Quick Start (Offline Segmentation)

Simple call to return chunk-level probabilities every 256 ms hop:

let results = try await manager.process(samples)
for (index, chunk) in results.enumerated() {
    print(
        String(
            format: "Chunk %02d: prob=%.3f, inference=%.4fs",
            index,
            chunk.probability,
            chunk.processingTime
        )
    )
}

The following are higher level APIs better suited to integrate with other systems

import FluidAudio

Task {
    let manager = try await VadManager(
        config: VadConfig(defaultThreshold: 0.75)
    )

    let audioURL = URL(fileURLWithPath: "path/to/audio.wav")
    let samples = try AudioConverter().resampleAudioFile(audioURL)

    var segmentation = VadSegmentationConfig.default
    segmentation.minSpeechDuration = 0.25
    segmentation.minSilenceDuration = 0.4

    let segments = try await manager.segmentSpeech(samples, config: segmentation)
    for segment in segments {
        print(
            String(format: "Speech %.2f–%.2fs", segment.startTime, segment.endTime)
        )
    }
}

Streaming

import FluidAudio

Task {
    let manager = try await VadManager()
    var state = await manager.makeStreamState()

    for chunk in microphoneChunks {
        let result = try await manager.processStreamingChunk(
            chunk,
            state: state,
            config: .default,
            returnSeconds: true,
            timeResolution: 2
        )

        state = result.state

        // Access raw probability (0.0-1.0) for custom logic
        print(String(format: "Probability: %.3f", result.probability))

        if let event = result.event {
            let label = event.kind == .speechStart ? "Start" : "End"
            print("\(label) @ \(event.time ?? 0)s")
        }
    }
}

CLI

Start with the general-purpose process command, which runs the diarization pipeline (and therefore VAD) end-to-end on a single file:

swift run fluidaudiocli process path/to/audio.wav

Once you need to experiment with VAD-specific knobs directly, reach for:

# Inspect offline segments (default mode)
swift run fluidaudiocli vad-analyze path/to/audio.wav

# Streaming simulation only (timestamps printed in seconds by default)
swift run fluidaudiocli vad-analyze path/to/audio.wav --streaming

# Benchmark accuracy/precision trade-offs
swift run fluidaudiocli vad-benchmark --num-files 50 --threshold 0.3

swift run fluidaudiocli vad-analyze --help lists every tuning option, including negative-threshold overrides, max-speech splitting, padding, and chunk size. Offline mode also reports RTFx using the model's per-chunk processing time.

Text‑To‑Speech (TTS)

⚠️ Beta: TTS currently supports American English only. Additional language support is planned.

FluidAudio ships two TTS backends:

	PocketTTS	Kokoro
GPL dependencies	None	None
Tokenizer	SentencePiece	CoreML G2P → IPA phonemes
Generation	Frame-by-frame autoregressive (80ms)	Parallel (all frames at once)
Streaming	Yes	No
Voice cloning	Yes (1–30s audio sample)	No
Pronunciation control	No	Yes (SSML, custom lexicon)
Output	24 kHz mono WAV	24 kHz mono WAV

PocketTTS

Streaming-friendly TTS with voice cloning support from short audio samples. Available language packs: english (default), german, german_24l, italian, italian_24l, portuguese, portuguese_24l, spanish, spanish_24l, french_24l (24-layer only — no 6-layer French upstream).

import FluidAudio

Task {
    let manager = PocketTtsManager(language: .spanish)
    try await manager.initialize()
    let audioData = try await manager.synthesize(text: "Hola, mundo.")
    try audioData.write(to: URL(fileURLWithPath: "out.wav"))
}

# English (default)
swift run fluidaudiocli tts "Hello from FluidAudio." --output out.wav --backend pocket

# Other languages
swift run fluidaudiocli tts "Hola mundo" --backend pocket --language spanish --output es.wav
swift run fluidaudiocli tts "Bonjour" --backend pocket --language french_24l --output fr.wav

# Clone a voice from an audio sample (works with any language pack)
swift run fluidaudiocli tts "Hello world." --output out.wav --backend pocket --clone-voice speaker.wav

See Documentation/TTS/PocketTTS.md for the full language table.

KokoroAne

ANE-resident Kokoro 82M (4-stage on Neural Engine, 3-stage on GPU). Yields 3-11× RTFx on Apple Silicon vs. the prior single-graph Kokoro path. English (af_heart) and Mandarin variants ship with a built-in G2P pipeline (BART CoreML for English OOV, jieba + sandhi + G2pW for Mandarin).

import FluidAudio

Task {
    let manager = KokoroAneManager()
    try await manager.initialize()
    let samples = try await manager.synthesize(text: "Hello from FluidAudio.")
    // `samples` is 24 kHz mono Float32 PCM
}

swift run fluidaudiocli tts "Hello from FluidAudio." --backend kokoroAne --output out.wav

Model assets are cached under ~/.cache/fluidaudio/Models/kokoro/.

Continuous Integration

tests.yml: Default build matrix covering SwiftPM tests and an iOS archive smoke test.
diarizer-benchmark.yml: Runs the streaming diarization benchmark on ES2004a for regression tracking.
offline-pipeline.yml: Executes the VBx offline pipeline end-to-end (fluidaudio diarization-benchmark --mode offline) and fails if DER/JER drift beyond guardrails or if models fail to download. Use this workflow as a reference for provisioning model caches in your own CI.

Everything Else

FAQs

CLI is available on macOS only. For iOS, use the library programmatically.
Models auto-download on first use. If your network restricts Hugging Face access, set an HTTPS proxy: export https_proxy=http://127.0.0.1:7890.
Windows alternative in development: fluid-server
If you're looking to get the system audio on a Mac, take a look at this repo for reference AudioCap

License

Apache 2.0 — see LICENSE for details.

Acknowledgments

This project builds upon the excellent work of the sherpa-onnx project for speaker diarization algorithms and techniques.

Pyannote: https://github.com/pyannote/pyannote-audio

WeSpeaker: https://github.com/wenet-e2e/wespeaker

Parakeet-mlx: https://github.com/senstella/parakeet-mlx

silero-vad: https://github.com/snakers4/silero-vad

Kokoro-82M: https://huggingface.co/hexgrad/Kokoro-82M

Citation

If you use FluidAudio in your work, please cite:

FluidInference Team. (2025). FluidAudio: Local Speaker Diarization, ASR, and VAD for Apple Platforms (Version 0.12.4) [Computer software]. GitHub. https://github.com/FluidInference/FluidAudio

@software{FluidInferenceTeam_FluidAudio_2025,
  author = {{FluidInference Team}},
  title = {{FluidAudio: Local Speaker Diarization, ASR, and VAD for Apple Platforms}},
  year = {2025},
  month = {3},
  version = {0.12.4},
  url = {https://github.com/FluidInference/FluidAudio},
  note = {Computer software}
}

Show Your Support

Help the Fluid Inference community grow by adding a "Powered by Fluid Inference" badge to your project!

Copy and paste this prompt to your coding agent where you host your homepage:

Add a centered 'Powered by Fluid Inference' badge to the footer linking to fluidinference.com. Image: https://assets.inference.plus/fi-badge.png. Whitelist the image hostname in your framework's config.

Or use one of these code snippets:

React/Next.js

<div className="flex justify-center py-8">
  <a href="https://fluidinference.com">
    <img
      src="https://assets.inference.plus/fi-badge.png"
      alt="Powered by Fluid Inference"
      height={80}
    />
  </a>
</div>

HTML

<div style="text-align: center; padding: 20px;">
  <a href="https://fluidinference.com">
    <img src="https://assets.inference.plus/fi-badge.png" alt="Powered by Fluid Inference" height="80">
  </a>
</div>

Markdown

<p align="center">
  <a href="https://fluidinference.com">
    <img src="https://assets.inference.plus/fi-badge.png" alt="Powered by Fluid Inference" height="80">
  </a>
</p>

GitHub Swift Monthly Trending Repositories

permissionlesstech/bitchat

bitchat

Getting a copy you can trust

License

Features

Technical Architecture

Bluetooth Mesh Network (Offline)

Nostr Protocol (Internet)

Channel Types

mesh #bluetooth

Location Channels (block #dr5rsj7, neighborhood #dr5rs, country #dr)

Direct Message Routing

Setup

Option 1: Using Xcode

Option 2: Using just

Localization

Ebullioscopic/Atoll

Atoll - DynamicIsland for macOS

Highlights

Other Features

Requirements

Installation

Quick Start

Settings

Gesture Controls

Troubleshooting (Basics)

License

Acknowledgments

Contributors

Star History

Updating Existing Clones

nikitabobko/AeroSpace

AeroSpace Beta

Key features

Installation

Community, discussions, issues

Project status

Development

Project values

macOS compatibility table

Sponsorship

People who have write access

Tip of the day

Related projects

jaywcjlove/awesome-mac

Awesome Mac

Contents

Reading and Writing Tools

Text Editors

Office

Markdown Tools

Note-taking

Journaling

Writing

Ebooks

RSS

Others

Developer Tools

IDEs

Developer Utilities

Regular Expression Editors

API Development and Analysis

Network Analysis

Frameworks For Hybrid Applications

Version Control

Virtualization

Databases

Terminal Apps

Design and Product

Design Tools

Prototyping and Mind-Mapping Tools

Screenshot Tools

Screen Recording

Other Tools

AI Tools

Communication

Collaboration and Team Tools

Email Clients

File Sharing

`mesh #bluetooth`

Location Channels (`block #dr5rsj7`, `neighborhood #dr5rs`, `country #dr`)

Option 2: Using `just`