espanso-跨平台文本扩展工具

系列文章目录

软件简介
espanso 是一个用 Rust 编写的跨平台文本扩展器。

特性：
适用于Windows、macOS和Linux
几乎适用于任何程序
使用表情符号
处理图像
日期扩展支持
自定义脚本支持
Shell 命令支持
特定于应用程序的配置
支持表格
可扩展包
用于Espanso 集线器的内置包管理器
基于文件的配置

---

---

window 11平台

win版本下载espanso_2.0.0-alpha.exe

请认准官网espanso下载安装的exe文件
安装成功，启动espanso软件：

espanso 参数

espanso start
espanso stop
espanso restart

安装exe的default 配置

espanso edit:
路径：
C:\Users\用户\AppData\Roaming\espanso\default.yml

安装exe的用户配置

espanso edit user-defined:
路径：
C:\Users\用户\AppData\Roaming\espanso\usr-defined.yml #用户自定义usr-defined

win版本下载espanso_2.0.0-alpha.zip

请认准官网下载espanso免安装版本
解压缩成功，运行espanso软件：

双击espanso文件，就可以出现在.espanso目录里面产生match目录。并且出现了一个弹窗。

同时.espanso文件夹里面多一个match文件，match文件里面有package。其目录结构如下：

一路选择“继续”按钮：

同时.espanso文件夹下瞬间多了config和match文件夹,match文件夹下多了base.yml文件,config文件夹下多了default.yml文件。其目录结构如下图：

.espanso文件夹下多了几个文件：

config文件夹下有default.yml,match文件下有base.yml。

接下来选择“继续”：

目录结构

在开始使用espanso之前，你需要双击‘STAT_ESPANSO.bat’文件。运行之后，你将可以看到".espanso"目录里产生一些文件。在对应目录里面，可以编写配置自定义的文件。
注意: 压缩包里面的任何文件不要随意变动或删除。

ubuntu20.04平台

Ubuntu版本下载

请认准官网的安装配置教程

wget 软件安装包地址

应用后台登记

espanso service register    

运行上面的命令，需要进行 登记成功后会自动生成一些默认的文件夹：

creating service file in "/home/xxxx/.config/systemd/user/espanso.service"
enabling systemd service
Created symlink /home/xxxx/.config/systemd/user/default.target.wants/espanso.service → /home/xxxx/.config/systemd/user/espanso.service.
service registered correctly!

espanso start

espanso 目录结构

查看espanso安装路径：

~ espanso path                                                                                                                     
Config: /home/用户名/.config/espanso
Packages: /home/用户名/.config/espanso/match/packages
Runtime: /home/用户名/.cache/espanso

所有的配置文件都留着espanso文件里面。$CONFIG代指/home/用户名/.config/espanso目录。其中espanso目录下，有config和match目录。

$CONFIG/
  config/
    default.yml
  match/
    base.yml

在config和match目录下，包含default.yml和base.yml文件。

案例模板

global_vars:
  - name: card
    type: date
    params:
      format: "%Y%m%d%H%M%S"
  - name: clip
    type: clipboard


matches:
  # 文本
  - trigger: ";welcome"
    replace: |-
      好开心你能关注我！

  
  # 自定义光标位置
  - trigger: ";xnkl"
    replace: 烎虎贺岁，祝$|$和家人新春快乐、虎虎生威、如虎添翼！🐯🐯🐯

  # 图片
  - trigger: ";zjm"
    image_path: /Users/XXX/zjm.jpeg

  - trigger: ";yjsl"
    image_path: /Users/XXX/yjsl.png

  - trigger: ";ydmy"
    image_path: /Users/XXX/ydmy2.jpg

  # 日期
  - trigger: ";name"
    replace: "祝好\n\n someone \n{{name_date}}"
    vars:
      - name: name_date
        type: date
        params:
          format: "%Y.%m.%d"

  - trigger: ";now"
    replace: "现在是{{time}}。"
    vars:
      - name: time
        type: date
        params:
          format: "%H点%M分"
  
  # 选择
  - trigger: ";bestc"
    replace: "\n{{blessing}}\n\nZhen Bu Rang Lai\n{{name_date}}"
    vars:
      - name: blessing
        type: choice
        params:
          values:
            - "Best Wishes,"
            - "Sincerely,"
            - "Best Regards,"
      - name: name_date
        type: date
        params:
          format: "%m/%d/%Y"

  # 随机
  - trigger: ";bestw"
    replace: "\n{{blessing}}\n\nZhen Bu Rang Lai\n{{name_date}}"
    vars:
      - name: blessing
        type: random
        params:
          choices:
            - "Best Wishes,"
            - "Sincerely,"
            - "Best Regards,"
      - name: name_date
        type: date
        params:
          format: "%m/%d/%Y"

  # 剪贴板 scp 的例子
  - trigger: ";scp"
    replace: "scp -P 6666 xxxx@xxxx.bilibili:~/$|$ {{clip}}"

  # 表单
  - trigger: ";spring"
    replace: "烎虎贺岁，祝{{form1.nick}}{{form1.blessing}}🐯🐯🐯🎉🎉🎉"
    vars:
      - name: form1
        type: form
        params:
          layout: |-
            称呼: [[nick]] \n
            祝福语: [[blessing]]
          fields:
            nick:
              multiline: false
            blessing:
              type: list # list or choice
              values:
                - 新春快乐、虎虎生威、如虎添翼！
                - Paper多多，Money多多！
                - 平安健康，开心长大！
                - 新春快乐，福泰安康！
                - 平安喜乐，阖家幸福，好运满满！


  # shell 天气
  - trigger: ";weather"
    replace: "{{output}}"
    vars:
      - name: output
        type: shell
        params:
          cmd: "curl wttr.in/Shanghai?format=1"

  # shell 天气
  - trigger: ";cityc"
    replace: "{{output}}"
    vars:
      - name: city
        type: choice
        params:
          values:
            - label: "北京"
              id: "Beijing"
            - label: "上海"
              id: "Shanghai"
            - label: "苏州"
              id: "Suzhu"
            - label: "漠河"
              id: "Mohe"
      - name: output
        type: shell
        params:
          cmd: "curl wttr.in/{{city}}?format=1"

 # shell 天气
  - trigger: ";cityf"
    replace: "{{output}}"
    vars:
      - name: form1
        type: form
        params:
          layout: |-
            城市: [[city]] 
          fields:
            city:
              multiline: false
      - name: output
        type: shell
        params:
          cmd: "curl wttr.in/{{form1.city}}?format=1"