# pywebcam

**Repository Path**: sembre/pywebcam

## Basic Information

- **Project Name**: pywebcam
- **Description**: 家用USB摄像头监控系统
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-13
- **Last Updated**: 2025-10-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 摄像头监控系统

该项目是一个基于 Python 的摄像头监控系统，包含摄像头控制、视频流传输、设备管理和用户界面功能。以下是项目的结构和主要组件：

---

## 项目简介

这是一个基于 Python 的摄像头监控系统，支持通过 MQTT 协议进行设备通信，并提供基于 Web 的用户界面用于设备管理和视频监控。系统支持多设备接入、摄像头控制、视频流传输以及用户身份验证功能。

---

## 主要组件

### `camera_publisher.py`
负责摄像头设备的控制与状态管理，主要功能包括：
- 连接和消息处理（MQTT）
- 摄像头启动与停止
- 摄像头参数设置（如增益、颜色校正）
- 视频流的生成与发送
- 设备状态和心跳信息的发送

### `web_subscriber.py`
提供 Web 服务和用户接口交互，主要功能包括：
- MQTT 消息订阅与处理
- 用户登录验证
- 获取设备列表
- 控制摄像头开关
- 视频流的生成与 Web 端展示

### `templates/index.html`
前端用户界面，包含：
- 登录页面
- 设备监控页面
- 视频流展示区域
- 控制面板与设置选项

### `requirements.txt`
项目依赖库列表，包含运行项目所需的 Python 包。

### `start_server.sh` / `start_server.bat`
启动脚本，用于在 Linux 或 Windows 系统上启动服务。

---

## 使用说明

### 安装依赖
```bash
pip install -r requirements.txt
```

### 启动服务
- **Linux/macOS**:
  ```bash
  ./start_server.sh
  ```
- **Windows**:
  ```cmd
  start_server.bat
  ```

### 访问 Web 界面
启动服务后，打开浏览器访问：
```
http://localhost:5000
```
输入密码登录后即可查看设备列表并控制摄像头。

---

## 功能特性

- **多设备支持**：可接入多个摄像头设备并进行统一管理。
- **实时视频流**：通过 Web 页面实时查看摄像头画面。
- **远程控制**：支持远程开启/关闭摄像头。
- **用户验证**：通过密码验证确保访问安全性。
- **设备状态监控**：实时显示设备连接状态和运行状态。

---

## 技术栈

- **Python**：核心语言
- **Flask**：Web 服务框架
- **MQTT**：设备通信协议
- **HTML/CSS/JavaScript**：前端界面开发

---

## 界面展示

![界面截图1](https://7sref.digiplc.cn/i/2025/10/13/68ec474a23150.png)

![界面截图2](https://7sref.digiplc.cn/i/2025/10/13/68ec4791ca5e9.png)

---

## 许可证

本项目采用 MIT 许可证，请在使用时遵循相关条款。