Feature Overview

MouseBoost has many features. It is easier to understand them by asking “what task do I want to finish now?” instead of memorizing the menu order. The actual menu changes dynamically based on the selected file type, multi-selection state, whether a folder is selected, installed third-party apps, and available permissions.

Context Menu Management

The core of MouseBoost is a configurable Finder context menu.

You can:

• Enable or hide menu items.
• Reorder menu items.
• Assign a shortcut to each menu item.
• Put frequent actions in the main menu.
• Use a folded menu to reduce Finder menu length.
• Change the folded menu name and icon.
• Hide the main menu icon or submenu icons.
• Control whether the system context menu appears at the top, bottom, or not at all.

Good main-menu candidates include Copy Path, New File, Open Terminal, Favorite Folders, Copy To, Move To, Clipboard History, and Batch Rename.

New Files

MouseBoost can create files directly in the current Finder folder.

Default types include:

• Text and rich text: txt, rtf, md.
• Data and config: json, xml.
• Office and iWork: docx, xlsx, pptx, pages, numbers, key.
• WPS: wps, et, dps.
• Web and scripts: html, css, js, py, sh.

You can also add an existing file as a template. Later, creating a new file from the context menu copies the template content and can preserve the icon and default filename.

Notes:

• New files can optionally open automatically after creation.
• You can choose whether new files hide their extensions.
• When no file is selected, some New File entries may show a save panel.
• If the current folder is not writable, authorize the folder first.

Favorite Folders

Favorite Folders put frequently used folders into the context menu.

Typical uses:

• Quickly open project folders, downloads, asset folders, or temporary folders.
• Copy the current selection to a favorite folder.
• Move the current selection to a favorite folder.
• Create aliases in favorite folders.
• Open Terminal in a favorite folder.
• Quickly add a right-clicked folder as a favorite folder.

Favorite Folders can expand subfolders. For deep workspaces, add the top-level folder and continue choosing subfolders inside the context menu.

Favorite Apps

Favorite Apps send files or folders to a chosen app quickly.

Default candidates include:

• OmniZip / OmniZip Pro.
• OmniReader.
• WeChat.
• Visual Studio Code.
• Sublime Text.
• Trae CN.
• Cursor.
• Windsurf.
• Antigravity.
• Codex.
• Android Studio, IntelliJ IDEA, WebStorm, PyCharm, PhpStorm, GoLand.
• Warp, Zed, Emacs.

Useful workflows:

• Right-click a project folder and open it in VS Code, Cursor, or WebStorm.
• Right-click a file and open it with a chosen editor.
• Put development tools in the main menu.
• Show install or open-failed guidance when an app is missing.

Favorite Websites

Favorite Websites put web entry points into the Finder context menu.

Defaults include several AI tool sites:

• DeepSeek.
• Doubao.
• Kimi.
• Gemini.
• ChatGPT.
• Claude.

You can add your own URLs, such as project management systems, internal docs, cloud drives, design tools, admin consoles, and other web tools.

Common Scripts

Common Scripts support Shell scripts and AppleScript. Scripts can read the selected file path, filename, extension, and folder, then run directly in the Finder context.

Default scripts include:

• Welcome prompt.
• Create a same-named folder from a file.
• tar compression.
• Restart Finder.
• Toggle dark / light appearance.
• Start screen saver.
• Lock screen.
• Sleep display and lock.
• Sleep.
• Toggle menu bar auto-hide.
• Toggle Dock auto-hide.
• macOS 13+ Stage Manager and recent apps toggles.
• Eject all disks.
• Show local IP.
• Clear clipboard.
• Empty Trash.
• Common Git operations.

Script variables include:

• @rfpath: current file path.
• @rfpaths: multiple selected file paths.
• @rfpos: folder of the current file.
• @rfposs: folders of multiple selected files.
• @rfname: current full filename.
• @rfnames: multiple full filenames.
• @rfnam: current filename without extension.
• @rfnams: multiple filenames without extensions.
• @rfext: current file extension.
• @rfexts: multiple file extensions.
• @rday: number of days used.
• @rloading: show a loading indicator while running.

Shell scripts automatically cd to the folder containing the current selection. If a script accesses protected paths, macOS may require folder authorization or Full Disk Access.

Default script code, dynamic Git scripts, and customization examples are documented in Common Scripts.

Terminals And Developer Tools

MouseBoost can open a terminal or third-party terminal tool in the current folder.

Supported entries include:

• Terminal Window.
• Terminal Tab.
• Terminal To.
• iTerm2 Window / Tab / To.
• Ghostty Window / Tab / To.
• cmux Window / Tab / To.
• Kaku Window / To.

If a default terminal Bundle ID is configured, MouseBoost uses that terminal first. Missing third-party terminals may show install guidance or a download link.

Copy, Move, And Paste

MouseBoost adds many Finder file-management actions:

• Copy path.
• Copy file or folder name.
• Copy file content.
• Copy directory tree.
• Copy to a favorite folder or another folder.
• Move to a favorite folder or another folder.
• Create an alias in a target folder.
• Send to Desktop shortcut.
• Cut files.
• Paste files.
• Paste images.

Notes:

• Cut and paste depend on reading Finder selection paths, which usually requires Accessibility permission.
• Command + X file cutting must be enabled in preferences.
• Cross-disk moves, external disks, and protected folders may require extra authorization.
• If the target already contains a file with the same name, MouseBoost prompts to replace or generate a unique name.

