A real-time remote control web application built with Flask and Socket.IO that enables seamless control of Windows machines through your web browser. Perfect for remote administration, support, and management across your local network.
- High-performance desktop streaming with configurable quality, resolution, and FPS
- Powered by DXCam for the best screen capture performance on Windows
- Server → Client: Stream system audio or microphone input
- Client → Server: Transmit microphone audio with real-time processing
- Configurable audio sample rate settings
- Full mouse control (move, click, scroll) with a synchronized cursor overlay for accurate visual feedback.
- Full keyboard input support (send text, shortcuts, and custom key combinations).
- Browse files and folders.
- Upload files (with drag-and-drop support).
- Download files.
- Delete files and folders.
- Create new folders.
- Rename files and folders.
- View a list of running processes.
- Expand/collapse process groups.
- Sort processes by name, PID, CPU usage, and memory usage.
- Terminate processes remotely.
- Displays total CPU usage and memory usage.
- Interactive Shell: Real-time command execution with live output
- System Information: Display detailed system information of the remote machine (CPU, memory, disk, network, etc.).
- Security: Role-based authentication with session management
- Responsive Design: Tailwind CSS-powered interface that works on any device
Click to expand/collapse the project structure
Remote-Control/
├── config/
│ ├── auth_config.py # Authentication configuration
│ └── server_config.py # Server configuration
├── core/
│ ├── audio_manager.py # AudioManager class
│ ├── input_manager.py # InputManager class
│ ├── keyboard_controller.py # Windows-specific keyboard control
│ ├── mouse_controller.py # Windows-specific mouse control
│ ├── shell_manager.py # ShellManager class
│ ├── stream_manager.py # StreamManager class
│ ├── system_manager.py # SystemManager class
│ └── task_manager.py # TaskManager class
├── events/
│ ├── __init__.py
│ ├── audio_events.py # Audio-related socket events
│ ├── auth_events.py # Auth socket events
│ ├── connection_events.py # Socket connection events
│ ├── input_events.py # Mouse/keyboard socket events
│ ├── shell_events.py # Shell socket events
│ └── task_events.py # Task manager events
├── routes/
│ ├── auth_routes.py # Login/logout routes
│ ├── file_routes.py # File management routes
│ ├── input_routes.py # Keyboard/mouse input routes
│ ├── shell_routes.py # Shell routes
│ ├── stream_routes.py # Streaming related routes
│ ├── system_routes.py # System info
│ └── task_routes.py # Task manager routes
├── static/
│ ├── css/
│ │ ├── styles.css
│ │ └── tailwind.css
│ └── js/
│ ├── modules/
│ │ ├── audio.js # AudioManager class
│ │ ├── audio-worklet-processor.js
│ │ ├── connection.js # Socket.IO connection management
│ │ ├── dom.js # DOM manipulation utilities
│ │ ├── file.js # File management functions
│ │ ├── input.js # Keyboard and mouse input handling
│ │ ├── nav.js # Navigation function
│ │ ├── shell.js # InteractiveShell class
│ │ ├── stream.js # Stream setup, control, and UI updates
│ │ ├── system.js # System information display
│ │ ├── task.js # Task manager functions
│ │ └── utils.js # General utility functions (like apiCall)
│ └── main.js # Main initialization and event handling
├── templates/
│ ├── index.html
│ └── login.html
├── app.py # Main application setup
├── extensions.py # SocketIO initialization
└── server.py # Main entry point
# Clone the repository
git clone https://github.com/marginal23326/Remote-Control.git
cd Remote-Control
# Install dependencies
pip install -r requirements.txtWhen you run the application for the first time, you will be prompted in the console to set up a username and password. These credentials will be used for authentication.
python server.py <port>(Replace <port> with your desired port number, e.g., 5000)
Open your browser and navigate to:
http://<server-ip>:<port>
Example:
http://192.168.1.100:5000
-
Install PyInstaller:
pip install pyinstaller
-
Run the build script:
build_exe.bat
The compiled executable will be available in the dist directory.
- Security: This application is designed for trusted networks. Be very cautious about exposing it directly to the Internet; only use it on your trusted local network.
- Windows 10/11 Only: Server-side functionality requires Windows due to system-specific dependencies.
- Permissions: Administrator privilege is required to access certain restricted folders in the file browser; everything else doesn't require it.
This project is licensed under the MIT License—see the LICENSE file for details.