8000 GitHub - soonxf/Qind: macOS 菜单栏(状态栏)效率工具集。无传统主窗口,常驻菜单栏,聚合 访达增强、截图、录屏、剪贴板、应用快捷键、输入法切换 等模块,通过一个玻璃拟态设置窗口统一管理。 · GitHub
[go: up one dir, main page]

Skip to content
soonxfPublic

About

macOS 菜单栏(状态栏)效率工具集。无传统主窗口,常驻菜单栏,聚合 访达增强、截图、录屏、剪贴板、应用快捷键、输入法切换 等模块,通过一个玻璃拟态设置窗口统一管理。

Topics

Resources

Stars

17 stars

Watchers

1 watching

Forks

Repository files navigation

Qind

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Français · Русский · Español · العربية

Website: https://qind.work/

A macOS menu bar (status bar) productivity toolkit. With no traditional main window, it lives in the menu bar and bundles modules such as Finder enhancements, screenshots, screen recording, clipboard, app hotkeys, and input method switching, all managed through a single glassmorphism settings window.

Item Description
Platform macOS 14.0 (Sonoma) or later
Form factor Menu bar app (LSUIElement = YES, no Dock icon)
Language Swift / SwiftUI + AppKit, system frameworks only, no SPM / CocoaPods dependencies
UI languages Simplified Chinese, Traditional Chinese, English, Japanese, Korean, French, Russian, Spanish, Arabic
Version 1.0.0 (build 2) · Bundle ID com.qind.app

App Preview

Clipboard floating panel

Clipboard floating panel — a desktop glassmorphism history panel with search and category filters for All / Text / Images / Files / Videos / Favorites

Finder feature menu App hotkeys
Finder feature menu settings App hotkey settings
Toggle and reorder the Finder context menu items Bind a global summon hotkey to any app
Screenshot Screen recording
Screenshot settings Screen recording settings
Configure capture hotkeys and capture modes Recording hotkeys and output naming templates
Input method switching Clipboard
Input method switching settings Clipboard settings
Remember / assign an input method per app History storage policy and panel appearance

Feature Modules

Modules are registered through the AppModule protocol (see AppModuleRegistry.swift) and can be enabled or disabled individually in Settings.

Module Description
Finder feature menu Injects actions into the Finder context menu via a Finder Sync extension: compress / decompress, copy / cut / paste, new file, new terminal, copy path, delete, empty Trash, show hidden files, network configuration, uninstall app, restart Finder, open with a chosen app, and more
App hotkeys Carbon global hotkeys that bind a summon / toggle shortcut to any installed app. Subscription required
Screenshot Full-screen / area / window / scrolling captures, smart element capture, subject extraction, OCR text recognition, screenshot annotation editor, quick access card. Subscription required
Screen recording Area / screen / window recording with video and GIF output, microphone and system audio, mouse highlight, keystroke overlay, live pen annotation
Input method switching Remembers and switches the input method per app. Subscription required
Clipboard Clipboard history panel (floating and regular forms), categories, favorites, storage policy. Subscription required
System settings System-level toggles such as permission management, launch at login, menu bar / Dock visibility
About Version and contact information

Subscription: App hotkeys, input method switching, clipboard, and screenshot are subscription features and can only be enabled after activating a subscription.


Requirements

  • macOS 14.0 or later
  • A recent version of Xcode (this repository has been verified to build with Xcode 26.6 / macOS SDK 26.5)
  • No third-party package manager dependencies required

Build and Run

Option 1: Command line (recommended, verified)

# 1. Build (Debug)
xcodebuild -project Qind.xcodeproj -scheme Qind -configuration Debug \
  -derivedDataPath build/DerivedData build

# 2. Launch
open build/DerivedData/Build/Products/Debug/Qind.app

Building the Qind scheme also compiles and embeds the Finder extension QindExtension.appex and the compression engine 7zz; there is no need to build the extension separately.

Option 2: Xcode GUI

  1. Double-click Qind.xcodeproj to open it
  2. Select the Qind scheme at the top and My Mac as the destination
  3. Press ⌘R to run

Once launched, the app does not appear in the Dock. Look for the Qind icon in the menu bar at the top-right of the screen to access the modules and settings. On first launch, an onboarding window appears to help you configure permissions and preferences.


Permissions on First Run

The app is signed locally (ad-hoc / Sign to Run Locally) and is not tied to a development team. Screenshot, screen recording, and hotkey capabilities depend on the following system permissions, which you can grant as needed in System Settings → Privacy & Security (the onboarding window and "System Settings → Permission Management" will prompt you as well):

Permission Purpose
Screen Recording Screenshots, screen recording, scrolling captures
Accessibility Global hotkeys, window monitoring, UI automation
Input Monitoring Global hotkey capture
Microphone Recording narration
Automation (AppleEvents) Controlling Finder / Terminal, etc.
Full Disk Access File operations such as Trash and app uninstallation
Notifications Copy confirmations, OCR results, etc.

The Finder extension is registered and enabled automatically via pluginkit when the app launches; if the context menu does not appear, you can manually check QindExtension in System Settings → Privacy & Security → Extensions → Finder.


Logs and Troubleshooting

Runtime logs are written under /tmp for easy troubleshooting:

Log Path
Main app /private/tmp/QindApp.log
Finder extension /private/tmp/QindExtension.log
Hotkey module /tmp/Qind_hotkey.log
tail -f /private/tmp/QindApp.log

Project Structure Overview

Qind/
├── Qind.xcodeproj/        # Project (targets: Qind / QindExtension / QindTests / QindUITests)
├── Qind/
│   ├── Modules/           # Feature modules (Screenshot / Record / Clipboard / Features / Hotkeys / InputMethod / System / About …)
│   ├── Components/        # Shared UI components (glass panels, permissions, settings scaffolding, etc.)
│   ├── Localization/      # In-house JSON localization tables (8 .lproj)
│   └── Contents/Frameworks/7zz   # 7-Zip command-line engine embedded in the bundle
├── QindExtension/         # Finder Sync extension (context menu injection)
└── docs/                  # App preview images

Third-Party Code and Components

Snapzy (screenshot / annotation / recording)

Parts of this project's screenshot annotation editor (Annotate), quick access card (Quick Access), capture compatibility layer (Shim*), and screen recording (Record) modules are ported from / derived from the open source project Snapzy:

The corresponding source code lives in Qind/Modules/ScreenshotModule/ and Qind/Modules/RecordModule/, where Annotate/Support/Shim*.swift is the compatibility layer that bridges to Qind's infrastructure. This project uses and modifies the above code in compliance with the BSD-3-Clause terms; this notice is provided here with thanks to the original author.

7-Zip (7zz)

The 7zz command-line binary is embedded in the app bundle (Qind/Contents/Frameworks/7zz) and powers the "compress / decompress" actions in the Finder context menu. 7-Zip © Igor Pavlov, released under the GNU LGPL.


License

Except for the third-party components listed above, the license for the remaining code in this project is declared separately by the repository owner.

About

macOS 菜单栏(状态栏)效率工具集。无传统主窗口,常驻菜单栏,聚合 访达增强、截图、录屏、剪贴板、应用快捷键、输入法切换 等模块,通过一个玻璃拟态设置窗口统一管理。

Topics

Resources

Stars

17 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages

0