screen-keyboard 1.0.1__tar.gz

screen_keyboard-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

screen_keyboard-1.0.1/MANIFEST.in

@@ -0,0 +1,7 @@
+include README.md
+include LICENSE
+include requirements.txt
+recursive-include src *.html
+recursive-include src *.py
+recursive-include src *.md
+recursive-include src *.txt

screen_keyboard-1.0.1/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: screen-keyboard
+Version: 1.0.1
+Summary: 手机键盘控制电脑 - 通过手机浏览器控制电脑输入
+Author-email: Your Name <your-email@example.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/your-username/screen-keyboard
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: flask>=2.3.0
+Requires-Dist: flask-socketio>=5.3.0
+Requires-Dist: pynput>=1.7.6
+Requires-Dist: python-socketio>=5.10.0
+Requires-Dist: python-engineio>=4.8.0
+Requires-Dist: simple-websocket>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Dynamic: license-file
+
+# 手机键盘控制电脑
+
+通过手机浏览器访问网页，使用虚拟键盘控制电脑输入。
+
+**原理**：网页发送键盘按键到电脑，由电脑上的输入法（如搜狗、微软拼音）处理拼音转换。
+
+## 快速安装
+
+### 方法一：pip 安装（推荐）
+
+```bash
+# 安装
+pip install screen-keyboard
+
+# 运行
+screen-keyboard
+```
+
+### 方法二：源码安装
+
+```bash
+# 克隆或直接下载后
+pip install -e .
+
+# 运行
+screen-keyboard
+# 或
+python app.py
+```
+
+### 方法三：一行命令安装
+
+```bash
+curl -sL https://raw.githubusercontent.com/your-username/screen-keyboard/main/install-one-line.sh | bash
+```
+
+## 使用方法
+
+### 1. 启动服务
+
+```bash
+screen-keyboard
+# 或
+python app.py
+```
+
+### 2. 手机访问
+
+服务端启动后会显示局域网地址，例如：
+```
+局域网地址：http://192.168.1.100:5000
+```
+
+在手机上连接同一 WiFi，用浏览器访问该地址即可。
+
+## 功能
+
+- ✅ 全键盘布局（QWERTY）
+- ✅ 符号/数字键盘切换
+- ✅ Shift 大写切换
+- ✅ 特殊按键（回车、退格、空格）
+- ✅ 方向键（倒 T 布局）
+- ✅ 触控板鼠标控制
+- ✅ 摇杆鼠标控制
+- ✅ 鼠标左右中键 + 滚轮
+- ✅ Win+Space 中英文切换
+- ✅ 拖动窗口/文件（双击触控板后拖动）
+
+## 说明
+
+- 确保手机和电脑在同一局域网
+- 电脑需开启拼音输入法
+- 如果防火墙阻止，请开放 5000 端口
+
+## 开发
+
+```bash
+# 创建 conda 环境
+conda env create -f environment.yml
+conda activate screen-keyboard
+
+# 安装依赖
+pip install -r requirements.txt
+
+# 运行
+python app.py
+```
+
+## License
+
+MIT License
+

screen_keyboard-1.0.1/README.md

@@ -0,0 +1,92 @@
+# 手机键盘控制电脑
+
+通过手机浏览器访问网页，使用虚拟键盘控制电脑输入。
+
+**原理**：网页发送键盘按键到电脑，由电脑上的输入法（如搜狗、微软拼音）处理拼音转换。
+
+## 快速安装
+
+### 方法一：pip 安装（推荐）
+
+```bash
+# 安装
+pip install screen-keyboard
+
+# 运行
+screen-keyboard
+```
+
+### 方法二：源码安装
+
+```bash
+# 克隆或直接下载后
+pip install -e .
+
+# 运行
+screen-keyboard
+# 或
+python app.py
+```
+
+### 方法三：一行命令安装
+
+```bash
+curl -sL https://raw.githubusercontent.com/your-username/screen-keyboard/main/install-one-line.sh | bash
+```
+
+## 使用方法
+
+### 1. 启动服务
+
+```bash
+screen-keyboard
+# 或
+python app.py
+```
+
+### 2. 手机访问
+
+服务端启动后会显示局域网地址，例如：
+```
+局域网地址：http://192.168.1.100:5000
+```
+
+在手机上连接同一 WiFi，用浏览器访问该地址即可。
+
+## 功能
+
+- ✅ 全键盘布局（QWERTY）
+- ✅ 符号/数字键盘切换
+- ✅ Shift 大写切换
+- ✅ 特殊按键（回车、退格、空格）
+- ✅ 方向键（倒 T 布局）
+- ✅ 触控板鼠标控制
+- ✅ 摇杆鼠标控制
+- ✅ 鼠标左右中键 + 滚轮
+- ✅ Win+Space 中英文切换
+- ✅ 拖动窗口/文件（双击触控板后拖动）
+
+## 说明
+
+- 确保手机和电脑在同一局域网
+- 电脑需开启拼音输入法
+- 如果防火墙阻止，请开放 5000 端口
+
+## 开发
+
+```bash
+# 创建 conda 环境
+conda env create -f environment.yml
+conda activate screen-keyboard
+
+# 安装依赖
+pip install -r requirements.txt
+
+# 运行
+python app.py
+```
+
+## License
+
+MIT License
+

