Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/deanishe/alfred-appscripts

Alfred workflow to search and run/open AppleScripts for the active application
https://github.com/deanishe/alfred-appscripts

alfred alfred-workflow applescript jxa python runner scripts search

Last synced: about 1 month ago
JSON representation

Alfred workflow to search and run/open AppleScripts for the active application

Host: GitHub
URL: https://github.com/deanishe/alfred-appscripts
Owner: deanishe
License: mit
Created: 2014-04-07T17:42:38.000Z (over 10 years ago)
Default Branch: master
Last Pushed: 2021-04-29T20:00:20.000Z (over 3 years ago)
Last Synced: 2024-08-02T14:12:29.531Z (5 months ago)
Topics: alfred, alfred-workflow, applescript, jxa, python, runner, scripts, search
Language: Python
Homepage:
Size: 2.77 MB
Stars: 87
Watchers: 7
Forks: 4
Open Issues: 2
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

awesome-starred-test - deanishe/alfred-appscripts - Alfred workflow to search and run/open AppleScripts for the active application (Python)

README

        
Alfred AppScripts Workflow

==========================

List, search and run/open AppleScripts for the active application. You can also specify directories that contain scripts that will always be shown, regardless of the active application.

![][demo]

Download

--------

**Note:** Version 3.0 and above are not compatible with Alfred 2.

The workflow can be downloaded from [GitHub releases][gh-releases] or from [Packal][packal].

Usage

-----

- `.as []` — Show/search list of AppleScripts for the active application

	- `↩` — Run the selected script.

	- `⌘+↩` — Open the selected script in Script Editor.

	- `⌥+↩` — Reveal the selected script in Finder.

- `appscripts []` — Show workflow configuration.

    - `Help` – Open this file in your browser.

    - `(No) Update Available` — Whether or not the workflow can be updated. Action the item to update or force an update check.

    - `Search Directories Recursively` – Whether the script directories should be searched recursively. Use with some caution.

    - `Edit Script Directories` — Open the configuration file in your default editor. The file contains a detailed description of how it works.

    - `Reset to Defaults` — Delete configuration and cache files.

Where are these scripts?

------------------------

The workflow comes with a default set of directories. These are defined in a settings file that you can edit yourself. Use the `Edit Script Directories` option in the configuration (keyword `appscripts`) to open the file in your editor.

These are the default directories. `{app_name}` will be replaced with the name of the currently active application, e.g. `BBEdit` or `OmniFocus`, and `{bundle_id}` with the application's bundle ID, e.g. `com.barebones.bbedit` or `com.omnigroup.OmniFocus2`:

- `~/Library/Scripts/Applications/{app_name}`

- `~/Library/Scripts/Applications/{bundle_id}`

- `~/Library/Application Scripts/{app_name}`

- `~/Library/Application Scripts/{bundle_id}`

- `~/Library/Application Support/{app_name}/Scripts`

- `~/Library/Application Support/{bundle_id}/Scripts`

- `~/Library/Containers/{bundle_id}/Data/Library/Application Support/{app_name}/Scripts`

Any `*.scpt`, `*.applescript`, `*.scptd` (script bundle) or `*.js` (JXA) files found within the above directories will be shown.

If you add a directory path that doesn't contain `{app_name}` or `{bundle_id}`, it will match every application and the scripts will always be shown. See the settings file (`AppScript Directories.txt`) for more information.

Bug reports, feature requests

-----------------------------

Please use [GitHub issues][gh-issues] to report bugs or request features. Alternatively, you can post in the [Alfred Forum thread][forum-thread].

Licence, thanks

---------------

The workflow code and the bundled [Alfred-Workflow][alfred-workflow] and [docopt][docopt] libraries are all licensed under the [MIT Licence][mit-licence].

The workflow icon was created by [Jono Hunt][jono].

The other icons are from [Font Awesome][font-awesome] by [Dave Gandy][dave-gandy], and released under the [SIL OFL 1.1 licence][sil-licence].

[alfred-workflow]: https://github.com/deanishe/alfred-workflow

[cc-licence]: http://creativecommons.org/licenses/by-nc/3.0/

[dave-gandy]: https://twitter.com/davegandy

[demo]: https://raw.githubusercontent.com/deanishe/alfred-appscripts/master/demo.gif "Animated demonstration of AppScripts"

[docopt]: https://github.com/docopt/docopt

[font-awesome]: http://fortawesome.github.io/Font-Awesome/

[forum-thread]: http://www.alfredforum.com/topic/4218-appscripts

[gh-issues]: https://github.com/deanishe/alfred-appscripts/issues

[gh-releases]: https://github.com/deanishe/alfred-appscripts/releases

[mit-licence]: http://opensource.org/licenses/MIT

[packal]: http://www.packal.org/workflow/appscripts

[sil-licence]: http://scripts.sil.org/OFL

[jono]: https://www.alfredforum.com/profile/66-jono/