{"id":50523058,"url":"https://github.com/ggbond268/MacTools","last_synced_at":"2026-06-20T00:00:54.400Z","repository":{"id":351220268,"uuid":"1209106566","full_name":"ggbond268/MacTools","owner":"ggbond268","description":"A free and open-source collection of native macOS menu bar tools. 免费开源的 macOS 原生菜单栏工具集合。","archived":false,"fork":false,"pushed_at":"2026-06-18T16:26:26.000Z","size":20142,"stargazers_count":223,"open_issues_count":29,"forks_count":11,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-18T18:21:45.456Z","etag":null,"topics":["fan-speed-control","macos","menubar","swiftui"],"latest_commit_sha":null,"homepage":"https://mactools.ggbond.app","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ggbond268.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-13T05:17:43.000Z","updated_at":"2026-06-18T16:26:37.000Z","dependencies_parsed_at":"2026-05-23T07:02:14.599Z","dependency_job_id":null,"html_url":"https://github.com/ggbond268/MacTools","commit_stats":null,"previous_names":["ggbond268/mactools"],"tags_count":72,"template":false,"template_full_name":null,"purl":"pkg:github/ggbond268/MacTools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ggbond268%2FMacTools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ggbond268%2FMacTools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ggbond268%2FMacTools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ggbond268%2FMacTools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ggbond268","download_url":"https://codeload.github.com/ggbond268/MacTools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ggbond268%2FMacTools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34552295,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-19T02:00:06.005Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fan-speed-control","macos","menubar","swiftui"],"created_at":"2026-06-03T06:00:31.031Z","updated_at":"2026-06-20T00:00:54.394Z","avatar_url":"https://github.com/ggbond268.png","language":"Swift","funding_links":[],"categories":["Menubar"],"sub_categories":["Text"],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/logo-mactools-rounded.png\" width=\"96\" height=\"96\" alt=\"MacTools logo\"\u003e\n  \u003ch1\u003eA free and open-source collection of native macOS menu bar tools\u003c/h1\u003e\n  \u003cp\u003e\u003ca href=\"README.zh-CN.md\"\u003e[中文]\u003c/a\u003e [English]\u003c/p\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://github.com/ggbond268/MacTools/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/ggbond268/MacTools?style=social\" alt=\"GitHub stars\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/ggbond268/MacTools/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/ggbond268/MacTools\" alt=\"License\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/ggbond268/MacTools/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/ggbond268/MacTools\" alt=\"Latest release\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\n  \u003cp\u003eMacTools brings frequently used system actions together in a lightweight, fast, and unobtrusive menu bar app. Built with SwiftUI + AppKit for macOS 14.0 and later.\u003c/p\u003e\n\u003c/div\u003e\n\n## Screenshots\n\n\u003cimg src=\"docs/assets/screenshots/readme-hero-en-dark.png\" alt=\"MacTools menu bar panels in dark mode\"\u003e\n\n## Features\n\n| Feature | Description |\n| ------- | ----------- |\n| Display Resolution | View connected displays and switch each display to an available resolution. |\n| Display Brightness | Quickly adjust built-in and DDC/CI external display brightness, with per-display shortcut increments and Gamma/Shade fallbacks. |\n| True Tone | Automatically adapt display colors to ambient light on MacBooks and compatible displays. |\n| Display Sleep | Put all displays to sleep immediately, then wake them with mouse movement or keyboard input. |\n| Dark Mode | Toggle the system light and dark appearances, with live state sync when the system theme changes. |\n| Night Shift | Toggle Night Shift to reduce blue light and warm the screen colors at night. |\n| Prevent Sleep | Keep the system awake while idle, with automatic stop options after 30 minutes, 1 hour, 2 hours, or 5 hours. |\n| Clean Mode | Show a full-screen black overlay and temporarily disable input for cleaning the screen, keyboard, or trackpad. |\n| Middle Click | Trigger middle click with a three-finger trackpad tap by converting system events through a CGEvent tap, without affecting other gestures or left click. |\n| Hide Notch | Mask the top notch area on built-in notch displays without modifying the original wallpaper. |\n| Hide Menu Bar Icons | Hide icons to the left of a menu bar divider, with drag-based layout for visible, hidden, and always-hidden areas. |\n| Auto Hide Menu Bar | Automatically hide the menu bar to make more screen space available. |\n| Auto Hide Dock | Automatically hide the Dock for a cleaner desktop. |\n| Stage Manager | Toggle Stage Manager to focus the current window and place other windows on the side. |\n| System Mute | Mute or restore system audio output through CoreAudio on the default output device, with automatic restoration when the plugin is disabled. |\n| Microphone Mute | Mute or restore the default microphone input through CoreAudio without requesting recording permission. |\n| Disk Cleanup | Scan caches, developer caches, and browser caches, with path safety checks and sensitive data protection before deletion. |\n| Xcode Cleanup | Scan DerivedData, device support files, archives, simulators, and preview caches by category; deletion is disabled while Xcode is running and only runs inside allowlisted roots. |\n| Eject Disks | Eject all removable disks in one click, automatically skipping system volumes and reporting when no disk can be ejected. |\n| Empty Trash | Show the number of Trash items and empty Trash through Finder; the action is disabled when Trash is empty. |\n| Clear Clipboard | Clear the current clipboard content to protect privacy and avoid accidental paste. |\n| IP Check | View public IPv4/IPv6, local LAN IP, location, ISP, ASN, and timezone, with copy support for single fields or the full result. |\n| Translator | Translate the currently selected text with a global shortcut; the first version supports OpenAI-compatible services and automatic language selection. |\n| App Shortcuts | Bind global shortcuts to common apps; pressing a shortcut opens or activates the app, and hides it if it is already frontmost. |\n| Launchpad | Summon an app grid in fullscreen or a compact window, with instant search, horizontal paging, keyboard navigation, drag-to-stack folders with inline rename (click an open folder's title, or right-click a folder to rename/dissolve), an adjustable glass background (clear/standard/deep presets or a custom material + dimming, with a live preview in settings), adjustable appearance (icon size 48–96 pt with rows/columns adapting, optional icons-only mode that hides app names, label appearance presets (color: automatic/light/dark/accent, weight, and a size tier that scales with the icon — shared by app names and the open-folder title), and a compact-window size slider — the compact panel now scales with the screen instead of capping at 960×680, so any display whose usable area exceeds ~1333×829 pt renders a larger panel than before, including modern built-in laptop screens (~13% on a 14″ MacBook Pro); all previewed live by a layout thumbnail in settings that mirrors the real grid math), a global shortcut, and IME-composition safety. |\n| Lock Screen | Lock the screen immediately, equivalent to Cmd+Ctrl+Q. |\n| Launch Items | Browse LaunchAgent/LaunchDaemon entries with search, field explanations, and user-level enable/disable controls. |\n| Calendar Widget | View a monthly calendar, lunar calendar data, holidays, and today's events in the component panel. |\n| System Status | Show 1-hour charts for CPU, GPU, memory, disk, network, battery, and high-usage processes. |\n| Activity Stats | Track keyboard, mouse, scroll, and foreground app usage, with manual hooks for Claude Code, Cursor, and Codex activity. |\n| Device Battery | Aggregate battery levels for the Mac, Bluetooth peripherals, AirPods/Beats split batteries and charging state, and Rapoo VT series mice, with multiple widget layouts. |\n| Fan Control | Manage fan speed presets with automatic, full-speed, and custom fixed-RPM modes; installs the bundled helper and requests administrator authorization on first control. |\n| Battery Charge Limit | Limit battery charging to a chosen cap, defaulting to 80%; charging stops at the cap and does not automatically resume below it unless the user chooses to continue or force discharge. |\n| Fix Damaged Apps | Remove quarantine attributes to resolve \"damaged and can't be opened\" prompts by selecting a .app in a file panel and running the fix with administrator privileges. |\n| Quit Apps | Select and quit running apps, or quit all at once; reverse selection helps quickly choose the target set. |\n| zsh Config | View and edit zsh configuration files such as .zshrc and .zshenv inside the app, with syntax highlighting, common snippets, and automatic backup before saving. |\n| Plugins \u0026 Settings | Install, update, and batch-update plugins in the plugin marketplace, and manage permissions, shortcuts, and plugin-specific settings. |\n| Menu Bar Icon Customization | Use local images or lightweight GIF/MP4 animations as the menu bar icon, download animated icons from the online gallery, remove backgrounds, adjust playback speed, and restore the default icon. |\n| Localization | Follow the system language by default, or choose a fixed app language in Settings \u003e General \u003e Appearance. |\n\n\u003e **Right-click action:** You can use Option + left-click on the MacTools icon to trigger the right-click action.\n\n## Install\n\n```bash\nbrew install --cask mactools\n```\n\n## Upgrade\n\n```bash\nbrew update\nbrew upgrade --cask --greedy mactools\n```\n\nIf Homebrew still reports that the cask is already up to date, check the locally resolved cask version first:\n\n```bash\nbrew info --cask mactools\n```\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, testing, plugin development, and release workflows.\n\n## License\n\nMacTools is open source under the [Apache License 2.0](LICENSE).\n\n## Acknowledgements\n\n- Third-party assets, dependencies, and implementation references are listed in [Sources/Resources/ThirdPartyNotices](Sources/Resources/ThirdPartyNotices).\n- Contributors\n\n  \u003ca href=\"https://github.com/ggbond268/MacTools/graphs/contributors\"\u003e\n    \u003cimg src=\"https://contrib.rocks/image?repo=ggbond268/MacTools\u0026max=120\u0026columns=12\" width=\"480\" alt=\"contributors\"\u003e\n  \u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fggbond268%2FMacTools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fggbond268%2FMacTools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fggbond268%2FMacTools/lists"}