open.source/espanso
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Cross-platform Text Expander written in Rust
140 Commits 5 Branches 44 Tags 46 MiB
Rust 54.5%
C++ 42.6%
C 1.2%
Objective-C++ 1.2%
Shell 0.2%
fee1f5edc1
Go to file
Federico Terzi fee1f5edc1 Set up CI with Azure Pipelines 
[skip ci]
2019-09-21 10:40:42 +02:00
images Add windows installation instructions 2019-09-18 10:59:29 +02:00
native Force include headers on CMake linux 2019-09-21 09:59:00 +02:00
other/EspansoNotifyHelper Add GPL preamble 2019-09-15 18:29:11 +02:00
packager Add packager build for macos 2019-09-18 11:10:36 +02:00
src Rename install/uninstall to register/unregister 2019-09-20 22:33:14 +02:00
.gitignore Update gitignore to include cmake output directories 2019-09-13 23:31:57 +02:00
azure-pipelines.yml Set up CI with Azure Pipelines 2019-09-21 10:40:42 +02:00
build.rs Fix #30 2019-09-16 11:02:40 +02:00
Cargo.lock Add extension mechanism and date extension 2019-09-15 13:03:21 +02:00
Cargo.toml Implement start subcommand on Windows. Fix #34 2019-09-16 10:56:14 +02:00
LICENSE Initial commit 2019-08-30 09:16:58 +02:00
packager.py Improve windows packager to include version in setup exe 2019-09-18 10:35:59 +02:00
README.md Add windows installation instructions 2019-09-18 10:59:29 +02:00

README.md

espanso

A cross-platform Text Expander written in Rust

Language Platforms License

example

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 😄
  • Date expansion support
  • Custom scripts support
  • Shell commands support
  • App-specific configurations
  • File based configuration

Table of contents

Installation

Windows

The installation on Windows is pretty straightforward, navigate to the Release page and download the latest installer ( usually named like espanso-win-0.1.0.exe ).

Because espanso is not digitally signed, you may experience a warning from Windows Smartscreen. In this case, just click on "More info" (1) and then on "Run anyway" (2), as shown in the picture:

Windows Smartscreen

If you completed the installation procedure, you should have espanso running. A good way to find out is by going on any text field and typing :espanso. You should see "Hi there!" appear.

Linux

TODO

MacOS

The easiest way to install espanso on macOS using the Homebrew package manager, but you can also do it manually.

Using Homebrew

The first thing to do is to add the official espanso tap to Homebrew with the following command:

brew tap federico-terzi/espanso

Then you can install espanso with:

brew install espanso

To make sure that espanso was correctly installed, you can open a terminal and type:

espanso --version

At this point, you have to Enable Accessibility to use espanso.

Enabling Accessibility

Because espanso uses the macOS Accessibility API to work, you need to authorize it using the following procedure:

Open a terminal and type the command:

espanso install

A dialog should show up, click on "Open System Preferences", as shown here:

Accessibility Prompt

Then, in the "Privacy" panel click on the Lock icon (1) to enable edits and then check "espanso" (2), as shown in the picture:

Accessibility Settings

Now open the terminal again and type:

espanso install

If everything goes well, you should see the espanso icon appear in the status bar:

macOS status bar icon

If you now type :espanso in any text field, you should see "Hi there!" appear!

Usage

TODO

FAQ

How does espanso work?

TODO

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

License

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