39 releases 39 tags

RSS feed

• v0.2.0-rc.35 c90f1394b5

  Compare

  v0.2.0-rc.35 Pre-release

  Cody Bryant released this 2026-08-19 22:50:25 -07:00 | -1 commits to main since this release

  The release where the robot stopped being read-only. Clean cycle and Reset are
  real buttons now, and whiskerless issues the certificates your broker needs
  instead of leaving that to you.

  Thanks to @CryingPecan, whose LitterHopper robot
  is behind much of the hopper work. Protocol detail lives in
  docs/devices/litter-robot-4/.

  Breaking changes

  • Broker usernames and passwords are gone — --username, --password and
    WHISKERLESS_PASSWORD. Everything authenticates by certificate now.
  • One broker per machine. --host and --ca moved off the everyday commands
    onto setup. A separate broker is a separate store: point WHISKERLESS_HOME at
    it.
  • --port and --insecure are gone. The robot's port is fixed in its firmware
    and it always checks the broker's name, so both could only point the CLI somewhere
    the robot cannot follow. A saved port is ignored, not an error.
  • whiskerless adopt is removed. Re-provision instead.
  • The store moved to ~/whiskerless. Your old ~/.whiskerless is moved there
    on first run, and settings 0.2.0 no longer reads are dropped from your robot
    profiles at the same time. That run tells you what changed.
  • Every robot gets a certificate of its own, with no way to opt out. A robot
    holding one still works on a broker that allows anonymous clients, so there was
    nothing to trade — and whiskerless robots marks any robot still presenting the
    certificate it shipped with.
  • whiskerless has to be able to sign now, unless you say otherwise. A store
    holding a CA certificate but not its key is no longer an unstated arrangement —
    it read like a finished setup while quietly refusing to issue anything. setup
    asks for the key, or offers a new authority; the second answer means
    re-provisioning every robot. See Upgrading from 0.1.3 in the README for what
    that costs at the robot and at the broker.
  • setup --auth records how your store authenticates, for a signing key that
    lives somewhere else on purpose. supplied takes a certificate per robot from
    provision --robot-cert/--robot-key and never wants the CA key; anonymous
    leaves robots the certificate they shipped with. The mode is stored, so later
    commands behave the same way with no flags, and a mode your files can no longer
    carry out is an error naming both rather than a silent downgrade.
  • Each robot's certificate is kept at robots/<serial>/client/, where this
    machine's has always been kept at client/. A robot re-provisioned stays the
    same client to your broker, so ACLs and log lines keyed to it still point at it;
    provision --reissue replaces one deliberately. provision now says to back up
    afterwards, because it leaves behind material an earlier backup does not have.
  • Certificates you supply are checked before anything is written: they have to
    chain to your CA, be valid now, not be a CA themselves, and carry the robot's
    serial as their common name — which is where a broker gets the robot's username.
    Nothing is filed until it passes, and a robot's is filed only once the robot has
    accepted it, so a rejected or aborted run leaves the one you were using intact.
  • binary_sensor.…_waste_drawer_removed → sensor.…_waste_drawer_last_moved.
    The robot never reports which way the drawer moved.
  • switch.…_panel_sleep_mode is now a binary sensor — the firmware refuses
    direct writes. Use the weekday schedule entities.
  • Clean cycle wait time is a number (3–30 minutes), not a select.
  • Library: Hazard.MOTOR, MotorCommandError, allow_motor,
    LitterRobot4Client and WhiskerlessAuthError are removed. Power still needs
    allow_dangerous.

  Added

  • Clean cycle and Reset buttons. Empty cycle, Power and WiFi ship disabled and
    marked (danger) — each costs a litter refill or takes the robot off the
    network. The CLI gains empty-cycle, power and wifi-toggle.
  • whiskerless runs a certificate authority for you. whiskerless setup makes
    the CA, your broker's certificate and this machine's identity, then prints the
    three files your broker needs. Bring your own with --ca and --ca-key.
  • Each robot gets its own certificate, written over BLE and named for its
    serial — so your broker can stop accepting anonymous clients.
  • whiskerless backup and whiskerless restore — the whole store in one
    optionally-encrypted file. The CA key is the one thing you cannot regenerate.
  • The CLI remembers your robots. provision saves them; robots, use and
    forget manage them. A second robot asks only for its serial and WiFi password.
  • Provisioning verifies the WiFi join, so a mistyped password fails loudly
    instead of leaving you a robot that never appears.
  • Litter level as a percentage — self-calibrating, or pinned with one press.
  • LitterHopper support: connected, fill gauge, and an out-of-litter alert the
    firmware never raises. A dispense arrives as three messages ~20 s apart, so the
    level survives a restart and one dispense cannot prove an empty hopper.
  • New entities: last cat visit, visit duration (disabled until your robot
    proves it reports one), waste drawer last moved, panel brightness for bright and
    dark rooms, and excess-weight detection.
  • whiskerless status, calibrate and panel-reset.
  • whiskerless diagnose — when the panel says "blinking blue" and nothing else,
    this asks the robot itself over Bluetooth. It reads and writes nothing. Reaching
    the robot needs pairing mode, which takes it off WiFi, so it warns, asks first, and
    costs a re-provision — and the answer is often just "the robot is trying to
    connect", which is the state the command itself caused. It says so rather than
    inventing a diagnosis. When the robot does volunteer a verdict — refused, network
    not found, or joined-without-an-address — that verdict is real and worth the trip.
  • New install channels: apt and dnf repositories, Homebrew with prebuilt
    bottles, .deb/.rpm, a signed macOS .pkg, and standalone Linux binaries —
    none of which need a system Python. Packages are GPG-signed
    (4BBACD5A6FF38564); setup is in the README.

  Fixed

  • Cat detection no longer mistakes weight on the scale for a cat, handling the
    robot is not a visit, and long visits are no longer dropped.
  • robotStatus 10 is the clean cycle. Unmapped, its readings were published as
    real litter levels. Readings are also suppressed while the globe is not level.
  • The globe motor fault sensor watches the activity stream, where the fault
    actually appears — the state document sat at 0 through a real fifty-minute fault.
  • Panel sleep and wake times can be set, and the weekday schedule arms every
    day rather than only Sunday.
  • whiskerless setup survives a long hostname, and reissues the broker's
    certificate when you move the broker — if it holds your CA's key. A certificate
    it did not issue is reported, never overwritten.
  • Provisioning works where the network list is not a multiple of four. The
    robot's WiFi scan is fetched in pages, and the last page asked for more than
    remained — which this firmware answers by dropping the Bluetooth link, halfway
    through provisioning. It looked like flaky Bluetooth.
  • Provisioning tells you to hold Connect until the light blinks yellow, and
    stops scanning the moment it finds your robot — it only advertises while you hold
    the button, and the scan was spending that window. The instruction used to say to
    hold "until it beeps"; the robot has no beep, so the one cue it offered was for
    something that never happens.
  • The waste drawer says when its number has not been measured. A Reset zeroes
    the gauge and the robot flags the result as unconfirmed until the next cycle's
    lasers take a real reading — whiskerless status was printing that placeholder as
    a measurement. In Home Assistant the sensor keeps publishing the value, so
    nothing keyed on it breaks, and carries a level_provisional attribute instead.
  • Provisioning warns that holding Connect wipes the robot's saved WiFi. The robot
    forgets its network the moment it enters pairing mode, does not come back on its
    own, and cannot be taken out of that mode by any button — only a completed
    provision restores it. This is the robot's behaviour, and it strands cloud users
    too; whiskerless just never said so.
  • The network list explains itself, with a legend for the password marker, the
    signal bars and the channel, and a clearer way to enter a hidden SSID than a bare
    -. The confirmation screen's identity row no longer sits a column out.
  • The robot's IP address is reported when the firmware gives a usable one. It
    answers "connected" before DHCP replies, so the address was read a moment too
    early; provisioning now waits for it. Some robots report an address that is not
    theirs, so only a plausible LAN lease is shown — and when none arrives the step
    simply says the WiFi is connected, which is what it verified either way.
  • Errors are sentences, not stack traces. --debug gives the traceback and
    the request log — with the WiFi password and the robot's key left out of it.
  • A short press of Connect toggles WiFi off, which the docs called harmless —
    the robot vanishes from your broker and looks dead. Hold it for pairing mode.
  • The declared Home Assistant minimum is correct (2025.3.0).

  Changed

  • The Refresh button is on by default, on existing installs too.
  • Manual calibration buttons ship disabled — the robot calibrates itself.

  Downloads

  • Source code (ZIP)
    0 downloads
  • Source code (TAR.GZ)
    2 downloads

  ---

  • SHA256SUMS
    0 downloads · 2026-08-19 23:17:04 -07:00 · 1,011 B
  • whiskerless-0.2.0-rc.35-linux-arm64
    4 downloads · 2026-08-19 23:17:03 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.35-linux-x86_64
    4 downloads · 2026-08-19 23:17:03 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.35-macos-arm64.pkg
    3 downloads · 2026-08-19 22:53:23 -07:00 · 15 MiB
  • whiskerless-0.2.0-rc.35-macos-x86_64.pkg
    3 downloads · 2026-08-19 22:53:25 -07:00 · 14 MiB
  • whiskerless-0.2.0~rc.35.aarch64.rpm
    2 downloads · 2026-08-19 23:17:03 -07:00 · 30 MiB
  • whiskerless-0.2.0~rc.35.x86_64.rpm
    2 downloads · 2026-08-19 23:17:03 -07:00 · 31 MiB
  • whiskerless-rc--0.2.0rc35.arm64_linux.bottle.json
    3 downloads · 2026-08-19 23:17:03 -07:00 · 67 KiB
  • whiskerless-rc--0.2.0rc35.arm64_sequoia.bottle.json
    3 downloads · 2026-08-19 23:17:04 -07:00 · 114 KiB
  • whiskerless-rc--0.2.0rc35.sequoia.bottle.json
    3 downloads · 2026-08-19 23:17:05 -07:00 · 114 KiB
  • whiskerless-rc--0.2.0rc35.x86_64_linux.bottle.json
    3 downloads · 2026-08-19 23:17:06 -07:00 · 67 KiB
  • whiskerless-rc-0.2.0rc35.arm64_linux.bottle.tar.gz
    3 downloads · 2026-08-19 23:17:08 -07:00 · 3.3 MiB
  • whiskerless-rc-0.2.0rc35.arm64_sequoia.bottle.tar.gz
    7 downloads · 2026-08-19 23:17:09 -07:00 · 3.1 MiB
  • whiskerless-rc-0.2.0rc35.sequoia.bottle.tar.gz
    5 downloads · 2026-08-19 23:17:10 -07:00 · 3 MiB
  • whiskerless-rc-0.2.0rc35.x86_64_linux.bottle.tar.gz
    4 downloads · 2026-08-19 23:17:11 -07:00 · 3.4 MiB
  • whiskerless_0.2.0~rc.35_amd64.deb
    4 downloads · 2026-08-19 23:17:03 -07:00 · 31 MiB
  • whiskerless_0.2.0~rc.35_arm64.deb
    1 download · 2026-08-19 23:17:03 -07:00 · 30 MiB
