Skip to main content

Frequently Asked Questions (FAQ)

Here we compile frequently asked questions from MiniTrack users and provide solutions.

Installation & Permissions​

Q: Why is accessibility permission required?​

A: Accessibility permission is required because MiniTrack needs to:

  • Control mouse cursor position and clicks
  • Simulate keyboard input
  • Execute special gesture commands (like Mission Control)

These operations are system-level features that require explicit authorization for security.

Q: I didn't see the permission request on first startup, what should I do?​

A: Grant permissions manually:

  1. Open System Settings
  2. Go to Privacy & Security → Accessibility
  3. Click the + button at the bottom left
  4. Select MiniTrack from the Applications folder
  5. Click Open

Q: Can I use it on iPad?​

A: Yes, MiniTrack fully supports iPad. Installation and usage are the same as iPhone. iPad's larger screen may provide a better trackpad experience.

Connection Issues​

Q: Bluetooth connection frequently disconnects?​

A: Unstable Bluetooth connection may be caused by:

  1. Signal Interference

    • Stay away from Wi-Fi routers and other Bluetooth devices
    • Some 2.4GHz devices (like microwaves) may cause interference

  2. Device Compatibility

    • Ensure both Mac and iOS/iPad devices support Bluetooth 5.0 and above
    • Update to the latest macOS and iOS/iPad OS versions

  3. Application Issues

    • Restart the MiniTrack application
    • Clear application cache then reconnect
    • Update to the latest version

  4. System Issues

    • Restart Bluetooth: Turn off for 10 seconds then turn back on
    • Restart devices

Q: Can I connect multiple iOS devices at once?​

A: The current version of MiniTrack only supports one iOS/iPad device connecting to Mac at a time. If you want to switch devices, disconnect the old device before connecting the new one.

Q: Application shows "Cannot get permissions" after connection?​

A: This usually means the Mac application lacks necessary system permissions:

  1. Open System Settings → Privacy & Security
  2. Check if the following permissions are granted to MiniTrack:
    • Accessibility ✓
    • Input Monitoring ✓ (if this option exists)
    • May also need authorization in Bluetooth settings
  3. Restart the MiniTrack application

Q: Why can't iOS find available devices?​

A: Check the following steps:

  1. Mac side: Make sure MiniTrack is running and broadcasting

    • Check MiniTrack icon in Mac menu bar
    • Application is not minimized or hidden
    • Mac's Bluetooth is enabled

  2. iOS side:

    • Open Settings → Bluetooth and confirm it's enabled
    • Ensure iPhone/iPad is not in Airplane mode
    • Both devices are within 10 meters

  3. Try:

    • Force close MiniTrack on iOS, then reopen
    • Restart MiniTrack on Mac
    • Restart Bluetooth

Features & Operations​

Q: Gesture recognition is inaccurate, what should I do?​

A: Gesture recognition is algorithm-based on finger position and movement. These tips may help:

  1. Ensure screen is clean - Fingerprints or dirt may affect recognition
  2. Adjust finger position - Ensure all fingers clearly touch the screen
  3. Slow down - Fast gestures may not be properly recognized
  4. Check sensitivity - Adjust gesture sensitivity in settings

Especially for multi-finger gestures (three finger, four finger):

  • All fingers should start on screen simultaneously
  • Reasonable distance between fingers
  • Consistent gesture execution speed

Q: Cursor movement has latency?​

A: Minor latency is normal, but if latency is excessive:

  1. Check Bluetooth connection quality

    • Move closer to Mac device
    • Avoid objects blocking the signal
    • Stay away from interference sources (routers, microwaves, etc.)

  2. Lower sensitivity

    • In Settings → Sensitivity
    • Appropriately lower cursor speed and scroll speed

  3. Restart application

    • Disconnect
    • Completely close both applications
    • Restart and reconnect

  4. Check device performance

    • Close unnecessary background applications
    • Ensure iOS and macOS have sufficient available memory

Q: Why don't some advanced gestures (like four-finger pinch) work?​

