# lazyeat

**Repository Path**: dttx123/lazyeat

## Basic Information

- **Project Name**: lazyeat
- **Description**: Lazyeat 吃饭时看剧/刷网页不想沾油手？  对着摄像头比划手势就能暂停视频/全屏/切换视频！Lazyeat is a touch-free controller for use while eating! Don't want greasy hands while watching shows or browsing the web during meals? You can pause videos/full screen/switch videos just by gesturing to the camera!
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 12
- **Created**: 2025-08-18
- **Last Updated**: 2025-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Lazyeat

![GitHub stars](https://img.shields.io/github/stars/maplelost/lazyeat)
![GitHub forks](https://img.shields.io/github/forks/maplelost/lazyeat?style=flat)
![Github Downloads](https://img.shields.io/github/downloads/lanxiuyun/lazyeat/total)

<div>
<a href="https://hellogithub.com/repository/286c84fcdd9945569ce9b9cbde402adc" target="_blank">
<img src="https://abroad.hellogithub.com/v1/widgets/recommend.svg?rid=286c84fcdd9945569ce9b9cbde402adc&claim_uid=EHFzTtsO05vQrh3" alt="Featured｜HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" /></a>
  <a href="http://upgrade.toolsetlink.com/upgrade/example/tauri-example.html" target="_blank">
    <img src="https://s2.loli.net/2025/06/11/r2dqNIWVXp4RaFe.png" height="54" />
  </a>
</div>

<h3>简体中文 | <a href="README_EN.md">English</a></h3>

Lazyeat 吃饭时看剧/刷网页不想沾油手？

对着摄像头比划手势就能暂停视频/全屏/切换视频！

如果你觉得对你有用的话，不妨给我一个 star⭐ 吧~

我们非常需要各位去推广这个软件来获取更高的关注度 🚀

如果有任何的想法或者建议，都可以在 QQ 群 [452246065](https://jq.qq.com/?_wv=1027&k=452246065) 中讨论喔！

|     平台     | 支持状态  |                              下载地址                              |
|:----------:|:-----:|:--------------------------------------------------------------:|
| 🪟 Windows | ✅ 支持  | [下载最新版本](https://github.com/maplelost/lazyeat/releases/latest) |
|   🍎 Mac   | ✅ 支持  | [下载最新版本](https://github.com/maplelost/lazyeat/releases/latest) |
|  🐧 Linux  | ⏳ 开发中 |                               /                                |
| 🤖 Android | ⏳ 开发中 |                               /                                |
|   📱 iOS   | ⏳ 开发中 |                               /                                |

## 功能

- 单指滑动控制光标
- 双指/Rock 执行鼠标单击
- ok 手势控制页面滚动
- 四指并拢发送按键
- 支持语音输入

![demo.gif](.readme/demo.gif)

# 🌠 截图

视频演示:https://www.bilibili.com/video/BV11SXTYTEJi/?spm_id_from=333.1387.homepage.video_card.click

<div align="center">
<img src=.readme/img.png width="800" height="600" />
</div>

# 快速开始

```
# 版本号声明，以下为我的开发环境
\Desktop\lazyeat> python --version
Python 3.11.11
(2025年4月19日 python 3.12.7 以及以上版本 pyinstaller 打包会失败)

Desktop\lazyeat> rustc --version
rustc 1.85.1 (4eb161250 2025-03-15)

\Desktop\lazyeat> node --version
v22.14.0
```

### 安装 rust 和 node

[rust](https://www.rust-lang.org/zh-CN/tools/install) 和 [node](https://nodejs.org/zh-cn/)

### 项目根目录打开项目(vscode,pycharm 等)

项目根目录（也就是 lazyeat 的根目录）
（如：C:\Users\你的用户名\Desktop\lazyeat，也可以直接打开文件夹后在地址栏输入 cmd）

### 安装 npm 以及 python 环境

```bash
npm run install-reqs
```

这一步遇到问题可以尝试使用管理员方式运行 cmd 再运行该命令

### build tauri 图标

```bash
npm run build:icons
```

### pyinstaller 打包

```bash
npm run build:py
# 打包 mac 版本
# npm run build:py-mac
# 打包 linux 版本
# npm run build:py-linux
```

### 下载语音识别模型并解压到 model 文件夹下

```bash
https://alphacephei.com/vosk/models/vosk-model-small-cn-0.22.zip
```

![img.png](.readme/img_model_example_inside.png)

### 运行 tauri dev 开发环境

```bash
npm run tauri dev
```

### 额外说明

#### 打包成生产环境（不发布就不需要）

```bash
npm run tauri build
```

打包后在 **lazyeat\src-tauri\target\release**目录下找到 exe 文件运行即可。

#### python 后端 debug

如果你需要 debug python 后端，那么先 pyinstaller 打包，再运行 `python src-py/main.py`。

因为 `npm run tauri dev` 需要生成 [tauri.conf.json](src-tauri/tauri.conf.json) 中编写的 sidecar。
详见：https://v2.tauri.app/zh-cn/develop/sidecar/

# 📢 语音识别模型替换

[小模型](https://alphacephei.com/vosk/models/vosk-model-small-cn-0.22.zip) [大模型](https://alphacephei.com/vosk/models/vosk-model-cn-0.22.zip)

前面的步骤下载的是小模型，如果需要使用大模型，下载后解压到 `model/` 替换

![img.png](.readme/img_model_example.png)

# 📝 TODO

- [ ] (2025 年 3 月 12 日) 嵌入 browser-use ，语音控制浏览器
- [ ] (2025 年 3 月 24 日) 开发安卓版本

[//]: # "# 📚 References"

# 开发问题

tauri build 失败:[tauri build 失败](https://github.com/tauri-apps/tauri/issues/7338)

tauri build 失败了，检查 src-tauri/bin 的大小，是否超过了 200M。如果超过了 200M，那么就需要检查 python 环境是否正确。

cargo 被墙:[cargo 被墙,换源](https://www.chenreal.com/post/599)

[非代码异常问题总结](https://github.com/maplelost/lazyeat/issues/30)

```
# 不知道有没有用
rm -rf ~/.cargo/.package-cache
```