open.source/espanso
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Cross-platform Text Expander written in Rust
127 Commits 5 Branches 44 Tags 46 MiB
Rust 54.5%
C++ 42.6%
C 1.2%
Objective-C++ 1.2%
Shell 0.2%
9c6a2cace3
Go to file
Federico Terzi 9c6a2cace3 Add installation instructions on MacOS readme
2019-09-18 11:43:52 +02:00
images Add installation instructions on MacOS readme 2019-09-18 11:43:52 +02:00
native Create macOS install/uninstall subcommands 2019-09-17 00:11:31 +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 Create macOS install/uninstall subcommands 2019-09-17 00:11:31 +02:00
.gitignore Update gitignore to include cmake output directories 2019-09-13 23:31:57 +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 Add packager build for macos 2019-09-18 11:10:36 +02:00
README.md Add installation instructions on MacOS readme 2019-09-18 11:43:52 +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

TODO

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!

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.