> *A cross-platform Text Expander written in Rust*

!GitHub release (latest by date)
!Maintenance
!Language
!License

!Platforms


| Example: 2019 | Example: 2025 |
| :----------------------------: | :-------------------------------------: |
|  |  |

Quick Links

• espanso website
• espanso hub

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
• System-wide 'autocorrect' specific to you

Key Features

• Cross-platform (Windows, macOS, Linux)
• Privacy-first (100% local, no tracking)
• Works with almost any program
• Emoji support 😄
• Image support
• Includes a powerful Search Bar 🔎
• Date expansion support
• Custom scripts support
• Shell commands support
• App-specific configurations
• Support Forms
• Expandable with packages
• Built-in package manager for espanso hub
• File based configuration
• Support Regex triggers
• Experimental Wayland support
• Written in Rust (Fast, Reliable)

Community & Support

• 💬 espanso Discord Server
• 📖 official documentation
• 💬 official Subreddit
• 🐛 Report Issues
• 💡 Feature Requests

Quick Start Examples

You can create additional files to organize your matches any way you want. Make sure to adhere to proper YAML spacing.

yaml
matches:
  - trigger: ":hello"
    replace: "Hi There!"
  - triggers: [":test1", ":test2"]
    replace: "These both expand to the same thing"

Team Members and Contributors

Team

Federico Terzi (Creator of espanso)
Rest of team in Alphabetical Order
Archigos (Lead Maintainer)
Auca (Previous Lead Maintainer)
n8henrie
smeech

You can also see the up to date list of Team Members here

Contributors

So many people have helped the project along the way. Thank you all!


Sponsors

We want to thank SignPath.io for code signing the Windows binaries ❤️

Donations

espanso is a free, open-source software project created by Federico Terzi and now maintained by a small team.
If you liked the project and would like to support further development,
please consider making a small donation, it really helps :)

Current Options

| PayPal | Coming Soon |
| :----: | :---------: |
| [](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=FHNLR5DRS267E&source=url) | |

Remarks

• Thanks to libxdo and xclip, used to implement the Linux port.
• Thanks to libxkbcommon and wl-clipboard, used to implement the Wayland port.
• Thanks to wxWidgets for providing a powerful cross-platform GUI library.
• Free code signing provided by SignPath.io, certificate by SignPath Foundation.

License

espanso was created by Federico Terzi
and is licensed under the [GPL-3.0 license](/LICENSE).

Collapse