• v0.2.0-rc.34 026a28388a

  Compare

  v0.2.0-rc.34 Pre-release

  Cody Bryant released this 2026-08-19 15:27:23 -07:00 | 6 commits to main since this release

  The release where the robot stopped being read-only. Clean cycle and Reset are
  real buttons now, and whiskerless issues the certificates your broker needs
  instead of leaving that to you.

  Thanks to @CryingPecan, whose LitterHopper robot
  is behind much of the hopper work. Protocol detail lives in
  docs/devices/litter-robot-4/.

  Breaking changes

  • Broker usernames and passwords are gone — --username, --password and
    WHISKERLESS_PASSWORD. Everything authenticates by certificate now.
  • One broker per machine. --host and --ca moved off the everyday commands
    onto setup. A separate broker is a separate store: point WHISKERLESS_HOME at
    it.
  • --port and --insecure are gone. The robot's port is fixed in its firmware
    and it always checks the broker's name, so both could only point the CLI somewhere
    the robot cannot follow. A saved port is ignored, not an error.
  • whiskerless adopt is removed. Re-provision instead.
  • The store moved to ~/whiskerless. Your old ~/.whiskerless is moved there
    on first run, and settings 0.2.0 no longer reads are dropped from your robot
    profiles at the same time. That run tells you what changed.
  • Every robot gets a certificate of its own, with no way to opt out. A robot
    holding one still works on a broker that allows anonymous clients, so there was
    nothing to trade — and whiskerless robots marks any robot still presenting the
    certificate it shipped with.
  • whiskerless has to be able to sign now, unless you say otherwise. A store
    holding a CA certificate but not its key is no longer an unstated arrangement —
    it read like a finished setup while quietly refusing to issue anything. setup
    asks for the key, or offers a new authority; the second answer means
    re-provisioning every robot. See Upgrading from 0.1.3 in the README for what
    that costs at the robot and at the broker.
  • setup --auth records how your store authenticates, for a signing key that
    lives somewhere else on purpose. supplied takes a certificate per robot from
    provision --robot-cert/--robot-key and never wants the CA key; anonymous
    leaves robots the certificate they shipped with. The mode is stored, so later
    commands behave the same way with no flags, and a mode your files can no longer
    carry out is an error naming both rather than a silent downgrade.
  • Each robot's certificate is kept at robots/<serial>/client/, where this
    machine's has always been kept at client/. A robot re-provisioned stays the
    same client to your broker, so ACLs and log lines keyed to it still point at it;
    provision --reissue replaces one deliberately. provision now says to back up
    afterwards, because it leaves behind material an earlier backup does not have.
  • Certificates you supply are checked before anything is written: they have to
    chain to your CA, be valid now, not be a CA themselves, and carry the robot's
    serial as their common name — which is where a broker gets the robot's username.
    Nothing is filed until it passes, and a robot's is filed only once the robot has
    accepted it, so a rejected or aborted run leaves the one you were using intact.
  • binary_sensor.…_waste_drawer_removed → sensor.…_waste_drawer_last_moved.
    The robot never reports which way the drawer moved.
  • switch.…_panel_sleep_mode is now a binary sensor — the firmware refuses
    direct writes. Use the weekday schedule entities.
  • Clean cycle wait time is a number (3–30 minutes), not a select.
  • Library: Hazard.MOTOR, MotorCommandError, allow_motor,
    LitterRobot4Client and WhiskerlessAuthError are removed. Power still needs
    allow_dangerous.

  Added

  • Clean cycle and Reset buttons. Empty cycle, Power and WiFi ship disabled and
    marked (danger) — each costs a litter refill or takes the robot off the
    network. The CLI gains empty-cycle, power and wifi-toggle.
  • whiskerless runs a certificate authority for you. whiskerless setup makes
    the CA, your broker's certificate and this machine's identity, then prints the
    three files your broker needs. Bring your own with --ca and --ca-key.
  • Each robot gets its own certificate, written over BLE and named for its
    serial — so your broker can stop accepting anonymous clients.
  • whiskerless backup and whiskerless restore — the whole store in one
    optionally-encrypted file. The CA key is the one thing you cannot regenerate.
  • The CLI remembers your robots. provision saves them; robots, use and
    forget manage them. A second robot asks only for its serial and WiFi password.
  • Provisioning verifies the WiFi join, so a mistyped password fails loudly
    instead of leaving you a robot that never appears.
  • Litter level as a percentage — self-calibrating, or pinned with one press.
  • LitterHopper support: connected, fill gauge, and an out-of-litter alert the
    firmware never raises. A dispense arrives as three messages ~20 s apart, so the
    level survives a restart and one dispense cannot prove an empty hopper.
  • New entities: last cat visit, visit duration (disabled until your robot
    proves it reports one), waste drawer last moved, panel brightness for bright and
    dark rooms, and excess-weight detection.
  • whiskerless status, calibrate and panel-reset.
  • New install channels: apt and dnf repositories, Homebrew with prebuilt
    bottles, .deb/.rpm, a signed macOS .pkg, and standalone Linux binaries —
    none of which need a system Python. Packages are GPG-signed
    (4BBACD5A6FF38564); setup is in the README.

  Fixed

  • Cat detection no longer mistakes weight on the scale for a cat, handling the
    robot is not a visit, and long visits are no longer dropped.
  • robotStatus 10 is the clean cycle. Unmapped, its readings were published as
    real litter levels. Readings are also suppressed while the globe is not level.
  • The globe motor fault sensor watches the activity stream, where the fault
    actually appears — the state document sat at 0 through a real fifty-minute fault.
  • Panel sleep and wake times can be set, and the weekday schedule arms every
    day rather than only Sunday.
  • whiskerless setup survives a long hostname, and reissues the broker's
    certificate when you move the broker — if it holds your CA's key. A certificate
    it did not issue is reported, never overwritten.
  • Provisioning works where the network list is not a multiple of four. The
    robot's WiFi scan is fetched in pages, and the last page asked for more than
    remained — which this firmware answers by dropping the Bluetooth link, halfway
    through provisioning. It looked like flaky Bluetooth.
  • Provisioning tells you to hold Connect, and stops scanning the moment it
    finds your robot — it only advertises while you hold the button, and the scan
    was spending that window.
  • The robot's IP address is reported instead of "no lease yet". It answers
    "connected" before DHCP replies, so the address was read a moment too early.
  • Errors are sentences, not stack traces. --debug gives the traceback and
    the request log — with the WiFi password and the robot's key left out of it.
  • A short press of Connect toggles WiFi off, which the docs called harmless —
    the robot vanishes from your broker and looks dead. Hold it for pairing mode.
  • The declared Home Assistant minimum is correct (2025.3.0).

  Changed

  • The Refresh button is on by default, on existing installs too.
  • Manual calibration buttons ship disabled — the robot calibrates itself.

  Downloads

  • Source code (ZIP)
    0 downloads
  • Source code (TAR.GZ)
    2 downloads

  ---

  • SHA256SUMS
    0 downloads · 2026-08-19 15:53:49 -07:00 · 1,011 B
  • whiskerless-0.2.0-rc.34-linux-arm64
    4 downloads · 2026-08-19 15:53:49 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.34-linux-x86_64
    4 downloads · 2026-08-19 15:53:49 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.34-macos-arm64.pkg
    3 downloads · 2026-08-19 15:30:57 -07:00 · 15 MiB
  • whiskerless-0.2.0-rc.34-macos-x86_64.pkg
    3 downloads · 2026-08-19 15:30:59 -07:00 · 14 MiB
  • whiskerless-0.2.0~rc.34.aarch64.rpm
    2 downloads · 2026-08-19 15:53:47 -07:00 · 30 MiB
  • whiskerless-0.2.0~rc.34.x86_64.rpm
    2 downloads · 2026-08-19 15:53:48 -07:00 · 31 MiB
  • whiskerless-rc--0.2.0rc34.arm64_linux.bottle.json
    4 downloads · 2026-08-19 15:56:30 -07:00 · 67 KiB
  • whiskerless-rc--0.2.0rc34.arm64_sequoia.bottle.json
    4 downloads · 2026-08-19 15:56:31 -07:00 · 114 KiB
  • whiskerless-rc--0.2.0rc34.sequoia.bottle.json
    4 downloads · 2026-08-19 15:56:31 -07:00 · 114 KiB
  • whiskerless-rc--0.2.0rc34.x86_64_linux.bottle.json
    4 downloads · 2026-08-19 15:56:32 -07:00 · 67 KiB
  • whiskerless-rc-0.2.0rc34.arm64_linux.bottle.tar.gz
    3 downloads · 2026-08-19 15:56:33 -07:00 · 3.3 MiB
  • whiskerless-rc-0.2.0rc34.arm64_sequoia.bottle.tar.gz
    7 downloads · 2026-08-19 15:56:33 -07:00 · 3.1 MiB
  • whiskerless-rc-0.2.0rc34.sequoia.bottle.tar.gz
    5 downloads · 2026-08-19 15:56:35 -07:00 · 3 MiB
  • whiskerless-rc-0.2.0rc34.x86_64_linux.bottle.tar.gz
    3 downloads · 2026-08-19 15:56:36 -07:00 · 3.3 MiB
  • whiskerless_0.2.0~rc.34_amd64.deb
    1 download · 2026-08-19 15:53:48 -07:00 · 31 MiB
  • whiskerless_0.2.0~rc.34_arm64.deb
    1 download · 2026-08-19 15:53:49 -07:00 · 30 MiB
• v0.2.0-rc.33 ab06f894be

  Compare

  v0.2.0-rc.33 Pre-release

  Cody Bryant released this 2026-08-18 23:11:47 -07:00 | 14 commits to main since this release

  The release where the robot stopped being read-only. Clean cycle and Reset are
  real buttons now, and whiskerless issues the certificates your broker needs
  instead of leaving that to you.

  Thanks to @CryingPecan, whose LitterHopper robot
  is behind much of the hopper work. Protocol detail lives in
  docs/devices/litter-robot-4/.

  Breaking changes

  • Broker usernames and passwords are gone — --username, --password and
    WHISKERLESS_PASSWORD. Everything authenticates by certificate now.
  • One broker per machine. --host and --ca moved off the everyday commands
    onto setup. A separate broker is a separate store: point WHISKERLESS_HOME at
    it.
  • --port and --insecure are gone. The robot's port is fixed in its firmware
    and it always checks the broker's name, so both could only point the CLI somewhere
    the robot cannot follow. A saved port is ignored, not an error.
  • whiskerless adopt is removed. Re-provision instead.
  • The store moved to ~/whiskerless. Your old ~/.whiskerless is moved there
    on first run.
  • binary_sensor.…_waste_drawer_removed → sensor.…_waste_drawer_last_moved.
    The robot never reports which way the drawer moved.
  • switch.…_panel_sleep_mode is now a binary sensor — the firmware refuses
    direct writes. Use the weekday schedule entities.
  • Clean cycle wait time is a number (3–30 minutes), not a select.
  • Library: Hazard.MOTOR, MotorCommandError, allow_motor,
    LitterRobot4Client and WhiskerlessAuthError are removed. Power still needs
    allow_dangerous.

  Added

  • Clean cycle and Reset buttons. Empty cycle, Power and WiFi ship disabled and
    marked (danger) — each costs a litter refill or takes the robot off the
    network. The CLI gains empty-cycle, power and wifi-toggle.
  • whiskerless runs a certificate authority for you. whiskerless setup makes
    the CA, your broker's certificate and this machine's identity, then prints the
    three files your broker needs. Bring your own with --ca and --ca-key.
  • Each robot gets its own certificate, written over BLE and named for its
    serial — so your broker can stop accepting anonymous clients.
  • whiskerless backup and whiskerless restore — the whole store in one
    optionally-encrypted file. The CA key is the one thing you cannot regenerate.
  • The CLI remembers your robots. provision saves them; robots, use and
    forget manage them. A second robot asks only for its serial and WiFi password.
  • Provisioning verifies the WiFi join, so a mistyped password fails loudly
    instead of leaving you a robot that never appears.
  • Litter level as a percentage — self-calibrating, or pinned with one press.
  • LitterHopper support: connected, fill gauge, and an out-of-litter alert the
    firmware never raises. A dispense arrives as three messages ~20 s apart, so the
    level survives a restart and one dispense cannot prove an empty hopper.
  • New entities: last cat visit, visit duration (disabled until your robot
    proves it reports one), waste drawer last moved, panel brightness for bright and
    dark rooms, and excess-weight detection.
  • whiskerless status, calibrate and panel-reset.
  • New install channels: apt and dnf repositories, Homebrew with prebuilt
    bottles, .deb/.rpm, a signed macOS .pkg, and standalone Linux binaries —
    none of which need a system Python. Packages are GPG-signed
    (4BBACD5A6FF38564); setup is in the README.

  Fixed

  • Cat detection no longer mistakes weight on the scale for a cat, handling the
    robot is not a visit, and long visits are no longer dropped.
  • robotStatus 10 is the clean cycle. Unmapped, its readings were published as
    real litter levels. Readings are also suppressed while the globe is not level.
  • The globe motor fault sensor watches the activity stream, where the fault
    actually appears — the state document sat at 0 through a real fifty-minute fault.
  • Panel sleep and wake times can be set, and the weekday schedule arms every
    day rather than only Sunday.
  • whiskerless setup survives a long hostname, and reissues the broker's
    certificate when you move the broker — if it holds your CA's key. A certificate
    it did not issue is reported, never overwritten.
  • Provisioning works where the network list is not a multiple of four. The
    robot's WiFi scan is fetched in pages, and the last page asked for more than
    remained — which this firmware answers by dropping the Bluetooth link, halfway
    through provisioning. It looked like flaky Bluetooth.
  • Provisioning tells you to hold Connect, and stops scanning the moment it
    finds your robot — it only advertises while you hold the button, and the scan
    was spending that window.
  • The robot's IP address is reported instead of "no lease yet". It answers
    "connected" before DHCP replies, so the address was read a moment too early.
  • Errors are sentences, not stack traces. --debug gives the traceback and
    the request log — with the WiFi password and the robot's key left out of it.
  • A short press of Connect toggles WiFi off, which the docs called harmless —
    the robot vanishes from your broker and looks dead. Hold it for pairing mode.
  • The declared Home Assistant minimum is correct (2025.3.0).

  Changed

  • The Refresh button is on by default, on existing installs too.
  • Manual calibration buttons ship disabled — the robot calibrates itself.

  Downloads

  • Source code (ZIP)
    0 downloads
  • Source code (TAR.GZ)
    2 downloads

  ---

  • SHA256SUMS
    0 downloads · 2026-08-18 23:37:27 -07:00 · 1,011 B
  • whiskerless-0.2.0-rc.33-linux-arm64
    3 downloads · 2026-08-18 23:37:27 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.33-linux-x86_64
    3 downloads · 2026-08-18 23:37:27 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.33-macos-arm64.pkg
    3 downloads · 2026-08-18 23:15:08 -07:00 · 15 MiB
  • whiskerless-0.2.0-rc.33-macos-x86_64.pkg
    3 downloads · 2026-08-18 23:15:12 -07:00 · 14 MiB
  • whiskerless-0.2.0~rc.33.aarch64.rpm
    2 downloads · 2026-08-18 23:37:26 -07:00 · 30 MiB
  • whiskerless-0.2.0~rc.33.x86_64.rpm
    2 downloads · 2026-08-18 23:37:26 -07:00 · 31 MiB
  • whiskerless-rc--0.2.0rc33.arm64_linux.bottle.json
    3 downloads · 2026-08-18 23:38:17 -07:00 · 67 KiB
  • whiskerless-rc--0.2.0rc33.arm64_sequoia.bottle.json
    3 downloads · 2026-08-18 23:38:18 -07:00 · 114 KiB
  • whiskerless-rc--0.2.0rc33.sequoia.bottle.json
    3 downloads · 2026-08-18 23:38:19 -07:00 · 114 KiB
  • whiskerless-rc--0.2.0rc33.x86_64_linux.bottle.json
    3 downloads · 2026-08-18 23:38:19 -07:00 · 67 KiB
  • whiskerless-rc-0.2.0rc33.arm64_linux.bottle.tar.gz
    3 downloads · 2026-08-18 23:38:21 -07:00 · 3.3 MiB
  • whiskerless-rc-0.2.0rc33.arm64_sequoia.bottle.tar.gz
    5 downloads · 2026-08-18 23:38:21 -07:00 · 3 MiB
  • whiskerless-rc-0.2.0rc33.sequoia.bottle.tar.gz
    5 downloads · 2026-08-18 23:38:22 -07:00 · 3 MiB
  • whiskerless-rc-0.2.0rc33.x86_64_linux.bottle.tar.gz
    3 downloads · 2026-08-18 23:38:24 -07:00 · 3.3 MiB
  • whiskerless_0.2.0~rc.33_amd64.deb
    1 download · 2026-08-18 23:37:27 -07:00 · 31 MiB
  • whiskerless_0.2.0~rc.33_arm64.deb
    1 download · 2026-08-18 23:37:27 -07:00 · 30 MiB
