qimage-mac是一个mac上提升markdown贴图体验的实用小工具,可以自定义快捷键,一键上传图片或截图至七牛云,获取图片的markdown引用至剪贴板,并自动粘贴到当前编辑器。

Introduction

qimage目前支持mac及windows,其中windows版基于Autohotkey实现,详细介绍请移步另一篇博文AutoHotkey&qshell 实现图片自动上传七牛并返回markdown引用,本篇主要介绍mac上基于Alfred和qshell的实现和使用。

Usage

使用方法很简单,只需两步即可完成图片的上传和使用,github有预览的动图:

  1. 复制本地图片或视频文件至剪贴板(cmd+c)/使用喜欢的截图工具截图
  2. 切换到编辑器,cmd+option+v即可

怎么样,是不是想试一把,下面就跟着我来一步一步安装使用这个小工具吧。

Pre-Work

开始之前需要做一些准备工作,注册七牛账号、安装必要的软件。

  1. 安装 Alfred with Powerpack
    如果你的mac上还没有安装Alfred(a productivity application for Mac OS X),请先至官网下载安装。另外由于该工具是基于Alfred的workflow功能实现,因此还需要购买Powerpack(£19),也不算很贵,如果充分利用的话还是很超值的,尽管网上也有破解版的。

  2. 安装qshell
    qshell是一个基于七牛API服务的命令行工具,qimage-mac即使用脚本执行qshell指令实现账户信息设置及文件的上传操作。官方文档对qshell的安装和使用有非常详细的教程,这里不再赘述。为了防止出现异常情况,这里强制要求将qshell_darwin_amd64文件重命名为qshell并移至usr/local/bin目录下。安装完成后在任意目录执行/usr/local/bin/qshell -v如果显示当前qshell版本号表明安装成功。

  3. 注册七牛账号
    七牛是一个云服务提供商,很多个人博客现在都喜欢用七牛的对象存储服务做图床,速度确实不错,有比较完整的文档和开发工具,另外实名以后有10G的免费空间使用,基本上满足使用。

Installation

如果准备工作都已完成,下面开始安装配置qimage-mac

  1. github下载最新的release版本
    qimage-mac文件夹下双击Qiniu.alfredworkflow文件安装该workflow。效果如下图所示,其中Hotkey为快捷键配置,Run Script为AppleScript脚本,最右边两个分别是粘贴板和系统通知。

  2. 配置workflow环境变量
    点击上图标出的环境变量图标,可以看到下图所示的四个配置项

    这四个配置项都与七牛账号相关:
    AccessKey & SecretKey
    这是qshell操作个人账号的账号凭证,登陆七牛账号后在个人面板->密钥管理中查看,或者直接访问https://portal.qiniu.com/user/key查看。
    bucket & bucketDomain
    对象存储->存储空间列表中选择或新建一个存储空间即bucket,点击该bucket在右边看到一个测试域名,该域名即bucketDomain是图片上传后的访问域名。

  3. 设置快捷键及关联应用。
    双击Hotkey模块,设置自己习惯的快捷键用于触发该workflow执行,如图这里设置的就是cmd+option+v,另外如果担心和别的热键冲突或者只想在特定的app中激活该热键,在Related Apps页签中将该app拖拽进来即可。

  4. 开始使用
    这时候如果一切顺利的话,便可以使用了。如果使用过程有什么问题,如下图在设置环境变量的右侧有个debug图标,点击打开debug窗口,重新操作一次查看错误日志定位问题,如果依然不能解决问题欢迎留言或在github中提交 issues

References

  1. qshell命令行工具
  2. How to save a new jpg image from the clipboard
  3. Workflow/environment variables
  4. How to split a string

Fork me on GitHubFork me on GitHub