Home / Rust / Productivity

espanso — A cross-platform Text Expander written in Rust

A cross-platform Text Expander written in Rust Visit the espanso website. What is a Text Expander? A text expander is a program that detects when you
Information
Category: Rust / Productivity
Watchers: 61
Star: 7.1k
Fork: 210
Last update: Mar 17, 2023
Resource links
https://espanso.org
https://github.com/espanso/espanso

espanso

A cross-platform Text Expander written in Rust

GitHub release (latest by date) Language Platforms License Build Status

example

Visit the espanso website.

What is a Text Expander?

A text expander is a program that detects when you type a specific keyword and replaces it with something else. This is useful in many ways:

  • Save a lot of typing, expanding common sentences.
  • Create system-wide code snippets.
  • Execute custom scripts
  • Use emojis like a pro.

Key Features

  • Works on Windows, macOS and Linux
  • Works with almost any program
  • Works with Emojis 😄
  • Works with Images
  • Date expansion support
  • Custom scripts support
  • Shell commands support
  • App-specific configurations
  • Expandable with packages
  • Built-in package manager for espanso hub
  • File based configuration

Get Started

Visit the official documentation.

Support

If you need some help to setup espanso, want to ask a question or simply get involved in the community, Join the official Subreddit! :)

Donations

espanso is a free, open source software developed in my (little) spare time. If you liked the project and would like to support further development, please consider making a small donation, it really helps :)

Donate with PayPal

Contributors

Many people helped the project along the way, thanks to all of you. In particular, I want to thank:

Remarks

  • Special thanks to the ModifyPath script, used by espanso to improve the Windows installer.

License

espanso was created by Federico Terzi and is licensed under the GPL-3.0 license.

352 Open More issues
Closed

Any Wayland support plans?

I see in the documentation that Wayland isn't currently supported. Are there any plans (however tentative) to do so at some point? I ask because I'd like to know whether it's worth my while following espanso's releases/progress.

Linux Feature 
opened May 19, 2020 by crispinb 42
Closed

Add debug mode to ShellExtension

Sometimes when writing a match that uses the shell plugin, there will be a problem that interferes with proper replacement, but the nature of the problem is difficult to ascertain. The yaml syntax can be valid, the match can be triggered, but the replacement is missing.

Adding -vvv (up to how many makes a difference?) to the espanso worker command doesn't reveal if any error happened during the command run, or what the output/error was, if any.

I encountered this debugging difficulty as I tried to add a trigger for local IP address, 2 ways:

  - trigger: :local
    replace: "{{address}}"
    vars:
      - name: address
        type: shell
        params:
          cmd: 'nmcli device show wlan0 | pcre2grep -M -O ''$1'' ''^IP4.ADDRESS\[1\]: *(.*)/.*'''
          # cmd: 'ip addr | pcre2grep -M -O ''$2'' ''^\d: wlan0: (.*\n[^\d])*.* inet ((\d+\.){3}\d+)/'''

Neither of the two cmd values above produced a replacement. There are a lot of symbols, and maybe the command being run isn't what I think it is, and it would help if I could find out if it is, and anything else about the commands being run.

Feature RFNR 
opened Jul 8, 2020 by AndydeCleyre 38
Closed

Replacement issue with Kitty

I looked at existing issues, and even at the code. It seems there is some "special" handling required for terminals. Can you please add kitty to the list?

With a file like:


matches:
  - trigger: ";name"
    replace: "Shadab Zafar"

  - trigger: ";email"
    replace: "[email protected]"

Results in:

Espanso on Kitty

Notice the issues with case of the text as well as special characters like @.

bug Linux 
opened May 14, 2020 by dufferzafar 32
Closed

espanso wayland fails to install on Ubuntu 22.04 with `libssl1.1` package unavailable error

Describe the bug

espanso wayland fails to install on Ubuntu 22.04 beta. a dependency for libssl1.1 is unable to be resolved.

