{"id":14062924,"url":"https://github.com/jimbrig/espanso-old","last_synced_at":"2025-05-05T21:31:06.670Z","repository":{"id":41139145,"uuid":"418933534","full_name":"jimbrig/espanso-old","owner":"jimbrig","description":"Espanso configs","archived":false,"fork":false,"pushed_at":"2022-05-23T16:20:08.000Z","size":68,"stargazers_count":12,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-09T04:25:33.465Z","etag":null,"topics":["automation","backup","espanso","text-expander","windows"],"latest_commit_sha":null,"homepage":"https://espanso.org/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jimbrig.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-10-19T13:21:04.000Z","updated_at":"2025-01-20T23:40:40.000Z","dependencies_parsed_at":"2022-08-25T18:10:08.390Z","dependency_job_id":null,"html_url":"https://github.com/jimbrig/espanso-old","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jimbrig%2Fespanso-old","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jimbrig%2Fespanso-old/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jimbrig%2Fespanso-old/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jimbrig%2Fespanso-old/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jimbrig","download_url":"https://codeload.github.com/jimbrig/espanso-old/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252580001,"owners_count":21771248,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","backup","espanso","text-expander","windows"],"created_at":"2024-08-13T07:02:53.772Z","updated_at":"2025-05-05T21:31:06.360Z","avatar_url":"https://github.com/jimbrig.png","language":null,"funding_links":[],"categories":["Others"],"sub_categories":[],"readme":"# Espanso \u003cimg align=\"right\" syle='float' href='https://user-images.githubusercontent.com/32652297/139356362-d02ef475-1b0e-4b73-9d9c-7b7e147cb426.png' src='https://user-images.githubusercontent.com/32652297/139356362-d02ef475-1b0e-4b73-9d9c-7b7e147cb426.png' /\u003e\n\n*My personal [Espanso](https://espanso.org/) text expander configuration files and setup*\n\n***\n\nLinks: [Espanso Website](https://espanso.org/) | [EspansoHub](https://hub.espanso.org/) | [Documentation](https://espanso.org/docs/get-started/) | [Reddit Community](https://www.reddit.com/r/espanso/) | [GitHub](https://github.com/federico-terzi/espanso)\n\n## What is `espanso`?\n\n[Espanso](https://espanso.org/) is an Open Source text-expander tool.\n\n## Ideas \n\n- Current IP Address\n- Time Codes for Work\n- Emoji's\n- Email Templates\n\n## Setup\n\n### Installation\n\nInstall via on Windows using a package manager of choice: \n\n- `winget`\n- `chocolatey`\n- `scoop`\n\n```powershell\n# winget\nwinget install FedericoTerzi.espanso\n\n# chocolatey\nsudo cinst -y espanso\n\n# scoop \nscoop install espanso\n```\n\n`espanso` should launch at startup, but to check run `espanso status`, and if it says *`espanso is not running`* then run *`espanso start`*.\n\n### Configuration\n\n`espanso` uses a file-based configuration approach. Simply run `espanso path` to determine the configuration folder's path.\n\n```powershell\n\u003e ~\\AppData\\Roaming\\espanso :: git(main) 10:43:57\n➜ wsl -e tree\n.\n├── README.md\n├── default.yml\n└── user\n    ├── credit-cards.yml\n    ├── dev-secrets.yml\n    ├── dev.yml\n    ├── emails.yml\n    ├── links.yml\n    ├── passwords.yml\n    ├── phone-numbers.yml\n    └── websites.yml\n\n1 directory, 10 files\n```\n\n### Notes\n\n`espanso` scripts should be located at `%APPDATA%\\espanso` (on Windows) [^1] with a file named `default.yml` and (optionally) a sub-directory named `user` \n(i.e. `%APPDATA%\\espanso\\user`). \n\nPlace sub-level child-scripts in the user folder.\n\n## User Scripts\n\nCurrently I have a total of 8 user-specific child scripts under parent *default.yml*, which are housed in the [user dirctory](user/):\n\n- [credit-cards.yml](user/credit-cards.yml): My credit cards [^2]\n- [dev-secrets.yml](user/dev-secrets.yml): Developer secrets [^2]\n- [dev.yml](user/dev.yml): Development related replacements (i.e. common code strings).\n- [emails.yml](user/emails.yml): My email addresses\n- [links.yml](user/links.yml): Personal websites\n- [passwords.yml](user/passwords.yml): My common passwords [^2]\n- [phone-numbers.yml](user/phone-numbers.yml): My cell phone numbers\n- [websites.yml](user/websites.yml): Similar to `links.yml`\n\n## Editing\n\nFor quick editing of espanso scripts run `espanso edit`.\n\n## Toggle (Important!)\n\nTo toggle `espanso`'s runtime simply double-tab the `Alt` key. This makes it useful to temporarilly disable then re-enable the service.\n\n## Application Specific\n\nUse the `filter_title` configuration variable to specify expansions that should only apply in windows with a title of the provided value. For example, to only match and trigger the below expansion in Outlook you would use:\n\n```yaml\nfilter_title: \"Outlook\"\nmatches:\n    - trigger: \":signature\"\n      replace: \"Jimmy Briggs\"\n```\n\nThe following table lays out all possible `filter_*` configurations:\n\n| Filter         | Description                                             | Windows Support                              | MacOS Support                                       | Linux Support   |\n| -------------- | ------------------------------------------------------- | -------------------------------------------- | --------------------------------------------------- | --------------- |\n| `filter_title` | Filter based on the current Window title                | Full support                                 | Uses the App identifier instead of the Window title | Full support    |\n| `filter_exec`  | Filter based on the current application executable path | Full support                                 | Full support                                        | Partial support |\n| `filter_class` | Filter based on the current Window class                | Uses the application executable path instead | Uses the App identifier instead                     | Full support    |\n\n***\n\n[^1]: File Paths are Operating Sysstem Dependent:  \n    - Linux: `$XDG_CONFIG_HOME/espanso` (e.g. `/home/user/.config/espanso`)\n    - macOS: `$HOME/Library/Preferences/espanso` (e.g. `/Users/user/Library/Preferences/espanso`)\n    - Windows: `{FOLDERID_RoamingAppData}\\espanso` (e.g. `%APPDATA%\\espanso)`)\n    \n\n[^2]: Encrypted via [git-crypt](). \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjimbrig%2Fespanso-old","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjimbrig%2Fespanso-old","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjimbrig%2Fespanso-old/lists"}