Protoplasm help

Choose your device for controls and common tasks.

Public apps: iPhone and iPad 1.1. Apple TV controls are below. Native Mac test-build instructions are separate below. Updated November 3, 2026.

App Store · Version 1.1 · iOS or iPadOS 26 or later

iPhone & iPad

  1. Start. Open Protoplasm and wait for the liquid to appear. The show runs by itself. For tools, use the eye control to switch to Create. Tap the active tool to reveal its choices.
  2. Change scene. Open Scene and look. Choose Scene, or use the previous and next arrows. Close the menu to return to the liquid.
  3. Add oil or ink. Tap Ink to open its tools, choose Oil or Ink, then tap or drag on the liquid. Drag the hue ring to change color.
  4. Turn or press the glass. Open Plate. Choose Turn and drag to turn the dish. Choose Press, hold on the liquid, then lift to release.
  5. Stir or use soap. Open Distort. Choose Stir and drag, or choose Soap and tap.
  6. Change focus or brightness. Open Scene and look and adjust the Focus or Brightness slider.
  7. Use device motion. In Create, choose Motion beside Listen and allow motion access if asked. Tip the device to move the liquid. Turn Motion off for touch-only control.

Pinch/spread changes the view zoom. Use the Focus slider for optical focus. Open Scene and look → ? Help for the control reference, or choose Tour for a walkthrough.

Respond to sound

  1. Tap the microphone button, labelled Listen with microphone.
  2. Allow microphone access. Play music nearby or make a sound.
  3. Tap the microphone button again to stop listening.

Basic microphone response stays free in 1.1. Microphone sound is analyzed on your device; it is not recorded or uploaded. Listen changes the image; it does not play music. Operator adds advanced audio, reel/video export and image-on-glass controls. Pause-to-compose is not included.

Operator and advanced audio

Choose a microphone and adjust Listen

For Operator on iPhone/iPad 1.1 and native Mac test builds. The public web show provides basic Listen; development web builds may expose additional testing controls. Apple TV has no audio input.

  1. Start Listen and allow microphone access. Open Audio controls beside Listen. If Operator is locked, this opens the upgrade screen first.
  2. If your device exposes two or more microphone inputs, choose one in Microphone. The selection shows the active input. Choose System default to let the operating system choose. With one exposed input, the picker stays hidden.
  3. Use the Advanced audio switch to show the six response controls. Set each amount or switch it off. Its amount is retained for this session, so switching it back on restores that amount.
  4. Turn the Artist on for Jets and Artist response. Enabling audio or changing its amounts does not turn the Artist on for you.

Light, heat and shimmer return to the scene’s settings when listening stops, including adjustments made while listening. Switching advanced audio off while Listen stays on returns to the basic bass/movement and highs/brightness response.

Available inputs depend on the device, browser and OS. The list refreshes when the system reports an input change. Input choices are not saved as a permanent app preference.

In web test builds: a chosen input is reused if you stop and restart Listen during the same page session. If a switch fails while the previous input is still live, it keeps listening to that input and shows an error. If a disconnected input stops Listen, choose Listen again to reconnect.

On iPhone/iPad: the picker uses the native inputs available to iOS/iPadOS. It does not choose your music output or promise that every connected headset or interface will expose a usable input.

Buy Operator or restore a purchase on iPhone or iPad

Operator is an optional one-time purchase. Basic playing, Listen and the Artist stay free.

  1. Open Scene and look → Operator. Audio controls, Reel export and Overlay also offer the upgrade when locked.
  2. Choose Unlock with the price shown by Apple, then follow Apple’s confirmation sheet. If the price is unavailable, retry later.
  3. To recover your purchase, use the same Apple Account and choose Restore purchases on the Operator screen.

If a purchase is pending, wait for approval. If restore finds nothing, check the Apple Account and app version, then send support the exact message if access is still missing.

Apple TV · tvOS 17 or later

