# mouse

**Repository Path**: X666TV/mouse

## Basic Information

- **Project Name**: mouse
- **Description**: 用python 实现的mouse without borders
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-08
- **Last Updated**: 2026-03-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PyMouseWithoutBorders

A Python implementation of Microsoft Garage Mouse without Borders functionality. This software allows you to control multiple computers from a single mouse and keyboard, and share clipboard data securely.

## Features

- **Mouse & Keyboard Sharing**: Control a remote computer using your local mouse and keyboard.
- **Clipboard Sharing**: Automatically syncs text clipboard between connected machines.
- **Secure Connection**: All communication is encrypted using a shared security key (AES encryption).
- **Cross-Platform Core**: Built with Python, though currently optimized for Windows.

## Installation

1.  Ensure you have Python 3.13+ installed.
2.  Install dependencies:
    ```bash
    pip install pynput cryptography pyperclip pystray Pillow netifaces
    ```
    (Note: `netifaces` is optional but recommended for future IP discovery features).

## Usage

1.  Run the application on both computers:
    ```bash
    python main.py
    ```

2.  **Configuration**:
    -   Enter the same **Security Key** on both machines.
    -   Choose a **Port** (default 5000).

3.  **Connection**:
    -   **Machine A (Server)**: Select "Server (Listen)" and click "Start / Connect".
    -   **Machine B (Client)**: Select "Client (Connect)", enter Machine A's IP address, and click "Start / Connect".

4.  **Control**:
    -   Once connected, press **F8** to toggle control mode.
    -   **LOCAL Mode**: You control your own computer.
    -   **REMOTE Mode**: Your mouse and keyboard input is sent to the remote computer. Your local mouse inputs are suppressed to prevent accidental clicks.

5.  **Clipboard**:
    -   Copy text on one machine, and it will be available to paste on the other machine automatically.

## Project Structure

-   `src/core/`: Core logic for input capture, replay, and event handling.
-   `src/network/`: Networking code (TCP server/client).
-   `src/ui/`: GUI implementation using Tkinter.
-   `src/utils/`: Utility functions (Security/Encryption).