To Reproduce Steps to reproduce the behavior:

  1. sudo apt update && sudo apt upgrade
  2. wget https://github.com/federico-terzi/espanso/releases/download/v2.1.5-beta/espanso-debian-wayland-amd64.deb
  3. sudo apt install ./espanso-debian-wayland-amd64.deb espanso-wayland : Depends: libssl1.1 (>= 1.1.0) but it is not installable
  4. sudo apt install libssl1.1 E: Package 'libssl1.1' has no installation candidate

Expected behavior

Expected to be able to install using instructions from https://espanso.org/docs/install/linux/#deb-wayland

Screenshots If applicable, add screenshots or screen recordings to help explain your problem.

Logs

Output of apt install for espanso

sudo apt install ./espanso-debian-wayland-amd64.deb
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Note, selecting 'espanso-wayland' instead of './espanso-debian-wayland-amd64.deb'
Some packages could not be installed. This may mean that you have
requested an impossible situation or if you are using the unstable
distribution that some required packages have not yet been created
or been moved out of Incoming.
The following information may help to resolve the situation:

The following packages have unmet dependencies:
 espanso-wayland : Depends: libssl1.1 (>= 1.1.0) but it is not installable
E: Unable to correct problems, you have held broken packages.

and libssl1.1

sudo apt install libssl1.1
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
Package libssl1.1 is not available, but is referred to by another package.
This may mean that the package is missing, has been obsoleted, or
is only available from another source

E: Package 'libssl1.1' has no installation candidate

Setup information

  • OS: What OS are you using?
  • Version: which version of Espanso are you running? (you can find out by running espanso --version inside a terminal)

This was espanso wayland v2.1.5-beta from https://github.com/federico-terzi/espanso/releases/download/v2.1.5-beta/espanso-debian-wayland-amd64.deb

$ lsb_release -a
No LSB modules are available.
Distributor ID:	Ubuntu
Description:	Ubuntu Jammy Jellyfish (development branch)
Release:	22.04
Codename:	jammy
bug Linux 
opened Apr 3, 2022 by idcrook 30
Closed

Espanso stops expanding after waking from sleep

Using espanso on macOS 10.14 or 10.15 (seems more noticeable though) seems to die after waking from a sleep. Sometimes using restart to restart the daemon fixes it, but not reliably. I have to usually perform a full restart to get it to start using expansions again.

bug MacOS 
opened Dec 11, 2019 by WardsParadox 27
Closed

Windows passive mode is broken

Good morning,

Just for tell which bug i found : On linux, if we reload the config, few instances of espanso could be started, i need to restart it.

When i use passive keys, text is not deleted.

bug Windows RFNR 
opened Aug 26, 2020 by Gadgetroch 26
Open

chore(deps): bump openssl from 0.10.36 to 0.10.48

Bumps openssl from 0.10.36 to 0.10.48.

Release notes

Sourced from openssl's releases.

openssl v0.10.48

What's Changed

New Contributors

Full Changelog: https://github.com/sfackler/rust-openssl/compare/openssl-v0.10.47...openssl-v0.10.48

openssl v0.10.47

No release notes provided.

openssl v0.10.46

No release notes provided.

openssl v0.10.45

No release notes provided.

openssl v0.10.44

No release notes provided.

openssl v0.10.43

No release notes provided.

openssl v0.10.42

No release notes provided.

openssl v0.10.41

No release notes provided.

openssl v0.10.40

No release notes provided.

openssl v0.10.39

No release notes provided.

openssl v0.10.38

No release notes provided.

openssl v0.10.37

No release notes provided.