Apple TV

  1. Open the menu. While watching, click the center of the Siri Remote. Choose Scene, Mood or Pace. Back closes a row, then the menu.
  2. Take control. Press Play/Pause, or choose Hands from the menu.
In Hands mode
Siri Remote actionResult
Circle the clickpadTurn the dish.
Swipe across the clickpadTilt the dish.
Click the centerDrop oil or dye.
Hold the center downPress the glass; release to lift it.
Click left or rightChange the next dye color.
Click up or downChange focus.

Press Play/Pause or Back to leave Hands. After 20 seconds without input, the automatic show resumes.

The Artist performs on its own. In versions with Operator, selecting a locked scene or control opens the upgrade and Restore purchases options. Apple TV shows a single dish and has no microphone input or music reactivity. Play/Pause switches who controls the show; it does not freeze the liquid.

Troubleshooting

The show does not start

Check the OS requirement above, then close and reopen the app. If it still fails, send us your device, OS version, app version and the message shown on screen.

Listen does not respond

On iPhone or iPad, check Settings → Privacy & Security → Microphone → Protoplasm. Allow access, return to the app and turn Listen off and on. Try nearby sound. If music playback is interrupted, turn Listen off and report your app version and audio output device.

Apple TV has no Listen control. Mac instructions are below.

I cannot see the tools

On iPhone or iPad, tap the corner visibility control to show the controls, then open Scene and look for Help. On Apple TV, leave Hands with Play/Pause or Back, then click the center of the remote to open the menu.

The motion or flashing is uncomfortable

Turn off Motion on iPhone or iPad. Enable your device’s Reduce Motion setting; Apple TV also follows Dim Flashing Lights. Close the show whenever you need a break.

Mac & test builds

For testers: the native Mac app is being prepared separately. These Mac and development-build notes do not establish public Mac availability.

Use the native Mac test build

Requires an Apple silicon Mac with macOS 26 or later.

  • Open Scene and look to change Scene, Focus or Brightness. Open ? Help for the tool reference.
  • Choose a tool, then click or drag on the liquid. Scroll over the canvas to zoom. Up/Down changes optical focus.
  • Press F for fullscreen. Escape dismisses an open menu or dialog.
  • Click Listen for microphone input. If access was denied, check System Settings → Privacy & Security → Microphone → Protoplasm.
What differs in newer iPhone and iPad builds?

Newer test builds use Create and Play. Tap the eye control to switch; tap the active tool to reveal its choices. Motion, beside Listen in Create, enables device tilt.

In these builds, pinch/spread changes view zoom. Use the Focus slider for optical focus.

Development builds may differ from the App Store version. Check your app version before following a test-build workflow.

Use Operator or restore a purchase in a test build

This section covers test environments. Public iPhone/iPad purchase instructions are above. Do not use a test transaction as proof of a production purchase.

  • iPhone/iPad and Mac tests: Operator covers advanced audio, reel/video export and image-on-glass controls. Basic Listen stays free. Pause-to-compose is deferred.
  • TV 1.1 preview: Ballroom, Lava and Abyss stay free. Operator adds the other scenes, Mood, Pace, Hands and manual Soap. It adds no audio input or music reactivity. TV 1.0 installations do not have these access limits.
  1. On iPhone/iPad or Mac, open Scene and look → Operator. On TV, select a locked scene or control.
  2. For a test purchase, choose Unlock with the price shown by Apple and follow its confirmation sheet. If the price is unavailable, retry later.
  3. To recover a purchase in that test environment, use the same Apple Account and choose Restore purchases on the Operator screen.

If a purchase is pending, wait for approval. If restore finds nothing, check the account and whether you are using the test or public app. Send us the exact message if access is still missing.

TestFlight purchases use Apple’s sandbox and do not incur charges. See Apple’s testing guide and purchase restoration help.

Contact support

Email andy@mindbendingpixels.com with your device, OS version, app version/build, App Store or TestFlight, and the steps that caused the problem. Include the exact error; a screenshot is optional.

Do not send passwords or payment details.