Sudoroom Door Shortcut for iPhone

Recreate the iPhone shortcut that opens the sudoroom door with a widget on your phone.

Keep your credentials private!

The door username and password are not in this guide, and the screenshots are redacted. Please don’t post them on the wiki, in chat, or anywhere public. Once you’ve built the shortcut, the password is stored in it in readable form. Don’t share the shortcut file (the Share button exports the password along with it). Point people to this guide instead.

This guide walks you through building an Apple Shortcut that asks the sudoroom server to open the door. You don’t need any technical background: follow the numbered steps and you’ll be done in about five minutes. If you’re curious about what’s actually happening, the blue Under the hood boxes explain each piece. Skip them if you just want it working.

How it Works:

When you tap this shortcut, your iPhone sends a short message over the internet to a computer at sudoroom. That message includes your username and password, so the computer knows you’re allowed in. If they check out, the computer then runs the door-opening program with your credentials.

Tap shortcut → phone sends request + login → room.sudoroom.org checks login → door program runs

Before you start, you need:

An iPhone or iPad with Apple’s Shortcuts app (it comes preinstalled; re-download it free from the App Store if you deleted it)
Your current door username and password (you should have received when you became a member)
An internet connection (Wi-Fi or cellular). You don’t need to be on the sudoroom network.

Build the Shortcut:

Open Shortcuts, tap + to create a new shortcut, and name it something like “sudoroom Door.” You’ll add four actions, in order. To add an action, tap the search bar at the bottom of the screen and type its name.

Step 1:

Add a Text action. Type the username, a colon, and the password, all on one line with no spaces: USERNAME:PASSWORD

Step 2:

Add an "Encode" action directly below the Text action. Make sure it says Encode Text with base64, then tap to expand it and set Line Breaks to None.

Step 3:

Add a "Set Variable" action. Name the variable b64creds. It should automatically show Base64 Encoded as its value; if not, tap the value and choose the Base64 Encoded result from Step 2.

Step 4:

Add a "Get Contents of URL" action. This is the step that actually contacts sudoroom.

Configure it like this:

URL: https://room.sudoroom.org/cgi-bin/omninidoor-wait-and-lock.sh
Method: GET
Header name: Authorization
Header value: Basic followed by the b64creds variable

To add the header, tap Headers, then Add new header. In the value field type Basic and a space, then tap the variable bar above the keyboard and pick b64creds. It should appear as an orange variable bubble, as in the screenshot.

Common mistake:

If you type the letters “b64creds” instead of picking the variable, the shortcut sends that literal word as your password and the door won’t open. Look for the orange bubble.

Check Your Work

Your shortcut should have exactly four actions, in this order:

Text: USERNAME:PASSWORD
Encode: Text with base64, Line Breaks = None
Set Variable: b64creds = Base64 Encoded
Get Contents of URL: the door URL, Method GET, header Authorization = Basic + b64creds

Tap the ▶ play button to test it. If the door responds, you’re done.

Optional:

Add a Show Result action at the end. It will pop up whatever the server sends back, which is very handy when something isn’t working.

Make it one tap

Once it works, put it somewhere quick to reach:

Home Screen: long-press the shortcut in the Shortcuts app → Share → Add to Home Screen. (Here “Share” only adds an icon; it doesn’t send the shortcut to anyone.)
Siri: say “Hey Siri,” followed by the shortcut’s name.
Lock Screen, Control Center, or Widget pull-down menu

Troubleshooting:

If it does not work, verify the following:

the URL
that the credentials are entered as USERNAME:PASSWORD
that Base64 uses no line breaks
and that the Authorization header contains the word Basic followed by a space and the b64creds variable

If the door password changes, just edit the Text action in Step 1. Nothing else needs to change.

If it still doesn’t work:

Add a Show Result action at the end (see above) and run the shortcut again, then match what you see:


What you See	Likely Cause	Fix
“401 Unauthorized” or “Authorization Required”	The server rejected your login	Check for spaces or typos in the Text action; confirm Line Breaks = None; confirm the header value is Basic, a space, then the b64creds bubble; ask whether the password has changed
“404 Not Found”	Typo in the URL	Compare the URL against the table in Step 4, character by character
“Could not connect” or a timeout	No internet, or the server is down	Check your connection; if others can’t open the door either, the server may be down
No error, but the door does nothing	The request went through; the problem is on the door side	Ask in the SudoRoom channel; the hardware may need attention

To rule out your phone entirely, run the curl command from the “How it works” section. Adding -i shows the HTTP status code (200 means success, 401 means bad credentials). If curl works and the shortcut doesn’t, the problem is in the shortcut setup.

Under the hood

The shortcut makes a single HTTPS GET request to a CGI shell script on room.sudoroom.org, authenticated with HTTP Basic Authentication. Basic auth means the client sends a header of the form Authorization: Basic \<base64(user:pass)\> and the web server checks it before running the script. If you have a terminal handy, this one command does exactly what the shortcut does: curl -u 'USERNAME:PASSWORD' https://room.sudoroom.org/cgi-bin/omnindoor-wait-and-lock.sh The shortcut just rebuilds that request by hand, because Shortcuts has no built-in “username/password” option for web requests.