EarWorm Integration User Guide

Unifi

EarWorm

A spectator chooses a song on a phone that is not yours. A few seconds later the title is in your ear, on a Notifier, or feeding a prompt that turns it into a reveal.

The complete guide is below: connecting EarWorm, how Unifi OS listens and what counts as a new choice, every Lookup Type, what each destination receives, speech and how to silence it, and five routines built end to end. Twenty-six findings are documented in full. 13 sections, 44 pages, 2 figures.

Download the guide — PDF, 2.1 MB

Real screens · every behavior traced to the app source

Section 1

What EarWorm is.

An address on the internet that holds one value at a time, and a phone that keeps asking what it is. What turns it into a method is everything Unifi OS does with the value afterwards.

The mechanism, in one paragraph

EarWorm is a web service outside Unifi OS. You give Unifi OS your EarWorm address as the Server URL, and while Enable is on it asks that address for its current value, waits your Polling Interval, and asks again. When the value differs from the last one it remembered, it becomes a reveal. It goes through Lookup Type, which can leave it alone or turn it into a place, a date, a time or a card cut, and on to every destination selected on EarWorm’s Automations screen.

The app’s own note describes EarWorm’s data as song or lyric data. Unifi OS does not care what the value is: a title, a lyric, a word or a number is handled the same way.

Settings App Integration. EarWorm is the sixth of sixteen integrations. This screen was captured with the phone in dark mode. — **Settings → App Integration.** EarWorm is the sixth of sixteen integrations. This screen was captured with the phone in dark mode.

What the app can and cannot tell you

What this guide establishes

Everything Unifi OS does: when it asks, what it accepts and ignores, what counts as a new value, what each lookup returns, what the Notifier displays, which destination receives what, and which rows work. All of it was read from the app’s source, and the tables that can be recomputed are recomputed every time this guide is built.

What it cannot

What the spectator sees. Who makes EarWorm, what its page offers a spectator, how your address is issued and what it holds between shows are decided by EarWorm, and none of it is in the source available here. For all of that, rely on whoever supplied your EarWorm account, and rehearse on the page you will use.

Why that matters in performance

Every routine in this guide is built from the half that is established. Where a routine depends on the other half, it says so and tells you what to check before you rely on it.

Four things to set, and two to watch

What	Where	Section
Your address	Server URL, Enable and Polling Interval	3
What happens to the value	Lookup Type, eighteen options	5
Where it goes	EarWorm → Automations	6
Whether it is spoken aloud	Not where you would expect. Read this before your first performance	8
Five rows that mislead	Phantom Studio, Calculator Studio, Image to Notifier and both P.E.S. rows	6
Whether it is still listening	A check that never gets an answer stops it until you save or relaunch	4

Out of the box, the spectator’s choice is read aloud by the phone. Speech starts switched on, and clearing it on EarWorm’s own Automations screen does not stop it. Section 8 explains why and gives you three ways to silence it (EW-03).

Section 2

EarWorm in one minute.

The whole integration, before any of the detail.

Question	Answer
Where is it?	Settings → App Integration → EarWorm, sixth in the list
Does it need a purchase in Unifi OS?	No. You need an EarWorm address
What does it receive?	One value at a time: whatever your address holds
How fast?	Your Polling Interval, in seconds, plus the time the address takes to answer
Does the same value fire twice?	Not in a row, even days apart
How many lookups?	18
How many destinations?	31, of which 5 do not work as labeled
Which start switched on?	Speech, and Notifier on a fresh install (EW-18)
What stops it?	Switching Enable off, not being logged in when the app opens, an address the phone cannot form, or a check that never gets an answer

The five-minute setup

Open it. Settings → App Integration → EarWorm → Settings.
Connect your address. Type a name into Integration Name, switch Enable on, and paste your whole EarWorm address, beginning https://, into Server URL.
Fill in Polling Interval. It cannot be left empty. Type 2 for a two-second check. Leave Lookup Type at None for now.
Press Save. You need an internet connection. The app confirms and starts listening straight away.
Choose where the value goes. Back on the EarWorm screen, open Automations, select your destinations, and press Save there too.
Silence the phone. Section 8, before you hand anyone the page.

Make a junk choice first. Whatever your address holds fires when Unifi OS starts listening, if it differs from the value this phone remembers — for example a choice made on your page while the app was closed. Make a meaningless choice on your page before the performance and let that be the value that fires. It goes everywhere a real value goes — posted, texted, drawn and spoken by every selected row — so choose something harmless to see in public. Section 4.

Section 3

Connecting EarWorm.

One screen, three groups, seven controls. Two fields must be filled in before Save will work — whether you are switching EarWorm on or off.

Finding it

Settings → App Integration → EarWorm. The EarWorm screen has two groups. Under Settings is a single Settings row, which opens everything in this section. Under Automation is Automations, which is Section 6.

EarWorm does not need a purchase in Unifi OS, and none of its own rows are gray or locked.

No capture of the EarWorm screens was available for this edition. The labels below are the app’s own English wording; the order of the rows is taken from the app’s layout file. If your screen differs, your screen is right.

Connection

Row	Factory	What it does
Integration Name	empty	A label for you. When you save with a Notifier connected and Enable on, this name is scrolled across the Notifier as a check that it is listening (EW-15). It is not shown with EarWorm’s results on the Status screen (EW-14).
Enable	off	Unifi OS asks your address for new values only while this is on. Saving with it on starts listening immediately, and the first time adds an EarWorm panel to the Status screen (EW-16).
Server URL	empty	Your EarWorm address. Required. It must be an EarWorm address; anything else shows Please enter valid url for EarWorm. Paste the whole address, beginning https://: only an address starting www. has the rest added for you, and any other short form saves but never works (EW-11).

Data Handling

Row	Factory	What it does
Lookup Type	None	What happens to the value before it is sent anywhere. The note beneath it reads Defines how song or lyric data is interpreted for reveals. Section 5.
Polling Interval	empty	How many seconds to wait, after each answer, before asking again. Opens a number keypad. The note reads How frequently Unifi checks for new data from Earworm. Required — see below.

Feedback

