← SENSORLOVE

Sensors

Every value has its own address under /sensorlove, with one number in it, or one text. A destination's PREFIX goes right after the root: /sensorlove/phone1/accel/x. OSC tells how the values travel.

ATTITUDE

Which way the phone is facing: pitch tips it forward, roll tilts it sideways, yaw turns it around. Hold it like a steering wheel or a camera and map it to rotation.

Addresses /sensorlove/attitude/*
AddressValue
/sensorlove/attitude/pitchRAD
/sensorlove/attitude/rollRAD
/sensorlove/attitude/yawRAD

QUATERNION (QUAT)

The same orientation as ATTITUDE, as four numbers. Use it to rotate 3D objects: it never flips or locks up when you point straight up or down.

Addresses /sensorlove/quaternion/*
AddressValue
/sensorlove/quaternion/x-1 TO 1
/sensorlove/quaternion/y-1 TO 1
/sensorlove/quaternion/z-1 TO 1
/sensorlove/quaternion/w-1 TO 1

GRAVITY

Which way is down. Tilt the phone and the values follow, smooth and without shake. The easiest way to steer something by tilting.

Addresses /sensorlove/gravity/*
AddressValue
/sensorlove/gravity/xG
/sensorlove/gravity/yG
/sensorlove/gravity/zG

GYROSCOPE (GYRO)

How fast the phone is spinning. Still is 0. Twist it quickly to trigger things, or let the spin drive a speed.

Addresses /sensorlove/gyro/*
AddressValue
/sensorlove/gyro/xRAD/S
/sensorlove/gyro/yRAD/S
/sensorlove/gyro/zRAD/S

ACCELEROMETER (ACCEL)

Every force on the phone, gravity included. Knocks, taps and bumps show up right away.

Addresses /sensorlove/accel/*
AddressValue
/sensorlove/accel/xG
/sensorlove/accel/yG
/sensorlove/accel/zG

USER ACCELERATION (U.ACCEL)

Only your movement, with gravity taken out. Shake, swing or punch the air: made for gestures and hits.

Addresses /sensorlove/useraccel/*
AddressValue
/sensorlove/useraccel/xG
/sensorlove/useraccel/yG
/sensorlove/useraccel/zG

LOCATION

Where the phone is and how fast it moves. Slow to update, but great for walks, rides and site-specific work. Needs location permission.

Permission: LOCATION

Addresses /sensorlove/location/*
AddressValue
/sensorlove/location/latDEG
/sensorlove/location/lonDEG
/sensorlove/location/altM
/sensorlove/location/speedM/S
/sensorlove/location/headingDEG
/sensorlove/location/addressTEXT

TEXT comes as an OSC string.

MAGNETOMETER (MAGNET)

The magnetic field around the phone. Bring a magnet or a speaker close and watch it jump. Also a rough compass.

Addresses /sensorlove/magnet/*
AddressValue
/sensorlove/magnet/xµT
/sensorlove/magnet/yµT
/sensorlove/magnet/zµT

BAROMETER (BARO)

Air pressure, and how far you went up or down. Lift the phone above your head and you will see it move.

Permission: MOTION

Addresses /sensorlove/pressure/*
AddressValue
/sensorlove/pressure/kpaKPA
/sensorlove/pressure/altitudeM

WEATHER

The weather where the phone is, from Open-Meteo.com: temperature (°C), how it feels, humidity, rain (mm), clouds, wind (m/s) and where it comes from, pressure (hPa), day or night, and the sky (WMO's code; in words at /sensorlove/weather/text, for an OSC In DAT). New every 15 minutes, and sent again every 5 seconds for a patch opened later. Needs your location, which goes out rounded to about 1 km. Weather data by Open-Meteo.com.

Permission: LOCATION

Addresses /sensorlove/weather/*
AddressValue
/sensorlove/weather/temp°C
/sensorlove/weather/feels°C
/sensorlove/weather/humidity%
/sensorlove/weather/rainMM
/sensorlove/weather/clouds%
/sensorlove/weather/windM/S
/sensorlove/weather/winddirDEG FROM
/sensorlove/weather/pressureHPA
/sensorlove/weather/isday0 / 1
/sensorlove/weather/codeWMO
/sensorlove/weather/textTEXT

TEXT comes as an OSC string.

TOUCH

Where up to five fingers are, from 0 to 1, and how many. Each keeps its number until it lifts. Touch the monitor, or open the pad to play the whole screen like an XY controller.

Addresses /sensorlove/touch/*
AddressValue
/sensorlove/touch/count0-5
/sensorlove/touch/1-5/x0-1
/sensorlove/touch/1-5/y0-1
/sensorlove/touch/1-5/down0 / 1
/sensorlove/touch/1-5/radiusPT

MICROPHONE (MIC)

How loud it is around the phone, from 0 to 1. Clap, talk or play music to drive light and sound.

Permission: MICROPHONE

Addresses /sensorlove/mic
AddressValue
/sensorlove/mic0-1

PROXIMITY (PROX)

The sensor next to the earpiece: 0 when something is close, 1 when clear. Wave a hand over it for a simple on / off trigger. It is a bit shy.

Addresses /sensorlove/proximity
AddressValue
/sensorlove/proximity0 / 1

BATTERY

How full the battery is, from 0 to 1. Handy in long installations: slow the piece down or warn before the phone dies. The wizard lives on it: full, he flies; then he sits, dozes off, and when it runs out there is only his grave.

Addresses /sensorlove/battery
AddressValue
/sensorlove/battery0-1

TIME

The phone's clock and calendar: hour, minute, second, how far the day has gone (0 to 1), the date, the weekday (1 is Monday) and the day of the year. For pieces that follow the day, or several phones on one clock. What changes slowly also goes out every 5 seconds, for a patch opened later. The hourglass runs a minute.

Addresses /sensorlove/time/*
AddressValue
/sensorlove/time/hour0-23
/sensorlove/time/minute0-59
/sensorlove/time/second0-60
/sensorlove/time/dayprogress0-1
/sensorlove/time/yearYEAR
/sensorlove/time/month1-12
/sensorlove/time/day1-31
/sensorlove/time/weekday1 MON-7 SUN
/sensorlove/time/yearday1-366

FACE TRACKING (FACE TRACK)

Reads your face with the front camera: where your head is and how it turns, where you look, and 52 expressions from 0 to 1, played by a frog. Tap the monitor for every value at once; CAMERA shows how to make each move.

Permission: CAMERA

Addresses /sensorlove/face/*
AddressValue
/sensorlove/face/detected0 / 1
/sensorlove/face/position/xM
/sensorlove/face/position/yM
/sensorlove/face/position/zM
/sensorlove/face/rotation/x-1 TO 1
/sensorlove/face/rotation/y-1 TO 1
/sensorlove/face/rotation/z-1 TO 1
/sensorlove/face/rotation/w-1 TO 1
/sensorlove/face/lookat/xM
/sensorlove/face/lookat/yM
/sensorlove/face/lookat/zM
/sensorlove/face/lefteye/xM
/sensorlove/face/lefteye/yM
/sensorlove/face/lefteye/zM
/sensorlove/face/righteye/xM
/sensorlove/face/righteye/yM
/sensorlove/face/righteye/zM
/sensorlove/face/eyeBlinkLeft0-1
/sensorlove/face/eyeLookDownLeft0-1
/sensorlove/face/eyeLookInLeft0-1
/sensorlove/face/eyeLookOutLeft0-1
/sensorlove/face/eyeLookUpLeft0-1
/sensorlove/face/eyeSquintLeft0-1
/sensorlove/face/eyeWideLeft0-1
/sensorlove/face/eyeBlinkRight0-1
/sensorlove/face/eyeLookDownRight0-1
/sensorlove/face/eyeLookInRight0-1
/sensorlove/face/eyeLookOutRight0-1
/sensorlove/face/eyeLookUpRight0-1
/sensorlove/face/eyeSquintRight0-1
/sensorlove/face/eyeWideRight0-1
/sensorlove/face/jawForward0-1
/sensorlove/face/jawLeft0-1
/sensorlove/face/jawRight0-1
/sensorlove/face/jawOpen0-1
/sensorlove/face/mouthClose0-1
/sensorlove/face/mouthFunnel0-1
/sensorlove/face/mouthPucker0-1
/sensorlove/face/mouthLeft0-1
/sensorlove/face/mouthRight0-1
/sensorlove/face/mouthSmileLeft0-1
/sensorlove/face/mouthSmileRight0-1
/sensorlove/face/mouthFrownLeft0-1
/sensorlove/face/mouthFrownRight0-1
/sensorlove/face/mouthDimpleLeft0-1
/sensorlove/face/mouthDimpleRight0-1
/sensorlove/face/mouthStretchLeft0-1
/sensorlove/face/mouthStretchRight0-1
/sensorlove/face/mouthRollLower0-1
/sensorlove/face/mouthRollUpper0-1
/sensorlove/face/mouthShrugLower0-1
/sensorlove/face/mouthShrugUpper0-1
/sensorlove/face/mouthPressLeft0-1
/sensorlove/face/mouthPressRight0-1
/sensorlove/face/mouthLowerDownLeft0-1
/sensorlove/face/mouthLowerDownRight0-1
/sensorlove/face/mouthUpperUpLeft0-1
/sensorlove/face/mouthUpperUpRight0-1
/sensorlove/face/browDownLeft0-1
/sensorlove/face/browDownRight0-1
/sensorlove/face/browInnerUp0-1
/sensorlove/face/browOuterUpLeft0-1
/sensorlove/face/browOuterUpRight0-1
/sensorlove/face/cheekPuff0-1
/sensorlove/face/cheekSquintLeft0-1
/sensorlove/face/cheekSquintRight0-1
/sensorlove/face/noseSneerLeft0-1
/sensorlove/face/noseSneerRight0-1
/sensorlove/face/tongueOut0-1

HAND TRACKING (HAND TRACK)

Up to two hands, front or back camera (with FACE on, the front one): H1 is your left hand, H2 your right. Each sends its gesture (fist, open palm, victory...), which fingers are up, where you pinch and how wide. Tap the monitor for every value at once; CAMERA shows how to make each gesture.

Permission: CAMERA

Addresses /sensorlove/hand/*
AddressValue
/sensorlove/hand/1/active0 / 1
/sensorlove/hand/1/gesture0-7
/sensorlove/hand/1/velocityVALUE
/sensorlove/hand/1/leftnessVALUE
/sensorlove/hand/1/rightnessVALUE
/sensorlove/hand/1/pinch_xVALUE
/sensorlove/hand/1/pinch_yVALUE
/sensorlove/hand/1/pinch_rotVALUE
/sensorlove/hand/1/pinch_distVALUE
/sensorlove/hand/1/thumb0 / 1
/sensorlove/hand/1/index0 / 1
/sensorlove/hand/1/middle0 / 1
/sensorlove/hand/1/ring0 / 1
/sensorlove/hand/1/pinky0 / 1
/sensorlove/hand/2/active0 / 1
/sensorlove/hand/2/gesture0-7
/sensorlove/hand/2/velocityVALUE
/sensorlove/hand/2/leftnessVALUE
/sensorlove/hand/2/rightnessVALUE
/sensorlove/hand/2/pinch_xVALUE
/sensorlove/hand/2/pinch_yVALUE
/sensorlove/hand/2/pinch_rotVALUE
/sensorlove/hand/2/pinch_distVALUE
/sensorlove/hand/2/thumb0 / 1
/sensorlove/hand/2/index0 / 1
/sensorlove/hand/2/middle0 / 1
/sensorlove/hand/2/ring0 / 1
/sensorlove/hand/2/pinky0 / 1
/sensorlove/hand/distanceVALUE