ScreenFloat 2
Instructions for using the ScreenFloat 2 URL scheme
App URL schemes can help you automate functionality, or call features up from different places.
ScreenFloat 2 currently exposes the following features through its URL scheme ‘esssf2‘:
- Capturing a screenshot
- Capturing a timed screenshot
- Recording your screen
as well as
- Creating a screenshot from contents on your clipboard
This document explains how it works.
Capturing
ScreenFloat’s base URL for starting a capture is
esssf2://sci-capture.at/
By itself, it does nothing.
The following parameter is required:
- captureType: The type of capture you’d like to create. Accepts the following values:
- screenshot - lets you capture a selective screenshot
- timed - lets you capture a selective screenshot with a countdown
- video - lets you record your screen
Example: esssf2://sci-capture.at/?captureType=screenshot
Capture a screenshot which, by default, will float.
The following parameters are optional:
- shouldFloat: Whether the shot should float right after capture. Accepts ‘true’ and ‘false’. Defaults to ‘true’ if not supplied.
Example: esssf2://sci-capture.at/?captureType=screenshot&shouldFloat=false
Capture a screenshot which then does not float.
- timerDuration: Only considered if ‘captureType’ is ‘timed’. Accepts an integer, like 5, or 6, or 10. If omitted or invalid, defaults to the defaults you have set up in ScreenFloat’s Settings > Keyboard Shortcuts > Capture Shot with Timer.
Example: esssf2://sci-capture.at/?captureType=timed&timerDuration=3
Capture a screenshot after a 3 second countdown.
- afterAction: What should happen after you have captured something. Accepts the following values:
- annotate (images only) - opens the annotation UI on the shot
- crop - opens the crop UI on the shot
- derez (images only) - “de-retinizes” the shot
- resize - opens the resize UI on the shot
- trim (videos only) - opens the trim UI on the shot
- cut (videos only) - opens the cutting UI on the shot
- icld - uploads the shot to iCloud and copies a link to it to your clipboard
- ikio - uploads the shot to ImageKit.io and copies a link to it to your clipboard
- cldnry - uploads the shot to Cloudinary.com and copies a link to it to your clipboard
Example: esssf2://sci-capture.at/?captureType=video&afterAction=icld
Start a screen recording, and afterwards uploads it to iCloud and copies a link to it to your clipboard.
Create a Shot from your Clipboard
To create a shot from text-, image- or video data on your clipboard, you can use this URL:
esssf2://sci-clipcap.at
If no valid data is on the clipboard, nothing happens.
The following parameter is optional:
- shouldFloat: Whether the shot should float right after capture. Accepts ‘true’ and ‘false’. Defaults to ‘true’ if not supplied.
Example: esssf2://sci-clipcap.at/?shouldFloat=false
Create a screenshot from content on your clipboard which then does not float.
Feedback and Questions
If you have any feedback or questions, please don’t hesitate to contact me.
Links