Row	Factory	What it does
Vibrate iPhone on Message	off	The phone vibrates once for each new value, except one whose result matches the last event the app handled (EW-26).
Vibrate Thumper/Notifier	off	A connected Notifier and a connected Thumper each give a short vibration for each new value, with the same exception (EW-26).

Polling Interval, properly

It cannot be left empty

An empty Polling Interval stops Save with Enter Poll Frequency. Advice you may have read elsewhere, that an empty field means five seconds, does not work in the source available here (EW-06).

What to type

A whole number of seconds. 2 is a good working value: the value arrives within about two seconds of the choice, plus however long your address takes to answer.

What not to type

0 is accepted and means ask again the instant an answer arrives — continuous traffic for no benefit you can see (EW-06).

What Save does

Checks Server URL is filled in (Enter Poll URL), then Polling Interval, then that the address is an EarWorm one. These checks run even when you are switching EarWorm off (EW-17).
Checks the phone is online. If not: The internet connection appears to be offline, and nothing is saved.
After a one-second pause, stores the settings. If Enable is on, it first reads your address once and waits for the answer: it does not tell you whether the read worked (EW-23), and a slow address keeps the spinner up until it answers.
If a Notifier is connected and Enable is on, sends it your Integration Name, with the vibrations your Feedback switches ask for.
If Enable is on, restarts listening and asks straight away — and whatever your address holds fires, if it is new. Section 4.
Shows Data saved successfully and closes the screen.

Leaving with the back button instead discards every change, without asking.

Four names do something different. An Integration Name of wikitest, cubesmith, iUnlockYourMind or PasscodeChecker, in any capitals, sends a picture to the Notifier on Save instead of scrolling the name. Choose something else.

Section 4

How Unifi OS listens.

Unifi OS is not told when a spectator chooses. It asks your address, remembers the last value it saw, and has no idea how old a value is. Those three facts explain almost everything EarWorm does that surprises people.

The rhythm

A question, an answer, a pause

Unifi OS asks your address, waits for the answer, then waits your Polling Interval before asking again. The gap between a choice and your reveal is the interval plus however long the address takes to reply.

When it starts

About eight seconds after the app opens, provided you are logged in, and immediately whenever you save the EarWorm settings with Enable on. Coming back to the app from another app does not restart it.

Errors do not stop it

No connection, a wrong address, a reply in a format it does not expect: each is ignored without a word, and it asks again after the interval. There is no indicator anywhere, so a broken address looks exactly like a spectator who has not chosen yet (EW-11).

A check that never gets an answer does

Unifi OS waits for each answer without a time limit, and only schedules the next question once an answer arrives. If the address accepts the connection and then never replies — a venue network that swallows the request, a server that hangs — listening stops there, silently, for good (EW-04). If nothing has arrived for longer than it should, open EarWorm → Settings, switch Enable off and back on, and press Save — Save stays dimmed until something changes. If the spinner does not clear, relaunch the app. An address the phone cannot form at all stops it the same way (EW-05).

Unifi OS is built to keep listening in the background. When it leaves the screen — you switch apps, or lock the phone and pocket it — it starts a silent, looping sound that lets it keep running, and stops that sound when you come back. Nothing restarts the sound once it stops. A phone call or an alarm can stop it, and so, probably, can a Phantom Studio reply finishing while the app is in the background. After any of these, bring Unifi OS to the front, lock the phone again, and make a junk choice before you rely on it. This has not been tried on a device.

What counts as a new value

Unifi OS remembers exactly one value. An answer that matches it character for character is ignored; anything else is remembered and fires — except an empty value or ---, which are remembered but never shown. That memory survives the app being closed. Computed from the app’s own code:

Value remembered	Now received	What happens
Bohemian Rhapsody	Bohemian Rhapsody	Nothing. The same value again is ignored
Bohemian Rhapsody	bohemian rhapsody	Fires. Capitals count
Bohemian Rhapsody	Bohemian Rhapsody + space	Fires. A trailing space counts
Bohemian Rhapsody	---	Nothing appears, but --- becomes the value to beat
---	Bohemian Rhapsody	Fires, even though it was the last song shown
Bohemian Rhapsody	(empty)	Nothing appears, but the empty value becomes the value to beat
Bohemian Rhapsody	Yesterday	Fires

Two spectators, one song

If the second person chooses exactly what the first did, you get nothing (EW-09) — unless the address held an empty value or --- in between, which your page may or may not do. Even then, if nothing else arrived in between, the repeat reaches the Notifier and speech but gives no vibration and skips Clipboard, URL, Calculator Studio, the lookup announcement and the Search and Inject modules’ extra sends (EW-26). With a free choice it rarely matters. With a short list of famous songs it will.

Last night’s value, this morning

When listening starts — on launch, or on Save — whatever your address holds fires if it differs from the last value this phone received (EW-10). A choice the app already received does not fire again. A value it never received — chosen after you closed the app, or left by someone trying your page while it was closed — arrives about eight seconds after you next open the app: a connected Notifier shows it, and with the factory settings the phone says it out loud.

The habit that fixes both

Before the performance, and between spectators: make a junk choice on your EarWorm page, watch it arrive, and move on. Now the value remembered is yours, and the next real one is guaranteed to be new.

Two words behave as if they were not EarWorm values at all. A value containing WebMessaging or Magneto, spelled with those capitals, is filed as another module’s event, and most destinations do not fire for it (EW-13). Spectators do not choose these. Performers testing the system sometimes type them.

Where a new value appears

Every accepted value becomes a new entry in the EarWorm panel on the Status screen, showing the result of Lookup Type. Then it goes to the destinations (Section 7).

Section 5

Lookup Type.

A spectator enters a post code and you want the town. A birthday and you want the date written out. Lookup Type does the conversion before the value goes anywhere — and has a habit on the Notifier worth knowing before you rely on it.

The eighteen options

EarWorm → Settings → Lookup Type, in this order: None, PIN, Pi Revelation, Date (DMY), Date (MDY), Date (DM), Date (MD), Post Code (AU), Post Code (SG), ZIP Code (USA), Post Code (FR), Post Code (DE), Post Code (IT), Post Code (UK), Time (HHMM), ACAAN, Synonyms and Antonyms.

Fifteen work offline. Three need the internet: Post Code (UK) asks Apple’s map service, and Synonyms and Antonyms ask an online thesaurus. The choice is stored in the app’s language; change the language and choose it again (EW-22).

What comes back

Every row below was computed from the app’s own code and data when this guide was built, with the factory memorized deck (Mnemonica, no Start Stack at) and without the Pi Revelation product. This result is what every destination receives, except the first spoken announcement, which reads the value as it arrived (Section 8).

EarWorm value	Lookup Type	Result sent onward
Bohemian Rhapsody	None	Bohemian Rhapsody
My code is 4821	PIN	My code is 4821
hello	PIN	(nothing)
1234	Pi Revelation	Page 27, Line 15, Index 9
0730	Time (HHMM)	07:30
7:30	Time (HHMM)	07::3030
7	Time (HHMM)	The app crashes
260370	Date (DMY)	26 March 1970
032670	Date (MDY)	March 26 1970
2603	Date (DM)	26 March
2000	Post Code (AU)	Barangaroo, Sydney, NSW
75001	Post Code (FR)	Paris 01, Ile De France
SW1A 1AA	Post Code (UK)	Needs the network
90210	ZIP Code (USA)	Beverly Hills, Los Angeles, CA
Beverly Hills	ZIP Code (USA)	Unreachable
07423	ACAAN	Cut the Eight of Clubs, position 33, to the top
happy	Synonyms	Needs the network

Habits to know

PIN keeps the whole value

If the value contains any digit, the entire value is the result; if it contains none, the result is empty and that empty result is still sent on: a selected Clipboard row empties the clipboard, and Search runs a blank search (EW-21). Unlock takes only the digits.

Time wants four digits, and one digit stops the app

0730 and 07:30 work. A one-digit hour or minute with a colon garbles it (7:30), and a single digit on its own stops the app completely (EW-20).

Dates are digits in pairs

Six digits give a full date; four give day and month. Date (MDY) drops the age (EW-20), but only the written-out date goes onward, so no destination shows the difference.

Post codes return the first place listed

A code shared by several places returns the first in the app’s table. A code it does not hold returns Unreachable, and that word is what the destinations receive.

What the Notifier shows, which is not the same thing

The Notifier does not display the result as it stands. It runs its own formatting, keyed by the same Lookup Type — and EarWorm hands it a value that has already been looked up. The formatter looks for a post code in “Barangaroo, Sydney, NSW”, finds none, and shows Unreachable (EW-12). Computed from the formatter itself (lines within a message separated by /, messages by |):

EarWorm value	Lookup Type	Notifier displays
Bohemian Rhapsody	None	Bohemian Rhapsody
My code is 4821	PIN	PIN / 4821
0730	Time (HHMM)	Time / 07:30
1234	Pi Revelation	PIN / 159) \| P25, L14, I9
2000	Post Code (AU)	Post Code / (blank) \| Unreachable
90210	ZIP Code (USA)	ZIP Code / (blank) \| Location / Unreachable
07423	ACAAN	ACAAN / Unreachable
2603	Date (DM)	The app crashes
0326	Date (MD)	The app crashes

With a Notifier, use None, PIN or Time. Every other lookup shows the wrong thing on the Notifier, and Date (DM) or Date (MD) with a Notifier connected stops the app the moment a value arrives, and so do Date (DMY) and Date (MDY) when the value has four digits or fewer. If you need the looked-up result in your hand, send it to Thumper or an earpiece (Section 8), and leave the Notifier off for that routine.

Section 6

The Automations screen.

Where the value goes. Thirty-one rows, two already selected — and five that do not do what their label says.

Using it

On the EarWorm screen, under Automation, tap Automations. Each row has a circle: tap it to select the row, tap again to clear it, then press Save. Leaving with the back button discards your changes.

The Automations screen. Another module s Automations screen, with the same rows EarWorm s shows. Tap a circle to select a row, then Save. — **The Automations screen.** Another module’s Automations screen, with the same rows EarWorm’s shows. Tap a circle to select a row, then Save.

The screen in the picture belongs to another module. It is the same screen with the same thirty-one rows; no capture of EarWorm’s own was available.

What starts switched on

Notifier and Speech

On a fresh install two rows are already selected: Notifier and Speech. On a phone that has had Unifi OS for a long time, Notifier may start off (EW-18); look before you rely on it. A new value is read aloud because the Search module’s Speech row also starts switched on (EW-03). EarWorm’s own Speech row only adds a lookup announcement, when Lookup Type is not None, so clearing it here is not enough — Section 8.

Rows shown gray

Nine rows belong to products sold separately. Until you own the product, or have it on trial, the row is shown gray at half strength and ignores taps: Search, Prevision, Calculator Studio, Prediction Studio, Notes Studio, Unifi Intelligence, X, Instagram and Book Studio. A row selected while you owned the product keeps sending after a trial ends, except Search and Prevision, which stop (EW-25).

All thirty-one rows

Row	Starts	Does it work from EarWorm?
Anagram Studio	off	Yes
Book Studio	off	Yes
Calculator Studio	off	No. WikiTest’s Calculator Studio row decides instead (EW-02)
Clipboard	off	Yes
Flitch	off	Yes
Goo	off	Yes, with Goo set up
Image to Notifier	off	No. Saved, never used (EW-07)
Inject	off	Yes — and the Search module’s Inject row also sends (EW-08)
Instagram	off	Yes
LUMEN Polling	off	Yes
MindScribe	off	Yes
Nexus	off	Yes
Notes Studio	off	Yes
Notifier	on	Yes, with Lookup Type None, PIN or Time (HHMM). Other lookups show the wrong thing (EW-12)
P.E.S. Email Prediction	off	No. Saved, never used (EW-07)
P.E.S. Image Prediction	off	No. Saved, never used (EW-07)
Phantom Studio	off	No. Web Polling 1’s Phantom Studio row decides instead (EW-01)
Prediction Studio	off	Yes
Prevision	off	Yes — and the Search module’s Prevision row also fires it (EW-08)
Search	off	Yes — and the Inject module’s Search row also fires it (EW-08)
SMS	off	Yes, once SMS is set up and has credit (EW-24)
Speech	on	Partly. It adds a second announcement when a lookup is set; it does not control the first (EW-03)
The Stranger	off	Yes
Thumper	off	Yes
Thumper Watch	off	Yes
Unifi API	off	Yes
Unifi Intelligence	off	Yes
Unlock	off	Yes, with exactly four or six digits
URL	off	Yes
Watch	off	Yes — the smart watch output
X	off	Yes

