ring-security

# Ring Security

Your Ring doorbell and camera ecosystem, accessible from the command line.

## Overview

This skill connects to Ring's cloud API to give you visibility into your home security system. Check doorbell and camera status, review motion detection events, manage security modes, and pull historical event data for analysis.

> **Note:** Ring does not offer an official public API. This tool uses the same endpoints as the Ring mobile app. Functionality may change if Ring updates their API.

## Getting Started

### Credentials

Ring uses email + password authentication with 2FA support:

```bash
export RING_EMAIL="you@example.com"
export RING_PASSWORD="your-password"
```

On first run, you'll be prompted for your 2FA code. The script caches the refresh token locally at `~/.ring-security/token.json`.

### First Connection

```bash
bash scripts/ring-security.sh auth login
# Enter 2FA code when prompted
# Token cached for future use

bash scripts/ring-security.sh auth check
# Verify token is valid
```

---

## Feature Walkthrough

### Device Discovery

When you first connect, the script maps all Ring devices on your account:

```bash
$ bash scripts/ring-security.sh devices

Ring Devices Found:
┌──────────────────────┬─────────────────┬──────────┬─────────┐
│ Name                 │ Type            │ Battery  │ Status  │
├──────────────────────┼─────────────────┼──────────┼─────────┤
│ Front Door           │ Doorbell Pro 2  │ N/A      │ Online  │
│ Backyard             │ Spotlight Cam   │ 87%      │ Online  │
│ Garage               │ Stick Up Cam    │ 45%      │ Online  │
│ Side Gate            │ Floodlight Cam  │ N/A      │ Offline │
└──────────────────────┴─────────────────┴──────────┴─────────┘
```

### Live Status

```bash
# All devices at a glance
bash scripts/ring-security.sh status

# Specific device details
bash scripts/ring-security.sh status "Front Door"

# Battery levels across all devices
bash scripts/ring-security.sh battery

# Wi-Fi signal strength
ba...