Skip to content

About

Home Assistant custom integration for Stealth Cam / GSM Outdoors Command cellular trail cameras.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

ย 

History

43 Commits

Folders and files

Repository files navigation

๐ŸฆŒ Stealth Cam Command Integration for Home Assistant

hacs_badge GitHub Release Validate License: MIT

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

A native, feature-rich Home Assistant custom integration for Stealth Cam / GSM Outdoors Command cellular trail cameras.

Provides real-time hardware telemetry, cellular connectivity monitoring, field weather analytics, GPS tracking, high-resolution photo reels, live wind matrix calculations, and 1-tap verified buck tagging.


๐ŸŒŸ Key Features

  • ๐Ÿ”‹ Hardware & Battery Telemetry: Real-time battery percentage (%), voltage (V), SD card health & free space (%), and cellular sync timestamps.
  • ๐Ÿ“ถ Cellular Connectivity: Signal strength ratings, RSSI dBm values, and carrier network status.
  • ๐Ÿ“ธ High-Resolution Photo Feeds: Native camera entities with high-resolution image proxies, thumbnail galleries, and full-screen inspection.
  • ๐ŸŒค๏ธ Field Environmental Sensors: Ambient field temperature (ยฐF), barometric pressure (inHg), pressure trend, wind speed & compass direction, and moon phase.
  • ๐Ÿงญ Stand Scent & Wind Direction Matrix: Evaluates current field wind against each camera stand's physical heading to compute favorable, marginal, or unfavorable hunting conditions.
  • ๐ŸฆŒ Multi-Classification Photo Tagging: 1-tap tagging for Bucks (Gold โœจ), Does (Blue ๐ŸฆŒ), and Human Activity (Red Alert ๐Ÿšจ) with automatic visual borders and glow badges.
  • ๐Ÿ”ข Consecutive Photo Burst Sighting Deduplication: Automatically groups consecutive burst photos of a buck or doe on a camera into a single sighting count (buck_hits_count, doe_hits_count, buck_hits_24h, doe_hits_24h), while preserving raw photo counts (raw_buck_photos_count, raw_doe_photos_count).
  • ๐Ÿ† Target Buck Profiler, /media Vault & Movement Tracker (v1.3.0):
    • Automatically downloads and archives every buck burst photo locally to /media/stealthcam_bucks/<guid>.jpg (and <guid>_hd.jpg) for permanent browsing in Home Assistant's Media Browser (media-source://media_source/local/stealthcam_bucks/...).
    • Iterative HD Photo State Machine: Automatically requests full-resolution uncompressed HD photos (PATCH /api/v1/file-manager/images/{guid}/{device_id}/hq/request) for the hero frame (#1) of a buck sighting burst; if Frame #1 fails or has obscured antlers, it automatically escalates to Frame #2 in the burst.
    • Multi-Image AI Vision & Manual Buck Naming: Supports automated antler profiling via Google Gemini (gemini-2.5-flash) or OpenAI (gpt-4o), plus manual services (stealthcam_command.name_buck, stealthcam_command.assign_buck_sighting) to name individual bucks, track last-seen timestamps, favorite stands, travel corridors, and expose sensor.stealthcam_buck_profiles and camera.stealthcam_buck_profile_1..8.
  • โฑ๏ธ Dual 24-Hour & All-Time Movement Distribution: Classifies both rolling 24-hour activity and historical trends across Dawn Transitions (5โ€“9 AM), Daylight Movement (9 AMโ€“4 PM), Evening Feeding (4โ€“8 PM), and Night Roaming (8 PMโ€“5 AM).
  • ๐Ÿšจ Human Activity & Intruder Detection: Flags cameras with human presence to immediately alert landowners of field activity.
  • ๐Ÿ—บ๏ธ GPS Mapping & Stand Tracking: Tracks camera positions on Home Assistant maps with custom stand character pins and compass headings.

๐Ÿ“ฆ Installation via HACS (Recommended)

  1. Ensure HACS (Home Assistant Community Store) is installed.
  2. Open Home Assistant and navigate to HACS โž” Integrations.
  3. Click the 3 dots in the top right corner and select Custom repositories.
  4. Enter the Repository URL:
    https://github.com/Malklor/ha_command_integration
    
  5. Select Integration as the Category and click Add.
  6. Find Stealth Cam Command in the integration list and click Download.
  7. Restart Home Assistant.

โš™๏ธ Configuration

  1. In Home Assistant, go to Settings โž” Devices & Services โž” Add Integration.
  2. Search for Stealth Cam Command.
  3. Enter your Stealth Cam Command account email and password.
  4. Click Submit. Home Assistant will automatically discover all registered cellular trail cameras and generate camera, sensor, and tracker entities.

๐Ÿ“Š Entities Created Per Camera

Entity Type Entity ID Example Description
Camera (Latest Photo) camera.stealth_cam_north_ridge_north_ridge_trail_cam Latest high-res photo capture with full image proxy
Capture Cameras (1โ€“36) camera.stealth_cam_north_ridge_north_ridge_photo_1 Individual historical photo capture camera entities
Battery Sensor sensor.stealth_cam_north_ridge_north_ridge_battery Battery percentage (%) and voltage
Signal Sensor sensor.stealth_cam_north_ridge_north_ridge_cellular_signal Cellular signal strength and carrier
SD Card Sensor sensor.stealth_cam_north_ridge_north_ridge_sd_free_space SD card free storage percentage (%)
Check-in Sensor sensor.stealth_cam_north_ridge_north_ridge_last_check_in Timestamp of last cellular check-in
Last Hit Sensor sensor.stealth_cam_north_ridge_north_ridge_last_animal_hit Timestamp of most recent animal detection
Buck Hits Sensor sensor.stealth_cam_north_ridge_north_ridge_positive_buck_hits Verified buck hit count
Peak Window Sensor sensor.stealth_cam_north_ridge_north_ridge_peak_movement_window Stand's peak movement window
Location Sensor sensor.stealth_cam_north_ridge_north_ridge_stand_location GPS coordinates and stand compass bearing
Buck Profiles Sensor (Hub) sensor.stealthcam_buck_profiles Master Target Buck Hit-List, movement logs, and stand corridors
Profiled Buck Cameras (1โ€“8) camera.stealthcam_buck_profile_1 Live hero portrait camera entities for up to 8 named property bucks
Buck Gallery Cameras (1โ€“20) camera.stealthcam_buck_1_photo_1 Per-buck historical capture camera entities (up to 20 photos per buck)

๐Ÿ› ๏ธ Services

The integration registers native services for dashboard interactions and automations:

stealthcam_command.name_buck

Renames an identified buck profile and optionally updates its antler points or physical notes:

service: stealthcam_command.name_buck
data:
  buck_id: "buck_north_ridge"
  name: "Boss"
  points: "8-PT (4x4)"
  antler_notes: "Wide 17-inch spread outside ears, tall G2s"

stealthcam_command.assign_buck_sighting

Assigns any buck sighting burst (by image GUID) to a named buck profile:

service: stealthcam_command.assign_buck_sighting
data:
  guid: "01a1109a-f850-73a7-9fb2-8b1be1024262"
  buck_name: "Boss"
  points: "8-PT (4x4)"

stealthcam_command.request_hd

Requests the full-resolution HD photo from the cellular trail camera (or escalates to the next frame in a buck burst):

service: stealthcam_command.request_hd
data:
  guid: "01a1109a-f850-73a7-9fb2-8b1be1024262"

stealthcam_command.configure_ai_profiler

Configures the optional Gemini (gemini-2.5-flash) or OpenAI (gpt-4o) API key for automated multi-image antler profiling:

service: stealthcam_command.configure_ai_profiler
data:
  provider: "gemini"
  api_key: "YOUR_API_KEY"

stealthcam_command.tag_buck

Tags or scores a photo capture as a verified antlered buck (Gold badge):

service: stealthcam_command.tag_buck
data:
  guid: "01a1109a-f850-73a7-9fb2-8b1be1024262"

stealthcam_command.tag_doe

Tags a photo capture as a verified doe (Blue badge):

service: stealthcam_command.tag_doe
data:
  guid: "01a1109a-f850-73a7-9fb2-8b1be1024262"

stealthcam_command.tag_person

Flags a photo capture for human activity (Red Alert badge):

service: stealthcam_command.tag_person
data:
  guid: "01a1109a-f850-73a7-9fb2-8b1be1024262"

stealthcam_command.sync_now

Triggers an immediate cloud refresh of camera telemetry and latest captures:

service: stealthcam_command.sync_now
  • ๐Ÿ”ฎ 5-Day Solunar & Weather Predictive Forecast Engine: Correlates future multi-day weather forecasts (temperature, templow, wind_bearing, wind_speed), upcoming moon phases, and cold snaps against historical stand baselines to recommend optimal stands and tactics for Dawn (5:30โ€“8:30 AM) vs. Dusk (4:30โ€“7:30 PM) hunting windows.
  • ๐ŸŒก๏ธ Deep Wildlife Environmental Matrix: Correlates buck/doe activity across temperature bands (<40ยฐF, 40โ€“50ยฐF, 50โ€“60ยฐF, 60โ€“70ยฐF, >70ยฐF), 8 lunar rut phases, and a 24-hour chronogram.
  • ๐Ÿ“ฑ Mobile-Optimized Photo Reel: Responsive 2-column photo reel layout on phones with 8-option Quick Filter bar (Bucks, Does, Person, Dawn, Midday, Evening, Night).

๐Ÿ“ฑ Drop-in Lovelace Dashboards & Auto-Discovery

Pre-built dashboard templates are provided in the dashboards/ directory:

๐ŸŒŸ Zero-Config Auto-Discovery Hub (dashboards/auto_entities_hub.yaml)

Automatically discovers and displays all cameras on your account in a responsive grid with weather, battery, and 24-hour movement intelligence.

๐Ÿงญ Deep Wildlife Analytics & 5-Day Forecast View (dashboards/hunting_analytics_view.yaml)

Dedicated full dashboard view featuring 5-day predictive forecast tables, temperature movement matrix, moon phase correlation, 24-hour movement chronogram, and stand habitat scorecards.

๐Ÿ“ธ Stand Deep-Dive & 36-Photo Reel (dashboards/camera_subview_template.yaml)

Provides individual stand telemetry, 24-hr time-of-day movement distribution, verified buck/doe hit badges, responsive mobile 2-column photo reel, and auto-populates all 36 capture entities.

๐ŸฆŒ Target Buck Registry & Hit-List Hub (dashboards/buck_registry_view.yaml)

Dedicated summary page showing all identified unique bucks, rack points/spread, last seen timestamp, last camera, unique sighting count, and clickable hero cards that navigate into each buck's full dossier.

๐Ÿ† Individual Buck Dossier & Full Photo Vault (dashboards/buck_dossier_subview_template.yaml)

Per-buck deep-dive subview (buck-1..buck-8) displaying the buck's hero portrait, time-of-day behavior breakdown, camera stand frequency, verified stand-to-stand travel corridors, weather/barometer triggers, chronological sighting log, and full photo gallery (camera.stealthcam_buck_<slot>_photo_1..20).


๐ŸŽจ Customizing Camera Icons & Map Pin Avatars

You can customize camera icons and map pins directly in Home Assistant without touching YAML:

Option A: Home Assistant UI

  1. Go to Settings โž” Devices & Services โž” Entities.
  2. Click on your camera's location entity (e.g. North Ridge Camera Location).
  3. Click the โš™๏ธ icon to set any custom icon (e.g. mdi:tree, mdi:deer, mdi:target).

Option B: Custom Face Avatars on Map Pins (customize.yaml)

To show custom circular character photos or stand badges on Home Assistant maps:

  1. Place your PNG icons in /config/www/avatars/.
  2. Add to /config/customize.yaml:
    sensor.stealth_cam_north_ridge_north_ridge_stand_location:
      entity_picture: /local/avatars/stand_1.png

๐Ÿ“„ License

Distributed under the MIT License.

About

Home Assistant custom integration for Stealth Cam / GSM Outdoors Command cellular trail cameras.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages