MathpixCsharp: C#实现的Mathpix Windows开源客户端

21.3.28: 第三方Api支付服务已修复。

不填appid和appkey是没法用的

不填appid和appkey是没法用的

不填appid和appkey是没法用的

👆强调一下,因为最近没有看使用说明就来跟我说用不了的人太多了。要么注册官方的开发者api,要么使用第三方的api和key。

github地址 https://github.com/itewqq/MathpixCsharp

应该不会有外国用户所以就只写中文README了(雾)

demo1.gif

功能支持:

  • [x] 截图识别公式转换为Latex代码
  • [x] 截图识别公式转换为Office Word公式
  • [x] 多显示器支持
  • [x] 最小化到系统托盘
  • [x] 快捷键截图,Ctrl+Alt+M(与官方客户端相同)
  • [x] 官方API支持,每个月可免费用1000次,需要国外信用卡
  • [x] 无需信用卡的第三方API支持

客户端安装:

使用安装包:

下载最新的安装包,解压之后双击Setup.exe,按照提示走即可安装好MathpixCsharp。

不能正常从github下载的点这里走网盘

链接:https://pan.baidu.com/s/10lzjMhyiB-wv7PSyDa2BTQ
提取码:hkfb

如果链接失效请留言我知乎账号谢谢 🙂

从源代码编译:

环境准备:

  • Windows 10
  • .NET Framework >= 4.6.1
  • Visual studio 2017,2019

将代码clone到本地

git clone https://github.com/itewqq/MathpixCsharp.git

使用Visual Studio打开项目,在Setup1项目上右键->重新生成,然后在目录
“`MathpixCsharp\Setup1\Release“`下即可找到setup.exe,双击安装即可。

使用方法

  • 如果你有国外的信用卡,例如Visa,MasterCard,推荐直接使用官方的API,每个月可以免费用1000次。详见 官方API使用教程
  • 如果你没有国外的信用卡,可以:
    • 使用我开发的Web版,没有快捷键支持,且Word公式转换效果较差。Web版介绍:https://zhuanlan.zhihu.com/p/208212375
    • 使用第三方API的Key,详见 第三方API使用教程

当然,如果你不差钱的话使用官方的服务永远是最好的选择 🙂

最近 github 老被墙所以我直接把使用说明放到这里好了:

使用官方API教程

  1. 首先到 https://dashboard.mathpix.com/ 注册一个账户并登录。然后到这里创建OCR API,在设置Biliing的时候需要用到国外的信用卡,可能会暂时扣1美元验证信用卡有效性。
  2. 之后在账户主页点击OCR APIs,就可以看到你的API keys列表,把 app_id 和 app_key 这两个字段复制出来,如下图:

apiPic.png

  1. 按照安装教程装好客户端。安装完之后如果没找到在哪儿启动请打开
    “`开始“`进行查找。
  2. 第一次打开会弹出在名为
    “`login“`的窗口,在里面填入之前的app_id和app_key,**下方的复选框选择“`官方Key“`**,**注意不要选错**,选错了会导致无法使用。然后点击确认。只需要填一次之后再打开就不用填了。如果填错了或者要更换Key可以在主界面点击“`菜单->重置Key“`。

image.png

  1. 客户端主界面如下图:

image.png

  1. 使用时需要先截屏选择要识别的公式。点击截屏按钮或者使用快捷键Ctrl+Alt+Q (0.0.6及之前的版本是Ctrl+Alt+M)开始截屏。进入截屏模式时,鼠标会变成十字形,如果进入截屏模式后不想截屏了,可以按右键取消截屏。截屏过程类似QQ的截屏功能,鼠标按下开始截屏,拖动选择区域,松开完成截屏。
  2. 截屏完成后客户端会自动完成识别,并将识别结果置于文本框内,点击文本框对应的按钮可以复制到剪贴板。为了方便使用,默认情况下程序会自动把inline的公式复制到剪贴板,无需点击按钮,如果点击了按钮,则之后的默认复制会记住本次的选择,在之后的自动复制中会选取该选择进行自动复制。完整的演示流程参考下图:
    使用演示

  3. 当点击关闭窗口的时候,MathpixCsharp会自动最小化到系统托盘,如果要退出客户端,请右键系统托盘上的客户端图标再选择退出。

  4. 关于Office Word中的公式:Word用户请点击复制MathML按钮,然后在word文档里右键->粘贴->仅粘贴文本。有时候Ctrl+V会有问题,但是现在这个问题貌似很少出现了。另外,由于Word自身处理公式的问题,有时候一些带括号的公式可能会出现这种情况:
    image.png这时候只需要把光标放在公式最后面,敲一下回车就好了。如果还有问题,就把光标放在异常的括号后面,点一下空格就好了。

注: 使用多个显示器时,MathpixCsharp将选择其窗体当前所在的屏幕进行截屏。

使用第三方API教程

  1. 到 https://mathf.xyz/ 购买app_id 和 app_key,如果你是第一次购买请认真阅读公告

  2. 按照安装教程装好客户端。安装完之后如果没找到在哪儿启动请打开
    “`开始“`进行查找。

  3. 第一次打开会弹出在名为
    “`login“`的窗口,在里面填入之前的app_id和app_key,**下方的复选框选择“`第三方Key“`**,**注意不要选错**,选错了会导致无法使用。然后点击确认。只需要填一次之后再打开就不用填了。如果填错了或者要更换Key可以在主界面点击“`菜单->重置Key“`。

image.png

强调一下,无论使用官方API还是第三方API,使用本客户端必须要填入两个字段,app_id和app_key。注意是两个字段,app_id和app_key,我觉得在教程里以及第三方的公告里已经写得很清楚了,不知道为什么很多人还是只填一个app_key,或者根本不填,或者没有把卡密的格式处理好直接带四个#来填进去,然后来找我发邮件问为什么不能用= =

  1. 客户端主界面如下图,使用第三方Api的时候右上角会显示当前Key的剩余使用次数:

image.png

  1. 使用时需要先截屏选择要识别的公式。点击截屏按钮或者使用快捷键Ctrl+Alt+Q (0.0.6及之前的版本是Ctrl+Alt+M)开始截屏。进入截屏模式时,鼠标会变成十字形,如果进入截屏模式后不想截屏了,可以按右键取消截屏。截屏过程类似QQ的截屏功能,鼠标按下开始截屏,拖动选择区域,松开完成截屏。
  2. 截屏完成后客户端会自动完成识别,并将识别结果置于文本框内,点击文本框对应的按钮可以复制到剪贴板。为了方便使用,默认情况下程序会自动把inline的公式复制到剪贴板,无需点击按钮,如果点击了按钮,则之后的默认复制会记住本次的选择,在之后的自动复制中会选取该选择进行自动复制。完整的演示流程参考下图:
    使用演示

  3. 当点击关闭窗口的时候,MathpixCsharp会自动最小化到系统托盘,如果要退出客户端,请右键系统托盘上的客户端图标再选择退出。

  4. 关于Office Word中的公式:Word用户请点击复制MathML按钮,然后在word文档里右键->粘贴->仅粘贴文本。有时候Ctrl+V会有问题,但是现在这个问题貌似很少出现了。另外,由于Word自身处理公式的问题,有时候一些带括号的公式可能会出现这种情况:
    image.png这时候只需要把光标放在公式最后面,敲一下回车就好了。如果还有问题,就把光标放在异常的括号后面,点一下空格就好了。

注: 使用多个显示器时,MathpixCsharp将选择其窗体当前所在的屏幕进行截屏。

另外还有一些功能有待完善,但是现在大概没空。丑是丑了点又不是不能用 也可能不能用,欢迎大家提issue,欢迎Pr。

“MathpixCsharp: C#实现的Mathpix Windows开源客户端”的2个回复

发表评论

您的电子邮箱地址不会被公开。 必填项已用*标注

此站点使用Akismet来减少垃圾评论。了解我们如何处理您的评论数据