Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/rosano/launchlet-extension

Browser extension for Launchlet
https://github.com/rosano/launchlet-extension

bookmarklet chrome-extension firefox-extension keyboard-shortcuts safari-extension userscripts userstyles

Last synced: 2 months ago
JSON representation

Browser extension for Launchlet

Awesome Lists containing this project

README 

        
Project logo



# [Launchlet](https://launchlet.dev) Browser Extension



As a complement to the [main project](https://github.com/launchlet/launchlet), this browser extension adds the following extra functionality to Launchlet:



- Run Recipes automatically on page load

- Run Recipes via keyboard shortcuts

- Customize keyboard shortcuts



# Setup



There are two parts to running the extension: *Install* in the browser, and then *Pair* with the [Composer](https://launchlet.dev/compose). 



## Install



The simplest way to install is from the extension platforms, but there are other options in the [releases](https://github.com/launchlet/launchlet-extension/releases).



### Firefox



https://addons.mozilla.org/addon/launchlet/



### Chrome



https://chrome.google.com/webstore/detail/launchlet/gmgfdkajnjplpjmodjmmmkfkpjdjgnlf



### Safari



Safari 13 no longer supports the common web extension format so it is currently only possible to install on Safari 12 or earlier.



The extension can't run on the 'Empty Page' but you can set the Homepage to 'about:blank' and then open new tabs with Homepage.



#### Safari 12



1. Download and unzip the '_shared/unpacked' [release](https://github.com/launchlet/launchlet-extension/releases)

2. Show the Develop menu: Safari > Preferences > Advanced > Show Develop menu in menu bar

3. Show the Extension Builder: Develop > Show Extension Builder

4. Install the unpacked extension: + > Add Extension > [select the lbx.safariextension folder]

5. Enter your password



Quitting Safari will reset extension data and require re-entering your password to run the extension.



#### Safari 11



Download the 'safari-signed' [release](https://github.com/launchlet/launchlet-extension/releases) and open with Safari



## Pair



1) Click the *Generate Key* button in the extension context menu and then copy the key

2) Click the *Pair extension* button in the Composer and enter the key



If successfully paired, the extension context menu should display a settings button and the Composer should not have any messages. If not successful, the extension context menu will continue to show the key and the Composer might say 'Waiting' or 'Failed'.



After pairing, all changes should transfer to the extension automatically.



# Keyboard Shortcuts



It is possible to run the version of Launchlet built in the Composer using the keyboard shortcut `Alt+Shift+1`. This shortcut is customizable from the extension Settings page.



There are two parts to a shortcut: the key combination and the *Signature*.



## Key combination



The key combination is specified using either the `code` or `key` from [JavaScript Keyboard events](https://keycode.info).



To simplify writing this out, in the extension Settings page there is a simulation that prints out the corresponding format for any shortcut — copy/paste this to specify the key combination.



## Signature



The extension makes it possible to set shortcuts using the *Signature* for any *Recipe* saved in the Composer.



For example, by default there is a shortcut of `Alt+Shift+2` for the signature `XYZAlfa`. This means that a *Recipe* with the *Signature* `XYZAlfa` should run with the key combination `Alt+Shift+2` — replace `XYZAlfa` with the *Signature* from your own *Recipe* to customize the shortcut.



The version of Launchlet built in the Composer has the *Signature* `LBXShortcutDefault`.



## ❤️



Help me keep creating projects that are public, accessible for free, and open-source.



Become a backer