The two rows that belong to someone else

Phantom Studio follows Web Polling 1

The app reads EarWorm’s selection and then tests Web Polling 1’s. Select it on EarWorm’s screen and nothing is spoken; select Phantom Studio on Settings → App Integration → Web Polling 1 → Automations and every EarWorm value is voiced (EW-01). That row also voices Web Polling 2 and 3, WikiTest, Cognito, Name Forge and Goo. The cleaner route to a Phantom Studio voice is through Unifi Intelligence (Section 9).

Calculator Studio follows WikiTest

The digits in the result are used when WikiTest’s Calculator Studio row is selected, not EarWorm’s (EW-02). To force the calculator from EarWorm, select it on Settings → App Integration → WikiTest → Automations and press Save. WikiTest does not need to be set up. The digits overwrite the saved force number of your active calculator profile, and only while the calculator is the screen in front; with any other screen in front, nothing is written.

Section 7

What each destination receives.

One value arrives. Here is exactly what leaves, destination by destination — what is sent, in what form, and what has to be true for it to arrive.

The one rule behind every row

Every destination receives the result: the value after Lookup Type has converted it. With None, that is the value exactly as your address held it. Only the first result is sent onward. One thing is not the result: the first spoken announcement reads the value as it arrived, before any lookup (Section 8).

Seven destinations also check whether the result names a playing card — ace of spades, AS, 10H — and receive it as a card when it does: Thumper, Prediction Studio, X, Instagram, The Stranger, Nexus, and Inject when its Reveal Mode sends a card video (in that mode, a result that names no card sends nothing to Inject). All but Inject also recognize a tarot card. The English word Joker is not recognized as a card.

On you

Destination	What arrives	Needs
Notifier	The result as a message. With None, the value itself. With a lookup, the Notifier formats it again, and for most lookups that goes wrong — Section 5 (EW-12)	A connected Notifier
Thumper	The result as a reveal, as a card when it names one, according to the Thumper’s own reveal settings	A connected Thumper
Thumper Watch	A time read from the result, set on the Thumper Watch	A connected Thumper, with the Thumper Watch paired to it
Watch	A time read from the result, set on the smart watch output — not the Apple Watch app. A result with no time or number in it, such as most song titles, sets nothing	The Watch output set up
Speech	Section 8	—
Feedback switches	Vibrate iPhone on Message: one phone vibration. Vibrate Thumper/Notifier: a short vibration on each connected device. Neither fires for a value whose result matches the last event the app handled (EW-26)	—

Always, whatever you select

Where	What appears
The Status screen	A new entry in the EarWorm panel showing the result. Your Integration Name is not shown (EW-14)
Apple Watch	The result, if the EarWorm panel is on the Status screen and the watch is reachable
A notification	If the app is in the background and notifications are allowed: the result, usually with a blank title (EW-14)

Into other Unifi OS modules

Destination	What happens	Needs
Anagram Studio	The result is handed to Anagram Studio as input	—
Book Studio	The result is used as the word for a word test	Book Studio
Calculator Studio	Only through WikiTest’s row: the digits in the result overwrite the saved force number of your active calculator profile, only while the calculator is in front (EW-02)	Calculator Studio, on screen
Clipboard	The result replaces whatever is on the phone’s clipboard	—
MindScribe	The result is sent to MindScribe	MindScribe connected
Notes Studio	The result is written into the open note if Notes Studio is on screen, and posted to your Notes Studio session online	Notes Studio
Prediction Studio	A design is generated from the result, or from its card, once the active design has all its required reveals. With no active design, nothing happens	Prediction Studio, an active design
Prevision	A Prevision is started with the result	Prevision
Unifi Intelligence	The result fills the next reveal of your active prompt, which runs once it has its Required Reveals	Unifi Intelligence
Unlock	The digits of the result become the Lock Studio passcode, only if there are exactly four or exactly six	—

Out of the phone

Destination	What happens	Needs
SMS	The result is sent through the SMS module’s own settings. An empty result is not sent. If SMS is off or out of credit, an alert asks you to enable SMS (EW-24)	SMS set up, credit
Search	A result that looks like a web address is opened; anything else is searched for	Search
Inject	The result is sent to your Inject account, as text (the factory setting) or a card video per Inject’s Reveal Mode. In card video mode, a result that names no playing card, such as a song title, sends nothing	Inject set up
URL	The result is sent to the URL module’s address. With Pi Revelation, it is reformatted a second time on the way (EW-19)	Internet
X, Instagram	The result, or its card, is posted according to that module’s settings	The social media product, set up
LUMEN Polling	The result is posted to your LUMEN message feed	Internet
Unifi API	An event with four fields: the result, the original value, the Lookup Type, and the event name EarWorm	Internet
Goo	The result is sent to your Goo account	Goo set up
Flitch	The result is sent to Flitch	Flitch set up
The Stranger, Nexus	The result, with its card when it names one, is sent to that app	That app set up

Nothing arrives

Phantom Studio and Calculator Studio selected on EarWorm’s screen do nothing; another module’s rows decide (EW-01, EW-02, and Section 6). Image to Notifier, P.E.S. Email Prediction and P.E.S. Image Prediction send nothing at all (EW-07).

Section 8

Speech, and silencing it.

The most important section in this guide for anyone performing with the phone near a spectator. An EarWorm value can be spoken by the app’s own voice in two separate ways, controlled from two different screens, and the one you would reach for first controls only the second. A third voice, Phantom Studio, follows the Phantom Studio row on Settings → App Integration → Web Polling 1 → Automations, not EarWorm’s (EW-01); keep that row clear unless you mean to use it.

The two announcements

First: the value itself

Every new value is read out exactly as it arrived. What decides whether this happens is not EarWorm’s Speech row. It is the Speech row on the Search module’s Automations screen, which starts switched on (EW-03). Opening the Search module needs the Search product or a Search trial still running; without either, you cannot reach that row at all.

The spoken value follows your Speech settings for spelling letters and numbers. Of a value with an underscore in it, only the part after the last underscore is spoken.

Second: the lookup, with its name

When Lookup Type is anything but None and EarWorm’s own Speech row is selected, a second announcement follows: “Time”, “Date” or “Location” and the result for those types, the lookup’s own name and the result for the rest. This is the only thing EarWorm’s Speech row controls.

Search’s Speech row	EarWorm’s Speech row	Lookup Type	What the phone says, for 90210
on (factory)	on (factory)	None	“90210”
on	on	ZIP Code (USA)	“90210”, then “Location” and “Beverly Hills, Los Angeles, CA”
on	off	any	“90210”
off	on	ZIP Code (USA)	“Location” and “Beverly Hills, Los Angeles, CA”
off	off	any	Nothing

Three ways to keep the value out of the room

1. Turn speech off everywhere

Settings → Speech, switch off Enable Speech and press Save. The app’s own voice says nothing until you switch it back on; Phantom Studio is separate, and Web Polling 1’s Phantom Studio row still voices EarWorm results (EW-01). The most reliable choice when no routine in the show uses the app’s voice.

2. Speak only into an earpiece

On the same screen, under Audio Output, switch on Bluetooth Audio Only and press Save. Speech then plays only while the phone’s audio goes to Bluetooth, wired headphones, USB audio, AirPlay or car audio; with none of those connected it is silent. With an earpiece in, the value is spoken only to you. Disconnect any venue speaker first: a Bluetooth speaker counts as a route, and the value plays through it. Confirm the route by ear before the show. Phantom Studio ignores this switch and plays through whatever the output is.

3. Switch off the row that controls it

If you own the Search product or have a Search trial still running, open the Search module’s Automations screen and clear its Speech row, then press Save. That silences the value for EarWorm — and for Goo, and for the Search module’s own results — while leaving the rest of Unifi OS free to speak. Then clear EarWorm’s own Speech row too, unless you want the lookup announcement.

Not these. Clearing Speech on EarWorm’s Automations screen does not stop the value. Nor does the Integration Events switch under Announcements on the Speech screen: in the source available here integration values are always allowed through.

Test it from the spectator’s side. Make a junk choice on your EarWorm page with the phone in your pocket and the volume where it will be during the show. If you hear anything, so will they.

Section 9

Five routines, end to end.

Everything in this guide, arranged into things you can perform tonight. Each one lists what to set, what to say, what to check before the show, and the part that goes wrong first. All five assume EarWorm is connected as in Section 3 (Enable on, Polling Interval 2, saved), that your EarWorm page is open on a phone the spectator can hold that is not the phone running Unifi OS — theirs, or a second phone you hand them — and that you have made a junk choice on that page since your last show. If the page is opened on the phone running Unifi OS, the app is no longer in front, and each result can appear on that phone as a notification (Section 7), with a vibration too if Vibrate iPhone on Message is on. What the page offers a spectator is decided by EarWorm: rehearse the exact action you will ask for.

Where a row ends Save on EarWorm → Settings, the button lights only once you change something: choosing the Lookup Type already shown does not light it. If you have set every value as listed and Save is still dimmed, they were already set. Leave with the back button; there is nothing to lose.

1. The song in their head

What the spectator experiences

You ask about the song that has been stuck in their head all week. They find it on the page and lock the phone. You hum the first line, then name it.

Build it

Where	What to set
EarWorm → Settings	Lookup Type None. Polling Interval 2. Vibrate Thumper/Notifier on. Enable on. Save.
EarWorm → Automations	Notifier only. Clear Speech. Save.
Settings → Speech	Enable Speech off. Save.
Hardware	Notifier connected, on your wrist or in your pocket.

Say it

Everyone has one — a song you can’t get out of your head. Don’t sing it. Find it on here, and then lock the phone.

The vibration tells you it has landed. Reveal the era, then the artist, then the title; hum the hook last.

Before the show

Choose a junk song on the page and watch it arrive. That replaces the remembered value with yours (EW-10) and tests every link at once.

What goes wrong first

Two spectators choosing the same hit. The second never arrives (EW-09). Between spectators, make a junk choice yourself.

2. A whisper in your ear

What the spectator experiences

They choose a song while you stand across the room with your back turned. You never look at a screen. You name it.

Build it

Where	What to set
EarWorm → Settings	Lookup Type None. Save.
EarWorm → Automations	Notifier selected, as a backup channel. Nothing else is needed: the value is spoken through the Search module’s Speech row, which starts on. Save.
The Search module’s Automations	Only if you own Search or have a Search trial still running: confirm Speech is selected. Save. If you cannot open the screen and your junk choice is silent, perform routine 1 instead (EW-03).
Settings → Speech	Enable Speech on. Bluetooth Audio Only on. Save.
Hardware	A Bluetooth earpiece, connected and confirmed as the phone’s current audio output. Disconnect any venue speaker, wired headphones or car audio: speech plays through any of them.

Say it

Choose a song on here — any song at all. I’ll stand over there with my back to you. Don’t say it, don’t hum it. Just tell me when you have it.

Before the show

Make a junk choice with the earpiece in: you should hear it. Then switch the earpiece off, or disconnect it in the phone’s Bluetooth settings (leave Bluetooth itself on, or the Notifier disconnects too), and make a different junk choice: the phone must stay silent, and the Notifier should still show the value. Reconnect the earpiece and confirm by ear that it is the current output before you start.

What goes wrong first

The route. If the earpiece drops and nothing else is connected, the phone goes silent rather than loud — which is the safe failure. Keep the Notifier as a second channel for anything that matters.

3. The song, drawn

What the spectator experiences

They choose any song and turn the phone face down. Moments later a sketch or card captioned with its title appears, delivered wherever your Prediction Studio design sends it.

Build it

Where	What to set
EarWorm → Settings	Lookup Type None. Save.
EarWorm → Automations	Prediction Studio and Notifier. Clear Speech. Save. The Prediction Studio row is gray without the product.
Prediction Studio	An active design that needs one reveal, with a caption for the title and the delivery its own guide describes. A design renders only once it has all its required reveals; with no active design, nothing happens.
Settings → Speech	Enable Speech off. Save.

Say it

Find the song you’d hum in an empty room. Choose it on here, then turn the phone face down and keep it to yourself.

Before the show

Make a junk choice and wait for the sketch or card to arrive where your design sends it. Then try a song named after a playing card, such as Ace of Spades. It is sent to Prediction Studio with its card as well as its title: a playing-card slot in your design shows the Ace of Spades, while a caption or sketch slot gets the words, as with any other title. Check what your design makes of it, or steer the spectator away from those titles.

What goes wrong first

Long titles. Size the caption for the longest song a spectator is likely to choose, and rehearse with one.

4. The lyric in a voice only they hear

What the spectator experiences

They wear a bone conduction headband, choose a song and put the phone down. A quiet voice whispers the first line to them — and no one else hears it.

Build it

Where	What to set
EarWorm → Settings	Lookup Type None, so the prompt receives the song title itself. Any other lookup sends its result instead, and PIN with a title that has no digits gives the prompt nothing. Save.
EarWorm → Automations	Unifi Intelligence only. Clear Notifier and Speech. Not Phantom Studio: that row does nothing here (EW-01). Save. The Unifi Intelligence row is gray without the product.
Settings → Unifi Intelligence → Create Prompt	Fill in all four text fields, or Save stays dimmed: Prompt Title (a name no other prompt uses, for example First line), Author (your name), the Prompt Description box (one line about what the prompt does), and Prompt Template: Write the first line of the song $Reveal1 as a gentle, spoken whisper. No title, no quotation marks. Required Reveals 1. Output Type Text. Save.
Settings → Unifi Intelligence, under Active Prompt	Tap the prompt row (it reads Select Prompt, or the name of the current prompt) and choose yours. Choosing a prompt clears any values already collected.
Settings → Unifi Intelligence → Automations	Phantom Studio only. Clear Speech and Notifier, which start selected. Save.
Settings → App Integration → Web Polling 1 → Automations	Phantom Studio clear, or the voice speaks the song title too (EW-01). Save.
Settings → Speech	Enable Speech off, so the app’s own voice says nothing. Save. Phantom Studio ignores this switch.
Settings → Phantom Studio	Tap Select Voice, choose a voice and press Save. Then press Save again on the Phantom Studio screen: the voice is kept only after that second Save. Until a voice is saved, nothing is whispered.
Hardware	The headband paired to your phone and confirmed as its current audio output, with no venue speaker connected. Phantom Studio ignores Bluetooth Audio Only and plays through whatever the output is; with no voice chosen, or no tokens, it is silent.

Say it

Put this on. Choose a song on the phone, set the phone down, and close your eyes. Listen.

What it costs

AI tokens for the prompt, and Phantom Studio’s own tokens for the voice.

Before the show

Top up both kinds of token. Test the prompt with Preview Prompt. Then wear the headband yourself, make a junk choice, and listen for the whisper — and for silence from the phone.

What goes wrong first

Silence. EarWorm, then the AI, then the voice take several seconds; time the gap in rehearsal. Give them something to do in it — close their eyes, take a breath.

5. The video that was already playing

What the spectator experiences

A second phone has been playing on the table since the start. They choose any song. When they look at the second phone, it is showing their song.

Build it

Where	What to set
EarWorm → Settings	Lookup Type None. Vibrate Thumper/Notifier on. Save.
EarWorm → Automations	Prevision and Notifier. Clear Speech. Save. Without the Prevision product or a trial, the Prevision row is gray and Prevision does not start.
Settings → Speech	Enable Speech off. Save.
Prevision	Set up on the second phone as the Prevision guide describes, ready before the spectator chooses.
The Search module’s Automations	Only if you own Search or have a Search trial still running: Prevision clear, or Prevision starts twice (EW-08). Save. Without Search you cannot open this screen; the row starts clear, but a selection made during an earlier Search trial stays on.
Hardware	Notifier connected, on your wrist or in your pocket.

Say it

That phone has been playing since before you sat down. Leave it where it is. Choose a song on this one — take your time.

Before the show

Run the whole chain with a junk choice and watch the second phone. What it shows for a song title is decided by Prevision’s settings, not by EarWorm.

What goes wrong first

Looking too soon. The Notifier’s vibration means the song has reached your phone, not that the second phone has changed. In rehearsal, time the gap from the vibration to the second phone showing the song, and wait at least that long before you direct attention to it.

The common thread is the junk choice. Every one of these starts with you choosing something meaningless on your EarWorm page and watching it arrive. It replaces the remembered value with yours, proves the network, confirms the destinations and checks the phone is silent, in one action. It also goes everywhere a real value goes — posted, texted, drawn and spoken by every selected row — so choose something harmless to see in public.

Section 10

Recommended settings.

What to set if you have not yet decided what you want, and why. Start here and change one thing at a time.

Setting	Recommended	Why
Integration Name	EarWorm	It is what the Notifier shows when you save
Server URL	The whole address, pasted, beginning https://	Any short form not starting www. saves but never works (EW-11)
Polling Interval	2	Fast enough to feel instant; 0 gains nothing you can see
Lookup Type	None	The simplest choice with a Notifier; PIN and Time (HHMM) also display correctly (EW-12)
Vibrate Thumper/Notifier	on	You feel the value arrive without looking
Vibrate iPhone on Message	off	It buzzes the phone running Unifi OS, not the one the spectator holds; a buzz can be heard, and Vibrate Thumper/Notifier already tells you the value has landed
Notifier row	on — check it	It may start off on an older install (EW-18)
Speech row	off	And silence speech properly as well — Section 8
Enable Speech	off, unless a routine uses the app’s voice	Silences the app’s own voice; Phantom Studio is separate (EW-01)
Bluetooth Audio Only	on, whenever speech is on	Speech then plays only through Bluetooth, wired headphones, USB audio, AirPlay or car audio. Disconnect any venue speaker

What not to do

Do not pair a date lookup with a Notifier

Date (DM) or Date (MD) with a Notifier connected stops the app when the value arrives, and so do Date (DMY) and Date (MDY) when the value has four digits or fewer (EW-12).

Do not rely on Phantom Studio or Calculator Studio from EarWorm’s screen

