Skip to content

About

Pawsistant is a Home Assistant integration for tracking your dogs activities as sensors

Resources

Stars

1 star

Watchers

0 watching

Forks

ย 
ย 

Latest commit

ย 

History

126 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Pawsistant ๐Ÿพ

Integration Usage

GitHub Downloads GitHub Latest Downloads GitHub Release GitHub Release Date GitHub Activity Coverage License hacs Project Maintenance ko-fi HACS Validation HA Version

A local-only dog activity tracker for Home Assistant. Log walks, bathroom breaks, meals, medications, weight, and more โ€” all stored privately in your HA instance with no cloud dependency.


Screenshots

Pawsistant Card โ€” Quick-log buttons and timeline ย ย  Pawsistant Card โ€” Backdate and weight logging


Features

  • Local storage only โ€” all data stored in HA's .storage directory, no cloud accounts or tokens required
  • Per-event sensors โ€” most-recent timestamp for each event type (pee, poop, medicine, walk, food, treat, water, grooming, training, sleep, weight, vaccine, sick)
  • Daily count sensors โ€” today's counts for common event types (resets at local midnight)
  • Days-since-medicine sensor โ€” track medication intervals for automation reminders
  • Weight sensor โ€” track your dog's weight over time
  • Pawsistant Card โ€” built-in Lovelace card auto-registers on install; log events, view the full event timeline with infinite scroll, and track stats without leaving the dashboard
  • Pawsistant Button Card โ€” separate card for placing quick-log buttons anywhere on your dashboard. Multiple buttons per card, configurable grid (2โ€“6 per row), add/remove/reorder in the visual editor. Tap opens backdate form, long-press logs instantly with haptic feedback
  • Haptic feedback โ€” long-press on any Pawsistant card triggers native haptics in HA Companion (Taptic Engine on iOS, system haptics on Android)
  • Multi-dog support โ€” add and remove dogs via services at any time
  • Timezone-aware โ€” daily counts use your HA instance's local timezone

Installation

Via HACS (recommended)

  1. Open HACS โ†’ Integrations โ†’ โ‹ฎ โ†’ Custom repositories
  2. Add https://github.com/prestomation/Pawsistant with category Integration
  3. Search for Pawsistant and install
  4. Restart Home Assistant

Manual

  1. Copy custom_components/pawsistant/ into your HA config's custom_components/ directory
  2. Restart Home Assistant

Configuration

  1. Go to Settings โ†’ Devices & Services โ†’ Add Integration
  2. Search for Pawsistant
  3. Enter your first dog's name (required), breed, and birth date (both optional)
  4. HA creates sensors for your dog and auto-registers the Pawsistant card as a Lovelace resource

Care schedules (Home Keeper integration)

If you also run the Home Keeper task tracker, Pawsistant's options (Settings โ†’ Devices & Services โ†’ Pawsistant โ†’ Configure โ†’ Manage care schedules) let you attach a recurring schedule to any pet activity โ€” nail trims, medicine, grooming, etc.

Pawsistant creates the matching recurring task in Home Keeper (attached to the pet's device) and keeps the two in sync: logging the activity in Pawsistant marks the Home Keeper task done, and completing the task in Home Keeper logs the activity in Pawsistant โ€” so they behave like the same button. The option only appears when Home Keeper is installed.

Pawsistant also announces itself to Home Keeper so it appears under Home Keeper's Settings โ†’ Companions section, with a Configure link to Pawsistant's settings page (where the care schedules above live) โ€” so if you have both, you'll discover they pair up from either side.


Lovelace Card

The Pawsistant card is automatically registered when the integration loads. Add it to any dashboard:

type: custom:pawsistant-card
dog: Sharky

Card features:

  • Quick-log buttons (tap to log now, hold to backdate)
  • Weight logging form with configurable unit (lbs/kg)
  • Full event timeline with infinite scroll, inline edit and delete
  • Stats row: pee count, poop count, days since medicine

Card config options:

Key Default Description
dog (required) Dog's display name (must match the name used in services)
shown_types ['poop','pee','medicine','sick','weight'] Which event-type buttons to show
weight_unit lbs Weight unit: lbs or kg
timeline_entity auto-detected Override timeline sensor entity ID
pee_count_entity auto-detected Override pee count sensor entity ID
poop_count_entity auto-detected Override poop count sensor entity ID
medicine_days_entity auto-detected Override days-since-medicine sensor entity ID
weight_entity auto-detected Override weight sensor entity ID

Services

pawsistant.log_event

Log an activity for a dog.

Field Required Description
dog โœ… Dog name (case-insensitive)
event_type โœ… One of: poop, pee, medicine, sick, food, treat, walk, water, sleep, vaccine, training, weight, grooming, teeth_brushing
note โ€” Optional note
value โ€” Numeric value (required for weight events; lbs)
timestamp โ€” ISO 8601 timestamp for backdating; defaults to now

pawsistant.delete_event

Delete an event by ID.

Field Required Description
event_id โœ… Event ID (available in sensor extra_state_attributes)

pawsistant.add_dog

Register a new dog (triggers integration reload to create sensors).

Field Required Description
name โœ… Dog's name
breed โ€” Breed
birth_date โ€” Birth date (YYYY-MM-DD)

pawsistant.remove_dog

Remove a dog and all associated events.

Field Required Description
dog โœ… Dog name (case-insensitive)

pawsistant.list_events

Query events for a dog. Returns data via service response (response_variable).

Field Required Default Description
dog โœ… Dog name
event_type โ€” all types Filter by event type
days โ€” 7 Number of past days to include

Example automation:

action:
  - service: pawsistant.list_events
    data:
      dog: Sharky
      event_type: medicine
      days: 30
    response_variable: medicine_events

pawsistant.import_events

Bulk-import events from a JSON array (for migrating from other systems).

Field Required Description
events โœ… List of event dicts with keys: event_type, timestamp, dog_id, note, value

Sensors

For a dog named Sharky, the following entities are created:

Entity Description
sensor.sharky_most_recent_pee Timestamp of last pee event
sensor.sharky_most_recent_poop Timestamp of last poop event
sensor.sharky_most_recent_medicine Timestamp of last medicine event
sensor.sharky_most_recent_walk Timestamp of last walk
sensor.sharky_most_recent_food Timestamp of last meal
sensor.sharky_daily_pee_count Pee events today
sensor.sharky_poop_count_today Poop events today
sensor.sharky_daily_walk_count Walks today
sensor.sharky_weight Most recent weight (lbs)
sensor.sharky_days_since_medicine Days since last medicine event
sensor.sharky_recent_timeline Count + list of events in last 24h

Storage

Events are stored in HA's .storage directory:

  • .storage/pawsistant โ€” dog registry (names, breeds, IDs)
  • .storage/pawsistant_events_YYYY โ€” events partitioned by year

No external database, no cloud sync, no tokens.


License

MIT

About

Pawsistant is a Home Assistant integration for tracking your dogs activities as sensors

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages