The community of Alfred workflow creators spans the world, and the breadth of the Mac ecosystem.
To help new workflow creators share their work, Vítor Galvão, long-time Alfred workflow creator and community member, wrote this guide to sharing your workflows on GitHub.
First, we'll take a look at how to host your workflows on GitHub, which is free, then at the fun part - sharing your workflows with your friends and colleagues.
Part 1: Hosting the Workflow
Typical file hosting services are rife with tradeoffs, usually offering short-lived links. Ideally you'll want to share your Workflow somewhere free of transfer and storage costs, with an established reputation, and that allows you update to your work.
GitHub ticks all the boxes, but it may be daunting to know where to start if you're not a technical person. We'll demystify the process.
- Signup for GitHub. You'll set up your email, password, and username.
- If you're redirected to a "Welcome to GitHub" or similar page where they ask about you or your team, feel free to ignore it.
- Create a new repository (the page where your Workflow will live).
Repository nameto something short but descriptive. Example:
Initialize this repository with, tick the
Add a README filebox.
- You will be redirected to your Workflow's repository page on GitHub. Save the URL in the address bar, it's what you'll share with other people.
- Open Alfred Preferences, go to
Workflowsand locate yours.
- Right-click your Workflow in the list and
Open in Finder. Copy it to your Desktop.
IMPORTANT: If you're not using the Finder's Column View, you'll be looking at the files of your Workflow. In that case, go to the menubar and click
Enclosing Folder(⌘↑) to ensure you're selecting the folder of the Workflow.
- Right-click your Workflow in Alfred Preferences again and
Export.... Save it to your Desktop.
- Drag and drop both into the browser window.
- You will be redirected. Press
Commit changesat the bottom of the new page.
- Redirected again, to the main page. On the bottom division you'll see a preview of your README.md. At the moment it contains the name of your repository in big letters. Click the pencil icon to the right to edit it.
- The file uses Markdown. If you don't know what that is, don't worry about it and write normally. Describe what your Workflow does and how to use it. Use the
About this Workflowtext as inspiration.
Commit changesat the bottom.
Part 2: Sharing the Workflow
Finally, the easy part. Share your Workflow on the official Alfred Forums. For the description, get inspiration from the GitHub's README. Include the link you saved in step 3.
To be extra helpful, include a direct download of the Workflow. To get the link, click the
.alfredworkflow file in your repository's main page and copy it from
That's it! You've learned the basics of sharing a Workflow for prosperity. Thank you for being part of the community.