• v0.2.0-rc.32 a0b358e3cf

  Compare

  v0.2.0-rc.32 Pre-release

  Cody Bryant released this 2026-08-18 19:00:33 -07:00 | 19 commits to main since this release

  The release where the robot stopped being read-only. Clean cycle and Reset are
  real buttons now, and whiskerless issues the certificates your broker needs
  instead of leaving that to you.

  Thanks to @CryingPecan, whose LitterHopper robot
  is behind much of the hopper work. Protocol detail lives in
  docs/devices/litter-robot-4/.

  Breaking changes

  • Broker usernames and passwords are gone — --username, --password and
    WHISKERLESS_PASSWORD. Everything authenticates by certificate now.
  • One broker per machine. --host and --ca moved off the everyday commands
    onto setup. A separate broker is a separate store: point WHISKERLESS_HOME at
    it.
  • --port and --insecure are gone. The robot's port is fixed in its firmware
    and it always checks the broker's name, so both could only point the CLI somewhere
    the robot cannot follow. A saved port is ignored, not an error.
  • whiskerless adopt is removed. Re-provision instead.
  • The store moved to ~/whiskerless. Your old ~/.whiskerless is moved there
    on first run.
  • binary_sensor.…_waste_drawer_removed → sensor.…_waste_drawer_last_moved.
    The robot never reports which way the drawer moved.
  • switch.…_panel_sleep_mode is now a binary sensor — the firmware refuses
    direct writes. Use the weekday schedule entities.
  • Clean cycle wait time is a number (3–30 minutes), not a select.
  • Library: Hazard.MOTOR, MotorCommandError, allow_motor,
    LitterRobot4Client and WhiskerlessAuthError are removed. Power still needs
    allow_dangerous.

  Added

  • Clean cycle and Reset buttons. Empty cycle, Power and WiFi ship disabled and
    marked (danger) — each costs a litter refill or takes the robot off the
    network. The CLI gains empty-cycle, power and wifi-toggle.
  • whiskerless runs a certificate authority for you. whiskerless setup makes
    the CA, your broker's certificate and this machine's identity, then prints the
    three files your broker needs. Bring your own with --ca and --ca-key.
  • Each robot gets its own certificate, written over BLE and named for its
    serial — so your broker can stop accepting anonymous clients.
  • whiskerless backup and whiskerless restore — the whole store in one
    optionally-encrypted file. The CA key is the one thing you cannot regenerate.
  • The CLI remembers your robots. provision saves them; robots, use and
    forget manage them. A second robot asks only for its serial and WiFi password.
  • Provisioning verifies the WiFi join, so a mistyped password fails loudly
    instead of leaving you a robot that never appears.
  • Litter level as a percentage — self-calibrating, or pinned with one press.
  • LitterHopper support: connected, fill gauge, and an out-of-litter alert the
    firmware never raises. A dispense arrives as three messages ~20 s apart, so the
    level survives a restart and one dispense cannot prove an empty hopper.
  • New entities: last cat visit, visit duration (disabled until your robot
    proves it reports one), waste drawer last moved, panel brightness for bright and
    dark rooms, and excess-weight detection.
  • whiskerless status, calibrate and panel-reset.
  • New install channels: apt and dnf repositories, Homebrew with prebuilt
    bottles, .deb/.rpm, a signed macOS .pkg, and standalone Linux binaries —
    none of which need a system Python. Packages are GPG-signed
    (4BBACD5A6FF38564); setup is in the README.

  Fixed

  • Cat detection no longer mistakes weight on the scale for a cat, handling the
    robot is not a visit, and long visits are no longer dropped.
  • robotStatus 10 is the clean cycle. Unmapped, its readings were published as
    real litter levels. Readings are also suppressed while the globe is not level.
  • The globe motor fault sensor watches the activity stream, where the fault
    actually appears — the state document sat at 0 through a real fifty-minute fault.
  • Panel sleep and wake times can be set, and the weekday schedule arms every
    day rather than only Sunday.
  • whiskerless setup survives a long hostname, and reissues the broker's
    certificate when you move the broker — if it holds your CA's key. A certificate
    it did not issue is reported, never overwritten.
  • Provisioning stops scanning the moment it finds your robot — a robot only
    advertises while you hold Connect, and it was spending that window.
  • Errors are sentences, not stack traces. --debug still gives the traceback.
  • A short press of Connect toggles WiFi off, which the docs called harmless —
    the robot vanishes from your broker and looks dead. Hold it for pairing mode.
  • The declared Home Assistant minimum is correct (2025.3.0).

  Changed

  • The Refresh button is on by default, on existing installs too.
  • Manual calibration buttons ship disabled — the robot calibrates itself.

  Downloads

  • Source code (ZIP)
    0 downloads
  • Source code (TAR.GZ)
    2 downloads

  ---

  • SHA256SUMS
    0 downloads · 2026-08-18 19:31:36 -07:00 · 1,011 B
  • whiskerless-0.2.0-rc.32-linux-arm64
    3 downloads · 2026-08-18 19:31:35 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.32-linux-x86_64
    3 downloads · 2026-08-18 19:31:36 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.32-macos-arm64.pkg
    3 downloads · 2026-08-18 19:04:45 -07:00 · 15 MiB
  • whiskerless-0.2.0-rc.32-macos-x86_64.pkg
    3 downloads · 2026-08-18 19:04:47 -07:00 · 14 MiB
  • whiskerless-0.2.0~rc.32.aarch64.rpm
    2 downloads · 2026-08-18 19:31:33 -07:00 · 30 MiB
  • whiskerless-0.2.0~rc.32.x86_64.rpm
    2 downloads · 2026-08-18 19:31:33 -07:00 · 31 MiB
  • whiskerless-rc--0.2.0rc32.arm64_linux.bottle.json
    3 downloads · 2026-08-18 19:34:03 -07:00 · 67 KiB
  • whiskerless-rc--0.2.0rc32.arm64_sequoia.bottle.json
    3 downloads · 2026-08-18 19:34:04 -07:00 · 114 KiB
  • whiskerless-rc--0.2.0rc32.sequoia.bottle.json
    3 downloads · 2026-08-18 19:34:05 -07:00 · 114 KiB
  • whiskerless-rc--0.2.0rc32.x86_64_linux.bottle.json
    3 downloads · 2026-08-18 19:34:05 -07:00 · 67 KiB
  • whiskerless-rc-0.2.0rc32.arm64_linux.bottle.tar.gz
    3 downloads · 2026-08-18 19:34:06 -07:00 · 3.3 MiB
  • whiskerless-rc-0.2.0rc32.arm64_sequoia.bottle.tar.gz
    8 downloads · 2026-08-18 19:34:08 -07:00 · 3 MiB
  • whiskerless-rc-0.2.0rc32.sequoia.bottle.tar.gz
    5 downloads · 2026-08-18 19:34:09 -07:00 · 3 MiB
  • whiskerless-rc-0.2.0rc32.x86_64_linux.bottle.tar.gz
    3 downloads · 2026-08-18 19:34:11 -07:00 · 3.3 MiB
  • whiskerless_0.2.0~rc.32_amd64.deb
    1 download · 2026-08-18 19:31:33 -07:00 · 31 MiB
  • whiskerless_0.2.0~rc.32_arm64.deb
    1 download · 2026-08-18 19:31:35 -07:00 · 30 MiB
• v0.2.0-rc.31 a35d40a793

  Compare

  v0.2.0-rc.31 Pre-release

  Cody Bryant released this 2026-08-18 16:18:56 -07:00 | 21 commits to main since this release

  The release where the robot stopped being read-only. Clean cycle and Reset are
  real buttons now, and whiskerless issues the certificates your broker needs
  instead of leaving that to you.

  Thanks to @CryingPecan, whose LitterHopper robot
  is behind much of the hopper work. Protocol detail lives in
  docs/devices/litter-robot-4/.

  Breaking changes

  • Broker usernames and passwords are gone — --username, --password and
    WHISKERLESS_PASSWORD. Everything authenticates by certificate now.
  • One broker per machine. --host and --ca moved off the everyday commands
    onto setup. A separate broker is a separate store: point WHISKERLESS_HOME at
    it.
  • --port and --insecure are gone. The robot's port is fixed in its firmware
    and it always checks the broker's name, so both could only point the CLI somewhere
    the robot cannot follow. A saved port is ignored, not an error.
  • whiskerless adopt is removed. Re-provision instead.
  • The store moved to ~/whiskerless. Your old ~/.whiskerless is moved there
    on first run.
  • binary_sensor.…_waste_drawer_removed → sensor.…_waste_drawer_last_moved.
    The robot never reports which way the drawer moved.
  • switch.…_panel_sleep_mode is now a binary sensor — the firmware refuses
    direct writes. Use the weekday schedule entities.
  • Clean cycle wait time is a number (3–30 minutes), not a select.
  • Library: Hazard.MOTOR, MotorCommandError, allow_motor,
    LitterRobot4Client and WhiskerlessAuthError are removed. Power still needs
    allow_dangerous.

  Added

  • Clean cycle and Reset buttons. Empty cycle, Power and WiFi ship disabled and
    marked (danger) — each costs a litter refill or takes the robot off the
    network. The CLI gains empty-cycle, power and wifi-toggle.
  • whiskerless runs a certificate authority for you. whiskerless setup makes
    the CA, your broker's certificate and this machine's identity, then prints the
    three files your broker needs. Bring your own with --ca and --ca-key.
  • Each robot gets its own certificate, written over BLE and named for its
    serial — so your broker can stop accepting anonymous clients.
  • whiskerless backup and whiskerless restore — the whole store in one
    optionally-encrypted file. The CA key is the one thing you cannot regenerate.
  • The CLI remembers your robots. provision saves them; robots, use and
    forget manage them. A second robot asks only for its serial and WiFi password.
  • Provisioning verifies the WiFi join, so a mistyped password fails loudly
    instead of leaving you a robot that never appears.
  • Litter level as a percentage — self-calibrating, or pinned with one press.
  • LitterHopper support: connected, fill gauge, and an out-of-litter alert the
    firmware never raises. A dispense arrives as three messages ~20 s apart, so the
    level survives a restart and one dispense cannot prove an empty hopper.
  • New entities: last cat visit, visit duration (disabled until your robot
    proves it reports one), waste drawer last moved, panel brightness for bright and
    dark rooms, and excess-weight detection.
  • whiskerless status, calibrate and panel-reset.
  • New install channels: apt and dnf repositories, Homebrew with prebuilt
    bottles, .deb/.rpm, a signed macOS .pkg, and standalone Linux binaries —
    none of which need a system Python. Packages are GPG-signed
    (4BBACD5A6FF38564); setup is in the README.

  Fixed

  • Cat detection no longer mistakes weight on the scale for a cat, handling the
    robot is not a visit, and long visits are no longer dropped.
  • robotStatus 10 is the clean cycle. Unmapped, its readings were published as
    real litter levels. Readings are also suppressed while the globe is not level.
  • The globe motor fault sensor watches the activity stream, where the fault
    actually appears — the state document sat at 0 through a real fifty-minute fault.
  • Panel sleep and wake times can be set, and the weekday schedule arms every
    day rather than only Sunday.
  • whiskerless setup survives a long hostname, and reissues the broker's
    certificate when you move the broker — if it holds your CA's key. A certificate
    it did not issue is reported, never overwritten.
  • Provisioning stops scanning the moment it finds your robot — a robot only
    advertises while you hold Connect, and it was spending that window.
  • Errors are sentences, not stack traces. --debug still gives the traceback.
  • A short press of Connect toggles WiFi off, which the docs called harmless —
    the robot vanishes from your broker and looks dead. Hold it for pairing mode.
  • The declared Home Assistant minimum is correct (2025.3.0).

  Changed

  • The Refresh button is on by default, on existing installs too.
  • Manual calibration buttons ship disabled — the robot calibrates itself.

  Downloads

  • Source code (ZIP)
    0 downloads
  • Source code (TAR.GZ)
    6 downloads

  ---

  • SHA256SUMS
    0 downloads · 2026-08-18 16:46:26 -07:00 · 1,011 B
  • whiskerless-0.2.0-rc.31-linux-arm64
    6 downloads · 2026-08-18 16:46:25 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.31-linux-x86_64
    2 downloads · 2026-08-18 16:46:25 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.31-macos-arm64.pkg
    3 downloads · 2026-08-18 16:23:03 -07:00 · 15 MiB
  • whiskerless-0.2.0-rc.31-macos-x86_64.pkg
    3 downloads · 2026-08-18 16:23:04 -07:00 · 14 MiB
  • whiskerless-0.2.0~rc.31.aarch64.rpm
    2 downloads · 2026-08-18 16:46:25 -07:00 · 30 MiB
  • whiskerless-0.2.0~rc.31.x86_64.rpm
    1 download · 2026-08-18 16:46:25 -07:00 · 31 MiB
  • whiskerless-rc--0.2.0rc31.arm64_linux.bottle.json
    3 downloads · 2026-08-18 16:44:52 -07:00 · 67 KiB
  • whiskerless-rc--0.2.0rc31.arm64_sequoia.bottle.json
    3 downloads · 2026-08-18 16:44:53 -07:00 · 114 KiB
  • whiskerless-rc--0.2.0rc31.sequoia.bottle.json
    3 downloads · 2026-08-18 16:44:54 -07:00 · 114 KiB
  • whiskerless-rc--0.2.0rc31.x86_64_linux.bottle.json
    3 downloads · 2026-08-18 16:44:55 -07:00 · 67 KiB
  • whiskerless-rc-0.2.0rc31.arm64_linux.bottle.tar.gz
    3 downloads · 2026-08-18 16:44:56 -07:00 · 3.3 MiB
  • whiskerless-rc-0.2.0rc31.arm64_sequoia.bottle.tar.gz
    5 downloads · 2026-08-18 16:44:57 -07:00 · 3 MiB
  • whiskerless-rc-0.2.0rc31.sequoia.bottle.tar.gz
    5 downloads · 2026-08-18 16:44:58 -07:00 · 3 MiB
  • whiskerless-rc-0.2.0rc31.x86_64_linux.bottle.tar.gz
    3 downloads · 2026-08-18 16:44:59 -07:00 · 3.3 MiB
  • whiskerless_0.2.0~rc.31_amd64.deb
    1 download · 2026-08-18 16:46:25 -07:00 · 31 MiB
  • whiskerless_0.2.0~rc.31_arm64.deb
    1 download · 2026-08-18 16:46:25 -07:00 · 30 MiB
