Umi-OCR Linux 实战指南:3 步搭好离线 OCR 工作流,批量效率直接拉满
【免费下载链接】Umi-OCROCR software, free and offline. 开源、免费的离线OCR软件。支持截屏/批量导入图片,PDF文档识别,排除水印/页眉页脚,扫描/生成二维码。内置多国语言库。项目地址: https://gitcode.com/GitHub_Trending/um/Umi-OCR
Umi-OCR 是一款在 Linux 上解压即用的离线文字识别工具:不联网、能批量、内置多国语言界面。这篇写给刚装完系统想立刻上手的人,5 分钟带你从解压压缩包走到桌面快捷方式、截图速识、批量处理、自动化脚本,外加一份踩坑急救包。
从零到能跑:安装与桌面化
📦 你刚把发行包解压完,但每次都要打开终端敲命令,太烦了。三步搞定:
- 把压缩包解压到一个无中文、无空格的路径,比如
/opt/umi-ocr,目录里有umi-ocr.sh启动脚本和UmiOCR-data数据目录。 - 给启动脚本加执行权限,然后终端里跑一次,确认主窗口能弹出来:
cd /opt/umi-ocr && chmod +x umi-ocr.sh && ./umi-ocr.sh- 创建桌面快捷方式。写入
~/.local/share/applications/umi-ocr.desktop(Icon换成你喜欢的任意 .png 路径,没有就留空):
[Desktop Entry] Type=Application Name=Umi-OCR Comment=离线文字识别工具 Exec=/opt/umi-ocr/umi-ocr.sh Icon= Terminal=false Categories=Utility;Graphics;执行chmod 644 ~/.local/share/applications/umi-ocr.desktop && update-desktop-database ~/.local/share/applications,应用菜单里就能点图标直接启动了。
三条核心工作流:截图速识、批量文档、多语言切换
截图速识:你刚截了一张带文字的图,想立刻把字拿走。打开"截图OCR"标签页 → 按你设好的快捷键(默认Ctrl+Alt+O一类,可在全局设置里改)划选屏幕区域 → 右侧识别记录栏出现文字 → 直接框选复制,或把光标点进记录里编辑后全选复制。文字乱序时,在"文本后处理"里选一个排版解析方案(比如"多栏-按自然段换行"),输出立刻整齐。
批量文档:你有一整文件夹扫描件要转文本。打开"批量OCR"页 → 拖入图片(支持 jpg/png/bmp/tif/webp 等)→ 左侧选输出格式:txt、md、csv(Excel)、jsonl四选一 → 点开始。图片带固定水印?进右栏的"忽略区域"编辑器,按住右键画几个矩形把水印框掉,这些区域的文字就不会出现在结果里。遇到超大长图识别不动,去"页面的设置→文字识别→限制图像边长"把数值调高。
多语言切换:你的系统语言是日文但想看英文界面。首次启动时 Umi-OCR 已按系统语言自动选好界面;要改随时改——"全局设置"→"语言/Language"→ 选中文(简/繁)、English、日本語等 → 重启软件生效。翻译文件都在UmiOCR-data/i18n目录里,dev-tools/i18n/ 下还附了完整的翻译工作流文档。
效率倍增器:按"回本速度"排好序的三招 ⚡
1. 文件管理器右键集成(回本最快)。适合天天拖图片的人:在 nautilus 的文件管理器里,新建脚本~/.local/share/nautilus/scripts/umi-ocr并chmod +x,内容如下。之后在任意图片上右键→Scripts 里就有入口,路径会自动传进来:
#!/bin/sh for f in "$@"; do umi-ocr --path "$f" done2. CLI 别名(日常最顺手)。适合终端重度用户,往~/.bashrc加三行别名,source一下即可。注意命令行依赖本地 HTTP 服务(默认开启),命令行手册 里还有--screenshot、--qrcode_read等全部指令:
alias ocr="umi-ocr --show" alias ocr-shot="umi-ocr --screenshot" alias ocr-file="umi-ocr --path"3. 自动化脚本(长期复利)。适合每月固定要处理一批扫描件的团队:--path直接传整个文件夹,--output指定结果文件,一行命令跑完全目录,可以丢进 cron:
#!/bin/sh umi-ocr --path "$HOME/scans" --output "$HOME/scans/result.txt"踩坑急救包:症状 → 诊断 → 处理 🔧
点图标没反应症状:双击快捷方式无窗口,终端报Permission denied。 诊断:脚本没有执行位,或系统 glibc 版本过旧(ldd --version看一眼)。 处理:chmod +x umi-ocr.sh;glibc 太旧就换更新的发行版或升级系统。
截屏闪烁 / UI 错位症状:划选截图时屏幕闪一下,或控件位置错乱。 诊断:显卡硬件加速渲染不兼容。 处理:全局设置→"界面和外观"→"渲染器",换个渲染方案或关掉硬件加速。
批量任务又慢又吃内存症状:几百张大图塞进去,进度条挪得比蜗牛慢。 处理:分批导入,同时调高"限制图像边长",关掉暂时不用的标签页。
换机丢配置你的所有设置都存在UmiOCR-data/.settings(ini 文件),搬机器时把这个目录整个拷走,识别参数和习惯设置原样恢复;手动改完配置后可用umi-ocr --reload热加载。
收尾:3 条值得记住的习惯
- 定期备份
UmiOCR-data目录,配置和习惯设置全在里面。 - 长图、带水印的图,先调"限制图像边长"和"忽略区域"再开跑。
- 养成看更新日志的习惯,项目迭代很快,关注最新 release 就能拿到新引擎与新功能。
【免费下载链接】Umi-OCROCR software, free and offline. 开源、免费的离线OCR软件。支持截屏/批量导入图片,PDF文档识别,排除水印/页眉页脚,扫描/生成二维码。内置多国语言库。项目地址: https://gitcode.com/GitHub_Trending/um/Umi-OCR
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考