Device management
The Devices page, in the sidebar, lists the devices on your PiShock account and the shockers other people have shared with you. It is where you choose which shockers MultiShock may use, and how strongly. You need to be signed in to use it.
Saving changes
Changes on this page only take effect when you click Save changes at the top right. While you have unsaved changes, the page shows Unsaved changes and a Discard button that throws them away. If you leave the page without saving, your changes are lost.
Sync from PiShock fetches the current list of devices from your PiShock account. MultiShock also syncs each time it starts and each time you sign in. Syncing reloads the page, so save any changes first.
Use Search by name or ID to find a device or shocker in a long list.
My devices
Each device on your PiShock account has a card. Click its header to expand or collapse it. The header shows how many shockers the device has, and how many are active right now.
The device's checkbox turns the whole device on or off. Each shocker in it has:
- A checkbox to let MultiShock use it. A shocker is only used when both it and its device are ticked, and you've saved.
- Allow shocks. When off, shocks are sent as vibrations instead.
- Test, which sends a one second vibration. You can also double-click the shocker.
- Active or Inactive: whether the shocker is in use right now. Tick it and save to make it active. Active doesn't mean the device is online, only that MultiShock will send it commands.
- Power limit, a percentage that scales every command sent to it. At 100%, shockers get exactly what a flow asks for.
- Cooldown, which keeps the shocker from firing again too soon. Click it to turn it on and set its Length and what happens During cooldown.
Safety controls explains exactly how Allow shocks, Power limit, and Cooldown change what is sent.
New shockers are added turned on, with shocks allowed and Power limit at 100%. Check their settings after adding a device to your PiShock account.
Shared with me
This tab lists shockers other people have shared with you through PiShock.
- Under Add shared shockers, click the name of the person who shared with you. Click the refresh button if someone new has shared with you.
- Their shockers appear on the right, grouped by person and device.
- Tick the shockers you want to use, then click Save changes.
Each shared shocker shows what its owner allows (shock, vibrate, and beep) and the owner's limits: the highest power and longest duration they allow. You can set a Power limit and a Cooldown as for your own shockers, but there is no Allow shocks switch; the owner's permissions decide that.
For each person, the refresh button fetches their shares again, for example after they change their limits, and the trash button removes their shockers from MultiShock straight away, without asking first.
If something is missing
See troubleshooting if devices or shockers don't appear, or stay Inactive.
Find shocker IDs and USB details
The number prefixed with # beside a shocker's name is its Shocker ID. Use it when selecting a specific shocker in a flow or reporting a targeting problem. Search by name or ID helps find a shocker in a long list.
A device ID identifies the hub; a shocker ID identifies a shocker paired to it. Shared-device metadata also includes an owner and share ID. These are different identifiers, so do not substitute a share ID or USB port name for a shocker ID.
For a USB connection problem, open Settings → Advanced → Debug &
diagnostics → Status to check the number of serial devices and loaded
shockers, then inspect the logs for the port, such as COM3 on Windows.
For plugin code, IDeviceActions.GetLoadedShockers() supplies both
DeviceId and ShockerId; see host services.
GetConnectedSerialDevices() supplies the hub's client ID and port name.
