Categorygithub.com/Hootrix/go-mouse-keeper
module
0.1.10
Repository: https://github.com/hootrix/go-mouse-keeper.git
Documentation: pkg.go.dev

# README

GoMouseKeeper

screenshot

GoMouseKeeper / GoMouseBusyer keeps your mouse busy. It's particularly useful in scenarios where you need to maintain screen activity, such as preventing automatic screen locks or maintaining online status.

Features

  • Random Mouse Movement: Simulates random mouse movements after a specified idle time
  • User Intervention Detection: Automatically pauses when manual mouse movement is detected
  • Flexible Timeout Settings: Multiple timeout options available (5 seconds, 1 minute, 5 minutes, 10 minutes, 30 minutes, 60 minutes)
  • System Tray Integration: Easy program control through system tray icon

Installation

Option 1: Direct Installation (Recommended)

go install github.com/Hootrix/go-mouse-keeper/cmd/mouse-keeper@latest

# or Specified version
go install github.com/Hootrix/go-mouse-keeper/cmd/[email protected]

After installation, simply run mouse-keeper in your terminal to start the program.

Option 2: Install from Source

git clone https://github.com/Hootrix/go-mouse-keeper.git
cd go-mouse-keeper
go install ./cmd/mouse-keeper

Usage

$ mouse-keeper

Command Line Options

Usage:
  mouse-keeper [command]

Available Commands:
  enable      Start MouseKeeper when system starts
  disable     Do not start MouseKeeper when system starts
  help        Help about any command

Flags:
  -h, --help   help for mouse-keeper

Auto-start Configuration

To configure MouseKeeper to start automatically with your system:

# Enable auto-start
sudo mouse-keeper enable

# Disable auto-start
sudo mouse-keeper disable

System Tray Usage

cmd-screenshot

  1. After running the program, you'll see an icon in your system tray
  2. Click the icon to see the following options:
    • Resume/Pause: Start/Stop mouse movement
    • Check Timeout Settings: Set mouse idle time
    • Quit: Exit the program
  3. The program starts in paused state by default, click "Resume" to start
  4. The program automatically pauses when manual mouse movement is detected

Status Icon Guide

  • ... (●): Program is running
  • (○): Program is paused

Contributing

Issues and Pull Requests are welcome!

# Packages

No description provided by the author