• v0.2.0-rc.30 b05b2ba0da

  Compare

  v0.2.0-rc.30 Pre-release

  Cody Bryant released this 2026-08-18 13:57:22 -07:00 | 25 commits to main since this release

  The release where the robot stopped being read-only. Clean cycle and Reset are
  real buttons now, and whiskerless issues the certificates your broker needs
  instead of leaving that to you.

  Thanks to @CryingPecan, whose LitterHopper robot
  is behind much of the hopper work. Protocol detail lives in
  docs/devices/litter-robot-4/.

  Breaking changes

  • Broker usernames and passwords are gone — --username, --password and
    WHISKERLESS_PASSWORD. Everything authenticates by certificate now.
  • One broker per machine. --host and --ca moved off the everyday commands
    onto setup. A separate broker is a separate store: point WHISKERLESS_HOME at
    it.
  • --port and --insecure are gone. The robot's port is fixed in its firmware
    and it always checks the broker's name, so both could only point the CLI somewhere
    the robot cannot follow. A saved port is ignored, not an error.
  • whiskerless adopt is removed. Re-provision instead.
  • The store moved to ~/whiskerless. Your old ~/.whiskerless is moved there
    on first run.
  • binary_sensor.…_waste_drawer_removed → sensor.…_waste_drawer_last_moved.
    The robot never reports which way the drawer moved.
  • switch.…_panel_sleep_mode is now a binary sensor — the firmware refuses
    direct writes. Use the weekday schedule entities.
  • Clean cycle wait time is a number (3–30 minutes), not a select.
  • Library: Hazard.MOTOR, MotorCommandError, allow_motor,
    LitterRobot4Client and WhiskerlessAuthError are removed. Power still needs
    allow_dangerous.

  Added

  • Clean cycle and Reset buttons. Empty cycle, Power and WiFi ship disabled and
    marked (danger) — each costs a litter refill or takes the robot off the
    network. The CLI gains empty-cycle, power and wifi-toggle.
  • whiskerless runs a certificate authority for you. whiskerless setup makes
    the CA, your broker's certificate and this machine's identity, then prints the
    three files your broker needs. Bring your own with --ca and --ca-key.
  • Each robot gets its own certificate, written over BLE and named for its
    serial — so your broker can stop accepting anonymous clients.
  • whiskerless backup and whiskerless restore — the whole store in one
    optionally-encrypted file. The CA key is the one thing you cannot regenerate.
  • The CLI remembers your robots. provision saves them; robots, use and
    forget manage them. A second robot asks only for its serial and WiFi password.
  • Provisioning verifies the WiFi join, so a mistyped password fails loudly
    instead of leaving you a robot that never appears.
  • Litter level as a percentage — self-calibrating, or pinned with one press.
  • LitterHopper support: connected, fill gauge, and an out-of-litter alert the
    firmware never raises. A dispense arrives as three messages ~20 s apart, so the
    level survives a restart and one dispense cannot prove an empty hopper.
  • New entities: last cat visit, visit duration (disabled until your robot
    proves it reports one), waste drawer last moved, panel brightness for bright and
    dark rooms, and excess-weight detection.
  • whiskerless status, calibrate and panel-reset.
  • New install channels: apt and dnf repositories, Homebrew with prebuilt
    bottles, .deb/.rpm, a signed macOS .pkg, and standalone Linux binaries —
    none of which need a system Python. Packages are GPG-signed
    (4BBACD5A6FF38564); setup is in the README.

  Fixed

  • Cat detection no longer mistakes weight on the scale for a cat, handling the
    robot is not a visit, and long visits are no longer dropped.
  • robotStatus 10 is the clean cycle. Unmapped, its readings were published as
    real litter levels. Readings are also suppressed while the globe is not level.
  • The globe motor fault sensor watches the activity stream, where the fault
    actually appears — the state document sat at 0 through a real fifty-minute fault.
  • Panel sleep and wake times can be set, and the weekday schedule arms every
    day rather than only Sunday.
  • whiskerless setup survives a long hostname, and reissues the broker's
    certificate when you move the broker — if it holds your CA's key. A certificate
    it did not issue is reported, never overwritten.
  • Provisioning stops scanning the moment it finds your robot — a robot only
    advertises while you hold Connect, and it was spending that window.
  • Errors are sentences, not stack traces. --debug still gives the traceback.
  • A short press of Connect toggles WiFi off, which the docs called harmless —
    the robot vanishes from your broker and looks dead. Hold it for pairing mode.
  • The declared Home Assistant minimum is correct (2025.3.0).

  Changed

  • The Refresh button is on by default, on existing installs too.
  • Manual calibration buttons ship disabled — the robot calibrates itself.

  Downloads

  • Source code (ZIP)
    0 downloads
  • Source code (TAR.GZ)
    0 downloads

  ---

  • SHA256SUMS
    0 downloads · 2026-08-18 14:23:31 -07:00 · 1,011 B
  • whiskerless-0.2.0-rc.30-linux-arm64
    5 downloads · 2026-08-18 14:23:30 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.30-linux-x86_64
    4 downloads · 2026-08-18 14:23:31 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.30-macos-arm64.pkg
    3 downloads · 2026-08-18 14:00:11 -07:00 · 15 MiB
  • whiskerless-0.2.0-rc.30-macos-x86_64.pkg
    3 downloads · 2026-08-18 14:00:13 -07:00 · 14 MiB
  • whiskerless-0.2.0~rc.30.aarch64.rpm
    2 downloads · 2026-08-18 14:23:29 -07:00 · 30 MiB
  • whiskerless-0.2.0~rc.30.x86_64.rpm
    2 downloads · 2026-08-18 14:23:29 -07:00 · 31 MiB
  • whiskerless-rc--0.2.0rc30.arm64_linux.bottle.json
    4 downloads · 2026-08-18 14:19:04 -07:00 · 67 KiB
  • whiskerless-rc--0.2.0rc30.arm64_sequoia.bottle.json
    4 downloads · 2026-08-18 14:19:04 -07:00 · 114 KiB
  • whiskerless-rc--0.2.0rc30.sequoia.bottle.json
    4 downloads · 2026-08-18 14:19:05 -07:00 · 114 KiB
  • whiskerless-rc--0.2.0rc30.x86_64_linux.bottle.json
    4 downloads · 2026-08-18 14:19:05 -07:00 · 67 KiB
  • whiskerless-rc-0.2.0rc30.arm64_linux.bottle.tar.gz
    5 downloads · 2026-08-18 14:19:05 -07:00 · 3.3 MiB
  • whiskerless-rc-0.2.0rc30.arm64_sequoia.bottle.tar.gz
    7 downloads · 2026-08-18 14:19:06 -07:00 · 3 MiB
  • whiskerless-rc-0.2.0rc30.sequoia.bottle.tar.gz
    5 downloads · 2026-08-18 14:19:06 -07:00 · 3 MiB
  • whiskerless-rc-0.2.0rc30.x86_64_linux.bottle.tar.gz
    5 downloads · 2026-08-18 14:19:07 -07:00 · 3.3 MiB
  • whiskerless_0.2.0~rc.30_amd64.deb
    2 downloads · 2026-08-18 14:23:29 -07:00 · 31 MiB
  • whiskerless_0.2.0~rc.30_arm64.deb
    3 downloads · 2026-08-18 14:23:29 -07:00 · 30 MiB
