Sudoroom Door Shortcut for iPhone - Revision history

Jerkey: /* Troubleshooting: */

2026-10-11T01:41:48Z

Troubleshooting:

← Older revision		Revision as of 18:41, 10 October 2026
Line 93:		Line 93:

	* the URL		* the URL
	* that the credentials are entered as ~~USERNAME~~:~~PASSWORD~~		* that the credentials are entered as username:password (all lowercase!)
	* that Base64 uses no line breaks		* that Base64 uses no line breaks
	* and that the Authorization header contains the word Basic followed by a space and the b64creds variable		* and that the Authorization header contains the word Basic followed by a space and the b64creds variable

Alessandranomaly: minor edits to fix

2026-10-08T14:31:06Z

minor edits to fix

← Older revision		Revision as of 07:31, 8 October 2026
Line 7:		Line 7:
	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.		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~~.		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 "Under the hood" section at the end explains each step.

	== How it Works: ==		== How it Works: ==

Alessandranomaly: /* Check Your Work */

2026-10-08T02:47:57Z

Check Your Work

← Older revision		Revision as of 19:47, 7 October 2026
Line 72:		Line 72:

	Tap the ▶ play button to test it. If the door responds, you’re done.		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.

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


	[[File:5 full shortcut.png\|frame\|left]]		[[File:5 full shortcut.png\|frame\|left]]


	== Make it one tap ==		== Make it one tap ==

Alessandranomaly: /* Make it one tap */

2026-10-08T02:45:34Z

Make it one tap

← Older revision		Revision as of 19:45, 7 October 2026
Line 84:		Line 84:
	* 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.)		* 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.		* Siri: say “Hey Siri,” followed by the shortcut’s name.
	* Lock Screen, Control Center, or ~~Action button: add it as a Shortcut control in your iPhone settings for those features.~~		* Lock Screen, Control Center, or Widget pull-down menu

	== Troubleshooting: ==		== Troubleshooting: ==

Alessandranomaly: /* Step 2: */

2026-10-08T02:43:52Z

Step 2:

← Older revision		Revision as of 19:43, 7 October 2026
Line 34:		Line 34:
	=== Step 2: ===		=== Step 2: ===

	~~Encode: convert it to Base64~~		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.
	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.

	[[File:2 encode base64.png\|frame\|left]]		[[File:2 encode base64.png\|frame\|left]]


	=== Step 3: ===		=== Step 3: ===

Alessandranomaly: /* Step 3: */

2026-10-08T02:43:23Z

Step 3:

← Older revision		Revision as of 19:43, 7 October 2026
Line 42:		Line 42:
	=== Step 3: ===		=== Step 3: ===

	~~Set Variable: name the result b64creds~~		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.
	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.

	[[File:3 set variable.png\|frame\|left]]		[[File:3 set variable.png\|frame\|left]]

Alessandranomaly: /* Step 4: */

2026-10-08T02:42:37Z

Step 4:

← Older revision		Revision as of 19:42, 7 October 2026
Line 49:		Line 49:
	=== Step 4: ===		=== Step 4: ===

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

	===== Configure it like this: =====		===== Configure it like this: =====
Line 65:		Line 64:
	===== Common mistake: =====		===== 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.		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 ==		== Check Your Work ==

Alessandranomaly at 02:39, 8 October 2026

2026-10-08T02:39:26Z

← Older revision		Revision as of 19:39, 7 October 2026
Line 25:		Line 25:
	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.		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: ==		=== Step 1: ===

	Add a Text action. Type the username, a colon, and the password, all on one line with no spaces:		Add a Text action. Type the username, a colon, and the password, all on one line with no spaces:
Line 32:		Line 32:
	[[File:1 text action.png\|frame\|left]]		[[File:1 text action.png\|frame\|left]]

	== Step 2: ==		=== Step 2: ===

	Encode: convert it to Base64		Encode: convert it to Base64
Line 40:		Line 40:


	== Step 3: ==		=== Step 3: ===

	Set Variable: name the result b64creds		Set Variable: name the result b64creds
Line 47:		Line 47:
	[[File:3 set variable.png\|frame\|left]]		[[File:3 set variable.png\|frame\|left]]

	== Step 4: ==		=== Step 4: ===

	Get Contents of URL: send the request		Get Contents of URL: send the request

Alessandranomaly at 02:38, 8 October 2026

2026-10-08T02:38:53Z

← Older revision		Revision as of 19:38, 7 October 2026
Line 25:		Line 25:
	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.		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: ===		== Step 1: ==

	Add a Text action. Type the username, a colon, and the password, all on one line with no spaces:		Add a Text action. Type the username, a colon, and the password, all on one line with no spaces:
Line 32:		Line 32:
	[[File:1 text action.png\|frame\|left]]		[[File:1 text action.png\|frame\|left]]

	=== Step 2: ===		== Step 2: ==

	Encode: convert it to Base64		Encode: convert it to Base64
Line 40:		Line 40:


	=== Step 3: ===		== Step 3: ==

	Set Variable: name the result b64creds		Set Variable: name the result b64creds
Line 47:		Line 47:
	[[File:3 set variable.png\|frame\|left]]		[[File:3 set variable.png\|frame\|left]]

	=== Step 4: ===		== Step 4: ==

	Get Contents of URL: send the request		Get Contents of URL: send the request

Alessandranomaly at 02:36, 8 October 2026

2026-10-08T02:36:52Z

← Older revision		Revision as of 19:36, 7 October 2026
Line 37:		Line 37:
	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.		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.

	[[File:2 encode base64.png\|~~thumb~~\|~~alt=Encode with base64, Line Breaks set to None.~~]]		[[File:2 encode base64.png\|frame\|left]]


	=== Step 3: ===		=== Step 3: ===
Line 44:		Line 45:
	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.		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.

	[[File:3 set variable.png\|~~thumb~~\|~~alt=Save the Base64 output as b64creds~~]]		[[File:3 set variable.png\|frame\|left]]

	=== Step 4: ===		=== Step 4: ===
Line 50:		Line 51:
	Get Contents of URL: send the request		Get Contents of URL: send the request
	Add a Get Contents of URL action. This is the step that actually contacts sudoroom.		Add a Get Contents of URL action. This is the step that actually contacts sudoroom.


	===== Configure it like this: =====		===== Configure it like this: =====
Line 60:		Line 60:

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

			[[File:4 get contents of url.png\|frame\|left]]

	===== Common mistake: =====		===== 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.		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.

	~~[[File:4 get contents of url.png\|thumb\|alt=The finished request: GET, plus the Authorization header]]~~


Line 79:		Line 79:
	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.		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.

	[[File:5 full shortcut.png\|~~thumb~~\|~~alt=complete shortcut with credentials redacted~~]]
			[[File:5 full shortcut.png\|frame\|left]]


	== Make it one tap ==		== Make it one tap ==