A: Advanced gestures require proper configuration in macOS system settings:

  1. Open System Settings → Trackpad (if using Mac trackpad) or Mouse

  2. Check if corresponding gestures are enabled:

    • Four-finger pinch should be configured as Show Application Windows or App Exposé
    • Four-finger spread should be configured as Show Desktop
    • Three-finger swipe should be configured as Slide Between Full-Screen Apps

  3. If gestures still don't work, try disabling then re-enabling in system preferences

note

Some Mac models or macOS versions may not support all gestures. Check if your Mac supports multi-finger trackpad gestures.

Q: How do I quickly switch between keyboard and trackpad?​

A: In the iOS application:

  1. In keyboard mode, there's a mini trackpad at the bottom of the screen
  2. Click the Trackpad button above the mini trackpad to switch back to full-screen trackpad
  3. In trackpad mode, there's a Keyboard button at the top to switch to keyboard

Quick switching allows seamless use of keyboard and trackpad functionality as needed.

Q: How do I input special characters on the virtual keyboard?​

A: The virtual keyboard supports special character input:

  1. Long-press letter keys - Additional symbol options appear
  2. Use modifier keys - Holding Shift can input uppercase letters and symbols
  3. Numeric keypad - Switch to numeric mode to input numbers and related symbols
  4. Switch keyboard layout - Settings may have different keyboard layout options

Performance & Optimization​

Q: How can I improve the smoothness of cursor movement?​

A: MiniTrack already has multiple built-in performance optimizations. These suggestions may further improve the experience:

  1. Optimize Bluetooth environment

    • Reduce the number of other Bluetooth devices
    • Keep device distance within 5 meters

  2. Adjust application settings

    • Turning off trail effect may improve smoothness
    • Check Settings for Trail option

  3. System optimization

    • Close unnecessary background applications on Mac
    • Ensure system has sufficient available memory
    • Update to the latest macOS version

  4. Hardware considerations

    • Some older Mac or iOS devices may have insufficient performance
    • Consider upgrading devices for better Bluetooth performance

Q: Does the application consume a lot of battery?​

A: MiniTrack uses multiple power optimization measures:

  1. Bluetooth optimization - Uses low-power Bluetooth (BLE) technology
  2. Event batching - Avoids frequent Bluetooth transmission
  3. Smart screen management - Automatically reduces refresh rate when not in use

Generally speaking:

  • iOS device has moderate power consumption during connected use
  • A full day of use typically won't completely drain the battery
  • Power consumption drops to minimum when disconnected

Power-saving tips:

  • Disconnect when not in use
  • Lower screen brightness
  • Turn off unnecessary background features

Theme & Interface​

Q: How do I switch between dark/light mode?​

A: In the MiniTrack application:

  1. Open application settings
  2. Find the Appearance or Theme option
  3. Select one of:
    • Light - Always use light theme
    • Dark - Always use dark theme
    • Follow System - Automatically adapt to device system theme setting

Changes take effect immediately.

Q: What languages does it support?​

A: MiniTrack currently supports:

  • Chinese (Simplified)
  • English

Select your preferred language in Language option in application settings.

Troubleshooting​

Q: Application crashes or becomes unresponsive?​

A: If you encounter crashes or freezing:

  1. Force close application

    • iOS: Swipe up (from bottom) or close in background app management
    • macOS: Press Command+Option+Esc, select MiniTrack, click "Force Quit"

  2. Clear cache (optional)

    • iOS: Open Settings → Find MiniTrack → Uninstall app, reinstall
    • macOS: Similar method

  3. Restart device

    • Completely restart both iOS/iPad and Mac devices

  4. Update application

    • Ensure running the latest version of MiniTrack

Q: How do I report bugs or provide feedback?​

A: We welcome feedback and bug reports! Please contact us through:

  • Visit the project GitHub page to submit an Issue
  • Send an email to official support email
  • Use the "Feedback" feature in the application

Providing detailed problem description, operating system version, and MiniTrack version number helps us resolve issues faster.

Haven't found your question? Check the Getting Started guide or contact technical support through official channels.