Commits
  • 4ff734f Release openssl v0.10.48 and openssl-sys v0.9.83 (#1855)
  • 5efceaa Merge pull request #1854 from alex/davids-openssl-of-horrors
  • 6ced4f3 Fix race condition with X509Name creation
  • a752805 Document the horror show
  • 78aa9aa Always provide an X509V3Context in X509Extension::new because OpenSSL require...
  • 332311b Resolve an injection vulnerability in EKU creation
  • 482575b Resolve an injection vulnerability in SAN creation
  • 690eeb2 Merge pull request #1852 from smoelius/master
  • e5b6d97 Improve reliability of some tests
  • 319200a Merge pull request #1851 from alex/libressl-versions
  • Additional commits viewable in compare view

Dependabot compatibility score

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

  • @dependabot rebase will rebase this PR
  • @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
  • @dependabot merge will merge this PR after your CI passes on it
  • @dependabot squash and merge will squash and merge this PR after your CI passes on it
  • @dependabot cancel merge will cancel a previously requested merge and block automerging
  • @dependabot reopen will reopen this PR if it is closed
  • @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
  • @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
  • @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
  • @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself) You can disable automated security fix PRs for this repo from the Security Alerts page.
dependencies 
opened Mar 24, 2023 by dependabot[bot] 0
Open

Froms window size is excceding the screen

Hi,

I noticed that if you want to replace a trigger with a From consisting of a long sentence, then the size of the Form Window would exceed the size of the screen.

I tried to add the following to the default.yml, but it didn't work out: form_size: width: 400 height: 300

Is there any feature to wrap the text within the Form without creating new lines.

Thank you for your time.

Best,

  • George
opened Mar 24, 2023 by GeorgeYaz 0
Open

Plain text rendering of HTML tables is too wide

Hi,

I’m using the HTML output option with a fragment containing a simple table and the rendering in apps that support HTML is as expected but when the app is plain text like Notepad, sublime text etc the table is rendered with borders 1000000 chars wide which will crash some apps when pasting a table with a number of rows. Looks like the html2text library is supplied this width.

Anyone successfully using HTML containing tables across different plain text apps? Not sure if I’m missing some styling that the html2text library will use.

To Reproduce The following snippet will induce the behaviour when pasting into plain text applications such as notepad, sublime text

- trigger: ":table"
   html: "<table><tr><th>Hello</th><th>World</th></tr><tr><td>Test</td><td>Test</td></tr></table>"

Expected behavior The width of the text table to fit the content or a sensible upper limit.

Setup information

  • OS: Windows
  • Version: 2.1.8
bug 
opened Mar 23, 2023 by kurt-m 0
Open

Espanso catches Alt code (Alt+Numpad) in Windows

Dear Espanso devs,

Thank you for that nice tool! When I want to insert a special character like a long dash "–", I do so using the Alt+NumPad way (in that case Alt+0150). As long as Espanso is running, it seems to catch the entering of the Alt codes and none of them work. Exiting Espanso restores the normal behavior and starting Espanso again makes the Alt codes unavailable again.

Best regards llvs

opened Mar 21, 2023 by llvs 0
Open

About the "espanso match exec" command

I'm attempting to use espanso match exec -t ':date' within a bash script and call it via Raycast. However, the command initially backspaces five times before inserting the current date. Is there a way to avoid the backspacing in this situation?

opened Mar 19, 2023 by yayiji 0
Open

Windows issue - will not triger

Describe the bug Espanso starts but will not execute any of my triggers (:espanso etc)

Logs