Other modules’ rows decide (EW-01, EW-02).

Do not rely on Image to Notifier or the P.E.S. rows

They never send (EW-07).

Do not trust a quiet EarWorm

A hung check stops listening without a sign (EW-04). If nothing has arrived for a while, switch Enable off and back on and press Save, or relaunch the app.

The two-minute pre-show check

Open EarWorm → Settings. Confirm Enable and Lookup Type. Switch Enable off and back on, then press Save — Save stays dimmed until something changes. Saving restarts listening.
Open Automations and read every selected row, including Notifier.
Open Settings → Speech and confirm Enable Speech is off, or Bluetooth Audio Only is on with the earpiece confirmed as the current output and no venue speaker connected. Then open Settings → App Integration → Web Polling 1 → Automations and confirm Phantom Studio is clear unless you mean to use it: that row voices every EarWorm value, and Phantom Studio ignores both switches (EW-01).
On your EarWorm page, make a junk choice. Watch it arrive where it should, and listen for anything that should not happen.

Section 11

Troubleshooting.

Symptom first, because that is what you have. The chain is short: your address holds a value, Unifi OS asks for it, a lookup converts it, destinations receive it. Whichever link you cannot confirm is the fault.

Nothing arrives

Symptom	Likely cause and fix
It worked earlier, now nothing	A check never got an answer and listening stopped (EW-04). Open EarWorm → Settings, flip any switch off and on, and press Save with Enable on — or relaunch the app.
Nothing has ever arrived	Enable off, not logged in, the phone offline, or an address that saves but does not answer in the expected way (EW-11). Paste the full address again.
The spectator chose, nothing came	The same value as the last one remembered (EW-09), or the silent sound that keeps Unifi OS checking in the background was stopped — by a phone call or an alarm, and possibly by Phantom Studio finishing a sentence — and nothing restarts it until the app is back in front (Section 4). Bring the app to the front; its next check picks up whatever your address holds.
Save will not work	Nothing has changed yet: Save stays dimmed until you edit a field, flip a switch or pick a different Lookup Type. Otherwise Enter Poll URL, Enter Poll Frequency, Please enter valid url for EarWorm. or the phone is offline. The checks apply even when switching EarWorm off (EW-17).
Phantom Studio said nothing	EarWorm’s row does nothing; Web Polling 1’s decides (EW-01). With that row selected, Phantom Studio is still silent if no voice is chosen in Phantom Studio or no tokens remain.
Calculator Studio did not force	WikiTest’s row decides (EW-02), the calculator was not on screen, or the result had no digits.
Image to Notifier or P.E.S. did nothing	They never do (EW-07).
The Notifier stayed dark for one value	It contained Magneto (EW-13). A value containing WebMessaging goes through Web Messaging’s own Notifier row instead: with that row on, the Notifier gets the value as it arrived, before EarWorm’s lookup, formatted by Web Messaging’s Lookup Type. If every value stays dark, the Notifier row is off (EW-18) or the Notifier is not connected.
Unlock did not change the passcode	The result did not have exactly four or six digits.
SMS asks to be enabled when it is	It is out of credit (EW-24).
A lookup stopped working after changing language	Choose the Lookup Type again (EW-22).

Something arrives, but wrong

Symptom	Likely cause and fix
A value nobody chose, just after launch or Save	A value your phone never received, left on your address — for example a choice made while the app was closed (EW-10). Make a junk choice before the show.
The Notifier shows Unreachable, a blank line or a strange number	A lookup other than None, PIN or Time is set (EW-12).
Every destination received Unreachable	The lookup did not recognize the value — or, with Post Code (UK), Synonyms or Antonyms, the online service could not be reached, returned an error or found no match. Check the phone’s connection.
A PIN result is the whole sentence, or empty	That is how PIN works (EW-21).
A time reads 07::3030	The value had a one-digit hour or minute with a colon, such as 7:30. Send 0730 or 07:30 (EW-20).
A Pi Revelation URL looks garbled	It is reformatted twice (EW-19).
The Notifier buzzed and showed your Integration Name	That is Save, not a value (EW-15).
The Notifier showed a value, but nothing vibrated	Its result matched the last event the app handled, so the vibrations, Clipboard, URL and the lookup announcement were skipped (EW-26). Make a junk choice between spectators.
The EarWorm panel is missing from Status	It is added only once; add it again with the round +/− button at the bottom right of the Status screen: tap EarWorm under Available, then tap Save (EW-16).

It went somewhere you did not send it

Symptom	Likely cause and fix
An EarWorm value started a Prevision, a search or an Inject reveal	The Search module’s Prevision or Inject row, or the Inject module’s Search row, is selected (EW-08).
Phantom Studio spoke an EarWorm value	Web Polling 1’s Phantom Studio row is selected (EW-01).
The calculator was forced unexpectedly	WikiTest’s Calculator Studio row is selected (EW-02).
A product row keeps sending after a trial ended	Clear it while you still can, or buy the product (EW-25).

The phone spoke, or stopped

Symptom	Likely cause and fix
The value was read aloud with EarWorm’s Speech row off	The Search module’s Speech row controls it (EW-03). Section 8.
It spoke twice	A lookup is set and EarWorm’s Speech row is on.
The app closed the moment a value arrived	Time (HHMM) with a single digit (EW-20), or, with a Notifier connected, Date (DM) or Date (MD) — or Date (DMY) or Date (MDY) with a value of four digits or fewer (EW-12).

Section 12

Reference.

Every control, its factory value and the section that explains it, read out of the app source rather than transcribed from a screen.

EarWorm → Settings

Group	Row	Factory	Section
Connection	Integration Name	empty	3
Connection	Enable	off	3
Connection	Server URL	empty, required	3
Data Handling	Lookup Type	None	5
Data Handling	Polling Interval	empty, required	3
Feedback	Vibrate iPhone on Message	off	3
Feedback	Vibrate Thumper/Notifier	off	3

Timing and limits