File And Folder Operations

Common operations include:

• New folder.
• Move to Trash.
• Delete directly.
• Get Info.
• Show Package Contents.
• Eject external volumes.
• Show or hide file extensions.
• Hide selected files.
• Unhide selected files.
• Hide all files in the current folder.
• Unhide all files in the current folder.
• Show or hide system hidden files.
• Lock or unlock files.
• Embed folder.
• Unembed folder.
• Add folder icon.
• Restore folder icon.

“Embed folder” is useful for collecting one or more files into a new folder. With multiple selections, you can choose whether to group by extension. “Unembed folder” moves folder contents up one level; when there is only one file, you can choose whether to rename the file to the folder name.

Batch Rename

Batch Rename is a separate window tool for processing many filenames at once.

Supported rules include:

• Add text.
• Replace text.
• Case conversion.
• Sequence number.
• Date.
• Formatted name.
• Delete text.
• Clean illegal or irregular characters.
• Extension rules.

Suggested workflow:

1. Select files in Finder.
2. Open Batch Rename.
3. Add one or more rules.
4. Check the preview list.
5. Execute only after confirming the result.

Batch Rename is a high-impact operation. The docs and website should show screenshots of both the rule area and the preview area.

File Analysis

MouseBoost provides file information and analysis tools:

• File Info window.
• MD5.
• SHA1.
• SHA256.
• SHA512.
• CRC32.
• Total file size.
• Duplicate finder.

Duplicate Finder requires selecting a folder. After scanning, it groups duplicate files and lets you review before deleting. Large folders may take longer to scan.

Image And Media Processing

Image tools are an important feature group in MouseBoost.

Supported actions:

• Image format conversion.
• Merge images into PDF.
• Extract images from PDF.
• Extract GIF frames.
• HEIC conversion.
• OCR image to text.
• SRT to TXT.
• Resize images to preset sizes.
• Custom image resize.
• Image crop.
• Image rotate.
• Image compression.
• Background removal.
• Replace background with a solid color, gradient, or image.
• Set as desktop picture.
• Scan QR code.
• Extract app or file icons.

Image conversion supports common formats such as png, jpg, jpeg, tiff, bmp, gif, webp, heic, pdf, and more. Office to PDF depends on LibreOffice. If LibreOffice is not installed, MouseBoost prompts you to install it.

Notes:

• Background removal requires macOS 14.0+.
• Screenshot-to-clipboard may require Screen Recording permission.
• Large images or batch processing may take time.
• Image compression creates a new _compressed.jpg file.
• Image rotation saves back to the original file. Back up important images first.

Compression And OmniZip

MouseBoost includes compression-related actions:

• Encrypted compression.
• tar compression script.
• Create DMG.
• Image compression.

It can also integrate OmniZip or OmniZip Pro:

• Extract to the current folder.
• Preview archives.
• Compress directly to zip.
• Custom compression.

If OmniZip is not installed, related menu items may show an open-failed prompt or install guidance.

Shortcuts

Each MouseBoost menu item can have its own shortcut. In the main app’s General menu configuration page, use the shortcut column to bind high-frequency actions such as Copy Path, Batch Rename, Clipboard History, scripts, and Terminal Here.

Default shortcuts include Quick Access, Cut File, Paste File, and Clipboard History. Shortcuts that read Finder selections usually require Accessibility permission.

Clipboard History

MouseBoost includes Clipboard History and stores history with SQLite.

Supported content types:

• Files.
• Images.
• Text.
• HTML.
• RTF.

Main abilities:

• Automatically monitor clipboard changes.
• Search history content.
• Filter by type, source app, and time.
• Preview items.
• Copy items.
• Paste to the current editor.
• Pin or unpin.
• Delete one record.
• Clear history.
• Configure double-click to copy or paste.
• Place the popover at the mouse position or screen center.
• Use blacklist or whitelist rules to ignore apps.
• Paste queue, which pastes multiple history items one by one.

Privacy handling:

• Ignores clipboard types marked hidden, transient, or automatically generated by the system.
• Ignores password-manager clipboard types such as 1Password.
• Marks content written by MouseBoost itself to avoid recording loops.

System Tools

MouseBoost also integrates system-level utilities:

• Keyboard Cleaner: shows a cleaning overlay and blocks keyboard input so you can wipe the keyboard.
• Keep Awake: supports 5, 10, 30, 60, 120 minutes, or indefinitely.
• Mute / unmute microphone.
• QuickTime screen recording.
• QuickTime audio recording.
• QuickTime movie recording.
• AirDrop.
• Send to WeChat.
• Use selected image as desktop picture.
• Screenshot to clipboard.

These abilities may depend on Accessibility, Screen Recording, Microphone, system share services, or third-party app settings.

Configuration Backup And Sync

MouseBoost supports configuration import/export and iCloud sync.

You can:

• Export configuration to a local file.
• Import from a local configuration file.
• Manually upload to iCloud.
• Manually download from iCloud.
• Enable automatic sync.

Configuration mainly includes menus, favorite folders, favorite apps, common scripts, new file templates, folder icons, and preference data.

Notes:

• iCloud sync requires iCloud Drive to be enabled in macOS.
• Downloading cloud configuration overwrites local configuration. Export a backup first.
• When automatic sync is enabled, importing configuration also syncs the result to iCloud.