mirror of
https://github.com/espanso/espanso.git
synced 2026-11-03 02:45:57 +00:00
A Privacy-first, Cross-platform Text Expander written in Rust
- 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 |
|---|---|---|
80d9e353e3On Windows the IPC pipes were named after the id alone (`\\.\pipe\espansodaemonv2`, `\\.\pipe\espansoworkerv2`), and named pipes are machine-wide. On a multi-user host (Remote Desktop Session Host, Azure Virtual Desktop multi-session) the first user to start espanso owns both pipes, and every other user's daemon and worker panic with `unable to initialize ipc server: Access is denied. (os error 5)`. The Unix implementation already scopes its sockets by placing them in the runtime dir; the Windows one received the same `parent_dir` and discarded it. The pipe name now carries a stable FNV-1a hash of the lower-cased runtime dir, so each user gets their own pair of pipes. Co-authored-by: Romain Dartigues <romain.dartigues@dealerbox-tech.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.