petcam / index.html
pearlyjam21's picture
Pet cam 0.6.0
5e8aa99 verified
Raw History Blame Contribute Delete
7.12 kB
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="A pet cam for Reachy Mini Wireless: live video, look around with the arrow keys, photos and dances.">
<title>Reachy Pet Cam</title>
<style>
:root { --bg: #0f1216; --panel: #171b21; --line: #262c35; --text: #e8ecf1; --muted: #9aa4b2; --accent: #7aa2ff; }
* { box-sizing: border-box; }
body { margin: 0; background: var(--bg); color: var(--text); font: 16px/1.55 system-ui, -apple-system, "Segoe UI", sans-serif; }
main { max-width: 760px; margin: 0 auto; padding: 48px 16px 64px; }
h1 { font-size: 2rem; margin: 0 0 8px; }
h2 { font-size: 1.15rem; margin: 40px 0 12px; }
p, li { color: var(--muted); }
strong, td:first-child { color: var(--text); }
.lede { font-size: 1.1rem; }
ol, ul { padding-left: 20px; }
li { margin: 6px 0; }
table { width: 100%; border-collapse: collapse; background: var(--panel); border: 1px solid var(--line); border-radius: 10px; overflow: hidden; }
td { padding: 9px 14px; border-top: 1px solid var(--line); color: var(--muted); }
tr:first-child td { border-top: 0; }
kbd { font: 0.85em ui-monospace, Consolas, monospace; background: var(--line); border-radius: 5px; padding: 2px 6px; color: var(--text); }
code { font: 0.9em ui-monospace, Consolas, monospace; color: var(--accent); overflow-wrap: anywhere; }
</style>
</head>
<body>
<main>
<h1>🐾 Reachy Pet Cam</h1>
<p class="lede">Turn a Reachy Mini Wireless into a pet camera you steer from a browser on your home Wi-Fi: live
video, listen to the room, talk through the robot, look around with the arrow keys, photos and dances. Soft
limits keep the head and body well inside the hardware's range.</p>
<h2>Install</h2>
<ol>
<li>In the Reachy Mini dashboard, install <strong>petcam</strong> from the app list.</li>
<li>Start it from the dashboard. The robot runs one app at a time, so this stops any other app.</li>
<li>The Reachy Mini Control app shows the page in its own window: watch, steer, listen and take photos there. In
a browser on the same Wi-Fi, go to <code>http://reachy-mini.local:8042</code>.</li>
<li>To talk, use <code>https://reachy-mini.local:8043</code> in a browser or on a phone (holding Talk on the http
page takes you there): browsers allow the microphone only on HTTPS. The robot makes its own certificate, so
each browser warns once: choose Advanced, then Proceed. The Control app's window can't open that page, so it
can't talk.</li>
</ol>
<p>Made for Reachy Mini Wireless with daemon version 1.8.3.</p>
<h2>Controls</h2>
<table>
<tr><td><kbd>←</kbd> <kbd>→</kbd> <kbd>↑</kbd> <kbd>↓</kbd> hold</td><td>Look around</td></tr>
<tr><td><kbd>Shift</kbd> + arrows</td><td>Slow, precise moves</td></tr>
<tr><td><kbd>Z</kbd> / <kbd>X</kbd> hold</td><td>Tilt the left antenna out / bring it back</td></tr>
<tr><td><kbd>V</kbd> / <kbd>C</kbd> hold</td><td>Tilt the right antenna out / bring it back</td></tr>
<tr><td><kbd>Space</kbd></td><td>Take a photo</td></tr>
<tr><td><kbd>T</kbd> hold</td><td>Talk through the robot's speaker</td></tr>
<tr><td><kbd>L</kbd></td><td>Listen to the room (on / off)</td></tr>
<tr><td><kbd>Q</kbd></td><td>A gentle dance, then back to where it was looking</td></tr>
<tr><td><kbd>Esc</kbd></td><td>Stop</td></tr>
<tr><td><kbd>H</kbd></td><td>Look straight ahead</td></tr>
<tr><td><kbd>S</kbd></td><td>Sleep / wake</td></tr>
<tr><td><kbd>+</kbd> / <kbd>-</kbd></td><td>Zoom in / out, up to 3× (also the mouse wheel over the video)</td></tr>
</table>
<p>On a phone, use the on-screen pad and buttons, and pinch the video to zoom. The zoom is digital and only changes
your own view: it enlarges the middle of the picture, and looking around aims it. Photos keep the whole
picture.</p>
<h2>Game controller</h2>
<table>
<tr><td>Either stick</td><td>Look around: the further you push, the faster it turns. Click the left stick to
look straight ahead.</td></tr>
<tr><td>Right stick click</td><td>Zoom: 1.5×, 2×, 3×, then back to the whole picture</td></tr>
<tr><td>D-pad</td><td>Slow, precise moves</td></tr>
<tr><td><kbd>A</kbd> hold</td><td>Talk</td></tr>
<tr><td><kbd>B</kbd></td><td>Stop</td></tr>
<tr><td><kbd>X</kbd></td><td>Take a photo</td></tr>
<tr><td><kbd>Y</kbd></td><td>Dance</td></tr>
<tr><td><kbd>LB</kbd> / <kbd>LT</kbd> hold</td><td>Tilt the left antenna out / bring it back</td></tr>
<tr><td><kbd>RB</kbd> / <kbd>RT</kbd> hold</td><td>Tilt the right antenna out / bring it back</td></tr>
<tr><td><kbd>View</kbd></td><td>Listen (on / off)</td></tr>
<tr><td><kbd>Menu</kbd></td><td>Sleep / wake</td></tr>
</table>
<p>Any Bluetooth or USB controller in its Xbox-style layout. Press any button once on the open page so the
browser finds it, and click the page once before using Listen or Talk from it.</p>
<h2>Sound</h2>
<ul>
<li><strong>Listen</strong> plays the robot's microphone in your browser. The microphone only runs while
someone listens.</li>
<li><strong>Hold to talk</strong> sends your microphone to the robot's speaker, one person at a time. The room
sound pauses for you while you talk, so you don't hear your own voice come back.</li>
<li>Your voice reaches the robot about half a second after you speak: it gathers a moment of it first, so
uneven Wi-Fi doesn't cut up your words. Your microphone stays open for 20 seconds after you let go, so the
next press starts at once.</li>
<li><strong>Sound on the robot</strong> sets the robot's speaker and microphone levels; at 0 they are off.</li>
<li>Nothing you hear or say is recorded.</li>
</ul>
<h2>Protecting the robot</h2>
<ul>
<li>Head pitch stays within ±30°, the head's turn relative to the body within ±55° and the body within ±115°
(hardware: ±40°, ±65°, ±160°).</li>
<li>The antennas tilt out to their own side, up to 40°, and never lean in from rest, where the two could
touch.</li>
<li>Moves ease in and out, and slow to 15% near a limit.</li>
<li>If the browser stops sending, the head eases to a stop within 0.3 s.</li>
<li>With nobody watching for 10 minutes, the robot goes to sleep with its motors off, and wakes when someone
opens the page.</li>
<li>Stopping the app wakes a sleeping robot gently first, instead of a one-second swing out of the sleep
pose.</li>
</ul>
<h2>Good to know</h2>
<ul>
<li>There is no login: anyone on your Wi-Fi who opens the page can watch, listen, talk and steer.</li>
<li>Photos are saved on the robot in <code>~/petcam_captures</code> and downloaded to the device that took
them.</li>
</ul>
</main>
</body>
</html>