screen_keyboard-1.0.1/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "screen-keyboard"
+version = "1.0.1"
+description = "手机键盘控制电脑 - 通过手机浏览器控制电脑输入"
+readme = "README.md"
+license = "MIT"
+authors = [{name = "Your Name", email = "your-email@example.com"}]
+requires-python = ">=3.8"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "flask>=2.3.0",
+    "flask-socketio>=5.3.0",
+    "pynput>=1.7.6",
+    "python-socketio>=5.10.0",
+    "python-engineio>=4.8.0",
+    "simple-websocket>=1.0.0",
+]
+
+[project.optional-dependencies]
+dev = ["pytest", "black", "flake8"]
+
+[project.scripts]
+screen-keyboard = "screen_keyboard.app:main"
+
+[project.urls]
+Homepage = "https://github.com/your-username/screen-keyboard"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["*"]
+
+[tool.setuptools.package-data]
+"*" = ["*.html", "*.md", "*.txt"]

screen_keyboard-1.0.1/requirements.txt

@@ -0,0 +1,6 @@
+flask>=2.3.0
+flask-socketio>=5.3.0
+pynput>=1.7.6
+python-socketio>=5.10.0
+python-engineio>=4.8.0
+evdev>=1.6.0

screen_keyboard-1.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

screen_keyboard-1.0.1/src/screen_keyboard/app.py

@@ -0,0 +1,246 @@
+#!/usr/bin/env python3
+"""
+手机键盘控制电脑 - 服务端
+使用 Flask + Socket.IO 实现 WebSocket 通信
+使用 pynput 模拟键盘输入
+"""
+
+import os
+import socket
+from flask import Flask, send_from_directory, request
+from flask_socketio import SocketIO
+from pynput.keyboard import Controller, Key, KeyCode
+from pynput.mouse import Controller as MouseController, Button
+
+# 获取包所在目录
+PACKAGE_DIR = os.path.dirname(os.path.abspath(__file__))
+
+app = Flask(__name__, static_folder=PACKAGE_DIR)
+app.config['SECRET_KEY'] = 'secret!'
+socketio = SocketIO(app, cors_allowed_origins="*", async_mode='threading', transports=['polling', 'websocket'])
+
+keyboard = Controller()
+mouse = MouseController()
+
+
+def get_local_ip():
+    """获取本机局域网 IP 地址"""
+    s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+    try:
+        s.connect(('10.255.255.255', 1))
+        ip = s.getsockname()[0]
+    except:
+        ip = '127.0.0.1'
+    finally:
+        s.close()
+    return ip
+
+
+@app.route('/')
+def index():
+    return send_from_directory(PACKAGE_DIR, 'index.html')
+
+
+@socketio.on('connect')
+def handle_connect():
+    print(f'客户端连接：{request.sid}')
+
+
+@socketio.on('disconnect')
+def handle_disconnect():
+    print(f'客户端断开：{request.sid}')
+
+
+@socketio.on('key')
+def handle_key(data):
+    """处理键盘按键事件"""
+    key = data.get('key', '')
+    key_type = data.get('type', 'char')
+
+    if key_type == 'special':
+        if not handle_special_key(key):
+            print(f'Unknown special key: {key}')
+    else:
+        keyboard.type(key)
+
+
+@socketio.on('key_combo')
+def handle_key_combo(data):
+    """处理组合键 (如 Ctrl+Tab、Ctrl+C、Win+Space、Ctrl+Shift+C)"""
+    key = data.get('key', '')
+    ctrl = data.get('ctrl', False)
+    ctrl_right = data.get('ctrl_right', False)
+    alt = data.get('alt', False)
+    alt_right = data.get('alt_right', False)
+    win = data.get('win', False)
+    shift = data.get('shift', False)
+    shift_right = data.get('shift_right', False)
+
+    # 构建修饰键列表
+    modifiers = []
+    if ctrl:
+        modifiers.append(Key.ctrl)
+    if ctrl_right:
+        modifiers.append(Key.ctrl_r)
+    if alt:
+        modifiers.append(Key.alt)
+    if alt_right:
+        modifiers.append(Key.alt_r)
+    if win:
+        modifiers.append(Key.cmd)
+    if shift:
+        modifiers.append(Key.shift)
+    if shift_right:
+        modifiers.append(Key.shift_r)
+
+    # 按顺序按下修饰键
+    for mod in modifiers:
+        keyboard.press(mod)
+
+    # 按下目标键
+    if len(key) == 1:
+        keyboard.press(key.lower())
+        keyboard.release(key.lower())
+    else:
+        # 特殊键
+        handle_special_key(key)
+
+    # 释放修饰键
+    for mod in reversed(modifiers):
+        keyboard.release(mod)
+
+
+# ===== 鼠标控制 =====
+@socketio.on('mouse_move')
+def handle_mouse_move(data):
+    """处理鼠标移动"""
+    x = data.get('x', 0)
+    y = data.get('y', 0)
+    mouse.move(x, y)
+
+
+@socketio.on('mouse_click')
+def handle_mouse_click(data):
+    """处理鼠标点击"""
+    button = data.get('button', 'left')
+    if button == 'left':
+        mouse.click(Button.left)
+    elif button == 'right':
+        mouse.click(Button.right)
+    elif button == 'middle':
+        mouse.click(Button.middle)
+
+
+@socketio.on('mouse_press')
+def handle_mouse_press(data):
+    """处理鼠标按键按下/释放（用于拖动）"""
+    button = data.get('button', 'left')
+    pressed = data.get('pressed', True)
+    if button == 'left':
+        if pressed:
+            mouse.press(Button.left)
+        else:
+            mouse.release(Button.left)
+    elif button == 'right':
+        if pressed:
+            mouse.press(Button.right)
+        else:
+            mouse.release(Button.right)
+    elif button == 'middle':
+        if pressed:
+            mouse.press(Button.middle)
+        else:
+            mouse.release(Button.middle)
+
+
+@socketio.on('mouse_scroll')
+def handle_mouse_scroll(data):
+    """处理鼠标滚轮"""
+    direction = data.get('direction', 'up')
+    if direction == 'up':
+        mouse.scroll(0, 3)
+    else:
+        mouse.scroll(0, -3)
+
+
+def handle_special_key(key):
+    """处理特殊按键"""
+    key_map = {
+        # 基础控制键
+        'Enter': Key.enter,
+        'Backspace': Key.backspace,
+        'Space': Key.space,
+        'Tab': Key.tab,
+        'Escape': Key.esc,
+        'CapsLock': Key.caps_lock,
+
+        # 修饰键
+        'Ctrl': Key.ctrl,
+        'CtrlRight': Key.ctrl_r,
+        'Alt': Key.alt,
+        'AltRight': Key.alt_r,
+        'Shift': Key.shift,
+        'ShiftRight': Key.shift_r,
+        'Super': Key.cmd,
+        'SuperRight': Key.cmd_r,
+        'Menu': Key.menu,
+
+        # 方向键
+        'ArrowUp': Key.up,
+        'ArrowDown': Key.down,
+        'ArrowLeft': Key.left,
+        'ArrowRight': Key.right,
+
+        # 导航键
+        'Insert': Key.insert,
+        'Delete': Key.delete,
+        'Home': Key.home,
+        'End': Key.end,
+        'PageUp': Key.page_up,
+        'PageDown': Key.page_down,
+
+        # 功能键
+        'F1': Key.f1,
+        'F2': Key.f2,
+        'F3': Key.f3,
+        'F4': Key.f4,
+        'F5': Key.f5,
+        'F6': Key.f6,
+        'F7': Key.f7,
+        'F8': Key.f8,
+        'F9': Key.f9,
+        'F10': Key.f10,
+        'F11': Key.f11,
+        'F12': Key.f12,
+
+        # 其他
+        'PrintScreen': Key.print_screen,
+        'ScrollLock': Key.scroll_lock,
+        'Pause': Key.pause,
+    }
+
+    if key in key_map:
+        keyboard.press(key_map[key])
+        keyboard.release(key_map[key])
+        return True
+    return False
+
+
+def main():
+    """命令行入口"""
+    local_ip = get_local_ip()
+    port = 5000
+
+    print("=" * 50)
+    print("手机键盘控制电脑 - 服务端已启动")
+    print("=" * 50)
+    print(f"局域网地址：http://{local_ip}:{port}")
+    print(f"\n请在手机浏览器访问上述地址")
+    print("按 Ctrl+C 停止服务")
+    print("=" * 50)
+
+    socketio.run(app, host='0.0.0.0', port=port, debug=False, allow_unsafe_werkzeug=True)
+
+
+if __name__ == '__main__':
+    main()