https://github.com/pnlng/alfred-url-actions
An Alfred workflow that fetches the URL and title of your browser's current tab, and does things with them.
https://github.com/pnlng/alfred-url-actions
alfred-workflow omnifocus popclip
Last synced: 2 months ago
JSON representation
An Alfred workflow that fetches the URL and title of your browser's current tab, and does things with them.
- Host: GitHub
- URL: https://github.com/pnlng/alfred-url-actions
- Owner: pnlng
- License: mit
- Created: 2019-12-18T21:12:30.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-11-14T00:49:00.000Z (over 1 year ago)
- Last Synced: 2024-11-05T22:41:38.996Z (7 months ago)
- Topics: alfred-workflow, omnifocus, popclip
- Language: Go
- Size: 4.92 MB
- Stars: 60
- Watchers: 3
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# URL Actions
URL Actions is an [Alfred](https://www.alfredapp.com/) workflow that fetches the URL and title of your browser's current tab (compatible with Firefox, Safari, Chrome, and pretty much everything else), and
does things with them. For example, it can
- Copy link in Markdown
- Add a task to OmniFocus Pro
- Optionally remove URL query parameters
The actions are also customizable. It can
- Open custom URLs
- Copy custom strings to clipboard
An optional [PopClip](https://pilotmoon.com/popclip/) extension is also available, if one is inclined to trigger the workflow from the mouse.
## Download
- [Alfred Workflow](https://www.github.com/pnlng/alfred-url-actions/releases/latest/download/URL.Actions.alfredworkflow)
- (Optional) [PopClip Extension](https://github.com/pnlng/alfred-url-actions/releases/download/v1.1.4/URLtoAlfred.popclipextz)
## Screenshots
| Alfred | OmniFocus quick entry |
| --------------------------- | ------------------------------ |
|  |  |
macOS notification
## Contents
- [URL Actions](#url-actions)
- [Download](#download)
- [Screenshots](#screenshots)
- [Contents](#contents)
- [Usage](#usage)
- [PopClip](#popclip)
- [Configuration](#configuration)
- [Variables](#variables)
- [Custom Actions](#custom-actions)
- [Alternatives](#alternatives)
- [Copying URLs](#copying-urls)
- [Adding to OmniFocus](#adding-to-omnifocus)
- [Browser Specific](#browser-specific)
- [Browser Support](#browser-support)
- [Acknowledgements](#acknowledgements)
## Usage
Select the desired URL (⌘L to get the URL of the current tab in a browser). Fire up the workflow's associated hotkey, which is ⇧^C by default.
- Pressing ↵ will either copy the formatted string or open the URL scheme action.
- Pressing ⌘↵ will remove query parameters from the URL.
- Example: `https://www.alfredapp.com/?param=something` becomes `https://www.alfredapp.com/`
### PopClip
Alternatively, if you use [PopClip](https://pilotmoon.com/popclip/), you trigger Alfred through the PopClip extension.
- Note: The extension triggers Alfred 4 by default. If you use other versions of Alfred, you would need to modify `alfred.applescript` and `Bundle Identifier` in `Config.plist`, and [package](https://github.com/pilotmoon/PopClip-Extensions#anatomy-of-a-popclip-extension) the extension yourself.
## Configuration
### Variables
See [here](https://www.alfredapp.com/help/workflows/advanced/variables/#environment) for a quick tutorial on how to configure variables in Alfred.
- `CLEAN_AMAZON` - Default: `true`
- The workflow removes tracking tokens from Amazon URLs if this variable is set to `true`.
- To disable the feature, set the variable to `false`.
- `UPDATE_FREQUENCY` - Default: 7
- Set once how many days the workflow should check for updates
- Updates done through [OneUpdater](https://github.com/vitorgalvao/alfred-workflows/tree/master/OneUpdater)
- `CUSTOM_ACTIONS_FILE` - Default: null
- The name of a JSON file in the workflow data directory supplying custom actions that override the default actions.
- `CUSTOM_ACTIONS` - Default: null
- A string in JSON format supplying custom actions that override the default actions.
- If both `CUSTOM_ACTIONS` and `CUSTOM_ACTIONS_FILE` are defined, only the `CUSTOM_ACTIONS_FILE` will be used.
### Custom Actions
You can supply custom actions that override the default actions in one of the following ways.
1. Put a JSON file in the workflow data directory (accessible via the keyword `urlact`). Let the value of `CUSTOM_ACTIONS_FILE` be the name of the file.
2. Let the value of `CUSTOM_ACTIONS` be a JSON string.
For a template, see [`actions_template.json`](https://github.com/pnlng/alfred-url-actions/blob/master/actions_template.json).
Example:
```json
[
{
"action_title": "Copy as Markdown link",
"output": "[{title}]({url})"
},
{
"action_title": "Add to OmniFocus",
"action_subtitle": "",
"output": "omnifocus:///add?name={title}¬e={url}",
"encode": true
}
]
```
Variables:
- `{title}`
- `{url}`
Attributes:
- `action_title`: Action title shown in Alfred.
- `action_subtitle`: (Optional) Action subtitle shown in Alfred. If unspecified, the workflow will display the formatted output in this field.
- `output`: Desired output of the action.
- `encode`: (Optional) Default `false`. Whether to encode the title of the webpage. This is useful when the action is to open an URL scheme.
_Note: Currently, if the output matches the regex `^.+:///._`, the workflow will open the URL. Conversely, if the output doesn't match the regex, the workflow will copy the output to clipboard.\*
## Alternatives
### Copying URLs
Fallroot's [Copy URL](https://github.com/fallroot/copy-url-for-alfred) is a great workflow for formatting an URL in various ways. It can get the current tab title and URL from Safari and Chrome. Alas, it does not support Firefox.
### Adding to OmniFocus
There is a workflow called [Create OmniFocus Tasks](https://web.archive.org/web/20170606130617/http://aaronhockley.com/alfred-2-workflow-create-omnifocus-tasks/) by Aaron Hockley. It's hosted [here on Dropbox](https://www.dropbox.com/s/nlx4uyfc905iyc2/CreateOmniFocusTasks.alfredworkflow), archived [here on GitHub](https://github.com/hzlzh/AlfredWorkflow.com/blob/master/Downloads/Workflows/CreateOmniFocusTasks.alfredworkflow), and is no longer actively maintained.
If you use only Safari or Chrome, and do not need to copy links in Markdown or clean Amazon URLs, this workflow might be the easiest way to add an URL and the associated page title to OmniFocus.
### Browser Specific
For maximal scriptability in Firefox, checkout deanishe's [Firefox Assistant for Alfred](https://github.com/deanishe/alfred-firefox/).
There are a few browser specific tools that can send the frontmost web page and URL to OmniFocus.
- [Firefox extension](https://addons.mozilla.org/en-US/firefox/addon/addtoomnifocus2/)
- [Script for Safari](https://github.com/jessesquires/safari-tabs-to-omnifocus)
- [Chrome extension](https://chrome.google.com/webstore/detail/send-to-omnifocus/ohdhaodomnlifoigpfcbjpcegdbefnen)
## Browser Support
- Firefox
- Chrome
- Safari
- Brave
- Opera
- Vivaldi
... probably any browser, really.
## Acknowledgements
This workflow is inspired by these articles and projects.
- [Clean Amazon links with TextExpander](https://leancrew.com/all-this/2015/06/clean-amazon-links-with-textexpander/) by Dr. Drang
- [Mail to OmniFocus - AppleScript](https://www.mnott.de/mail-to-omnifocus-applescript/) by Matthias Nott
- This [gist](https://gist.github.com/vitorgalvao/5392178) by vitorgalvao
- AppleScript and JavaScript for Automation to get frontmost tab's url and title of various browsers
- [Workflow/environment variables in Alfred](https://www.deanishe.net/post/2018/10/workflow/environment-variables-in-alfred/) by deanishe
- The [Copy URL](https://github.com/fallroot/copy-url-for-alfred) workflow by fallroot
This workflow is especially indebted to:
- The [AwGo](https://github.com/deanishe/awgo/) library by deanishe