Skip to content

Android client for controlling your PC's mouse and keyboard over Wi-Fi. Connect to the server using IP and port, control the mouse, send keyboard input, view installed apps, and launch them remotely.

Notifications You must be signed in to change notification settings

harimoradiya/WiFi-Mouse-Android-Client

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

7 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

WiFi Mouse Client

This client application works in conjunction with the WiFi Mouse Server:

  • Repository: WiFi Mouse Server
  • Description: Kotlin Multiplatform server application for Windows, macOS, and Linux
  • Features: Real-time device monitoring, server management, accessibility integration
  • Required: Must be installed and running on your computer to use this client Transform your Android device into a powerful wireless mouse and keyboard for your computer. Control your PC/Mac/Linux system remotely with intuitive touch gestures, keyboard input, and advanced features like app launching.

๐Ÿ“ฑ Screenshots

Mouse Screen Keyboard Screen Apps Screen
Mouse Screen Keyboard Screen Apps Screen

๐Ÿ“ฑ Features

Core Controls

  • Mouse Control: Precise cursor movement with touch gestures
  • Left/Right Click: Tap and long-press gestures
  • Scroll Support: Two-finger scrolling in all directions
  • Drag & Drop: Advanced gesture support for file operations

Keyboard Features

  • Full Keyboard: Complete QWERTY keyboard with special keys
  • Function Keys: F1-F12 and system keys support
  • Text Input: Direct text typing with predictive input

Advanced Features

  • App Launcher: View and launch installed applications on server
  • Connection Management: Easy connect/disconnect with server status
  • Real-time Feedback: Instant response and connection status updates
  • Multiple Gestures: Support for various touch patterns and gestures

๐Ÿ“‹ Requirements

  • Android Version: Android 5.0 (API level 21) or higher
  • Network: WiFi connection (same network as server)
  • Storage: 10MB free space
  • Permissions: Network access permissions

๐Ÿ“ฅ Installation

From Google Play Store

Coming Soon - Link will be updated once published (Currently i don't have a play console account :)

From Source

git clone https://github.com/yourusername/wifi-mouse-client.git
cd wifi-mouse-client
./gradlew assembleDebug

๐Ÿš€ Quick Start

1. Setup Server Connection

  1. Ensure your WiFi Mouse Server is running on your computer
  2. Note the IP address and port displayed on the server
  3. Open WiFi Mouse Client on your Android device

2. Connect to Server

  1. Tap "Connect" button
  2. Enter the server IP address (e.g., 192.168.1.100)
  3. Enter the port number (default: 8080)
  4. Tap "Connect" to establish connection

3. Start Controlling

  • Move Cursor: Slide your finger on the touchpad area
  • Left Click: Single tap
  • Right Click: Two-finger tap or long press
  • Scroll: Two-finger swipe up/down or left/right
  • Type: Use the keyboard button to open virtual keyboard

๐ŸŽฎ Controls Guide

Mouse Controls

Gesture Action
Single finger slide Move cursor
Single tap Left click
Two-finger tap Right click
Two-finger scroll Scroll vertically

๐Ÿ”ง Features Overview

Connection Management

  • Manual Connection: Enter IP and port manually
  • Connection Status: Real-time connection indicator
  • Auto-reconnect: Automatic reconnection on network interruption
  • Connection History: Remember previous server connections

Mouse & Touchpad

  • Sensitivity Settings: Adjustable cursor speed and acceleration
  • Gesture Customization: Configure touch gestures to your preference
  • Precision Mode: Slow cursor movement for precise operations
  • Multi-touch Support: Advanced gestures with multiple fingers

Virtual Keyboard

  • Full QWERTY Layout: Complete keyboard with numbers and symbols
  • Special Keys: Function keys, arrow keys, and system keys

App Launcher

  • Installed Apps List: View all applications installed on server computer
  • Search Function: Quick search through installed applications
  • Launch Apps: Remote launch applications with single tap

โš™๏ธ Settings & Configuration

Control Settings

  • Mouse Sensitivity: Adjust cursor movement speed
  • Scroll Speed: Configure scrolling sensitivity

Display Settings

  • Theme: Light/Dark mode selection
  • Screen Orientation: Portrait/Landscape lock
  • Button Layout: Customize control button positions
  • Fullscreen Mode: Hide status bar for maximum screen space

๐Ÿ› ๏ธ Troubleshooting

Connection Issues

Cannot Connect to Server

  1. Check Network: Ensure both devices are on same WiFi network
  2. Verify Server: Confirm server application is running
  3. IP Address: Double-check the server IP address
  4. Firewall: Ensure firewall isn't blocking the connection
  5. Port: Verify the port number is correct

Frequent Disconnections

  1. WiFi Stability: Check WiFi signal strength
  2. Power Saving: Disable battery optimization for the app
  3. Network Settings: Reset network settings if necessary
  4. Router Issues: Restart your WiFi router

Control Issues

Performance Issues

Lag or Delay

  1. Network Speed: Check WiFi connection speed
  2. Background Apps: Close unnecessary apps on Android
  3. Server Performance: Ensure server computer isn't overloaded
  4. Distance: Stay within reasonable range of WiFi router

๐Ÿ“Š Technical Specifications

  • Minimum Android Version: 5.0 (API 21)
  • Target Android Version: 14 (API 34)
  • Network Protocol: TCP/IP over WiFi
  • Data Encryption: Local network communication

๐Ÿ”’ Privacy & Security

  • Local Network Only: All communication stays on your local network
  • No Internet Required: Works completely offline
  • No Data Collection: No personal data is collected or transmitted
  • Open Source: Full source code available for review
  • Secure Protocol: Encrypted communication between client and server

๐Ÿค Contributing

We welcome contributions to improve WiFi Mouse Client!

How to Contribute

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/new-feature)
  3. Make your changes
  4. Test thoroughly on different Android versions
  5. Commit your changes (git commit -m 'Add new feature')
  6. Push to the branch (git push origin feature/new-feature)
  7. Create a Pull Request

Development Setup

# Clone the repository
git clone https://github.com/harimoradiya/WiFi-Mouse-Android-Client.git

# Open in Android Studio
# Build and run on device or emulator
./gradlew installDebug

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ› Bug Reports & Feature Requests

Found a bug or have a feature request? Please use GitHub Issues.

Bug Report Template

  • Device Model: (e.g., Samsung Galaxy S21)
  • Android Version: (e.g., Android 12)
  • App Version: (e.g., v1.2.3)
  • Server OS: (e.g., Windows 11)
  • Steps to Reproduce: Detailed steps
  • Expected Behavior: What should happen
  • Actual Behavior: What actually happens
  • Screenshots: If applicable

๐Ÿ“ž Support

  • FAQ: Common questions and answers
  • Issues: Report problems on GitHub Issues
  • Discussions: Join community discussions

๐ŸŽฏ Roadmap

Upcoming Features

  • Gesture recording and playback
  • Custom button layouts
  • Voice commands integration
  • File transfer capabilities

๐Ÿ† Acknowledgments

  • Thanks to all contributors and beta testers
  • Inspired by existing remote control solutions
  • Built with modern Android development practices

Download WiFi Mouse Client today and turn your Android device into the ultimate computer controller!

About

Android client for controlling your PC's mouse and keyboard over Wi-Fi. Connect to the server using IP and port, control the mouse, send keyboard input, view installed apps, and launch them remotely.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages