Add an IP camera example

Author: yushulx

examples/official/ip_camera/.gitignore

@@ -0,0 +1,25 @@
+# Python cache files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Log files
+*.log
+
+# Test files
+test_*.py
+*_test.py
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS files
+Thumbs.db
+.DS_Store
+
+# Temporary files
+*.tmp
+*.temp

examples/official/ip_camera/README.md

@@ -0,0 +1,57 @@
+# USB Camera to IP Camera 
+
+A complete solution for transforming your USB camera into an IP camera with both web access and a professional desktop client! This system includes a Python server that streams video from any USB camera over your local network, plus a modern GUI client for viewing and managing camera streams.
+
+## 📋 Requirements
+
+- **Python**: 3.7 or higher
+- **Hardware**: USB camera connected to your PC
+
+## 🛠️ Installation
+
+1. **Clone or download** this repository
+2. **Install server dependencies**:
+   ```bash
+   pip install -r requirements.txt
+   ```
+3. **Install GUI client dependencies**:
+   ```bash
+   cd gui_client
+   pip install -r requirements.txt
+   ```
+
+## 🎯 Quick Start
+
+### 1. Start the IP Camera Server
+
+```bash
+python ip_camera_server.py
+```
+
+The server will:
+- Detect your USB camera automatically
+- Start streaming on port 5000
+- Display access URLs in console
+- Create a web interface at `http://localhost:5000`
+
+### 2. Access Your Camera
+
+#### Option A: Web Browser
+- **Local**: `http://localhost:5000`
+- **Network**: `http://YOUR_IP_ADDRESS:5000`
+
+#### Option B: GUI Client
+```bash
+cd gui_client
+python main.py
+```
+
+Then:
+1. Click "Connect to Camera" or press Ctrl+O
+2. Enter connection details:
+   - **IP Address**: `localhost` (or your PC's IP)
+   - **Port**: `5000`
+   - **Stream Path**: `/video_feed`
+3. Click "Connect" to start streaming
+
+

examples/official/ip_camera/camera_config.json

@@ -0,0 +1,33 @@
+{
+    "camera_index": 0,
+    "host": "0.0.0.0",
+    "port": 5000,
+    "resolution": [
+        1280,
+        720
+    ],
+    "fps": 30,
+    "auto_reconnect": true,
+    "log_level": "INFO",
+    "stream_settings": {
+        "enable_timestamp": true,
+        "timestamp_color": [
+            0,
+            255,
+            0
+        ],
+        "timestamp_font_scale": 0.7,
+        "timestamp_thickness": 2
+    },
+    "camera_settings": {
+        "brightness": null,
+        "contrast": null,
+        "saturation": null,
+        "exposure": null
+    },
+    "network": {
+        "max_connections": 10,
+        "buffer_size": 1024,
+        "timeout": 30
+    }
+}

examples/official/ip_camera/gui_client/config.json

@@ -0,0 +1,28 @@
+{
+  "video_settings": {
+    "fit_mode": 0,
+    "show_overlay": true,
+    "auto_reconnect": true,
+    "reconnect_delay": 3
+  },
+  "connection_settings": {
+    "timeout": 10,
+    "buffer_size": 1024,
+    "user_agent": "IP-Camera-GUI-Client/1.0",
+    "retry_attempts": 3
+  },
+  "interface_settings": {
+    "always_on_top": false,
+    "start_fullscreen": false,
+    "save_window_position": true,
+    "theme": "system",
+    "language": "en"
+  },
+  "recent_connections": [],
+  "application": {
+    "name": "IP Camera Viewer",
+    "version": "1.0.0",
+    "author": "IP Camera Tools",
+    "description": "Professional desktop application for viewing IP camera streams"
+  }
+}