# MicroPython Video Stream

**Repository Path**: walkline/micropython-video-stream

## Basic Information

- **Project Name**: MicroPython Video Stream
- **Description**: MicroPython 开发板使用 OLED 实时显示电脑桌面图像
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2021-09-07
- **Last Updated**: 2022-05-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: MicroPython, oled

## README

<h1 align="center">MicroPython Video Stream</h1>

<p align="center"><img src="https://img.shields.io/badge/Licence-MIT-green.svg?style=for-the-badge" /></p>

### 项目介绍

`MicroPython`开发板使用`OLED`实时显示电脑桌面图像

### 如何使用

项目分为`服务器端`和`客户端`两部分

#### 运行服务器端程序

服务器端包括 2 个文件：

* `server.py`：服务器端主程序
* `capture.py`：捕捉桌面图像并转换数据

直接运行`server.py`即可

```bash
$ python server.py
```

#### 运行客户端程序

客户端包括 5 个文件：

* `client1.py`：用于接收和显示桌面图像
* `config.sample.py`：填写`WIFI`相关信息，需要修改文件名为`config.py`
* `wifihandler.py`：用于连接`WFIF`
* `drivers/ssd1306.py`：`oled`驱动程序
* `main.py`：客户端主程序

推荐使用 [AMPY Batch Tool](https://gitee.com/walkline/a-batch-tool) (`ab`工具) 进行文件上传和调试操作

```bash
# 上传文件
$ ab
```

上传文件之后复位开发板即可

#### 调试客户端程序

要查看开发板输出信息或调试代码可以使用`ab`工具进入`repl`模式

```bash
# 进入 repl 模式
$ ab --repl

# 删除 main.py 文件
# 使用快捷键 Ctrl-X

# 运行开发板上的文件
# 使用快捷键 Ctrl-T
>>>
Run onboard file
    [1] /boot.py
    [2] /client1.py
    [3] /config.py
    [4] /drivers/ssd1306.py
    [5] /wifihandler.py
    [6] /main.py
Choose a file: 6
>>>

# 在开发板上运行本地文件
# 使用快捷键 Ctrl-R
>>> Run local file
    [1] wifihandler.py
    [2] server.py
    [3] main.py
    [4] drivers\ssd1306.py
    [6] config.py
    [7] client1.py
    [8] capture.py
Choose a file: 3
>>>
```

### 效果展示

请自行前往 B 站观看 [全损低清无声丢帧版《买瓜》](https://www.bilibili.com/video/BV1Gf4y1P7aY/)，如果点开视频了，请务必一健三连，谢谢！

### 已知问题

* 如果电脑和开发板连接了路由器，结果发现数据传输速度很慢还卡顿，有可能是信号不好的缘故，可以使用电脑+无线网卡开热点的方式解决

* 图像二值化优化做的还是有问题，录制视频效果不好，实际观看效果也一般。。。

### 合作交流

* 联系邮箱：<walkline@163.com>
* QQ 交流群：
    * 走线物联：163271910
    * 扇贝物联：31324057

<p align="center"><img src="https://gitee.com/walkline/WeatherStation/raw/docs/images/qrcode_walkline.png" width="300px" alt="走线物联"><img src="https://gitee.com/walkline/WeatherStation/raw/docs/images/qrcode_bigiot.png" width="300px" alt="扇贝物联"></p>