C:\WINDOWS\system32>espanso log 12:22:36 [daemon(4200)] [INFO] reading configs from: "C:\Users\ed\AppData\Roaming\espanso" 12:22:36 [daemon(4200)] [INFO] reading packages from: "C:\Users\ed\AppData\Roaming\espanso\match\packages" 12:22:36 [daemon(4200)] [INFO] using runtime dir: "C:\Users\ed\AppData\Local\espanso" 12:22:36 [daemon(4200)] [INFO] system info: Windows v10 (19045) - kernel: 19045 12:22:36 [daemon(4200)] [INFO] watching for changes in path: "C:\Users\ed\AppData\Roaming\espanso" 12:22:36 [daemon(4200)] [INFO] espanso version: 2.1.8 12:22:36 [daemon(4200)] [INFO] spawning the worker process... 12:22:36 [daemon(4200)] [INFO] binded to named pipe: \.\pipe\espansodaemonv2 12:22:36 [worker(9572)] [INFO] reading configs from: "C:\Users\ed\AppData\Roaming\espanso" 12:22:36 [worker(9572)] [INFO] reading packages from: "C:\Users\ed\AppData\Roaming\espanso\match\packages" 12:22:36 [worker(9572)] [INFO] using runtime dir: "C:\Users\ed\AppData\Local\espanso" 12:22:36 [worker(9572)] [INFO] system info: Windows v10 (19045) - kernel: 19045 12:22:36 [worker(9572)] [INFO] binded to named pipe: \.\pipe\espansoworkerv2 12:22:36 [worker(9572)] [INFO] using Win32AppInfoProvider 12:22:36 [worker(9572)] [INFO] monitoring the status of the daemon process 12:22:36 [worker(9572)] [INFO] using Win32Source 12:22:36 [worker(9572)] [INFO] using Win32Injector 12:22:36 [worker(9572)] [INFO] using Win32Clipboard 12:22:37 [worker(9572)] [WARN] unable to find espanso AppUserModelID in the list of registered ones, falling back to Powershell

C:\WINDOWS\system32>espanso path Config: C:\Users\ed\AppData\Roaming\espanso Packages: C:\Users\ed\AppData\Roaming\espanso\match\packages Runtime: C:\Users\ed\AppData\Local\espanso

bug 
opened Mar 18, 2023 by craziedde 0

Contents

    espanso Cross-platform Text Expander written in Rust
    futuretea A patterns expander
    rust-cross rust-musl-cross — Docker images for compiling static Rust binaries using musl-cross
    nguyenvulebinh Transformation spoken text to written text
    FriendsOfREDAXO YCOM Impersonate. Login as selected YCOM user 🧙‍♂️in frontend.
    japaric Everything you need to know about cross compiling Rust programs!
    crossterm-rs Cross platform terminal library rust
    threedaymonk Collection of text algorithms. gem install text
    winfsp Cross-platform FUSE library for Go - Works on Windows, macOS, Linux, FreeBSD, NetBSD, OpenBSD
    webview Tiny cross-platform webview library for C/C++/Golang. Uses WebKit (Gtk/Cocoa) and Edge (Windows)
    TaKO8Ki A cross-platform TUI database management tool written in Rust
    antonok-edm Fully cross-platform VST2 plugin with a custom editor UI, written in Rust.
    dthree Cross-platform Linux commands in ES6
    floooh minimal cross-platform standalone C headers
    ilai-deutel A text editor in ≤1024 lines of code, written in Rust
    pH-7 :memo: PHNotepad is a simple Java text/code editor (notepad) written in Java. It has also nice features such as Search tool, Find/Replace text/code, Auto completion, Nice Image Buttons for better UX, etc.
    orbitalquark Textadept is a fast, minimalist, and remarkably extensible cross-platform text editor for programmers.
    WebReflection A cross platform, cross WebView, solution to fit 100% any Web page.
    moxystudio A cross platform solution to node's spawn and spawnSync
    NyaMisty Cross Platform Hook Library based on Detours
    taoyds scripts and baselines for Spider: Yale complex and cross-domain semantic parsing and text-to-SQL challenge
    Share this repo

    Related Repos


    Productivity
    420
    pier — A central repository to manage (add, search metadata, etc.) all your one-liners, sc...
    pier-cli pier ~ A Linux script management tool THANKS: To @Plommonsorbet for the great improvements to the shell NEW: Nix derivation COMING SOON: Syntax highli
     
    Productivity
    7.1k
    espanso — A cross-platform Text Expander written in Rust
    espanso A cross-platform Text Expander written in Rust Visit the espanso website. What is a Text Expander? A text expander is a program that detects when you