• v0.2.0-rc.29 43d0bf4beb

  Compare

  v0.2.0-rc.29 Pre-release

  Cody Bryant released this 2026-08-18 11:42:57 -07:00 | 29 commits to main since this release

  The release where the robot stopped being read-only. Whiskerless could always
  watch a Litter-Robot 4 and change its settings; it could not press anything. The
  panel button register turned out to be writable, so Clean cycle and Reset are
  real buttons now — they emit the exact code the panel does, which means the
  firmware's pinch, cat-detect and bonnet interlocks apply to them just as they do
  to a finger. Two other things changed the day-to-day: provisioning no longer
  fails silently when you mistype the WiFi password, and the CLI remembers your
  robots instead of wanting a wall of flags on every command.

  Thanks to @CryingPecan, whose LitterHopper robot
  on ESP 1.4.4 is behind much of what's below. Protocol detail lives in
  docs/devices/litter-robot-4/.

  Breaking changes

  Worth reading before you upgrade; the rest of the list is safe to skim.

  • Broker usernames and passwords are gone. --username, --password and
    WHISKERLESS_PASSWORD no longer exist, and neither does the profile field. The
    robot cannot send credentials at all, so running two authentication schemes
    against one broker only bought complexity — everything identifies by
    certificate now, the CLI included.

  • One broker per machine. The broker, its port and its CA moved off each
    robot and into the store, because every robot in a house talks to the same one.
    --host, --port, --ca and --insecure are gone from the everyday commands
    and live on setup, which is where the broker is established. A genuinely
    separate broker is a separate store: point WHISKERLESS_HOME at it.

  • whiskerless adopt is removed. With the broker no longer per-robot it only
    recorded a serial, and it could never give the robot the certificate it now
    needs. Re-provision instead.

  • The store moved to ~/whiskerless — no leading dot, so the folder you are
    told to back up is one you can find. Your existing ~/.whiskerless is moved
    there automatically the first time you run anything.

  • binary_sensor.<robot>_waste_drawer_removed → sensor.<robot>_waste_drawer_last_moved.
    The robot reports that the drawer moved and never which way, so a binary
    sensor was claiming more than the hardware says.

  • switch.<robot>_panel_sleep_mode → a binary sensor. The firmware refuses
    direct writes to it, so the switch could only ever fail. The weekday schedule
    entities are the control.

  • Clean cycle wait time is a number (3–30 minutes), not a select.

  • Library: Hazard.MOTOR, MotorCommandError and allow_motor are gone. A
    written press is the same event as a physical one, so that gate gated a hazard
    that does not exist — and every caller passed the flag unconditionally, which
    made the real gates look like the same formality. Power still requires
    allow_dangerous.

  • Library: LitterRobot4Client and WhiskerlessAuthError are removed. Nothing
    used them, and the client had become a third, already-drifting copy of the
    write-verify loop.

  • Homebrew gained build dependencies — rust and openssl@3 — because
    certificates became core function and cryptography is a Rust extension that
    Homebrew builds from source. This briefly meant a multi-minute, ~2.4 GB
    install; bottles now make it instant again (see Added), so it only bites on
    a platform we do not bottle. Nothing about the installed result changes, and
    every other install path (PyPI/pipx/uvx, the macOS .pkg, .deb/.rpm) uses
    wheels and was never affected.

  Added

  • Clean cycle and Reset buttons, and they actually work. Proven on ESP 1.1.75
    and 1.4.4. This is the project's first recovered action command; the old "no
    action commands exist" framing is dead.
  • Empty cycle, Power and WiFi, shipped disabled and named (danger) — an
    empty cycle costs a litter refill, and a robot that is switched off, or has had
    its WiFi switched off, has left the network, so nothing over MQTT brings it
    back. WiFi is the panel's Connect button: it took the robot off the broker
    in 0.8 seconds, panel light white, and only a physical press undoes it. The CLI
    gains empty-cycle, power and wifi-toggle; all three prompt first, and the
    two that can end the connection have no --yes.
  • Provisioning verifies the WiFi join. A mistyped passphrase used to sail
    through silently — the robot accepted everything, rebooted, and simply never
    appeared on any network, which is indistinguishable from a dead unit. The robot
    names that failure if asked, so provisioning now polls the join status and stops
    with "mistyped WiFi password" before touching the broker config; a confirmed
    join prints the robot's IP and moves on early. Firmware that stays silent gets
    the old wait.
  • The CLI remembers your robots. provision saves the serial, broker and CA
    under ~/whiskerless; later commands run bare.
    robots, use and forget list, pick and drop them — damaged profiles are
    shown as such and can still be removed.
  • A second robot inherits the saved setup — each prompt offers what your
    robots already share, so you type only the serial and the WiFi password.
  • whiskerless setup is a new command, run once before any robot. It
    establishes your broker's address and its certificates, and prints the three
    files to install on the broker. Deliberately separate from provision:
    between generating those files and a robot being able to use them, somebody has
    to install them and restart the broker — and a robot in pairing mode is holding
    a short window open the whole time. provision now refuses on a machine that
    has not been set up, and says so.
  • whiskerless runs a certificate authority for you. The Litter-Robot cannot
    send a username or a password — its firmware has no field for one, because it
    was built for AWS IoT, which authenticates clients by certificate. So
    certificates are the only authentication it has, and the first provision on a
    machine offers to set the whole thing up: a CA, your broker's server
    certificate, and an identity for this machine. Press enter and it is done. It
    prints the three files your broker needs and which mosquitto directive each one
    goes with. Already have a CA? Point at it with --ca, add --ca-key if you
    want certificates issued here, and it is copied into place under our names.
  • whiskerless backup and whiskerless restore. "Back up ~/whiskerless"
    is advice people follow exactly as often as it is convenient, and the CA
    private key in there is the one thing that cannot be regenerated — losing it
    costs you the ability to add or re-provision a robot without walking to every
    robot you own. backup writes one file; restore puts it back. Leave the
    path off either and it asks — restore lists the backups it can see, newest
    first, and takes a number. Each archive is named for the moment it was made
    and never replaces an earlier one, because that earlier file may be the copy
    from before whatever you are about to change; the timestamp lives in the
    name because it is the only part that survives being copied to a stick or
    pulled out of a snapshot. It offers to
    encrypt (AES-256-GCM, scrypt) and an unattended run has to say --no-password
    or set WHISKERLESS_BACKUP_PASSWORD rather than write a signing key in the
    clear by default. Unencrypted it is an ordinary .tar.gz, because this is a
    file you open once, years later, possibly on a machine with no whiskerless on
    it. restore refuses to replace an existing setup unless you pass --force,
    and the refusal says whether the CA differs and names the robots that would
    stop trusting your broker; --force moves the old store aside rather than
    deleting it.
  • Each robot gets its own certificate, signed by your CA, written over BLE
    exactly the way the Whisker app writes its own — same order, same 100-byte
    chunks, same single apply. Its common name is the robot's serial, so
    use_identity_as_username makes your broker log the robot by name. Nothing
    keeps a copy: the robot holds the only one, and a replacement is one
    re-provision away.
  • Your broker can stop accepting anonymous clients. That was never a
    workaround for a missing feature — it was the only option when the robot had no
    identity of its own to present. Now it has one. Without a CA key to sign with,
    provisioning says so loudly and leaves the robot's factory certificate alone,
    which is exactly how whiskerless worked before.
  • Litter level as a percentage — self-calibrating over time, or pinned
    instantly by one button press with the globe filled the way you consider full.
  • LitterHopper support: connected, fill gauge, and an out-of-litter alert the
    firmware never raises. The entities enable themselves at the first dispense.
  • New entities: last cat visit, last visit duration, waste drawer last moved,
    panel brightness for bright and dark rooms, and excess-weight detection — the
    stuck-scale condition the robot otherwise only shows on its own panel.
  • whiskerless status — the robot in plain terms from a single fresh reading:
    level, drawer, faults, calibration. It names what needs a listener rather than
    printing zeros. whiskerless calibrate full|empty stores your own litter
    reference per robot and refuses a reading that cannot be one, and
    whiskerless panel-reset presses Reset.
  • Activity-derived entities survive a restart instead of reading unknown until
    the next cat visit.
  • New install channels: Homebrew, .deb/.rpm, and standalone Linux binaries
    for amd64 and arm64 — none of which need a system Python.
  • apt and dnf repositories, so Linux installs and upgrades come through the
    package manager instead of a downloaded file. Two channels — stable and
    testing — because version ordering alone cannot keep a candidate away from
    release subscribers until the release it precedes actually exists. Setup, and
    the one-time key import it cannot avoid, is in the README. The packages are
    GPG-signed (4BBACD5A6FF38564); on dnf that signature is what gpgcheck
    verifies, while apt authenticates the repository index Forgejo signs.
  • Homebrew bottles, so brew install pours a prebuilt keg in seconds instead
    of downloading ~2.4 GB of rust and llvm to compile cryptography. Four
    platforms: Apple Silicon and Intel macOS, and Linux on both architectures.
    Anything unbottled still installs exactly as before, just slowly.
  • The CLI shows liveness and colour: a spinner on the BLE scan (heartbeat lines
    when piped), banners on the dangerous prompts, NO_COLOR honoured.
    whiskerless --version works, and a bare whiskerless prints an
    orientation instead of a usage error.
  • The README covers the whole journey: prerequisites, per-platform installs
    including Homebrew, everyday use, upgrading, the rc channel, uninstalling.
  • The integration has an icon and a logo, shipped inside it and served by Home
    Assistant 2026.3+; older versions simply show what they show today.

  Fixed

  • whiskerless setup no longer dies on a machine with a long hostname. The
    certificate it issues for this machine is named whiskerless-<hostname>, and
    X.509 caps a common name at 64 bytes — so a long enough hostname made
    cryptography raise and took the whole command down with a traceback. Names
    are now truncated on a character boundary; the full name still goes in the
    SAN, which is what TLS actually verifies.
  • Moving your broker reissues its certificate. setup --host <new> used to
    record the new address while leaving the old certificate in place, then print
    those same files and tell you to install them — handing the robot a
    certificate naming somewhere it does not connect, which fails every handshake
    and looks exactly like a broken robot. It is reissued when the host changes,
    and says so; without a CA key to sign with, it tells you to replace it
    yourself instead of staying quiet.
  • Provisioning stops scanning the moment it finds your robot. It used to run
    the whole --scan-timeout even after the robot answered — and since a robot
    only advertises while you hold Connect, that spent the pairing window instead
    of using it. One bench attempt found the robot and then failed to connect,
    because it had gone quiet by the time the scan ended.
  • The WiFi check no longer reports 0.0.0.0 as your robot's address. The
    robot says "connected" the instant it associates, before DHCP hands out a
    lease, so the join is confirmed but the address is not yet known — and printing
    the unset one claimed a fact it did not have.
  • Pet weight is right again (raw ÷ 100, the cloud's own units) — recent rc
    builds doubled the reading.
  • The weekday sleep schedule arms every day, not just Sunday, and the panel
    sleep and wake times can actually be set — they now write the per-day
    registers instead of one the firmware only computes.
  • robotStatus 10 is the clean cycle, with the boot cycle and filter wizard
    mapped too. Left unmapped, their readings were published as real litter levels.
  • Litter readings are suppressed while the globe is not level — mid-cycle the
    sensors are looking at the globe, not the litter. The first reading after a
    restart is no longer discarded either.
  • The globe motor fault sensor watches the activity stream, where the fault
    actually appears — the state document sat at 0 through a real fifty-minute
    fault. A restored fault can also clear after a missed clear event, on the proof
    of a clean cycle completing.
  • Cat detection no longer mistakes weight on the scale for a cat — occupancy
    uses the bit that tracks the animal, not the one a misseated bonnet holds — and
    handling the robot no longer counts as a visit.
  • A long cat visit is no longer dropped. The close was matched against a
    90-second window, and the cats that sit longest fell outside it. Last cat
    visit now updates on every robot, stamping from occupancy rather than only
    from weight events, which one robot never sends.
  • Hopper telemetry stopped lying about itself. Detection now means litter was
    actually delivered, because the link register reports healthy on a bench and
    "disconnected" during a refill — so nothing reads it for connectivity any more.
    The level survives a restart instead of reading unknown for days, a robot that
    dispenses but rarely reports its link keeps its telemetry, one dispense cannot
    prove an empty hopper, and the upgrade sweep no longer removes hopper entities
    from a robot that has one.
  • The hopper is now detected at all. A dispense is published as three
    separate messages about twenty seconds apart, and detection insisted on seeing
    them in a single message — a shape no capture has ever shown, on either
    firmware. So the hopper was never sighted: on a fresh install its entities
    stayed disabled forever, robots that kept theirs on older evidence went stale
    instead of updating, and every fill-gauge sample was discarded, so the learned
    scale never moved either. The burst is now assembled across messages, and
    survives a restart landing in the middle of one. A lone diagnostic read of the
    dispense register still proves nothing, which is what the old rule was for.
  • The out-of-litter alert judges against your robot's own learned floor —
    floors differ per unit, and a fixed cutoff could cry empty while litter was
    still flowing.
  • A restored excess-weight alarm clears once the robot reports the pan clear,
    instead of re-firing on every later visit.
  • Event sensors appear only once their fact has been reported. Some firmware
    never emits a drawer event or a weight, and those sensors sat unknown forever; a
    one-time sweep applies the same standard to existing installs — and a detection
    re-sweep no longer disables entities you enabled yourself.
  • brew install sisyphusmd/tap/whiskerless works again (the formula pinned a
    bleak whose build backend Homebrew cannot build), and every release now
    install-tests the formula before the tap publishes.
  • Errors are sentences, not stack traces. A Bluetooth failure reads "BLE scan
    failed: Bluetooth device is turned off"; ~ expands everywhere; every provision
    answer is checked at its prompt, including that the CA really is a PEM; file and
    broker errors print one line. --debug still gives you the traceback.
  • The serial validator rejects the model number (LR4-0301-00-US) printed
    beside the real serial on the label.
  • --dry-run marks everything it prints, so a simulation no longer describes
    writes that never happened.
  • whiskerless set night-light-mode auto works — every accepted spelling used
    to crash.
  • Every settings write is verified by read-back, multi-register writes no
    longer lose parts, and broker failures print instead of raising.
  • Fewer unknowns while calibration settles: the calibration reference shows the
    built-in default (marked as such) and the hopper level a labelled estimate.
  • "A short press does nothing" was wrong, and dangerous. A short press of the
    robot's Connect button toggles its WiFi off — the light bar turns white
    and the robot vanishes from your broker, looking for all the world like a dead
    unit. The README and the recovery guide both told you it was harmless. Hold
    Connect for pairing mode; tap it only to put the radio back.
  • The status a robot reports while powering down is no longer labelled
    "powering up", now that each half of a power cycle has been captured on its
    own rather than together.
  • The waste-drawer register no longer claims to know direction. A brief rule
    ("it speaks on a seat and stays silent on a removal") held on one robot and
    failed on the other; whiskerless still reports only when the drawer last
    moved, which is all the hardware supports.
  • The declared Home Assistant minimum is correct (2025.3.0, not 2025.2.0).

  Changed

  • Some entities were renamed, and existing installs are moved with them:
    Start clean cycle → Clean cycle, the two calibration buttons →
    Calibrate full / Calibrate empty, Hopper fill (raw) → Hopper
    reading, Litter calibration reference → Litter reference. Entity IDs you
    chose yourself are left alone, and every rename is logged — check automations
    that referenced the old IDs.
  • The manual calibration buttons now ship disabled. The robot calibrates
    itself; enable them if you want to pin the scale to a measurement of your own.
  • Last visit duration ships disabled and enables itself at your robot's first
    report — not every robot emits it, and that is not a firmware split.
  • Litter distances read in millimetres, not inches converted to thirteen
    decimal places — the unit the protocol and the docs use. Per-entity overrides
    still win.
  • The raw hopper reading, last dispense and clean-cycle count moved to
    Diagnostics, leaving the sensor list to the things worth a glance.
  • Auto-calibration got a statistics upgrade: a median-based outlier gate keeps
    in-band anomalies (a paw reads like an overfull globe) away from the litter
    anchors, and the hopper floor is learned from declined-into flatline runs — in
    both directions, so a floor that moved up is found as readily as one below.
  • Detections remember what proved them, so tightening one rule can no longer
    cost you entities another rule had already earned.
  • All the derived telemetry moved into the library, which is what will let the
    CLI show everything Home Assistant shows without a second implementation.
  • Release binaries and the macOS installer carry the version in the filename
    (whiskerless-<version>-linux-x86_64); the scheme is in packaging/README.md.

  Downloads

  • Source code (ZIP)
    0 downloads
  • Source code (TAR.GZ)
    0 downloads

  ---

  • SHA256SUMS
    0 downloads · 2026-08-18 12:08:45 -07:00 · 1,011 B
  • whiskerless-0.2.0-rc.29-linux-arm64
    2 downloads · 2026-08-18 12:08:45 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.29-linux-x86_64
    1 download · 2026-08-18 12:08:45 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.29-macos-arm64.pkg
    3 downloads · 2026-08-18 11:47:19 -07:00 · 15 MiB
  • whiskerless-0.2.0-rc.29-macos-x86_64.pkg
    3 downloads · 2026-08-18 11:47:20 -07:00 · 14 MiB
  • whiskerless-0.2.0~rc.29.aarch64.rpm
    1 download · 2026-08-18 12:08:44 -07:00 · 30 MiB
  • whiskerless-0.2.0~rc.29.x86_64.rpm
    1 download · 2026-08-18 12:08:44 -07:00 · 31 MiB
  • whiskerless-rc--0.2.0rc29.arm64_linux.bottle.json
    5 downloads · 2026-08-18 12:08:26 -07:00 · 67 KiB
  • whiskerless-rc--0.2.0rc29.arm64_sequoia.bottle.json
    4 downloads · 2026-08-18 12:08:26 -07:00 · 114 KiB
  • whiskerless-rc--0.2.0rc29.sequoia.bottle.json
    4 downloads · 2026-08-18 12:08:27 -07:00 · 114 KiB
  • whiskerless-rc--0.2.0rc29.x86_64_linux.bottle.json
    4 downloads · 2026-08-18 12:08:28 -07:00 · 67 KiB
  • whiskerless-rc-0.2.0rc29.arm64_linux.bottle.tar.gz
    3 downloads · 2026-08-18 12:08:29 -07:00 · 3.3 MiB
  • whiskerless-rc-0.2.0rc29.arm64_sequoia.bottle.tar.gz
    1 download · 2026-08-18 12:08:30 -07:00 · 3 MiB
  • whiskerless-rc-0.2.0rc29.sequoia.bottle.tar.gz
    1 download · 2026-08-18 12:08:31 -07:00 · 3 MiB
  • whiskerless-rc-0.2.0rc29.x86_64_linux.bottle.tar.gz
    3 downloads · 2026-08-18 12:08:32 -07:00 · 3.3 MiB
  • whiskerless_0.2.0~rc.29_amd64.deb
    1 download · 2026-08-18 12:08:44 -07:00 · 31 MiB
  • whiskerless_0.2.0~rc.29_arm64.deb
    1 download · 2026-08-18 12:08:45 -07:00 · 30 MiB
• v0.2.0-rc.28 1ac036c0dd

  Compare

  v0.2.0-rc.28 Pre-release

  Cody Bryant released this 2026-08-17 21:32:34 -07:00 | 34 commits to main since this release

  The release where the robot stopped being read-only. Whiskerless could always
  watch a Litter-Robot 4 and change its settings; it could not press anything. The
  panel button register turned out to be writable, so Clean cycle and Reset are
  real buttons now — they emit the exact code the panel does, which means the
  firmware's pinch, cat-detect and bonnet interlocks apply to them just as they do
  to a finger. Two other things changed the day-to-day: provisioning no longer
  fails silently when you mistype the WiFi password, and the CLI remembers your
  robots instead of wanting a wall of flags on every command.

  Thanks to @CryingPecan, whose LitterHopper robot
  on ESP 1.4.4 is behind much of what's below. Protocol detail lives in
  docs/devices/litter-robot-4/.

  Breaking changes

  Worth reading before you upgrade; the rest of the list is safe to skim.

  • Broker usernames and passwords are gone. --username, --password and
    WHISKERLESS_PASSWORD no longer exist, and neither does the profile field. The
    robot cannot send credentials at all, so running two authentication schemes
    against one broker only bought complexity — everything identifies by
    certificate now, the CLI included.

  • One broker per machine. The broker, its port and its CA moved off each
    robot and into the store, because every robot in a house talks to the same one.
    --host, --port, --ca and --insecure are gone from the everyday commands
    and live on setup, which is where the broker is established. A genuinely
    separate broker is a separate store: point WHISKERLESS_HOME at it.

  • whiskerless adopt is removed. With the broker no longer per-robot it only
    recorded a serial, and it could never give the robot the certificate it now
    needs. Re-provision instead.

  • The store moved to ~/whiskerless — no leading dot, so the folder you are
    told to back up is one you can find. Your existing ~/.whiskerless is moved
    there automatically the first time you run anything.

  • binary_sensor.<robot>_waste_drawer_removed → sensor.<robot>_waste_drawer_last_moved.
    The robot reports that the drawer moved and never which way, so a binary
    sensor was claiming more than the hardware says.

  • switch.<robot>_panel_sleep_mode → a binary sensor. The firmware refuses
    direct writes to it, so the switch could only ever fail. The weekday schedule
    entities are the control.

  • Clean cycle wait time is a number (3–30 minutes), not a select.

  • Library: Hazard.MOTOR, MotorCommandError and allow_motor are gone. A
    written press is the same event as a physical one, so that gate gated a hazard
    that does not exist — and every caller passed the flag unconditionally, which
    made the real gates look like the same formality. Power still requires
    allow_dangerous.

  • Library: LitterRobot4Client and WhiskerlessAuthError are removed. Nothing
    used them, and the client had become a third, already-drifting copy of the
    write-verify loop.

  • Homebrew gained build dependencies — rust and openssl@3 — because
    certificates became core function and cryptography is a Rust extension that
    Homebrew builds from source. This briefly meant a multi-minute, ~2.4 GB
    install; bottles now make it instant again (see Added), so it only bites on
    a platform we do not bottle. Nothing about the installed result changes, and
    every other install path (PyPI/pipx/uvx, the macOS .pkg, .deb/.rpm) uses
    wheels and was never affected.

  Added

  • Clean cycle and Reset buttons, and they actually work. Proven on ESP 1.1.75
    and 1.4.4. This is the project's first recovered action command; the old "no
    action commands exist" framing is dead.
  • Empty cycle, Power and WiFi, shipped disabled and named (danger) — an
    empty cycle costs a litter refill, and a robot that is switched off, or has had
    its WiFi switched off, has left the network, so nothing over MQTT brings it
    back. WiFi is the panel's Connect button: it took the robot off the broker
    in 0.8 seconds, panel light white, and only a physical press undoes it. The CLI
    gains empty-cycle, power and wifi-toggle; all three prompt first, and the
    two that can end the connection have no --yes.
  • Provisioning verifies the WiFi join. A mistyped passphrase used to sail
    through silently — the robot accepted everything, rebooted, and simply never
    appeared on any network, which is indistinguishable from a dead unit. The robot
    names that failure if asked, so provisioning now polls the join status and stops
    with "mistyped WiFi password" before touching the broker config; a confirmed
    join prints the robot's IP and moves on early. Firmware that stays silent gets
    the old wait.
  • The CLI remembers your robots. provision saves the serial, broker and CA
    under ~/whiskerless; later commands run bare.
    robots, use and forget list, pick and drop them — damaged profiles are
    shown as such and can still be removed.
  • A second robot inherits the saved setup — each prompt offers what your
    robots already share, so you type only the serial and the WiFi password.
  • whiskerless setup is a new command, run once before any robot. It
    establishes your broker's address and its certificates, and prints the three
    files to install on the broker. Deliberately separate from provision:
    between generating those files and a robot being able to use them, somebody has
    to install them and restart the broker — and a robot in pairing mode is holding
    a short window open the whole time. provision now refuses on a machine that
    has not been set up, and says so.
  • whiskerless runs a certificate authority for you. The Litter-Robot cannot
    send a username or a password — its firmware has no field for one, because it
    was built for AWS IoT, which authenticates clients by certificate. So
    certificates are the only authentication it has, and the first provision on a
    machine offers to set the whole thing up: a CA, your broker's server
    certificate, and an identity for this machine. Press enter and it is done. It
    prints the three files your broker needs and which mosquitto directive each one
    goes with. Already have a CA? Point at it with --ca, add --ca-key if you
    want certificates issued here, and it is copied into place under our names.
  • whiskerless backup and whiskerless restore. "Back up ~/whiskerless"
    is advice people follow exactly as often as it is convenient, and the CA
    private key in there is the one thing that cannot be regenerated — losing it
    costs you the ability to add or re-provision a robot without walking to every
    robot you own. backup writes one file; restore puts it back. Leave the
    path off either and it asks — restore lists the backups it can see, newest
    first, and takes a number. Each archive is named for the moment it was made
    and never replaces an earlier one, because that earlier file may be the copy
    from before whatever you are about to change; the timestamp lives in the
    name because it is the only part that survives being copied to a stick or
    pulled out of a snapshot. It offers to
    encrypt (AES-256-GCM, scrypt) and an unattended run has to say --no-password
    or set WHISKERLESS_BACKUP_PASSWORD rather than write a signing key in the
    clear by default. Unencrypted it is an ordinary .tar.gz, because this is a
    file you open once, years later, possibly on a machine with no whiskerless on
    it. restore refuses to replace an existing setup unless you pass --force,
    and the refusal says whether the CA differs and names the robots that would
    stop trusting your broker; --force moves the old store aside rather than
    deleting it.
  • Each robot gets its own certificate, signed by your CA, written over BLE
    exactly the way the Whisker app writes its own — same order, same 100-byte
    chunks, same single apply. Its common name is the robot's serial, so
    use_identity_as_username makes your broker log the robot by name. Nothing
    keeps a copy: the robot holds the only one, and a replacement is one
    re-provision away.
  • Your broker can stop accepting anonymous clients. That was never a
    workaround for a missing feature — it was the only option when the robot had no
    identity of its own to present. Now it has one. Without a CA key to sign with,
    provisioning says so loudly and leaves the robot's factory certificate alone,
    which is exactly how whiskerless worked before.
  • Litter level as a percentage — self-calibrating over time, or pinned
    instantly by one button press with the globe filled the way you consider full.
  • LitterHopper support: connected, fill gauge, and an out-of-litter alert the
    firmware never raises. The entities enable themselves at the first dispense.
  • New entities: last cat visit, last visit duration, waste drawer last moved,
    panel brightness for bright and dark rooms, and excess-weight detection — the
    stuck-scale condition the robot otherwise only shows on its own panel.
  • whiskerless status — the robot in plain terms from a single fresh reading:
    level, drawer, faults, calibration. It names what needs a listener rather than
    printing zeros. whiskerless calibrate full|empty stores your own litter
    reference per robot and refuses a reading that cannot be one, and
    whiskerless panel-reset presses Reset.
  • Activity-derived entities survive a restart instead of reading unknown until
    the next cat visit.
  • New install channels: Homebrew, .deb/.rpm, and standalone Linux binaries
    for amd64 and arm64 — none of which need a system Python.
  • apt and dnf repositories, so Linux installs and upgrades come through the
    package manager instead of a downloaded file. Two channels — stable and
    testing — because version ordering alone cannot keep a candidate away from
    release subscribers until the release it precedes actually exists. Setup, and
    the one-time key import it cannot avoid, is in the README. The packages are
    GPG-signed (4BBACD5A6FF38564); on dnf that signature is what gpgcheck
    verifies, while apt authenticates the repository index Forgejo signs.
  • Homebrew bottles, so brew install pours a prebuilt keg in seconds instead
    of downloading ~2.4 GB of rust and llvm to compile cryptography. Four
    platforms: Apple Silicon and Intel macOS, and Linux on both architectures.
    Anything unbottled still installs exactly as before, just slowly.
  • The CLI shows liveness and colour: a spinner on the BLE scan (heartbeat lines
    when piped), banners on the dangerous prompts, NO_COLOR honoured.
    whiskerless --version works, and a bare whiskerless prints an
    orientation instead of a usage error.
  • The README covers the whole journey: prerequisites, per-platform installs
    including Homebrew, everyday use, upgrading, the rc channel, uninstalling.
  • The integration has an icon and a logo, shipped inside it and served by Home
    Assistant 2026.3+; older versions simply show what they show today.

  Fixed

  • whiskerless setup no longer dies on a machine with a long hostname. The
    certificate it issues for this machine is named whiskerless-<hostname>, and
    X.509 caps a common name at 64 bytes — so a long enough hostname made
    cryptography raise and took the whole command down with a traceback. Names
    are now truncated on a character boundary; the full name still goes in the
    SAN, which is what TLS actually verifies.
  • Moving your broker reissues its certificate. setup --host <new> used to
    record the new address while leaving the old certificate in place, then print
    those same files and tell you to install them — handing the robot a
    certificate naming somewhere it does not connect, which fails every handshake
    and looks exactly like a broken robot. It is reissued when the host changes,
    and says so; without a CA key to sign with, it tells you to replace it
    yourself instead of staying quiet.
  • Provisioning stops scanning the moment it finds your robot. It used to run
    the whole --scan-timeout even after the robot answered — and since a robot
    only advertises while you hold Connect, that spent the pairing window instead
    of using it. One bench attempt found the robot and then failed to connect,
    because it had gone quiet by the time the scan ended.
  • The WiFi check no longer reports 0.0.0.0 as your robot's address. The
    robot says "connected" the instant it associates, before DHCP hands out a
    lease, so the join is confirmed but the address is not yet known — and printing
    the unset one claimed a fact it did not have.
  • Pet weight is right again (raw ÷ 100, the cloud's own units) — recent rc
    builds doubled the reading.
  • The weekday sleep schedule arms every day, not just Sunday, and the panel
    sleep and wake times can actually be set — they now write the per-day
    registers instead of one the firmware only computes.
  • robotStatus 10 is the clean cycle, with the boot cycle and filter wizard
    mapped too. Left unmapped, their readings were published as real litter levels.
  • Litter readings are suppressed while the globe is not level — mid-cycle the
    sensors are looking at the globe, not the litter. The first reading after a
    restart is no longer discarded either.
  • The globe motor fault sensor watches the activity stream, where the fault
    actually appears — the state document sat at 0 through a real fifty-minute
    fault. A restored fault can also clear after a missed clear event, on the proof
    of a clean cycle completing.
  • Cat detection no longer mistakes weight on the scale for a cat — occupancy
    uses the bit that tracks the animal, not the one a misseated bonnet holds — and
    handling the robot no longer counts as a visit.
  • A long cat visit is no longer dropped. The close was matched against a
    90-second window, and the cats that sit longest fell outside it. Last cat
    visit now updates on every robot, stamping from occupancy rather than only
    from weight events, which one robot never sends.
  • Hopper telemetry stopped lying about itself. Detection now means litter was
    actually delivered, because the link register reports healthy on a bench and
    "disconnected" during a refill — so nothing reads it for connectivity any more.
    The level survives a restart instead of reading unknown for days, a robot that
    dispenses but rarely reports its link keeps its telemetry, one dispense cannot
    prove an empty hopper, and the upgrade sweep no longer removes hopper entities
    from a robot that has one.
  • The hopper is now detected at all. A dispense is published as three
    separate messages about twenty seconds apart, and detection insisted on seeing
    them in a single message — a shape no capture has ever shown, on either
    firmware. So the hopper was never sighted: on a fresh install its entities
    stayed disabled forever, robots that kept theirs on older evidence went stale
    instead of updating, and every fill-gauge sample was discarded, so the learned
    scale never moved either. The burst is now assembled across messages, and
    survives a restart landing in the middle of one. A lone diagnostic read of the
    dispense register still proves nothing, which is what the old rule was for.
  • The out-of-litter alert judges against your robot's own learned floor —
    floors differ per unit, and a fixed cutoff could cry empty while litter was
    still flowing.
  • A restored excess-weight alarm clears once the robot reports the pan clear,
    instead of re-firing on every later visit.
  • Event sensors appear only once their fact has been reported. Some firmware
    never emits a drawer event or a weight, and those sensors sat unknown forever; a
    one-time sweep applies the same standard to existing installs — and a detection
    re-sweep no longer disables entities you enabled yourself.
  • brew install sisyphusmd/tap/whiskerless works again (the formula pinned a
    bleak whose build backend Homebrew cannot build), and every release now
    install-tests the formula before the tap publishes.
  • Errors are sentences, not stack traces. A Bluetooth failure reads "BLE scan
    failed: Bluetooth device is turned off"; ~ expands everywhere; every provision
    answer is checked at its prompt, including that the CA really is a PEM; file and
    broker errors print one line. --debug still gives you the traceback.
  • The serial validator rejects the model number (LR4-0301-00-US) printed
    beside the real serial on the label.
  • --dry-run marks everything it prints, so a simulation no longer describes
    writes that never happened.
  • whiskerless set night-light-mode auto works — every accepted spelling used
    to crash.
  • Every settings write is verified by read-back, multi-register writes no
    longer lose parts, and broker failures print instead of raising.
  • Fewer unknowns while calibration settles: the calibration reference shows the
    built-in default (marked as such) and the hopper level a labelled estimate.
  • "A short press does nothing" was wrong, and dangerous. A short press of the
    robot's Connect button toggles its WiFi off — the light bar turns white
    and the robot vanishes from your broker, looking for all the world like a dead
    unit. The README and the recovery guide both told you it was harmless. Hold
    Connect for pairing mode; tap it only to put the radio back.
  • The status a robot reports while powering down is no longer labelled
    "powering up", now that each half of a power cycle has been captured on its
    own rather than together.
  • The waste-drawer register no longer claims to know direction. A brief rule
    ("it speaks on a seat and stays silent on a removal") held on one robot and
    failed on the other; whiskerless still reports only when the drawer last
    moved, which is all the hardware supports.
  • The declared Home Assistant minimum is correct (2025.3.0, not 2025.2.0).

  Changed

  • Some entities were renamed, and existing installs are moved with them:
    Start clean cycle → Clean cycle, the two calibration buttons →
    Calibrate full / Calibrate empty, Hopper fill (raw) → Hopper
    reading, Litter calibration reference → Litter reference. Entity IDs you
    chose yourself are left alone, and every rename is logged — check automations
    that referenced the old IDs.
  • The manual calibration buttons now ship disabled. The robot calibrates
    itself; enable them if you want to pin the scale to a measurement of your own.
  • Last visit duration ships disabled and enables itself at your robot's first
    report — not every robot emits it, and that is not a firmware split.
  • Litter distances read in millimetres, not inches converted to thirteen
    decimal places — the unit the protocol and the docs use. Per-entity overrides
    still win.
  • The raw hopper reading, last dispense and clean-cycle count moved to
    Diagnostics, leaving the sensor list to the things worth a glance.
  • Auto-calibration got a statistics upgrade: a median-based outlier gate keeps
    in-band anomalies (a paw reads like an overfull globe) away from the litter
    anchors, and the hopper floor is learned from declined-into flatline runs — in
    both directions, so a floor that moved up is found as readily as one below.
  • Detections remember what proved them, so tightening one rule can no longer
    cost you entities another rule had already earned.
  • All the derived telemetry moved into the library, which is what will let the
    CLI show everything Home Assistant shows without a second implementation.
  • Release binaries and the macOS installer carry the version in the filename
    (whiskerless-<version>-linux-x86_64); the scheme is in packaging/README.md.

  Downloads

  • Source code (ZIP)
    0 downloads
  • Source code (TAR.GZ)
    0 downloads

  ---

  • SHA256SUMS
    1 download · 2026-08-17 21:59:34 -07:00 · 1,011 B
  • whiskerless-0.2.0-rc.28-linux-arm64
    4 downloads · 2026-08-17 21:59:34 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.28-linux-x86_64
    5 downloads · 2026-08-17 21:59:34 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.28-macos-arm64.pkg
    5 downloads · 2026-08-17 21:35:46 -07:00 · 15 MiB
  • whiskerless-0.2.0-rc.28-macos-x86_64.pkg
    5 downloads · 2026-08-17 21:35:47 -07:00 · 14 MiB
  • whiskerless-0.2.0~rc.28.aarch64.rpm
    3 downloads · 2026-08-17 21:59:33 -07:00 · 30 MiB
  • whiskerless-0.2.0~rc.28.x86_64.rpm
    3 downloads · 2026-08-17 21:59:33 -07:00 · 31 MiB
  • whiskerless-rc--0.2.0rc28.arm64_linux.bottle.json
    2 downloads · 2026-08-18 07:25:21 -07:00 · 67 KiB
  • whiskerless-rc--0.2.0rc28.arm64_sequoia.bottle.json
    1 download · 2026-08-18 07:25:22 -07:00 · 114 KiB
  • whiskerless-rc--0.2.0rc28.sequoia.bottle.json
    1 download · 2026-08-18 07:25:23 -07:00 · 114 KiB
  • whiskerless-rc--0.2.0rc28.x86_64_linux.bottle.json
    2 downloads · 2026-08-18 07:25:24 -07:00 · 67 KiB
  • whiskerless-rc-0.2.0rc28.arm64_linux.bottle.tar.gz
    13 downloads · 2026-08-18 07:25:26 -07:00 · 3.3 MiB
  • whiskerless-rc-0.2.0rc28.arm64_sequoia.bottle.tar.gz
    8 downloads · 2026-08-18 07:25:28 -07:00 · 3 MiB
  • whiskerless-rc-0.2.0rc28.sequoia.bottle.tar.gz
    8 downloads · 2026-08-18 07:25:29 -07:00 · 3 MiB
  • whiskerless-rc-0.2.0rc28.x86_64_linux.bottle.tar.gz
    8 downloads · 2026-08-18 07:25:31 -07:00 · 3.3 MiB
  • whiskerless_0.2.0~rc.28_amd64.deb
    5 downloads · 2026-08-17 21:59:34 -07:00 · 31 MiB
  • whiskerless_0.2.0~rc.28_arm64.deb
    3 downloads · 2026-08-17 21:59:34 -07:00 · 30 MiB
• v0.2.0-rc.27 624ebe3360

  Compare

  v0.2.0-rc.27 Pre-release

  Cody Bryant released this 2026-08-17 07:19:21 -07:00 | 48 commits to main since this release

  The release where the robot stopped being read-only. Whiskerless could always
  watch a Litter-Robot 4 and change its settings; it could not press anything. The
  panel button register turned out to be writable, so Clean cycle and Reset are
  real buttons now — they emit the exact code the panel does, which means the
  firmware's pinch, cat-detect and bonnet interlocks apply to them just as they do
  to a finger. Two other things changed the day-to-day: provisioning no longer
  fails silently when you mistype the WiFi password, and the CLI remembers your
  robots instead of wanting a wall of flags on every command.

  Thanks to @CryingPecan, whose LitterHopper robot
  on ESP 1.4.4 is behind much of what's below. Protocol detail lives in
  docs/devices/litter-robot-4/.

  Breaking changes

  Worth reading before you upgrade; the rest of the list is safe to skim.

  • Broker usernames and passwords are gone. --username, --password and
    WHISKERLESS_PASSWORD no longer exist, and neither does the profile field. The
    robot cannot send credentials at all, so running two authentication schemes
    against one broker only bought complexity — everything identifies by
    certificate now, the CLI included.

  • One broker per machine. The broker, its port and its CA moved off each
    robot and into the store, because every robot in a house talks to the same one.
    --host, --port, --ca and --insecure are gone from the everyday commands
    and live on setup, which is where the broker is established. A genuinely
    separate broker is a separate store: point WHISKERLESS_HOME at it.

  • whiskerless adopt is removed. With the broker no longer per-robot it only
    recorded a serial, and it could never give the robot the certificate it now
    needs. Re-provision instead.

  • The store moved to ~/whiskerless — no leading dot, so the folder you are
    told to back up is one you can find. Your existing ~/.whiskerless is moved
    there automatically the first time you run anything.

  • binary_sensor.<robot>_waste_drawer_removed → sensor.<robot>_waste_drawer_last_moved.
    The robot reports that the drawer moved and never which way, so a binary
    sensor was claiming more than the hardware says.

  • switch.<robot>_panel_sleep_mode → a binary sensor. The firmware refuses
    direct writes to it, so the switch could only ever fail. The weekday schedule
    entities are the control.

  • Clean cycle wait time is a number (3–30 minutes), not a select.

  • Library: Hazard.MOTOR, MotorCommandError and allow_motor are gone. A
    written press is the same event as a physical one, so that gate gated a hazard
    that does not exist — and every caller passed the flag unconditionally, which
    made the real gates look like the same formality. Power still requires
    allow_dangerous.

  • Library: LitterRobot4Client and WhiskerlessAuthError are removed. Nothing
    used them, and the client had become a third, already-drifting copy of the
    write-verify loop.

  • Homebrew installs now compile, and take minutes rather than seconds.
    Certificates became core function, so cryptography is a hard dependency — and
    Homebrew builds every resource from source, where cryptography is a Rust
    extension. The formula gained rust as a build dependency and openssl@3;
    nothing about the installed result changes. Every other install path
    (PyPI/pipx/uvx, the macOS .pkg, .deb/.rpm) uses wheels and is unaffected.

  Added

  • Clean cycle and Reset buttons, and they actually work. Proven on ESP 1.1.75
    and 1.4.4. This is the project's first recovered action command; the old "no
    action commands exist" framing is dead.
  • Empty cycle, Power and WiFi, shipped disabled and named (danger) — an
    empty cycle costs a litter refill, and a robot that is switched off, or has had
    its WiFi switched off, has left the network, so nothing over MQTT brings it
    back. WiFi is the panel's Connect button: it took the robot off the broker
    in 0.8 seconds, panel light white, and only a physical press undoes it. The CLI
    gains empty-cycle, power and wifi-toggle; all three prompt first, and the
    two that can end the connection have no --yes.
  • Provisioning verifies the WiFi join. A mistyped passphrase used to sail
    through silently — the robot accepted everything, rebooted, and simply never
    appeared on any network, which is indistinguishable from a dead unit. The robot
    names that failure if asked, so provisioning now polls the join status and stops
    with "mistyped WiFi password" before touching the broker config; a confirmed
    join prints the robot's IP and moves on early. Firmware that stays silent gets
    the old wait.
  • The CLI remembers your robots. provision saves the serial, broker and CA
    under ~/whiskerless; later commands run bare.
    robots, use and forget list, pick and drop them — damaged profiles are
    shown as such and can still be removed.
  • A second robot inherits the saved setup — each prompt offers what your
    robots already share, so you type only the serial and the WiFi password.
  • whiskerless setup is a new command, run once before any robot. It
    establishes your broker's address and its certificates, and prints the three
    files to install on the broker. Deliberately separate from provision:
    between generating those files and a robot being able to use them, somebody has
    to install them and restart the broker — and a robot in pairing mode is holding
    a short window open the whole time. provision now refuses on a machine that
    has not been set up, and says so.
  • whiskerless runs a certificate authority for you. The Litter-Robot cannot
    send a username or a password — its firmware has no field for one, because it
    was built for AWS IoT, which authenticates clients by certificate. So
    certificates are the only authentication it has, and the first provision on a
    machine offers to set the whole thing up: a CA, your broker's server
    certificate, and an identity for this machine. Press enter and it is done. It
    prints the three files your broker needs and which mosquitto directive each one
    goes with. Already have a CA? Point at it with --ca, add --ca-key if you
    want certificates issued here, and it is copied into place under our names.
  • whiskerless backup and whiskerless restore. "Back up ~/whiskerless"
    is advice people follow exactly as often as it is convenient, and the CA
    private key in there is the one thing that cannot be regenerated — losing it
    costs you the ability to add or re-provision a robot without walking to every
    robot you own. backup writes one file; restore puts it back. Leave the
    path off either and it asks — restore lists the backups it can see, newest
    first, and takes a number. Each archive is named for the moment it was made
    and never replaces an earlier one, because that earlier file may be the copy
    from before whatever you are about to change; the timestamp lives in the
    name because it is the only part that survives being copied to a stick or
    pulled out of a snapshot. It offers to
    encrypt (AES-256-GCM, scrypt) and an unattended run has to say --no-password
    or set WHISKERLESS_BACKUP_PASSWORD rather than write a signing key in the
    clear by default. Unencrypted it is an ordinary .tar.gz, because this is a
    file you open once, years later, possibly on a machine with no whiskerless on
    it. restore refuses to replace an existing setup unless you pass --force,
    and the refusal says whether the CA differs and names the robots that would
    stop trusting your broker; --force moves the old store aside rather than
    deleting it.
  • Each robot gets its own certificate, signed by your CA, written over BLE
    exactly the way the Whisker app writes its own — same order, same 100-byte
    chunks, same single apply. Its common name is the robot's serial, so
    use_identity_as_username makes your broker log the robot by name. Nothing
    keeps a copy: the robot holds the only one, and a replacement is one
    re-provision away.
  • Your broker can stop accepting anonymous clients. That was never a
    workaround for a missing feature — it was the only option when the robot had no
    identity of its own to present. Now it has one. Without a CA key to sign with,
    provisioning says so loudly and leaves the robot's factory certificate alone,
    which is exactly how whiskerless worked before.
  • Litter level as a percentage — self-calibrating over time, or pinned
    instantly by one button press with the globe filled the way you consider full.
  • LitterHopper support: connected, fill gauge, and an out-of-litter alert the
    firmware never raises. The entities enable themselves at the first dispense.
  • New entities: last cat visit, last visit duration, waste drawer last moved,
    panel brightness for bright and dark rooms, and excess-weight detection — the
    stuck-scale condition the robot otherwise only shows on its own panel.
  • whiskerless status — the robot in plain terms from a single fresh reading:
    level, drawer, faults, calibration. It names what needs a listener rather than
    printing zeros. whiskerless calibrate full|empty stores your own litter
    reference per robot and refuses a reading that cannot be one, and
    whiskerless panel-reset presses Reset.
  • Activity-derived entities survive a restart instead of reading unknown until
    the next cat visit.
  • New install channels: Homebrew, .deb/.rpm, and standalone Linux binaries
    for amd64 and arm64 — none of which need a system Python.
  • The CLI shows liveness and colour: a spinner on the BLE scan (heartbeat lines
    when piped), banners on the dangerous prompts, NO_COLOR honoured.
    whiskerless --version works, and a bare whiskerless prints an
    orientation instead of a usage error.
  • The README covers the whole journey: prerequisites, per-platform installs
    including Homebrew, everyday use, upgrading, the rc channel, uninstalling.
  • The integration has an icon and a logo, shipped inside it and served by Home
    Assistant 2026.3+; older versions simply show what they show today.

  Fixed

  • Provisioning stops scanning the moment it finds your robot. It used to run
    the whole --scan-timeout even after the robot answered — and since a robot
    only advertises while you hold Connect, that spent the pairing window instead
    of using it. One bench attempt found the robot and then failed to connect,
    because it had gone quiet by the time the scan ended.
  • The WiFi check no longer reports 0.0.0.0 as your robot's address. The
    robot says "connected" the instant it associates, before DHCP hands out a
    lease, so the join is confirmed but the address is not yet known — and printing
    the unset one claimed a fact it did not have.
  • Pet weight is right again (raw ÷ 100, the cloud's own units) — recent rc
    builds doubled the reading.
  • The weekday sleep schedule arms every day, not just Sunday, and the panel
    sleep and wake times can actually be set — they now write the per-day
    registers instead of one the firmware only computes.
  • robotStatus 10 is the clean cycle, with the boot cycle and filter wizard
    mapped too. Left unmapped, their readings were published as real litter levels.
  • Litter readings are suppressed while the globe is not level — mid-cycle the
    sensors are looking at the globe, not the litter. The first reading after a
    restart is no longer discarded either.
  • The globe motor fault sensor watches the activity stream, where the fault
    actually appears — the state document sat at 0 through a real fifty-minute
    fault. A restored fault can also clear after a missed clear event, on the proof
    of a clean cycle completing.
  • Cat detection no longer mistakes weight on the scale for a cat — occupancy
    uses the bit that tracks the animal, not the one a misseated bonnet holds — and
    handling the robot no longer counts as a visit.
  • A long cat visit is no longer dropped. The close was matched against a
    90-second window, and the cats that sit longest fell outside it. Last cat
    visit now updates on every robot, stamping from occupancy rather than only
    from weight events, which one robot never sends.
  • Hopper telemetry stopped lying about itself. Detection now means litter was
    actually delivered, because the link register reports healthy on a bench and
    "disconnected" during a refill — so nothing reads it for connectivity any more.
    The level survives a restart instead of reading unknown for days, a robot that
    dispenses but rarely reports its link keeps its telemetry, one dispense cannot
    prove an empty hopper, and the upgrade sweep no longer removes hopper entities
    from a robot that has one.
  • The out-of-litter alert judges against your robot's own learned floor —
    floors differ per unit, and a fixed cutoff could cry empty while litter was
    still flowing.
  • A restored excess-weight alarm clears once the robot reports the pan clear,
    instead of re-firing on every later visit.
  • Event sensors appear only once their fact has been reported. Some firmware
    never emits a drawer event or a weight, and those sensors sat unknown forever; a
    one-time sweep applies the same standard to existing installs — and a detection
    re-sweep no longer disables entities you enabled yourself.
  • brew install sisyphusmd/tap/whiskerless works again (the formula pinned a
    bleak whose build backend Homebrew cannot build), and every release now
    install-tests the formula before the tap publishes.
  • Errors are sentences, not stack traces. A Bluetooth failure reads "BLE scan
    failed: Bluetooth device is turned off"; ~ expands everywhere; every provision
    answer is checked at its prompt, including that the CA really is a PEM; file and
    broker errors print one line. --debug still gives you the traceback.
  • The serial validator rejects the model number (LR4-0301-00-US) printed
    beside the real serial on the label.
  • --dry-run marks everything it prints, so a simulation no longer describes
    writes that never happened.
  • whiskerless set night-light-mode auto works — every accepted spelling used
    to crash.
  • Every settings write is verified by read-back, multi-register writes no
    longer lose parts, and broker failures print instead of raising.
  • Fewer unknowns while calibration settles: the calibration reference shows the
    built-in default (marked as such) and the hopper level a labelled estimate.
  • "A short press does nothing" was wrong, and dangerous. A short press of the
    robot's Connect button toggles its WiFi off — the light bar turns white
    and the robot vanishes from your broker, looking for all the world like a dead
    unit. The README and the recovery guide both told you it was harmless. Hold
    Connect for pairing mode; tap it only to put the radio back.
  • The status a robot reports while powering down is no longer labelled
    "powering up", now that each half of a power cycle has been captured on its
    own rather than together.
  • The waste-drawer register no longer claims to know direction. A brief rule
    ("it speaks on a seat and stays silent on a removal") held on one robot and
    failed on the other; whiskerless still reports only when the drawer last
    moved, which is all the hardware supports.
  • The declared Home Assistant minimum is correct (2025.3.0, not 2025.2.0).

  Changed

  • Some entities were renamed, and existing installs are moved with them:
    Start clean cycle → Clean cycle, the two calibration buttons →
    Calibrate full / Calibrate empty, Hopper fill (raw) → Hopper
    reading, Litter calibration reference → Litter reference. Entity IDs you
    chose yourself are left alone, and every rename is logged — check automations
    that referenced the old IDs.
  • The manual calibration buttons now ship disabled. The robot calibrates
    itself; enable them if you want to pin the scale to a measurement of your own.
  • Last visit duration ships disabled and enables itself at your robot's first
    report — not every robot emits it, and that is not a firmware split.
  • Litter distances read in millimetres, not inches converted to thirteen
    decimal places — the unit the protocol and the docs use. Per-entity overrides
    still win.
  • The raw hopper reading, last dispense and clean-cycle count moved to
    Diagnostics, leaving the sensor list to the things worth a glance.
  • Auto-calibration got a statistics upgrade: a median-based outlier gate keeps
    in-band anomalies (a paw reads like an overfull globe) away from the litter
    anchors, and the hopper floor is learned from declined-into flatline runs — in
    both directions, so a floor that moved up is found as readily as one below.
  • Detections remember what proved them, so tightening one rule can no longer
    cost you entities another rule had already earned.
  • All the derived telemetry moved into the library, which is what will let the
    CLI show everything Home Assistant shows without a second implementation.
  • Release binaries and the macOS installer carry the version in the filename
    (whiskerless-<version>-linux-x86_64); the scheme is in packaging/README.md.

  Downloads

  • Source code (ZIP)
    0 downloads
  • Source code (TAR.GZ)
    0 downloads

  ---

  • whiskerless-0.2.0-rc.27-linux-arm64
    0 downloads · 2026-08-17 07:45:29 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.27-linux-x86_64
    0 downloads · 2026-08-17 07:45:29 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.27-macos-arm64.pkg
    0 downloads · 2026-08-17 07:23:30 -07:00 · 15 MiB
  • whiskerless-0.2.0-rc.27-macos-x86_64.pkg
    0 downloads · 2026-08-17 07:23:34 -07:00 · 14 MiB
  • whiskerless-0.2.0~rc.27.aarch64.rpm
    0 downloads · 2026-08-17 07:45:28 -07:00 · 30 MiB
  • whiskerless-0.2.0~rc.27.x86_64.rpm
    0 downloads · 2026-08-17 07:45:28 -07:00 · 31 MiB
  • whiskerless_0.2.0~rc.27_amd64.deb
    0 downloads · 2026-08-17 07:45:28 -07:00 · 31 MiB
  • whiskerless_0.2.0~rc.27_arm64.deb
    0 downloads · 2026-08-17 07:45:29 -07:00 · 30 MiB
• v0.2.0-rc.26 2193c04eab

  Compare

  v0.2.0-rc.26 Pre-release

  Cody Bryant released this 2026-08-16 23:20:43 -07:00 | 51 commits to main since this release

  The release where the robot stopped being read-only. Whiskerless could always
  watch a Litter-Robot 4 and change its settings; it could not press anything. The
  panel button register turned out to be writable, so Clean cycle and Reset are
  real buttons now — they emit the exact code the panel does, which means the
  firmware's pinch, cat-detect and bonnet interlocks apply to them just as they do
  to a finger. Two other things changed the day-to-day: provisioning no longer
  fails silently when you mistype the WiFi password, and the CLI remembers your
  robots instead of wanting a wall of flags on every command.

  Thanks to @CryingPecan, whose LitterHopper robot
  on ESP 1.4.4 is behind much of what's below. Protocol detail lives in
  docs/devices/litter-robot-4/.

  Breaking changes

  Worth reading before you upgrade; the rest of the list is safe to skim.

  • Broker usernames and passwords are gone. --username, --password and
    WHISKERLESS_PASSWORD no longer exist, and neither does the profile field. The
    robot cannot send credentials at all, so running two authentication schemes
    against one broker only bought complexity — everything identifies by
    certificate now, the CLI included.

  • One broker per machine. The broker, its port and its CA moved off each
    robot and into the store, because every robot in a house talks to the same one.
    --host, --port, --ca and --insecure are gone from the everyday commands
    and live on setup, which is where the broker is established. A genuinely
    separate broker is a separate store: point WHISKERLESS_HOME at it.

  • whiskerless adopt is removed. With the broker no longer per-robot it only
    recorded a serial, and it could never give the robot the certificate it now
    needs. Re-provision instead.

  • The store moved to ~/whiskerless — no leading dot, so the folder you are
    told to back up is one you can find. Your existing ~/.whiskerless is moved
    there automatically the first time you run anything.

  • binary_sensor.<robot>_waste_drawer_removed → sensor.<robot>_waste_drawer_last_moved.
    The robot reports that the drawer moved and never which way, so a binary
    sensor was claiming more than the hardware says.

  • switch.<robot>_panel_sleep_mode → a binary sensor. The firmware refuses
    direct writes to it, so the switch could only ever fail. The weekday schedule
    entities are the control.

  • Clean cycle wait time is a number (3–30 minutes), not a select.

  • Library: Hazard.MOTOR, MotorCommandError and allow_motor are gone. A
    written press is the same event as a physical one, so that gate gated a hazard
    that does not exist — and every caller passed the flag unconditionally, which
    made the real gates look like the same formality. Power still requires
    allow_dangerous.

  • Library: LitterRobot4Client and WhiskerlessAuthError are removed. Nothing
    used them, and the client had become a third, already-drifting copy of the
    write-verify loop.

  • Homebrew installs now compile, and take minutes rather than seconds.
    Certificates became core function, so cryptography is a hard dependency — and
    Homebrew builds every resource from source, where cryptography is a Rust
    extension. The formula gained rust as a build dependency and openssl@3;
    nothing about the installed result changes. Every other install path
    (PyPI/pipx/uvx, the macOS .pkg, .deb/.rpm) uses wheels and is unaffected.

  Added

  • Clean cycle and Reset buttons, and they actually work. Proven on ESP 1.1.75
    and 1.4.4. This is the project's first recovered action command; the old "no
    action commands exist" framing is dead.
  • Empty cycle, Power and WiFi, shipped disabled and named (danger) — an
    empty cycle costs a litter refill, and a robot that is switched off, or has had
    its WiFi switched off, has left the network, so nothing over MQTT brings it
    back. WiFi is the panel's Connect button: it took the robot off the broker
    in 0.8 seconds, panel light white, and only a physical press undoes it. The CLI
    gains empty-cycle, power and wifi-toggle; all three prompt first, and the
    two that can end the connection have no --yes.
  • Provisioning verifies the WiFi join. A mistyped passphrase used to sail
    through silently — the robot accepted everything, rebooted, and simply never
    appeared on any network, which is indistinguishable from a dead unit. The robot
    names that failure if asked, so provisioning now polls the join status and stops
    with "mistyped WiFi password" before touching the broker config; a confirmed
    join prints the robot's IP and moves on early. Firmware that stays silent gets
    the old wait.
  • The CLI remembers your robots. provision saves the serial, broker and CA
    under ~/whiskerless; later commands run bare.
    robots, use and forget list, pick and drop them — damaged profiles are
    shown as such and can still be removed.
  • A second robot inherits the saved setup — each prompt offers what your
    robots already share, so you type only the serial and the WiFi password.
  • whiskerless setup is a new command, run once before any robot. It
    establishes your broker's address and its certificates, and prints the three
    files to install on the broker. Deliberately separate from provision:
    between generating those files and a robot being able to use them, somebody has
    to install them and restart the broker — and a robot in pairing mode is holding
    a short window open the whole time. provision now refuses on a machine that
    has not been set up, and says so.
  • whiskerless runs a certificate authority for you. The Litter-Robot cannot
    send a username or a password — its firmware has no field for one, because it
    was built for AWS IoT, which authenticates clients by certificate. So
    certificates are the only authentication it has, and the first provision on a
    machine offers to set the whole thing up: a CA, your broker's server
    certificate, and an identity for this machine. Press enter and it is done. It
    prints the three files your broker needs and which mosquitto directive each one
    goes with. Already have a CA? Point at it with --ca, add --ca-key if you
    want certificates issued here, and it is copied into place under our names.
  • whiskerless backup and whiskerless restore. "Back up ~/whiskerless"
    is advice people follow exactly as often as it is convenient, and the CA
    private key in there is the one thing that cannot be regenerated — losing it
    costs you the ability to add or re-provision a robot without walking to every
    robot you own. backup writes one file; restore puts it back. Leave the
    path off either and it asks — restore lists the backups it can see, newest
    first, and takes a number. Each archive is named for the moment it was made
    and never replaces an earlier one, because that earlier file may be the copy
    from before whatever you are about to change; the timestamp lives in the
    name because it is the only part that survives being copied to a stick or
    pulled out of a snapshot. It offers to
    encrypt (AES-256-GCM, scrypt) and an unattended run has to say --no-password
    or set WHISKERLESS_BACKUP_PASSWORD rather than write a signing key in the
    clear by default. Unencrypted it is an ordinary .tar.gz, because this is a
    file you open once, years later, possibly on a machine with no whiskerless on
    it. restore refuses to replace an existing setup unless you pass --force,
    and the refusal says whether the CA differs and names the robots that would
    stop trusting your broker; --force moves the old store aside rather than
    deleting it.
  • Each robot gets its own certificate, signed by your CA, written over BLE
    exactly the way the Whisker app writes its own — same order, same 100-byte
    chunks, same single apply. Its common name is the robot's serial, so
    use_identity_as_username makes your broker log the robot by name. Nothing
    keeps a copy: the robot holds the only one, and a replacement is one
    re-provision away.
  • Your broker can stop accepting anonymous clients. That was never a
    workaround for a missing feature — it was the only option when the robot had no
    identity of its own to present. Now it has one. Without a CA key to sign with,
    provisioning says so loudly and leaves the robot's factory certificate alone,
    which is exactly how whiskerless worked before.
  • Litter level as a percentage — self-calibrating over time, or pinned
    instantly by one button press with the globe filled the way you consider full.
  • LitterHopper support: connected, fill gauge, and an out-of-litter alert the
    firmware never raises. The entities enable themselves at the first dispense.
  • New entities: last cat visit, last visit duration, waste drawer last moved,
    panel brightness for bright and dark rooms, and excess-weight detection — the
    stuck-scale condition the robot otherwise only shows on its own panel.
  • whiskerless status — the robot in plain terms from a single fresh reading:
    level, drawer, faults, calibration. It names what needs a listener rather than
    printing zeros. whiskerless calibrate full|empty stores your own litter
    reference per robot and refuses a reading that cannot be one, and
    whiskerless panel-reset presses Reset.
  • Activity-derived entities survive a restart instead of reading unknown until
    the next cat visit.
  • New install channels: Homebrew, .deb/.rpm, and standalone Linux binaries
    for amd64 and arm64 — none of which need a system Python.
  • The CLI shows liveness and colour: a spinner on the BLE scan (heartbeat lines
    when piped), banners on the dangerous prompts, NO_COLOR honoured.
    whiskerless --version works, and a bare whiskerless prints an
    orientation instead of a usage error.
  • The README covers the whole journey: prerequisites, per-platform installs
    including Homebrew, everyday use, upgrading, the rc channel, uninstalling.
  • The integration has an icon and a logo, shipped inside it and served by Home
    Assistant 2026.3+; older versions simply show what they show today.

  Fixed

  • Provisioning stops scanning the moment it finds your robot. It used to run
    the whole --scan-timeout even after the robot answered — and since a robot
    only advertises while you hold Connect, that spent the pairing window instead
    of using it. One bench attempt found the robot and then failed to connect,
    because it had gone quiet by the time the scan ended.
  • The WiFi check no longer reports 0.0.0.0 as your robot's address. The
    robot says "connected" the instant it associates, before DHCP hands out a
    lease, so the join is confirmed but the address is not yet known — and printing
    the unset one claimed a fact it did not have.
  • Pet weight is right again (raw ÷ 100, the cloud's own units) — recent rc
    builds doubled the reading.
  • The weekday sleep schedule arms every day, not just Sunday, and the panel
    sleep and wake times can actually be set — they now write the per-day
    registers instead of one the firmware only computes.
  • robotStatus 10 is the clean cycle, with the boot cycle and filter wizard
    mapped too. Left unmapped, their readings were published as real litter levels.
  • Litter readings are suppressed while the globe is not level — mid-cycle the
    sensors are looking at the globe, not the litter. The first reading after a
    restart is no longer discarded either.
  • The globe motor fault sensor watches the activity stream, where the fault
    actually appears — the state document sat at 0 through a real fifty-minute
    fault. A restored fault can also clear after a missed clear event, on the proof
    of a clean cycle completing.
  • Cat detection no longer mistakes weight on the scale for a cat — occupancy
    uses the bit that tracks the animal, not the one a misseated bonnet holds — and
    handling the robot no longer counts as a visit.
  • A long cat visit is no longer dropped. The close was matched against a
    90-second window, and the cats that sit longest fell outside it. Last cat
    visit now updates on every robot, stamping from occupancy rather than only
    from weight events, which one robot never sends.
  • Hopper telemetry stopped lying about itself. Detection now means litter was
    actually delivered, because the link register reports healthy on a bench and
    "disconnected" during a refill — so nothing reads it for connectivity any more.
    The level survives a restart instead of reading unknown for days, a robot that
    dispenses but rarely reports its link keeps its telemetry, one dispense cannot
    prove an empty hopper, and the upgrade sweep no longer removes hopper entities
    from a robot that has one.
  • The out-of-litter alert judges against your robot's own learned floor —
    floors differ per unit, and a fixed cutoff could cry empty while litter was
    still flowing.
  • A restored excess-weight alarm clears once the robot reports the pan clear,
    instead of re-firing on every later visit.
  • Event sensors appear only once their fact has been reported. Some firmware
    never emits a drawer event or a weight, and those sensors sat unknown forever; a
    one-time sweep applies the same standard to existing installs — and a detection
    re-sweep no longer disables entities you enabled yourself.
  • brew install sisyphusmd/tap/whiskerless works again (the formula pinned a
    bleak whose build backend Homebrew cannot build), and every release now
    install-tests the formula before the tap publishes.
  • Errors are sentences, not stack traces. A Bluetooth failure reads "BLE scan
    failed: Bluetooth device is turned off"; ~ expands everywhere; every provision
    answer is checked at its prompt, including that the CA really is a PEM; file and
    broker errors print one line. --debug still gives you the traceback.
  • The serial validator rejects the model number (LR4-0301-00-US) printed
    beside the real serial on the label.
  • --dry-run marks everything it prints, so a simulation no longer describes
    writes that never happened.
  • whiskerless set night-light-mode auto works — every accepted spelling used
    to crash.
  • Every settings write is verified by read-back, multi-register writes no
    longer lose parts, and broker failures print instead of raising.
  • Fewer unknowns while calibration settles: the calibration reference shows the
    built-in default (marked as such) and the hopper level a labelled estimate.
  • "A short press does nothing" was wrong, and dangerous. A short press of the
    robot's Connect button toggles its WiFi off — the light bar turns white
    and the robot vanishes from your broker, looking for all the world like a dead
    unit. The README and the recovery guide both told you it was harmless. Hold
    Connect for pairing mode; tap it only to put the radio back.
  • The status a robot reports while powering down is no longer labelled
    "powering up", now that each half of a power cycle has been captured on its
    own rather than together.
  • The waste-drawer register no longer claims to know direction. A brief rule
    ("it speaks on a seat and stays silent on a removal") held on one robot and
    failed on the other; whiskerless still reports only when the drawer last
    moved, which is all the hardware supports.
  • The declared Home Assistant minimum is correct (2025.3.0, not 2025.2.0).

  Changed

  • Some entities were renamed, and existing installs are moved with them:
    Start clean cycle → Clean cycle, the two calibration buttons →
    Calibrate full / Calibrate empty, Hopper fill (raw) → Hopper
    reading, Litter calibration reference → Litter reference. Entity IDs you
    chose yourself are left alone, and every rename is logged — check automations
    that referenced the old IDs.
  • The manual calibration buttons now ship disabled. The robot calibrates
    itself; enable them if you want to pin the scale to a measurement of your own.
  • Last visit duration ships disabled and enables itself at your robot's first
    report — not every robot emits it, and that is not a firmware split.
  • Litter distances read in millimetres, not inches converted to thirteen
    decimal places — the unit the protocol and the docs use. Per-entity overrides
    still win.
  • The raw hopper reading, last dispense and clean-cycle count moved to
    Diagnostics, leaving the sensor list to the things worth a glance.
  • Auto-calibration got a statistics upgrade: a median-based outlier gate keeps
    in-band anomalies (a paw reads like an overfull globe) away from the litter
    anchors, and the hopper floor is learned from declined-into flatline runs — in
    both directions, so a floor that moved up is found as readily as one below.
  • Detections remember what proved them, so tightening one rule can no longer
    cost you entities another rule had already earned.
  • All the derived telemetry moved into the library, which is what will let the
    CLI show everything Home Assistant shows without a second implementation.
  • Release binaries and the macOS installer carry the version in the filename
    (whiskerless-<version>-linux-x86_64); the scheme is in packaging/README.md.

  Downloads

  • Source code (ZIP)
    0 downloads
  • Source code (TAR.GZ)
    0 downloads

  ---

  • whiskerless-0.2.0-rc.26-linux-arm64
    0 downloads · 2026-08-16 23:45:46 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.26-linux-x86_64
    0 downloads · 2026-08-16 23:45:46 -07:00 · 31 MiB
  • whiskerless-0.2.0-rc.26-macos-arm64.pkg
    1 download · 2026-08-16 23:25:06 -07:00 · 15 MiB
  • whiskerless-0.2.0-rc.26-macos-x86_64.pkg
    1 download · 2026-08-16 23:25:08 -07:00 · 14 MiB
  • whiskerless-0.2.0~rc.26.aarch64.rpm
    0 downloads · 2026-08-16 23:45:45 -07:00 · 30 MiB
  • whiskerless-0.2.0~rc.26.x86_64.rpm
    0 downloads · 2026-08-16 23:45:45 -07:00 · 31 MiB
  • whiskerless_0.2.0~rc.26_amd64.deb
    0 downloads · 2026-08-16 23:45:45 -07:00 · 31 MiB
  • whiskerless_0.2.0~rc.26_arm64.deb
    0 downloads · 2026-08-16 23:45:45 -07:00 · 30 MiB