
MTools
一个桌面工具箱,搞定音视频、图片、文本和 AI 识别
MTools 是一款基于 Python 的桌面多功能工具箱,把音视频处理、图片编辑、文本操作和编码工具整合到一个应用里,并内置 AI 增强能力。它想解决的核心问题是:日常办公和内容创作中,处理音频、视频、图片、文本往往要在多个软件之间来回切换,操作繁琐、学习成本高。MTools 把这些高频小工具收拢到统一界面,比如语音转文字(集成 FunASR、Whisper)、OCR 文字识别(PPOCR)、音频提取、格式转换、图片压缩裁剪、文本批量处理、编码解码等,让用户在一个程序里完成大部分轻量任务。AI 增强让语音识别、图像文字提取等环节更省事,适合不想折腾命令行、又需要快速处理素材的用户。项目用 Python 编写,跨平台桌面运行,星标数处于成长阶段,功能覆盖面广但仍在持续迭代。
项目数据
使用教程
环境要求
- Windows 10/11 (x64)、macOS 或 Linux 桌面环境
- 从源码运行需已安装 uv(README 使用 uv run / uv add 命令)
- 使用 CUDA 版本需预先安装 CUDA 12.x + cuDNN 9.x
- NVIDIA GPU 建议为 30 系及以上、显存 8GB 以上
安装与启动步骤
-
1下载预编译版
README 推荐方式,无需安装 Python。到 Releases 或国内下载站取对应平台的可执行文件。
-
2获取项目源码
README 未列出克隆命令,仓库地址取自项目主页;克隆后进入 MTools 目录再继续。
git clone https://github.com/HG-ha/MTools.git -
3安装依赖
README 中『一键安装依赖』代码块内容未完整展示,请按仓库文档执行,不要自行猜测包名。
-
4运行程序
在项目根目录执行,这是 README 明确给出的启动命令,需已装好 uv 环境。
uv run flet run -
5启用 CUDA 加速
需要完全释放 NVIDIA GPU 性能时追加该依赖;README 提示可按需换成免配 CUDA/cuDNN 的依赖。
uv add onnxruntime-gpu[cuda,cudnn]==1.24.4 -
6编译独立程序
想把项目编译成独立可执行文件,按 README 指引查看完整编译指南文档。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
AI 服务 Base URL | 否 | 接入 OpenAI 兼容大模型,用于字幕修复、AI 翻译等功能 | https://api.atlascloud.ai/v1 |
onnxruntime 后端 | 否 | AI 功能依赖,按平台选:Windows 用 directml,macOS/Linux 用默认版 | onnxruntime-directml==1.24.4 |
如何确认成功
执行 uv run flet run 后成功弹出 MTools 主界面(含浅色/深色主题),即启动成功。
常见问题
Q:不会 Python 能用吗?
A:可以。用方式一下载 Releases 里的预编译版本,无需安装 Python,直接双击可执行文件即可运行。
Q:Windows 该选哪个版本?
A:显存低于 8GB 或显卡早于 NVIDIA 30 系,尽量选体积最小的 MTools_Windows_amd64;需要 CUDA 加速再选 CUDA 系列。
Q:CUDA 版本启动报环境错误怎么办?
A:CUDA 版需预先装好 CUDA 12.x + cuDNN 9.x;不想配置环境可改用内置完整运行时库的 CUDA_FULL 版本。
Q:如何把项目编译成 exe?
A:README 指向完整编译指南文档,按其中的说明操作即可,不要直接照搬运行命令去打包。
注意事项
- README 中『一键安装依赖』的代码块未完整展示,具体依赖安装命令请以仓库 docs 目录下的文档为准。
- DirectML 版本不支持限制显存,只有 CUDA 版本可以限制显存大小。
- CUDA_FULL 版本内置 CUDA 与 cuDNN 运行时,开箱即用但体积增加约 2GB。
核心亮点
- 功能集成度高,音视频、图片、文本、编码工具集中在一个桌面应用,减少多软件切换
- 内置 AI 能力,集成 FunASR、Whisper 做语音转文字,PPOCR 做图片文字识别,开箱可用
- 基于 Python 开发,桌面端运行,对不熟悉命令行的用户相对友好,适合快速处理日常素材
不足之处
- 功能模块较多但成熟度参差,部分工具可能只是基础封装,深度处理能力有限
- 项目星标数仍处于成长阶段,文档完整度和社区生态有待观察
适用场景
- 把会议录音或视频快速转成文字稿
- 从截图或扫描图片中批量提取文字
- 日常办公中压缩图片、转换音视频格式、批量处理文本
替代项目
utools、DevToys
项目介绍
同类项目推荐
sunshine-control-panel
开源
一站式管理游戏库、监控内存,AI 助手加持,让大屏启动更高效。
Sunshine Foundation 大屏桌面管理器 | Tauri + Vue 3,游戏库管理、米塔AI助手、内存监控···
Stirling PDF
开源
本地部署 PDF 工具箱
#1 PDF Application on GitHub that lets you edit PDFs on any device anywhere
obsidian-md2wechat
开源
一键将 Obsidian 笔记排版成公众号文章,告别手动调格式
Obsidian → WeChat | Obsidian 插件一键排版发布到微信公众号,键排版发布到微信公众号:···
pdf2md
开源
浏览器里直接把 PDF 变成 Markdown,不用上传,隐私安全。
Browser based tool to convert PDFs to Markdown