DOCSEARCHbyAlgolia
Submit Docs

BetterAndBetter Documentation

repository·master·Indexed 20 days ago

https://github.com/songhao/betterandbetter

A comprehensive macOS productivity enhancement tool featuring advanced gesture recognition for trackpads and mice, window management with snapping and splitting, and automation via AppleScript. It includes specialized modules for keyboard shortcuts, scenario modes, auto pop-up actions for text and files, corner triggers, and a toolbox containing clipboard management and Bluetooth-based unlocking.

Tokens
1.9K
Snippets
1
Records
11
Agent score
71%

What's inside BetterAndBetter

  1. Overview of BetterAndBetter modules

    master

    BetterAndBetter is a macOS productivity suite that enhances user experience through various specialized modules. Key modules include:

    • Trackpad (触摸板): Uses gestures (single finger, multi-finger, tapping, drawing) to simulate key presses or execute AppleScript.
    • Mouse (鼠标): Customizes mouse gestures (right-click movement) and button combinations to trigger actions.
    • Keyboard (键盘): Allows customization of shortcuts.
    • Scenario Mode (情景模式): Automates Mac settings based on different contexts.
    • Auto Pop-up (自动跳窗): Provides quick actions for selected text or files (similar to PopClip).
    • Corner Trigger (边角触发): Assigns actions (shortcuts, presets, or AppleScript) to clicking the four corners of the screen.
    • Window Management (窗口管理): Features window snapping, splitting, and dragging enhancements.
    • Toolbox (工具箱): A collection of utilities like Bluetooth unlocking, clipboard management, and more.
    • Script (脚本): Integration for using AppleScript to extend functionality.

  2. Understand drawing modes for Mouse and Touchpad

    master

    The application supports two primary ways to perform drawing actions:

    • 鼠标右键绘图 (Mouse Right-Click Drawing): Hold down the right mouse button and move the mouse to begin drawing.
    • 触摸板绘图 (Touchpad Drawing): Slide your finger across the touchpad to draw without needing to press down.

  3. Configure Mouse gestures and acceleration

    master

    The Mouse module allows for extensive customization of mouse behavior.

    Gesture Types:

    • Right-click movement: Perform movements while holding the right mouse button.
    • Combination keys: Hold the right mouse button and use other menu-indicated actions.
    • Other buttons: Hold other mouse buttons combined with menu-indicated actions.

    Settings:

    • Gesture Similarity: Adjust how closely the drawn trajectory must match the database (recommended range: 75--95).
    • Mouse Acceleration: A slider to adjust acceleration; setting this to 0 disables mouse acceleration.

  4. Configure Trackpad gestures

    master

    The Trackpad module is a gesture recognition application for MacBook trackpads. It listens for finger movements and executes rules when a gesture is recognized.

    Capabilities:

    • Simulate key presses.
    • Execute preset commands.
    • Execute AppleScript.

    Key Features:

    • Two-finger drawing: When enabled, holding one finger and tapping with another allows for single-finger drawing (simulating a right-click drag).
    • Blacklist: You can select a 'Blacklist' for specific gestures to ensure they do not trigger while using certain applications.

  5. Manage windows with Window Management features

    master

    The Window Management module provides tools for controlling window placement and movement.

    Features:

    • Split Screen Hints: When moving a window, eight hint boxes appear representing different split-screen positions.
    • Snapping (吸附): Dragging a window toward the left or right edge of the screen will trigger a yellow line. Releasing the mouse will snap the window to that side.
      • Moving the mouse to an already snapped window will cause it to pop out.
      • Moving the mouse away will snap it back.
      • Note: Windows that are equal to the full screen width will not snap.

  6. Configure general preferences in BetterAndBetter

    master

    You can customize the application behavior through the Preferences menu. Key settings include:

    • 开机时启动 (Start at boot): Automatically launch the application when the system starts.
    • 提醒小贴士 (Show tips): Toggle reminder tips.
    • 显示绘图轨迹 (Show drawing trajectory): When enabled, the cursor's path is displayed while drawing using the Touchpad module, Mouse module (right-click drawing), or Touchpad drawing.
    • 语言 (Language): Change the application language.
    • 同意反馈崩溃信息 (Agree to crash reports): Opt-in to sending crash information for debugging.

  7. Use the Auto Pop-up module for text and files

    master

    The Auto Pop-up module provides a quick-action menu for selected text or files, similar to PopClip.

    How to trigger:

    • For Text:
      1. Dragging to select text.
      2. Double-clicking text.
      3. Two clicks on an input area within 0.6 seconds without moving the mouse.
    • For Files:
      1. Dragging to select in a blank area of Finder.
      2. Double-clicking on the Desktop.
      3. Two clicks on a file or directory within 0.6 seconds without moving the mouse.

    Configuration:

    • The module uses two tables for actions. You can drag rows to change the execution order.
    • Status Bar Indicators:
      • ⌘C, ⌘V, ⌘X: These actions only appear in the pop-up if the active App supports Copy, Paste, or Cut.
      • ⌘: This action always appears in the pop-up regardless of the active App.

  8. Access BetterAndBetter help documentation by module

    master

    The BetterAndBetter help documentation is organized by functional modules. Use the following guides to troubleshoot or configure specific features:

    • General Settings: For general configuration and common issues, refer to the General Settings guide.
    • Touch/Trackpad: For settings related to the touchpad and touch modules, see the Touch Module guide.
    • Mouse: For mouse and mouse module settings, see the Mouse Module guide.
    • Keyboard: For keyboard and keyboard module settings, see the Keyboard Module guide.
    • Scenario Modes: For settings related to scenario modes, see the Scenario Mode guide.
    • Auto Window Switching: For the auto window switching module, see the Auto Window Switching Module guide.
    • Corner Trigger: For corner trigger module settings, see the Corner Trigger Module guide.
    • Window Management: For window management module settings, see the Window Management Module guide.
    • Toolbox: For toolbox module settings, see the Toolbox Module guide.
    • Scripts: For script module settings, see the Script Module guide.

  9. Use Toolbox utilities: Bluetooth Unlocking and Clipboard Management

    master

    The Toolbox module contains several specialized utilities.

    Bluetooth Unlocking

    Automatically enters your system password by detecting a paired Bluetooth device when waking from sleep, screen saver, or when the screen is turned off.

    • Login Photo: If enabled, the app uses the built-in camera to take a photo when waking. If no Bluetooth device is detected, the photo is saved to a user-selected directory (which can be synced via iCloud to detect unauthorized access).

    Clipboard Management

    Keeps track of the last 10 clipboard items and allows for three fixed clipboard entries.

    Triggering the Clipboard Manager:

    • Via the Auto Pop-up module by clicking the ✄ icon.
    • Via a custom shortcut defined in the Keyboard module.

    Execution:

    • Click any line in the pop-up window with the mouse.
    • Press the corresponding number key (Note: To call fixed clipboard content, hold Fn + the number key).