Thing	Value
First check after launch	about 8 seconds, logged in
First check after Save	about 1 second plus one answer from your address, with Enable on
Gap between checks	Polling Interval seconds after each answer; no minimum
Time limit on an answer	none
Values remembered for repeats	1, exact, kept across launches
Never shown	An empty value, ---
Lookup types	18
Automations rows	31; 5 do not work as labeled
Rows starting on	Speech; Notifier on a fresh install, but it may start off on an older install (EW-18)
Unlock accepts	exactly 4 or 6 digits
Purchase needed in Unifi OS	None for EarWorm itself

Where things live

What you want	Where it is
Address, lookup, interval, vibration	Settings → App Integration → EarWorm → Settings
Where values go	EarWorm → Automations
Silencing the spoken value	Settings → Speech, or the Search module’s Automations
Phantom Studio for EarWorm	Settings → App Integration → Web Polling 1 → Automations
Calculator Studio for EarWorm	Settings → App Integration → WikiTest → Automations
The memorized deck for ACAAN	Settings → Memorized Deck

Findings recorded against this integration

Ref	What it is	Section
EW-01	Phantom Studio row follows Web Polling 1	6
EW-02	Calculator Studio row follows WikiTest	6
EW-03	EarWorm’s Speech row does not stop the value being spoken	8
EW-04	A check with no answer stops listening	4
EW-05	An address the phone cannot form stops listening	4
EW-06	Polling Interval cannot be blank, has no minimum	3
EW-07	Image to Notifier and both P.E.S. rows do nothing	6
EW-08	Search and Inject modules’ rows also route values	6
EW-09	A repeat of the remembered value is ignored	4
EW-10	A leftover value fires when listening starts	4
EW-11	The address check is shallow; failures are silent	3
EW-12	The Notifier looks the value up a second time	5
EW-13	Two words are filed as other modules’ events	4
EW-14	The Integration Name is not shown with results	7
EW-15	Save signals the Notifier	3
EW-16	The EarWorm panel is added only once	3
EW-17	Switching off still needs a valid address	3
EW-18	Notifier may start off on an older install	6
EW-19	Pi Revelation is reformatted twice for URL	7
EW-20	Time and Date (MDY) lookup faults	5
EW-21	PIN with no digits sends an empty result onward	5
EW-22	Lookup Type is stored in the display language	5
EW-23	Save does not check the address works	3
EW-24	The SMS alert blames settings for no credit	7
EW-25	Rows for products no longer owned keep sending	6
EW-26	A value matching the last event skips the phone-side steps	4

Section 13

Index.

By section, so it stays right however the pages fall.

ACAAN5
Address, Server URL3
Alerts on Save3
Apple Watch7
App Integration3
Automations screen6
Background, the app in4
Bluetooth Audio Only8
Calculator Studio, and WikiTest’s row6
Card names, recognized7
Crashes, and what causes them11
Dates5
Earpiece, speaking into8
Empty values and ---4
Enable3
Enable Speech8
Gray rows6
Hung check, and restarting4
Image to Notifier6
Integration Name3
Junk choice, the habit4
Lookup Type5
Notifier, what it displays5
On by default6
P.E.S. rows6
Phantom Studio, and Web Polling 16
PIN5
Polling Interval3
Post codes5
Pre-show check10
Recommended settings10
Repeated values4
Routines9
Search module, its Speech row8
Speech8
Status screen7
Time (HHMM)5
Troubleshooting11
Unifi API event7
Unifi Intelligence7
Unlock7
Vibrate switches3

Finally

Three things worth remembering.

1. Make a junk choice first

Before every show and between spectators. It replaces the value remembered with your junk one, so the next real choice counts as new, proves the network, and shows you exactly where the next value will go. It goes everywhere a real value goes, so choose something harmless to see in public.

2. Silence the phone on the Speech screen

Not on EarWorm’s Automations screen, where the Speech row does not control the value. Enable Speech off, or Bluetooth Audio Only on with an earpiece you have confirmed by ear and no venue speaker connected. Phantom Studio is separate: keep Web Polling 1’s Phantom Studio row clear unless you mean to use it.

3. If it goes quiet, switch Enable off and on, and save

A check that never gets an answer stops EarWorm without a sign. Switch Enable off and back on and press Save, or relaunch the app; either starts it again.

Everything else in this guide is detail. Those three are the habit.

How this guide was checked

EarWorm has no screens of its own in the captures supplied by Illuminati Magic, so the two pictures in this guide are of screens it shares — the App Integration list, and another module’s Automations screen — and are captioned as such. Every control name is reproduced from the app’s own English strings rather than from a code identifier.

The tables that can be recomputed are recomputed every time this guide is built: the eighteen lookup types and every worked lookup, from a line-by-line port of the app’s lookup code and its bundled place and deck data; what the Notifier displays, from a port of the Notifier’s own formatter; when a value counts as new, from a port of the listening code; and the thirty-one Automations rows, which start on and which are gray without a purchase, read from the Automations screen’s code. The build refuses to produce a PDF if a single cell disagrees.

The app source consulted for this edition is dated July 23, 2026 and is not the current build, so anything added or fixed since will not appear in it. This guide records twenty-six findings against the integration, listed in Section 12 and each marked where it occurs; every one was read from that source and may already have been addressed. Where a claim could not be established it is marked in the text rather than stated.

Open at publication, because none of it is decided by Unifi OS: who makes EarWorm and what its page offers a spectator; how an address is issued; and whether the page ever sends an empty value or --- between choices. The order of the EarWorm Settings rows is taken from the app’s layout file and has not been seen on a device.

Help and support

For anything this guide doesn’t answer — a fault, a question about your setup, a routine you cannot get to work — contact Illuminati Magic: support@illuminati-magic.com.

EarWorm is a separate service. Unifi OS, which connects to it, is designed and made by Illuminati Magic.

About Us

Illuminati Magic is dedicated to the innovation of world class magic illusions for the discerning performer. Founded in 2017, by technology entrepreneur Nathan Buzza, Illuminati Magic has developed a myriad of illusions, known only to a select few.

Contact Info

AUSTRALIAN OFFICE
19 Windarra Drive
City Beach WA 6015
AUSTRALIA

INDIAN OFFICE
Money Plant High Street
Sarkhej, Gandhinagar
Highway Gota, B-658,
382470 Ahmedabad
Gujarat
INDIA

Quick Links

Social

© 2026 Illuminati Magic. (C) Copyright 2026