Collected Workflows

This is a collection of smaller workflows, experiments, and demonstrations of interesting concepts for writing automations with the Alfred App.

__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.1. Duden Workflow
  • 1.2. What Unicode character is this?
  • 1.3. Roman Numeral Converter
  • 1.4. DEVONthink ←→ PDF Expert
  • 1.5. Define Word - A Better Dictionary
  • 1.6. AlfredOCR
  • 1.7. Favorites
  • 1.8. New File
  • 1.9. Keyboard Brightness
  • 1.10. GIF from Video
  • 1.11. Bluetooth Device Battery
  • 1.12. QResolve
  • 1.13. GIF from Images
  • 1.14 Extract Keywords
  • 1.15 Color Picker
  • 1.16 PDF to Text
  • 1.17 PDF Split
  • 1.18 PDF Compress
  • 1.19 Scratchpad
  • 1.20 Window Navigator
  • 1.21 Fuzzy Search
  • 1.22 PDF to Table
  • 1.23 PDF to Docx
• 2. Proof of Concept \& Demos
  • 2.1. Extended Hotkeys
  • 2.2. Permission Handler
  • 2.3. GUI Input Experiment
  • 2.4. Heads-up Display

---

1. Workflows

1.1. Duden Workflow

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

---

1.2. What Unicode character is this?

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

Convert Roman numerals to decimal and vice versa. Accepts Arabic numbers in the range 1 to 3999.

---

1.4. DEVONthink ←→ PDF Expert

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

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

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+

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.

  • 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

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.
• 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

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 playgrounds.

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

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

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 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

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

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

1.13. GIF from Images

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 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

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

pdftotext

• brew install poppler
• formula on brew.sh

1.15 Color Picker

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

Extract text from PDF documents.

Usage

Extract the entire text from one or more PDFs by sending them to the workflow's File Action or locate a PDF with the 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 and action it in Alfred.

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 and action them in Alfred.

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 and action it in Alfred.

Press ↩ to return to the view where you can set the start and end pages.

Dependencies

• With Homebrew install
• Poppler: brew install poppler

1.17 PDF Split

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. 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 and action it in Alfred.

Press ↩ to return to the view where you can set the start and end pages.

Dependencies

• With Homebrew install
• Poppler: brew install poppler

1.18 PDF Compress

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.

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 install
• Ghostscript: brew install gs

1.19 Scratchpad

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.

1.20 Window Navigator

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

Limited scope fuzzy search. use fzf for classic matching use fzf-abbrev for initial character matching

1.22 PDF to Table

Extract tables from PDF documents as CSV.

Usage

Extract tables from PDFs via the Universal Action 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 (Information on installing Java)
  • Java for macOS download page
• Tabula (The jar file is included in this workflow)

1.23 PDF to Docx

Convert PDFs to Word documents.

Setup

• Install pdf2docx via the command line: pip install pdf2docx

Usage

Convert PDFs to Word documents (docx) via the Universal Action.

---

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

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

Demo for displaying notifications on a heads-up display.
The script takes two arguments:

• The text to display
• The width of the prompt