mirror of
https://github.com/espanso/espanso.git
synced 2026-09-29 16:28:45 +00:00
A Privacy-first, Cross-platform Text Expander written in Rust
https://espanso.org
- Rust 55.6%
- C++ 41.1%
- Objective-C++ 1.3%
- C 1.2%
- PowerShell 0.2%
- Other 0.4%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
0cadaeaddfA YAML global_var like `echo: 12345` loads as a number, but the echo extension only matched strings, so it failed with "missing 'echo' parameter" even though the parameter was there. Coerce numbers and booleans to their string form and widen the JSON schema to match, so editors stop flagging valid config. Null, arrays and objects still error, since none has a sensible single-string form. Fixes #2722. Co-authored-by: VXNCXNX <VXNCXNX@users.noreply.github.com> |
||
| .claude/skills/release-notes | ||
| .devcontainer | ||
| .github | ||
| .vscode | ||
| docs | ||
| espanso | ||
| espanso-clipboard | ||
| espanso-config | ||
| espanso-detect | ||
| espanso-engine | ||
| espanso-info | ||
| espanso-inject | ||
| espanso-ipc | ||
| espanso-kvs | ||
| espanso-mac-utils | ||
| espanso-match | ||
| espanso-modulo | ||
| espanso-package | ||
| espanso-render | ||
| espanso-ui | ||
| images | ||
| nix | ||
| schemas | ||
| scripts | ||
| snap/hooks | ||
| .clang-format | ||
| .dockerignore | ||
| .editorconfig | ||
| .envrc | ||
| .gitattributes | ||
| .gitignore | ||
| .pre-commit-config.yaml | ||
| biome.json | ||
| Cargo.lock | ||
| Cargo.toml | ||
| Compilation.md | ||
| default.nix | ||
| flake.lock | ||
| flake.nix | ||
| LICENSE | ||
| README.md | ||
| rust-toolchain.toml | ||
| rustfmt.toml | ||
| SECURITY.md | ||
| snapcraft.yaml | ||
| tarpaulin.toml | ||
A cross-platform Text Expander written in Rust
| Example: 2019 | Example: 2025 |
|---|---|
 |
 |
Quick Links
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.
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 (Maintainer)
Auca (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 |
|---|---|
 |
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.