Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zeitlings/alfred-workflows
Collected Alfred Workflows & Proof of Concept
https://github.com/zeitlings/alfred-workflows
alfred alfred-workflow automation converter devonthink dictionary filesystem macos ocr pdf pdf-compression text-recognition window-switcher
Last synced: 14 days ago
JSON representation
Collected Alfred Workflows & Proof of Concept
- Host: GitHub
- URL: https://github.com/zeitlings/alfred-workflows
- Owner: zeitlings
- License: mit
- Created: 2023-02-05T12:52:41.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-29T12:21:15.000Z (15 days ago)
- Last Synced: 2024-10-29T14:49:51.875Z (15 days ago)
- Topics: alfred, alfred-workflow, automation, converter, devonthink, dictionary, filesystem, macos, ocr, pdf, pdf-compression, text-recognition, window-switcher
- Language: Swift
- Homepage:
- Size: 24 MB
- Stars: 220
- Watchers: 6
- Forks: 8
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
Collected Workflows
This is a collection of smaller workflows, experiments, and demonstrations of interesting concepts for writing automations with the [Alfred App](https://www.alfredapp.com/workflows/).
__Some workflows live in their own repository:__
- [µBib | Citations, BibTeX, and Research](https://github.com/zeitlings/ubib)
- [Quill | Text processing utility](https://github.com/zeitlings/alfred-quill)
- [Ayai · GPT Nexus (preview)](https://github.com/zeitlings/ayai-gpt-nexus)
- [DEVONthink 3 Portal](https://github.com/zeitlings/alfred-devonthink)
- [Logseq Workflow](https://github.com/zeitlings/alfred-logseq)
- [Ollama Workflow](https://github.com/zeitlings/alfred-ollama)
- [Default Browser](https://github.com/zeitlings/alfred-set-default-browser/)
- [Unified Search](https://github.com/zeitlings/alfred-unified-search) 
- [Calendar++](https://github.com/zeitlings/alfred-calendar)
---
**Table of Contents**
- [1. Workflows](#1-workflows)
- [1.1. Duden Workflow](#11-duden-workflow)
- [1.2. What Unicode character is this?](#12-what-unicode-character-is-this)
- [1.3. Roman Numeral Converter](#13-roman-numeral-converter)
- [1.4. DEVONthink ←→ PDF Expert](#14-devonthink--pdf-expert)
- [1.5. Define Word - A Better Dictionary](#15-define-word---a-better-dictionary)
- [1.6. AlfredOCR](#16-alfredocr)
- [1.7. Favorites](#17-favorites)
- [1.8. New File](#18-new-file)
- [1.9. Keyboard Brightness](#19-keyboard-brightness)
- [1.10. GIF from Video](#110-gif-from-video)
- [1.11. Bluetooth Device Battery](#111-bluetooth-device-battery)
- [1.12. QResolve](#112-qresolve)
- [1.13. GIF from Images](#113-gif-from-images)
- [1.14 Extract Keywords](#114-extract-keywords)
- [1.15 Color Picker](#115-color-picker)
- [1.16 PDF to Text](#116-pdf-to-text)
- [1.17 PDF Split](#117-pdf-split)
- [1.18 PDF Compress](#118-pdf-compress)
- [1.19 Scratchpad](#119-scratchpad)
- [1.20 Window Navigator](#120-window-navigator)
- [1.21 Fuzzy Search](#121-fuzzy-search)
- [1.22 PDF to Table](#122-pdf-to-table)
- [1.23 PDF to Docx](#123-pdf-to-docx)
- [2. Proof of Concept \& Demos](#2-proof-of-concept--demos)
- [2.1. Extended Hotkeys](#21-extended-hotkeys)
- [2.2. Permission Handler](#22-permission-handler)
- [2.3. GUI Input Experiment](#23-gui-input-experiment)
- [2.4. Heads-up Display](#24-heads-up-display)
---
# 1. Workflows
## 1.1. Duden Workflow
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.0.0-dude)
Search, navigate and view information from duden.de German spelling dictionary.
- ` shift ⇧ ` or `cmd ⌘+Y`: Get QuickLook previews for the landing page, grammar, and synonyms
- `cmd ⌘+L` to view the full entry contents.
- Action synonymes to list all synonyms. Action any synonym to view the entry for it.
- Action examples or idioms to list all that are available.
**Credits:** [SwiftSoup](https://github.com/scinfu/SwiftSoup)
---
## 1.2. What Unicode character is this?
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v2.0.2-uni)
[](/assets/code/WhatIsIt.swift)
The What Unicode character is this? workflow tells you which unicode character it is. Given a character or string, you will get the unicode code points, the scalar names and general categories.
### Example `ツ`
- KATAKANA LETTER TU
- `U+30C4`
- Other Letter
### Modifiers
- `⌘ cmd` yields `\u{30C4}` (swift, ES6 formatted)
- `⌥ opt` yields `\u30C4` (python, go formatted)
- `⌃ ctrl` yields `ツ` (HTML entity)
- `⇧ shift` yields `0x30C4` (hex literal)
### Inverse
Given a hex value either raw or in any of the above formattings will return its corresponding unicode character.
- `whatisit? \u{1F914}` yields info for 🤔
---
## 1.3. Roman Numeral Converter
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.2.0-rn)
[](/assets/code/RomanNumeral.swift)
Convert Roman numerals to decimal and vice versa. Accepts Arabic numbers in the range 1 to 3999.
---
## 1.4. DEVONthink ←→ PDF Expert
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v2.1.2-xdev)
Get either the DEVONthink 3 reference URL from PDF Expert, that is the x-devonthink-item page link for the active document opened in PDF Expert, the selection link if you have text selected, or the annotation link if your selection intersects an annotation and checking for annotations is enabled.
The PDF, of course, has to live in one of your open DEVONthink databases.
- `cmd ⌘` to open the PDF on the same page in DEVONthink
- `.xdev` to enable or disable opening the document in DEVONthink when using the hotkey
**Expected result A**
`x-devonthink-item://1D7FA99A-AAFF-4883-9853-F0666A650400?page=6`
**Expected result B**
`x-devonthink-item://1D7FA99A-AAFF-4883-9853-F0666A650400?page=6&start=66&length=9&search=selection`
**Expected result C**
`x-devonthink-item://1D7FA99A-AAFF-4883-9853-F0666A650400?page=6&annotation=Squiggly&x=212&y=406`
### Known issues
- Fails with documents opened in PDF Expert split view
https://user-images.githubusercontent.com/25689591/218268102-3c07c799-4906-4d2b-9e55-38691f6b0a34.mp4
## 1.5. Define Word - A Better Dictionary
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.2.0-dict)
Customizable Dictionary with Quicklook Preview - and Dark Mode.
`shift` or `cmd+Y` to preview the dictionary entry
`ctrl` to see the dictionary associated with the entry
`cmd + ⏎` to paste a word to the frontmost application (spell checker)
`cmd+C` to copy the dictionary entry's plain text to the clipboard
`cmd+L` to view the plain text as Large Type
You can define dictionaries for lookups, set the font size of the previews, or manually select a dictionary to use. The previews reflect the global appearance, i.e. they have a dark mode. The workflow also includes a preset for looking up synonyms of a word and a convenient keyboard shortcut for quick lookups. To use the workflow as a multilingual spell checker, you can use the `cmd` modifier when actioning the entry to paste the word to the frontmost application.
## 1.6. AlfredOCR
_No external dependencies are required to perform the OCR._
### 1.6.1 Alfred OCR Light
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.3.0-ocr)
[](/assets/code/AlfredOCR.swift)
The workflow allows you to copy text from images using optical character recognition. Take a snapshot with your mouse or trackpad and the recognized text is automatically copied to the clipboard.
You can also extract text from images sent to the workflow's File Action.
### 1.6.2 Alfred OCR+
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.4.1-ocr2)
The workflow allows you to copy text from images, or to convert PDF files into searchable PDF documents using optical character recognition, and to apply compression to PDF documents.
__1 / Snapshot__
Take a snapshot with your mouse or trackpad and the recognized text is automatically copied to the clipboard.
- Default shortcut: ⌘ ⇧ 6
- Default keyword: `ocr`
__2 / PDF Document__
- To convert a PDF into a searchable PDF document, pass it to the workflow's *[Universal Action](https://www.alfredapp.com/help/features/universal-actions/)*.
- To compress the resulting PDF, pass the source document on while pressing the **⌘+⇧** keys.
- To open the resulting PDF, pass the source document on while pressing the **⌥+⇧** keys.
- To force the replacement of a source document, pass it on while pressing the **⌥+⌘** keys.
- To compress a PDF without performing OCR, pass it to the `Compress PDF Document` File Action.
- To view the **progress tracker**, re-enable the workflow with the `Keyword` (default: `ocr`).
## 1.7. Favorites
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.1.0-fav)
Add files and folders to your list of favorites by using the workflow's Universal Action. Quickly find them again by activating the workflow with the Keyword (default: fav) or by setting a hotkey of your choice.
- Hit `enter` or `cmd+O` to open a file or folder.
- Add items with the workflow’s [Universal Action](https://www.alfredapp.com/help/features/universal-actions/).
- **Modifiers:**
- `ctrl`: Show full Path
- `cmd`: Reveal in Finder
- `opt`: Browse in Alfred
- `cmd+shift`: Move up
- `opt+shift`: Move down
- `fn`: Remove from Favorites
- `shift` or `cmd+Y`: Quicklook Preview
## 1.8. New File
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.3.0-nf)
The workflow allows you to quickly create new files in the Finder.
If the post-haste behavior is enabled, new files are created the same way as folders are when you use the shortcut (default: ⌥+⇧+N). Otherwise you will be prompted with the input mask where you can configure the file name and type.
The workflow will pick up on your location in the Finder and create the new file there. If you use the keyword, the most recently used Finder window will be selected as the destination. If no Finder window is currently open, the file will be created in the configurable fallback location.
__Bonus:__ In addition to all plain-text type files, the workflow can also quickly create `docx`, `doc`, `odt`, `rtf` and `rtfd` documents and Xcode `playground`s.
__Creating a new file__
- ⌘ to view the full path to the target folder.
- ↩ to create the file with configured settings.
- ⌘⇧↩ to create the file **with clipboard** contents.
- ⌥⇧↩ to create the file **without clipboard** contents.
If auto-suggest is enabled, press TAB to accept and expand the suggested filename. (new in v1.2.0)
## 1.9. Keyboard Brightness
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.1.0-kbr)
[](/assets/code/Incandescent.swift)
Adjust the keyboard backlight brightness either by using the keyword or by setting up custom shortcuts.
When using the keyword
- type > or + to increase the brightness
- type < or - to decrease the brightness
## 1.10. GIF from Video
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.1.0-gif)
The workflow allows you to convert video of popular formats to animated GIFs. To do this, it uses ffmpeg as a dependency.
### Usage
Either send a video to the workflow's [*File Action*](https://www.alfredapp.com/help/workflows/triggers/file-action/) or invoke the workflow using the keyword and search for the video file you want to convert. Then select the image size you want the resulting GIF to have from the list to start the conversion.
## 1.11. Bluetooth Device Battery
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.1.2-btb)
[](/assets/code/DeviceBattery.swift)
View the battery charge status of connected Bluetooth devices
(macOS 13.0+). Install Apple's SF Pro font to see the icons.
## 1.12. QResolve
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.1.0-qr)
[](/assets/code/QResolve.swift)
Resolve and open links from QR codes
### Usage
**A /** Take a snapshot of the QR code you want to open the link to
- Default keyword: `qrr`
- Recommended shortcut: **⌘+⇧+7**
**B /** Send an image containing the QR code to the workflow's [File Action](https://www.alfredapp.com/help/workflows/triggers/file-action/)
## 1.13. GIF from Images
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.0.0-gif2)
The workflow allows you to convert a series of still images into animated GIFs. For this, it uses ImageMagick as a dependency.
### Usage
Send a series of still images to the workflow's [*File Action*](https://www.alfredapp.com/help/workflows/triggers/file-action/) to create an animated GIF. The smallest image determines the dimensions of the result. All source images are assumed to be of the same file type, e.g. jpg or png.
## 1.14 Extract Keywords
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.0.0-kw)
Extract keywords and keyphrases from articles, books or other documents with YAKE!
### Usage
- Send `PDF`, `docx`, `doc`, `rtf` or `txt` documents to the workflow's File Actions
- Pass the text from your selection in macOS on to the workflow's Universal Action
- Use the keyword and paste your text (default: `kw`)
### Dependencies
The workflow relies on **Python3** to install the YAKE standalone.
#### YAKE!
- `pip install git+https://github.com/LIAAD/yake`
- [official installation guide](https://github.com/LIAAD/yake/#option-3-standalone-installation-for-development-or-integration)
#### pdftotext
- `brew install poppler`
- [formula on brew.sh](https://formulae.brew.sh/formula/poppler)
## 1.15 Color Picker
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.3.4-cp) [](/assets/code/ColorPicker.swift)
Pick a color to get its hex, rgba, hsl representation or NSColor initializer.
### Usage
Activate the *Color Sampler* with the keyword (default: `cp`) and pick the desired color.
### Color History
To review previously picked colors, activate the workflow with the keyword preceded by a colon (default: `:cp`).
## 1.16 PDF to Text
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.0.0-pdftotext)
Extract text from PDF documents.
### Usage
Extract the entire text from one or more PDFs by sending them to the workflow's [File Action](https://www.alfredapp.com/help/workflows/triggers/file-action/) or locate a PDF with the [File Filter](https://www.alfredapp.com/help/workflows/inputs/file-filter/) by using the keyword (default: `pdftotext`). To extract the text from specific pages of a single document, use the ⌘ modifier. The result will be exported as a plain text document.
#### File Filter
- ↩ Proceed to extract the entire text.
- ⌘↩ Proceed by specifing the pages to extract.
- ⌃↩ Proceed, push the result to the [File Buffer](https://www.alfredapp.com/help/features/file-search/#file-buffer) and [action it in Alfred](https://www.alfredapp.com/help/features/universal-actions/).
#### File Action
- ↩ Proceed to extract the entire text.
- ⌘↩ Proceed by specifing the pages to extract (single file only).
- ⌃↩ Proceed, push the result(s) to the [File Buffer](https://www.alfredapp.com/help/features/file-search/#file-buffer) and [action them in Alfred](https://www.alfredapp.com/help/features/universal-actions/).
#### Specifying the Pages
- ↩ Proceed to extract text from the specified pages.
- ⌘↩ Preview the first and last PDF pages w/ Alfred's PDF View.
- ⌥↩ Preview the contents of the first and last page w/ Alfred's Text View.
- ⌃↩ Proceed, push the result to the [File Buffer](https://www.alfredapp.com/help/features/file-search/#file-buffer) and [action it in Alfred](https://www.alfredapp.com/help/features/universal-actions/).
Press ↩ to return to the view where you can set the start and end pages.
### Dependencies
- With [Homebrew](https://brew.sh/) install
- Poppler: `brew install poppler`
## 1.17 PDF Split
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.0.0-pdfsplit)
Easily extract a specific page range from an existing PDF document and create a new PDF file with the selected pages.
### Usage
Either invoke the workflow by using the keyword (default: `pdfsplit`) and locate a PDF, or send a PDF to the workflow's [File Action](https://www.alfredapp.com/help/workflows/triggers/file-action/). Specify the start and end pages of the range you want to be extracted. The specified first and last page can be previewed by pressing the ⌘ modifier.
#### Specifying the Pages
- ↩ Proceed to extract text from the specified pages.
- ⌘↩ Preview the first and last PDF pages w/ Alfred's PDF View.
- ⌥↩ Proceed, push the result to the [File Buffer](https://www.alfredapp.com/help/features/file-search/#file-buffer) and [action it in Alfred](https://www.alfredapp.com/help/features/universal-actions/).
Press ↩ to return to the view where you can set the start and end pages.
### Dependencies
- With [Homebrew](https://brew.sh/) install
- Poppler: `brew install poppler`
## 1.18 PDF Compress
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.0.1-pdfcompress)
Compress PDF documents.
### Usage
Either invoke the workflow by using the keyword (default: `pdfcompress`) and locate a PDF, or send a PDF to the workflow's "Compress PDF Document" [File Action](https://www.alfredapp.com/help/workflows/triggers/file-action/).
A compression preset can be selected by pressing ⌥ before proceeding with ↩.
#### File Filter
- ↩ Proceed to compress the PDF using the default strategy.
- ⌥↩ Select a compression preset.
#### File Action
- ↩ Proceed to compress the PDF using the default strategy.
- ⌥↩ Select a compression preset.
#### Compression Presets
- ↩ Proceed to compress the PDF using the selected strategy.
The result will be a compressed document in the same location as the source PDF file.
### Dependencies
- With [Homebrew](https://brew.sh/) install
- Ghostscript: `brew install gs`
## 1.19 Scratchpad
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.2.0-pad)
Quickly access up to 9 scratchpads for spontaneous note-taking.
🟡 🟠 🔴 🟣 🔵 🟢
### Usage
Press the keyboard shortcut to open the scratchpad that was last used.
Press the keyboard shortcut again or ⎋ to dismiss the scratchpad without saving.
In __Editing Mode__
* ⌘⏎ to save changes¹
* ⇧⏎ to preview as rendered markdown
* ⌥⏎ to view all pads and search your notes²
* ⌘⇧⏎ to cycle through your scratchpads
In __Markdown Mode__
* ⏎ or ⇧⏎ to start editing
* ⌥⏎ to view all pads and search your notes²
* ⌘⇧⏎ to cycle through your scratchpads
* ⎋ to either cancel or go back through previously viewed pads
Press the secondary keyboard shortcut or enter the workflow's keyword (default: `pad`) to view all scratchpads and to search their contents.
__Notes:__
¹ Changes are also saved when previewing and when switching the active pad.
² When searching for a pad containing a keyword, the first matching line will be used as subtitle. Press ⌘L to view the matched line as [Large Type](https://www.alfredapp.com/help/features/large-type/).
## 1.20 Window Navigator
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.3.0-winnav) [](/assets/code/WindowNavigator/WindowNavigator.swift) [](/assets/code/WindowNavigator/AccessibilityBridgingHeader.h)
Navigate to any window of the currently focused application or any application across all desktops, or switch windows within the current desktop space.
> [!NOTE]
> macOS 15 deprecates an API that Window Navigator uses to retrieve window information. Already compiled executables will continue to work as expected, but compilation will fail if you try to run the workflow for the first time with macOS 15.
> I'm investigating a solution to this problem.
### Usage
1. Search the windows of the active app globally using the Navigator keyword.
2. Search app windows in the current desktop space using the Switcher keyword.
3. Search all visible windows of all apps globally using the Global keyword.
* ↩ to navigate to the selected window.
* ⌘↩ to close the selected window.
* ⌥↩ to quit the owning application.
#### 1. Navigator
#### 2. Switcher
#### 3. Global
## 1.21 Fuzzy Search
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.0.0-fuzzy)
Limited scope fuzzy search.
- use fzf for classic matching
- use fzf-abbrev for initial character matching
## 1.22 PDF to Table
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.0.0-pdftable)
Extract tables from PDF documents as CSV.
### Usage
Extract tables from PDFs via the [Universal Action](https://www.alfredapp.com/help/features/universal-actions) and export them as CSV.
- Use __PDF to Table (Lattice)__ if there are ruling lines separating each cell
- Use __PDF to Table (Stream)__ if there are no ruling lines separating each cell
### Dependencies
- [Java](https://www.java.com/en/download/help/mac_install.html) (Information on installing Java)
* [Java for macOS download page](https://www.java.com/en/download/)
- [Tabula](https://github.com/tabulapdf/tabula-java) (The jar file is included in this workflow)
## 1.23 PDF to Docx
[](https://github.com/zeitlings/alfred-workflows/releases/tag/v1.1.1-pdfdocx)
Convert PDFs to Word documents.
### Setup
- Install [pdf2docx](https://github.com/ArtifexSoftware/pdf2docx) via the command line: `pip install pdf2docx`
### Usage
Convert PDFs to Word documents (docx) via the [Universal Action](https://www.alfredapp.com/help/features/universal-actions).
---
# 2. Proof of Concept & Demos
## 2.1. Extended Hotkeys
__Modifier Palettes & Double Tap Hotkeys.__ Proof of concept and demo implementation of modifier palettes to invoke actions on consecutive keystrokes in Alfred.
Modifier Palette example behavior.
- `⌥O`, `⌥K` To trigger action A.
- `⌥I`, `⌥K` To trigger action B.
Double-Tap Hotkey example behavior
- `⌃+`, `⌃+` To trigger action.
### Details
The core idea is to inject environment variables into the workflow configuration and to modify them with some delay.
- To set up modifier palettes, all you have to do is define an identifier on any hotkey, `⌥O`, such as "`openA`". This is the "text" argument that the hotkey passes on as `{query}`. Set the identifier to some *environment* variable, say "`gate`", and use a downstream `conditional object` triggered by a different hotkey, `⌥K`, to check if the variable (`{var:gate}`) is equal to the identifier `openA`. Any action that you make depend on this condition will be triggered iff `gate` is equal to `openA`, i.e. if you have recently tapped the hotkey associated with the identifier.
- To set up double-tap hotkeys, proceed in the same way, defining an identifier for the hotkey's "text" argument. For each double tap hotkey, an environment variable is injected that is either `0` or `1` for inactive or active.
`Disclaimer`: Alfred may crash if you get the timing of the keystrokes just right. This is due to a data race where the same variable ("`gate`") is accessed and modified by different threads at the same time. Also, for the double-tap hotkeys, there is some "bleed" into the other hotkeys with the way it is set up in the demo. Tapping a, then b, will also trigger b, instead of having to tap b twice.
---
## 2.2. Permission Handler
An example of how to handle permissions gracefully for your executables. (For now, take a look at the *Duden Workflow* that implements the permission handler).
## 2.3. GUI Input Experiment
[](/assets/code/Dialog.swift)
Run a graphical prompt and read the input. Proof of concept for using NSWindow and SwiftUI components to get user input through a graphical prompt and then use it in the Alfred app - or on the command line.
## 2.4. Heads-up Display
[](/assets/code/HUD.swift)
Demo for displaying notifications on a heads-up display.
The script takes two arguments:
- The text to display
- The width of the prompt
