THIS WEEK'S SPONSOR:

Boom 3D

Enjoy Immersive Audio on Your Mac


WordleBot: A Shortcut to Annotate Your Wordle Results with Scores

WordleBot for iPhone.

WordleBot for iPhone.

Update, January 18: I have released version 1.1 of WordleBot with support for converting emoji results to a single image. You can read the article here and redownload the updated shortcut below.

I, like the rest of the Twitter over the past few weeks, have fallen in love with Wordle, Josh Wardle’s ingenious daily word game (if you somehow missed it, check out Wardle’s profile in The New York Times). It’s so refreshing to have something so disarmingly simple, yet challenging that isn’t out to scam us (although some have tried) or sell our data on the Internet these days. Wordle reminds me of Brain Age for Nintendo DS in its heyday: everyone I know does it and is talking about it, at least for now. For me, Wordle has become this nice, daily ritual that I try to complete with my girlfriend to improve our English skills.

Wordle is a web app, and it comes with a clever built-in sharing feature that lets you share your results with other people by visualizing them as emoji of different colors based on the letters you guessed in the daily puzzle. I’m sure you’ve seen those tweets featuring lots of green and yellow emoji pass by on your timeline. While I think Wordle’s default sharing mechanism is fun, on-brand, and already iconic, I don’t like how its output is not accessible or descriptive enough. Folks with visual impairments such as colorblindness may find the emoji-laden Wordle tweets nearly impossible to decipher; those blocks of emoji don’t play well with screen-reading technologies such as VoiceOver; and, I just thought it’d be useful to figure out a way to score each line of the puzzle to bring some additional context to your Wordle results.

So, I made WordleBot, a shortcut that takes Wordle’s default shareable text and reformats it with partial and perfect scores for each line. With WordleBot, you’ll be able to share results that keep the original Wordle aesthetic and format but also include scores for 🟨 and 🟩 letters on each line, like this tweet:

WordleBot works with successful results shared from the Wordle web app (I assume that if you fail to complete a puzzle, you likely don’t want to brag about it). Once you’re done with a Wordle puzzle, hit the Share button, select WordleBot from the share sheet, and voilà – WordleBot will reformat your Wordle results to include scores for each line. The reformatted results are automatically copied to the clipboard, so you can paste them in other apps and share them – with more context around the emoji – with everyone else who’s currently obsessed with this word game.

Running WordleBot from the share sheet.

Running WordleBot from the share sheet.

Allow me to point out a few interesting details about WordleBot. For starters, if you’re not using the default yellow and green emoji (Wordle has an option for high-contrast colors) or want to change the words “partial” and “perfect” I’m using in the shortcut, you can modify what WordleBot should look for in the ‘Dictionary’ action toward the beginning of the shortcut, pictured below.

If you want to modify the emoji used by Wordle or the meaning of scores, edit this action.

If you want to modify the emoji used by Wordle or the meaning of scores, edit this action.

Furthermore, WordleBot is a nice example of how advanced actions in the Shortcuts app can seamlessly work behind the scenes to produce results that look “simple” and obvious, which is what I love about user automation. Under the hood, WordleBot uses two different regular expressions to parse Wordle’s shareable text and breaks it down in two different components: the first line of text (which shows in how many turns the game was completed) and the block of emoji. Then, I used a repeat loop to iterate over every line of emoji and run another regular expression that counts how many partial and perfect guesses are found on each line. The shortcut takes advantage of the ‘Add to Variable’ and ‘Combine Text’ actions to assemble reformatted results.

The regular expressions that power WordleBot.

The regular expressions that power WordleBot.

Thanks to Shortcuts’ integration with the share sheet and clipboard, WordleBot can read results passed from Safari, reformat them, and put them back into the system clipboard. However – and this is new in iOS/iPadOS 15 and macOS Monterey – if you don’t run WordleBot from the share sheet, it’ll automatically try to get text from your clipboard instead. This way, if you play Wordle on your Mac, you can still take advantage of WordleBot by copying results first then manually running the shortcut since Monterey doesn’t feature any share sheet support for the Shortcuts app.

Like I said above, Wordle is one of my favorite things on the Internet lately; I think it resonates with people because we could all use something pure and focused that hasn’t been contaminated with NFTs the latest Silicon Valley fad. I wanted to make something to complement my daily Wordle habit, and I hope you’ll find WordleBot as useful as I did.

You can download WordleBot for free below and find it in the MacStories Shortcuts Archive.

WordleBot

Reformat results for a completed Wordle game to include scores for partial and perfect guesses on each line. The shortcut can ouput results as reformatted emoji or as a single image saved to the Photos app.

Get the shortcut here.

Unlock More with Club MacStories

Founded in 2015, Club MacStories has delivered exclusive content every week for over six years.

In that time, members have enjoyed nearly 400 weekly and monthly newsletters packed with more of your favorite MacStories writing as well as Club-only podcasts, eBooks, discounts on apps, icons, and services. Join today, and you’ll get everything new that we publish every week, plus access to our entire archive of back issues and downloadable perks.

The Club expanded in 2021 with Club MacStories+ and Club Premier. Club MacStories+ members enjoy even more exclusive stories, a vibrant Discord community, a rotating roster of app discounts, and more. And, with Club Premier, you get everything we offer at every Club level plus an extended, ad-free version of our podcast AppStories that is delivered early each week in high-bitrate audio.

Choose the Club plan that’s right for you:

  • Club MacStories: Weekly and monthly newsletters via email and the web that are brimming with app collections, tips, automation workflows, longform writing, a Club-only podcast, periodic giveaways, and more;
  • Club MacStories+: Everything that Club MacStories offers, plus exclusive content like Federico’s Automation Academy and John’s Macintosh Desktop Experience, a powerful web app for searching and exploring over 6 years of content and creating custom RSS feeds of Club content, an active Discord community, and a rotating collection of discounts, and more;
  • Club Premier: Everything in from our other plans and AppStories+, an extended version of our flagship podcast that’s delivered early, ad-free, and in high-bitrate audio.