{"id":"08c93290-d283-46ab-af8f-529c03f7adf6","entityType":"agent","slug":"clawhub-bytesagain-lab-ring-security","name":"Ring Security","canonicalUrl":"https://www.xpersona.co/agent/clawhub-bytesagain-lab-ring-security","canonicalPath":"/agent/clawhub-bytesagain-lab-ring-security","generatedAt":"2026-10-11T03:53:16.501Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T00:16:50.738Z","emptyReason":null},"description":"Reference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Ring Security concepts, best practices, and implementation patterns. Skill: Ring Security Owner: bytesagain-lab Summary: Reference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Ring Security concepts, best practices, and implementation patterns. Tags: chinese:1.0.0, latest:3.0.1, productivity:1.0.0 Version history: v3.0.1 | 2026-03-24T01:44:10.979Z | user Fix description v3.0.0 | 2026-03-23T00:59:49.052Z | user Clean package v2.0.1 | 2026-03-18T10:49:45","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s174pq5f3gzez3838vt2642fmx848f1d:ring-security","sourceUrl":"https://clawhub.ai/bytesagain-lab/ring-security","homepage":"https://clawhub.ai/bytesagain-lab/skills/ring-security","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/bytesagain-lab/ring-security","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/bytesagain-lab/skills/ring-security","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":62,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Reference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Ring Security concepts, best practices, and implementation patterns. Ski"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T00:16:50.738Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T00:16:50.738Z","emptyReason":null},"stars":null,"forks":null,"downloads":1222,"packageName":null,"latestVersion":"3.0.1","tractionLabel":"1.2K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T00:16:50.671Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T00:16:50.738Z","lastCrawledAt":"2026-10-11T00:16:50.671Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T00:16:50.671Z","lastVerifiedAt":null,"highlights":[{"version":"3.0.1","createdAt":"2026-03-24T01:44:10.979Z","changelog":"Fix description","fileCount":4,"zipByteSize":4957},{"version":"3.0.0","createdAt":"2026-03-23T00:59:49.052Z","changelog":"Clean package","fileCount":3,"zipByteSize":3879},{"version":"2.0.1","createdAt":"2026-03-18T10:49:45.388Z","changelog":"update","fileCount":3,"zipByteSize":3230},{"version":"2.0.0","createdAt":"2026-03-17T18:50:49.114Z","changelog":"v2.5 standard: Use-when desc, homepage, source, security fix","fileCount":5,"zipByteSize":8015},{"version":"2.3.6","createdAt":"2026-03-16T13:15:40.401Z","changelog":"yaml-fix+quality","fileCount":5,"zipByteSize":7976},{"version":"2.3.5","createdAt":"2026-03-16T12:10:01.316Z","changelog":"yaml-fix+quality","fileCount":5,"zipByteSize":7976},{"version":"2.3.4","createdAt":"2026-03-15T22:40:59.548Z","changelog":"Quality upgrade","fileCount":4,"zipByteSize":6886},{"version":"2.3.3","createdAt":"2026-03-15T21:54:58.952Z","changelog":"Quality upgrade: custom functionality","fileCount":4,"zipByteSize":6887}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s174pq5f3gzez3838vt2642fmx848f1d:ring-security","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-ring-security/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-ring-security/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-ring-security/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-ring-security/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-ring-security/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-ring-security/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T03:53:16.498Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-ring-security/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-ring-security/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-ring-security/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-ring-security/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T00:16:50.738Z","emptyReason":null},"readme":"Skill: Ring Security\n\nOwner: bytesagain-lab\n\nSummary: Reference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Ring Security concepts, best practices, and implementation patterns.\n\nTags: chinese:1.0.0, latest:3.0.1, productivity:1.0.0\n\nVersion history:\n\nv3.0.1 | 2026-03-24T01:44:10.979Z | user\n\nFix description\n\nv3.0.0 | 2026-03-23T00:59:49.052Z | user\n\nClean package\n\nv2.0.1 | 2026-03-18T10:49:45.388Z | user\n\nupdate\n\nv2.0.0 | 2026-03-17T18:50:49.114Z | user\n\nv2.5 standard: Use-when desc, homepage, source, security fix\n\nv2.3.6 | 2026-03-16T13:15:40.401Z | user\n\nyaml-fix+quality\n\nv2.3.5 | 2026-03-16T12:10:01.316Z | user\n\nyaml-fix+quality\n\nv2.3.4 | 2026-03-15T22:40:59.548Z | user\n\nQuality upgrade\n\nv2.3.3 | 2026-03-15T21:54:58.952Z | user\n\nQuality upgrade: custom functionality\n\nv2.3.2 | 2026-03-15T10:57:13.991Z | user\n\nQuality fix: cleaner docs, removed flags\n\nv2.3.1 | 2026-03-15T01:46:42.506Z | user\n\nQuality update: docs, examples, standards compliance\n\nv2.3.0 | 2026-03-14T00:21:05.693Z | user\n\nQuality fixes: removed third-party references, aligned docs with implementation\n\nv2.2.0 | 2026-03-13T17:09:11.917Z | user\n\nEnhanced descriptions for better AI triggering\n\nv2.1.0 | 2026-03-13T16:54:38.132Z | user\n\nEnhanced descriptions for better AI triggering\n\nv1.0.1 | 2026-03-13T00:26:59.079Z | user\n\nAdd runtime declaration + security compliance\n\nv1.0.0 | 2026-03-11T11:18:20.323Z | auto\n\nInitial release of ring-security.\n\n- Monitor and manage Ring doorbells and security cameras from the command line.\n- Features include device discovery, live status, event history review, security mode control, and light/siren toggling.\n- Supports exporting event data as CSV or JSON for analysis.\n- Provides analytics like daily activity summaries and peak activity hours.\n- Designed for use with Ring’s cloud API, including 2FA and token management.\n\nArchive index:\n\nArchive v3.0.1: 4 files, 4957 bytes\n\nFiles: scripts/script.sh (6991b), skill-card.md (1813b), SKILL.md (1179b), _meta.json (132b)\n\nFile v3.0.1:SKILL.md\n\n---\nname: \"ring-security\"\nversion: \"3.0.1\"\ndescription: \"Reference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Ring Security concepts, best practices, and implementation patterns.\"\nauthor: \"BytesAgain\"\nhomepage: \"https://bytesagain.com\"\nsource: \"https://github.com/bytesagain/ai-skills\"\ntags: [ring,security, reference]\ncategory: \"life\"\n---\n\n# Ring Security\n\nReference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Ring Security concepts, best practices, and implementation patterns. No API keys or credentials required.\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `intro` | intro reference |\n| `quickstart` | quickstart reference |\n| `patterns` | patterns reference |\n| `debugging` | debugging reference |\n| `performance` | performance reference |\n| `security` | security reference |\n| `migration` | migration reference |\n| `cheatsheet` | cheatsheet reference |\n\n## Output Format\n\nAll commands output plain-text reference documentation via heredoc. No external API calls, no credentials needed, no network access.\n\n---\n\n*Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*\n\nFile v3.0.1:_meta.json\n\n{\n \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n \"slug\": \"ring-security\",\n \"version\": \"3.0.1\",\n \"publishedAt\": 1774316650979\n}\n\nFile v3.0.1:skill-card.md\n\n## Description:\n\nReference tool for life - covers intro, quickstart, patterns and more. Quick lookup for Ring Security concepts, best practices, and implementation patterns.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[bytesagain-lab](https://clawhub.ai/user/bytesagain-lab)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill as a quick reference for Ring Security concepts, quickstart material, implementation patterns, troubleshooting, performance, security considerations, migration guidance, and cheat-sheet output.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill provides generic reference documentation rather than a deeply specialized Ring Security integration.\n\nMitigation: Treat the output as quick-reference guidance and review it against authoritative Ring Security requirements before using it for operational decisions.\n\n## Reference(s):\n\n- [Ring Security on ClawHub](https://clawhub.ai/bytesagain-lab/skills/ring-security)\n- [BytesAgain](https://bytesagain.com)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Guidance]\n\n**Output Format:** [Plain-text reference documentation with Markdown headings]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [No API keys, privileged access, network access, persistence, or destructive behavior are indicated by the security evidence.]\n\n## Skill Version(s):\n\n3.0.1 (source: server release evidence and SKILL.md frontmatter; script declares 3.0.0)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v3.0.0: 3 files, 3879 bytes\n\nFiles: scripts/script.sh (6991b), SKILL.md (947b), _meta.json (132b)\n\nFile v3.0.0:SKILL.md\n\n---\nname: \"ring-security\"\nversion: \"3.0.0\"\ndescription: \"Powered by BytesAgain\"\nauthor: \"BytesAgain\"\nhomepage: \"https://bytesagain.com\"\nsource: \"https://github.com/bytesagain/ai-skills\"\ntags: [ring,security, reference]\ncategory: \"life\"\n---\n\n# Ring Security\n\nPowered by BytesAgain. No API keys or credentials required — outputs reference documentation only.\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `intro` | intro reference |\n| `quickstart` | quickstart reference |\n| `patterns` | patterns reference |\n| `debugging` | debugging reference |\n| `performance` | performance reference |\n| `security` | security reference |\n| `migration` | migration reference |\n| `cheatsheet` | cheatsheet reference |\n\n## Output Format\n\nAll commands output plain-text reference documentation via heredoc. No external API calls, no credentials needed, no network access.\n\n---\n\n*Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*\n\nFile v3.0.0:_meta.json\n\n{\n \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n \"slug\": \"ring-security\",\n \"version\": \"3.0.0\",\n \"publishedAt\": 1774227589052\n}\n\nArchive v2.0.1: 3 files, 3230 bytes\n\nFiles: scripts/script.sh (2440b), SKILL.md (4193b), _meta.json (132b)\n\nFile v2.0.1:SKILL.md\n\n---\nversion: \"2.0.0\"\nname: ring-security\ndescription: \"Control Ring doorbells and cameras from the terminal. Use when scanning motion events, auditing device access, checking firmware, reporting activity.\"\nauthor: BytesAgain\nhomepage: https://bytesagain.com\nsource: https://github.com/bytesagain/ai-skills\n---\n\n# Ring Security\n\nSecurity scanning and hardening tool for auditing systems, generating reports, and enforcing compliance from the command line.\n\n## Overview\n\nring-security provides a suite of security-focused commands for vulnerability scanning, compliance auditing, encryption helpers, password generation, and hardening guidance. All operations are local and logged for traceability.\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `ring-security scan` | Run a vulnerability scan |\n| `ring-security audit` | Execute a security audit checklist |\n| `ring-security check ` | Quick security check on a specific target |\n| `ring-security report` | Generate a security report |\n| `ring-security harden` | Display hardening steps (Update → Firewall → Auth) |\n| `ring-security encrypt ` | Encryption helper for a given file or string |\n| `ring-security hash ` | Generate SHA-256 hash of a string |\n| `ring-security password` | Generate a random 16-character password |\n| `ring-security compliance` | Show compliance checklist (Access controls, Encryption, Logging) |\n| `ring-security alerts` | Check for active security alerts |\n| `ring-security help` | Show help message |\n| `ring-security version` | Show version (v2.0.0) |\n\n## Data Storage\n\n- **Location:** `$RING_SECURITY_DIR` or `~/.local/share/ring-security/`\n- **Data file:** `data.log` — general operation log\n- **History:** `history.log` — timestamped action log for audit trail\n- All data is plain text, stored locally. No cloud services required.\n\n## Requirements\n\n- bash (with `set -euo pipefail`)\n- python3 (standard library only — used for password generation via `random` and `string`)\n- Standard Unix utilities (`sha256sum`, `date`, `echo`)\n- No external API keys or accounts needed\n\n## When to Use\n\n1. **Quick vulnerability scanning** — Run `scan` to identify potential security issues on a system\n2. **Security audits** — Use `audit` to walk through a checklist of security controls\n3. **Password generation** — Generate strong random passwords with `password` — 16 chars with letters, digits, and symbols\n4. **Compliance reviews** — Use `compliance` to check Access Controls, Encryption, and Logging status\n5. **System hardening** — Follow the `harden` guide for a step-by-step approach: Update → Firewall → Auth\n\n## Examples\n\n```bash\n# Run a full vulnerability scan\nring-security scan\n\n# Perform a security audit\nring-security audit\n\n# Quick check on a specific target\nring-security check \"web-server-01\"\n\n# Generate a security report\nring-security report\n```\n\n```bash\n# Get hardening guidance\nring-security harden\n# Output: Step 1: Update | Step 2: Firewall | Step 3: Auth\n\n# Generate a random password\nring-security password\n# Output: e.g. \"aB3!xK9mQ2@nP7wL\"\n\n# Hash a string with SHA-256\nring-security hash \"my-secret-value\"\n# Output: SHA-256 hash of the input\n```\n\n```bash\n# Check compliance status\nring-security compliance\n# Output: [ ] Access controls | [ ] Encryption | [ ] Logging\n\n# Check for active security alerts\nring-security alerts\n\n# Encrypt a file\nring-security encrypt \"sensitive-data.txt\"\n```\n\n## How It Works\n\nEach command performs its security operation and logs the action with a timestamp to `history.log`. The `hash` command uses `sha256sum` for real cryptographic hashing. The `password` command leverages Python's `random` and `string` modules to generate 16-character passwords mixing uppercase, lowercase, digits, and special characters (`!@#`).\n\n## Tips\n\n- Pipe `hash` output for scripting: `ring-security hash \"value\" | xargs echo`\n- Use `report` in a cron job for regular security summaries\n- Override the data directory: `export RING_SECURITY_DIR=/path/to/custom/dir`\n- Combine `scan` and `audit` in a daily cron for automated security monitoring\n\n---\n\nPowered by BytesAgain | bytesagain.com | hello@bytesagain.com\n\nFile v2.0.1:_meta.json\n\n{\n \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n \"slug\": \"ring-security\",\n \"version\": \"2.0.1\",\n \"publishedAt\": 1773830985388\n}\n\nArchive v2.0.0: 5 files, 8015 bytes\n\nFiles: scripts/ring.sh (8564b), scripts/script.sh (2440b), SKILL.md (6270b), tips.md (2010b), _meta.json (132b)\n\nFile v2.0.0:SKILL.md\n\n---\nversion: \"2.0.0\"\nname: ring-security\ndescription: \"Monitor and manage Ring doorbells and security cameras. Query device status, review motion events, manage modes.\"\nauthor: BytesAgain\nhomepage: https://bytesagain.com\nsource: https://github.com/bytesagain/ai-skills\n---\n\n# Ring Security\n\nYour Ring doorbell and camera system, accessible from the command line.\n\n## Overview\n\nThis 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.\n\n> **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.\n\n## Getting Started\n\n### Credentials\n\nRing uses email + password authentication with 2FA support:\n\n```bash\nexport RING_EMAIL=\"you@example.com\"\nexport RING_PASSWORD=\"your-password\"\n```\n\nOn first run, you'll be prompted for your 2FA code. The script caches the refresh token locally at `~/.ring-security/token.json`.\n\n### First Connection\n\n```bash\nbash scripts/ring-security.sh auth login\n# Enter 2FA code when prompted\n# Token cached for future use\n\nbash scripts/ring-security.sh auth check\n# Verify token is valid\n```\n\n---\n\n## Feature Walkthrough\n\n### Device Discovery\n\nWhen you first connect, the script maps all Ring devices on your account:\n\n```bash\n$ bash scripts/ring-security.sh devices\n\nRing Devices Found:\n┌──────────────────────┬─────────────────┬──────────┬─────────┐\n│ Name │ Type │ Battery │ Status │\n├──────────────────────┼─────────────────┼──────────┼─────────┤\n│ Front Door │ Doorbell Pro 2 │ N/A │ Online │\n│ Backyard │ Spotlight Cam │ 87% │ Online │\n│ Garage │ Stick Up Cam │ 45% │ Online │\n│ Side Gate │ Floodlight Cam │ N/A │ Offline │\n└──────────────────────┴─────────────────┴──────────┴─────────┘\n```\n\n### Live Status\n\n```bash\n# All devices at a glance\nbash scripts/ring-security.sh status\n\n# Specific device details\nbash scripts/ring-security.sh status \"Front Door\"\n\n# Battery levels across all devices\nbash scripts/ring-security.sh battery\n\n# Wi-Fi signal strength\nbash scripts/ring-security.sh signal\n```\n\n### Motion & Ring Events\n\nThis is the core of Ring monitoring — reviewing what happened and when.\n\n```bash\n# Recent events (last 20)\nbash scripts/ring-security.sh events\n\n# Events for a specific device\nbash scripts/ring-security.sh events \"Front Door\" --limit 50\n\n# Events in a time range\nbash scripts/ring-security.sh events --from \"2024-01-15 08:00\" --to \"2024-01-15 18:00\"\n\n# Motion events only\nbash scripts/ring-security.sh events --type motion\n\n# Ding (doorbell press) events only\nbash scripts/ring-security.sh events --type ding\n\n# Event details with snapshot URL\nbash scripts/ring-security.sh event \n```\n\n### Security Modes\n\nControl your Ring alarm system modes (requires Ring Alarm):\n\n```bash\n# Current mode\nbash scripts/ring-security.sh mode\n\n# Set mode\nbash scripts/ring-security.sh mode home\nbash scripts/ring-security.sh mode away\nbash scripts/ring-security.sh mode disarmed\n\n# Mode history\nbash scripts/ring-security.sh mode history\n```\n\n### Light Control\n\nFor Ring devices with built-in lights (Floodlight Cam, Spotlight Cam):\n\n```bash\n# Toggle lights\nbash scripts/ring-security.sh light on \"Backyard\"\nbash scripts/ring-security.sh light off \"Backyard\"\n\n# Siren\nbash scripts/ring-security.sh siren on \"Backyard\"\nbash scripts/ring-security.sh siren off \"Backyard\"\n```\n\n### Event Export & Analysis\n\n```bash\n# Export events as CSV\nbash scripts/ring-security.sh export csv events_jan.csv --days 30\n\n# Export as JSON\nbash scripts/ring-security.sh export json events_jan.json --days 30\n\n# Activity summary (events per device per day)\nbash scripts/ring-security.sh analytics --days 7\n\n# Peak activity hours\nbash scripts/ring-security.sh analytics hourly --days 30\n```\n\n## Example Output: Analytics\n\n```\nActivity Summary (Last 7 Days):\n────────────────────────────────\nFront Door: ████████████████████ 47 events\nBackyard: █████████████ 31 events\nGarage: ██████ 14 events\n\nPeak Hours:\n 08:00-09:00 ████████ 18 events (morning deliveries)\n 17:00-18:00 ██████████ 23 events (arrivals home)\n 22:00-23:00 ████ 9 events (wildlife/wind)\n\nMost Active Day: Tuesday (avg 15.2 events)\nQuietest Day: Sunday (avg 4.8 events)\n```\n\n## Automation Ideas\n\n**Daily security digest email:**\n```bash\n0 8 * * * bash /path/to/ring-security.sh analytics --days 1 | mail -s \"Ring Daily Digest\" you@email.com\n```\n\n**Low battery alert:**\n```bash\nbash scripts/ring-security.sh battery --below 20\n# Outputs only devices below 20%, exit code 1 if any found\n```\n\n**Motion spike detection:**\n```bash\n# Alert if more than 20 events in the last hour\nCOUNT=$(bash scripts/ring-security.sh events --hours 1 --count)\nif [ \"$COUNT\" -gt 20 ]; then\n echo \"Unusual activity: $COUNT events in the last hour\"\nfi\n```\n\n## Caveats\n\n- Ring API is unofficial — updates to the Ring app may temporarily break functionality\n- 2FA is required for new logins; the cached token typically lasts 2-4 weeks\n- Video downloads require a Ring Protect subscription\n- API rate limits are not publicly documented; the script includes conservative delays\n- Snapshot URLs expire after a few minutes — download them promptly\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\nRun `ring-security help` to see all available commands.\n\n## Requirements\n- bash 4+\n- python3 (standard library only)\n\nFile v2.0.0:_meta.json\n\n{\n \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n \"slug\": \"ring-security\",\n \"version\": \"2.0.0\",\n \"publishedAt\": 1773773449114\n}\n\nFile v2.0.0:tips.md\n\n# Tips for Ring Security\n\n## Event Management\n\n1. **Check the `analytics` command regularly.** It shows activity patterns — unusually high event counts might indicate a problem (or just a windy day triggering your motion sensor).\n\n2. **Export events monthly.** Keep a local record with `export csv` in case you ever need to reference historical data. Ring's cloud retention depends on your subscription.\n\n3. **Tune motion sensitivity in the Ring app.** If you're getting too many false positives, adjust motion zones and sensitivity there — the API doesn't expose these settings.\n\n4. **Use `--type motion` vs `--type ding`** to separate actual doorbell presses from motion alerts.\n\n## Battery Life\n\n- Battery devices (Stick Up Cam, Spotlight Cam Battery) drain faster with:\n - High motion frequency\n - Cold weather\n - Live view usage\n - Poor Wi-Fi signal (more retries)\n- Use `battery --below 30` in a weekly cron to get early warnings\n- Wired devices (Doorbell Pro, Floodlight Cam) don't have this issue\n\n## Security Modes\n\n- **Home mode:** Disarms indoor cameras, keeps outdoor ones active\n- **Away mode:** Arms everything\n- **Disarmed:** All monitoring off (not recommended)\n- Set up mode changes in cron: arm at bedtime, disarm in the morning\n\n## Troubleshooting\n\n- **\"Token expired\"** — Run `auth login` again. You'll need your 2FA code.\n- **\"Device offline\"** — Check Wi-Fi. Power cycle the device. Check the Ring app for firmware updates.\n- **Events not showing** — There can be a 1-2 minute delay between event occurrence and API availability\n- **Slow API responses** — Ring's API can be sluggish during peak hours. The script retries automatically.\n\n## Privacy Notes\n\n- Ring events are stored in Amazon's cloud — be aware of data retention policies\n- Shared users on your Ring account can also see events\n- Video recordings require a Ring Protect subscription ($3.99/mo per device or $12.99/mo for all)\n- Consider local-only alternatives (like Frigate) if cloud storage concerns you\n\nArchive v2.3.6: 5 files, 7976 bytes\n\nFiles: scripts/ring.sh (8564b), scripts/script.sh (2422b), SKILL.md (6228b), tips.md (2010b), _meta.json (132b)\n\nFile v2.3.6:SKILL.md\n\n---\nversion: \"2.0.0\"\nname: ring-security\ndescription: \"Monitor and manage Ring doorbells and security cameras. Query device status, review motion events, manage modes, and export event history. Use when you need ring security capabilities. Triggers on: ring security.\"\nauthor: BytesAgain\n---\n\n# Ring Security\n\nYour Ring doorbell and camera system, accessible from the command line.\n\n## Overview\n\nThis 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.\n\n> **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.\n\n## Getting Started\n\n### Credentials\n\nRing uses email + password authentication with 2FA support:\n\n```bash\nexport RING_EMAIL=\"you@example.com\"\nexport RING_PASSWORD=\"your-password\"\n```\n\nOn first run, you'll be prompted for your 2FA code. The script caches the refresh token locally at `~/.ring-security/token.json`.\n\n### First Connection\n\n```bash\nbash scripts/ring-security.sh auth login\n# Enter 2FA code when prompted\n# Token cached for future use\n\nbash scripts/ring-security.sh auth check\n# Verify token is valid\n```\n\n---\n\n## Feature Walkthrough\n\n### Device Discovery\n\nWhen you first connect, the script maps all Ring devices on your account:\n\n```bash\n$ bash scripts/ring-security.sh devices\n\nRing Devices Found:\n┌──────────────────────┬─────────────────┬──────────┬─────────┐\n│ Name │ Type │ Battery │ Status │\n├──────────────────────┼─────────────────┼──────────┼─────────┤\n│ Front Door │ Doorbell Pro 2 │ N/A │ Online │\n│ Backyard │ Spotlight Cam │ 87% │ Online │\n│ Garage │ Stick Up Cam │ 45% │ Online │\n│ Side Gate │ Floodlight Cam │ N/A │ Offline │\n└──────────────────────┴─────────────────┴──────────┴─────────┘\n```\n\n### Live Status\n\n```bash\n# All devices at a glance\nbash scripts/ring-security.sh status\n\n# Specific device details\nbash scripts/ring-security.sh status \"Front Door\"\n\n# Battery levels across all devices\nbash scripts/ring-security.sh battery\n\n# Wi-Fi signal strength\nbash scripts/ring-security.sh signal\n```\n\n### Motion & Ring Events\n\nThis is the core of Ring monitoring — reviewing what happened and when.\n\n```bash\n# Recent events (last 20)\nbash scripts/ring-security.sh events\n\n# Events for a specific device\nbash scripts/ring-security.sh events \"Front Door\" --limit 50\n\n# Events in a time range\nbash scripts/ring-security.sh events --from \"2024-01-15 08:00\" --to \"2024-01-15 18:00\"\n\n# Motion events only\nbash scripts/ring-security.sh events --type motion\n\n# Ding (doorbell press) events only\nbash scripts/ring-security.sh events --type ding\n\n# Event details with snapshot URL\nbash scripts/ring-security.sh event \n```\n\n### Security Modes\n\nControl your Ring alarm system modes (requires Ring Alarm):\n\n```bash\n# Current mode\nbash scripts/ring-security.sh mode\n\n# Set mode\nbash scripts/ring-security.sh mode home\nbash scripts/ring-security.sh mode away\nbash scripts/ring-security.sh mode disarmed\n\n# Mode history\nbash scripts/ring-security.sh mode history\n```\n\n### Light Control\n\nFor Ring devices with built-in lights (Floodlight Cam, Spotlight Cam):\n\n```bash\n# Toggle lights\nbash scripts/ring-security.sh light on \"Backyard\"\nbash scripts/ring-security.sh light off \"Backyard\"\n\n# Siren\nbash scripts/ring-security.sh siren on \"Backyard\"\nbash scripts/ring-security.sh siren off \"Backyard\"\n```\n\n### Event Export & Analysis\n\n```bash\n# Export events as CSV\nbash scripts/ring-security.sh export csv events_jan.csv --days 30\n\n# Export as JSON\nbash scripts/ring-security.sh export json events_jan.json --days 30\n\n# Activity summary (events per device per day)\nbash scripts/ring-security.sh analytics --days 7\n\n# Peak activity hours\nbash scripts/ring-security.sh analytics hourly --days 30\n```\n\n## Example Output: Analytics\n\n```\nActivity Summary (Last 7 Days):\n────────────────────────────────\nFront Door: ████████████████████ 47 events\nBackyard: █████████████ 31 events\nGarage: ██████ 14 events\n\nPeak Hours:\n 08:00-09:00 ████████ 18 events (morning deliveries)\n 17:00-18:00 ██████████ 23 events (arrivals home)\n 22:00-23:00 ████ 9 events (wildlife/wind)\n\nMost Active Day: Tuesday (avg 15.2 events)\nQuietest Day: Sunday (avg 4.8 events)\n```\n\n## Automation Ideas\n\n**Daily security digest email:**\n```bash\n0 8 * * * bash /path/to/ring-security.sh analytics --days 1 | mail -s \"Ring Daily Digest\" you@email.com\n```\n\n**Low battery alert:**\n```bash\nbash scripts/ring-security.sh battery --below 20\n# Outputs only devices below 20%, exit code 1 if any found\n```\n\n**Motion spike detection:**\n```bash\n# Alert if more than 20 events in the last hour\nCOUNT=$(bash scripts/ring-security.sh events --hours 1 --count)\nif [ \"$COUNT\" -gt 20 ]; then\n echo \"Unusual activity: $COUNT events in the last hour\"\nfi\n```\n\n## Caveats\n\n- Ring API is unofficial — updates to the Ring app may temporarily break functionality\n- 2FA is required for new logins; the cached token typically lasts 2-4 weeks\n- Video downloads require a Ring Protect subscription\n- API rate limits are not publicly documented; the script includes conservative delays\n- Snapshot URLs expire after a few minutes — download them promptly\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\nRun `ring-security help` to see all available commands.\n\nFile v2.3.6:_meta.json\n\n{\n \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n \"slug\": \"ring-security\",\n \"version\": \"2.3.6\",\n \"publishedAt\": 1773666940401\n}\n\nFile v2.3.6:tips.md\n\n# Tips for Ring Security\n\n## Event Management\n\n1. **Check the `analytics` command regularly.** It shows activity patterns — unusually high event counts might indicate a problem (or just a windy day triggering your motion sensor).\n\n2. **Export events monthly.** Keep a local record with `export csv` in case you ever need to reference historical data. Ring's cloud retention depends on your subscription.\n\n3. **Tune motion sensitivity in the Ring app.** If you're getting too many false positives, adjust motion zones and sensitivity there — the API doesn't expose these settings.\n\n4. **Use `--type motion` vs `--type ding`** to separate actual doorbell presses from motion alerts.\n\n## Battery Life\n\n- Battery devices (Stick Up Cam, Spotlight Cam Battery) drain faster with:\n - High motion frequency\n - Cold weather\n - Live view usage\n - Poor Wi-Fi signal (more retries)\n- Use `battery --below 30` in a weekly cron to get early warnings\n- Wired devices (Doorbell Pro, Floodlight Cam) don't have this issue\n\n## Security Modes\n\n- **Home mode:** Disarms indoor cameras, keeps outdoor ones active\n- **Away mode:** Arms everything\n- **Disarmed:** All monitoring off (not recommended)\n- Set up mode changes in cron: arm at bedtime, disarm in the morning\n\n## Troubleshooting\n\n- **\"Token expired\"** — Run `auth login` again. You'll need your 2FA code.\n- **\"Device offline\"** — Check Wi-Fi. Power cycle the device. Check the Ring app for firmware updates.\n- **Events not showing** — There can be a 1-2 minute delay between event occurrence and API availability\n- **Slow API responses** — Ring's API can be sluggish during peak hours. The script retries automatically.\n\n## Privacy Notes\n\n- Ring events are stored in Amazon's cloud — be aware of data retention policies\n- Shared users on your Ring account can also see events\n- Video recordings require a Ring Protect subscription ($3.99/mo per device or $12.99/mo for all)\n- Consider local-only alternatives (like Frigate) if cloud storage concerns you\n\nArchive v2.3.5: 5 files, 7976 bytes\n\nFiles: scripts/ring.sh (8564b), scripts/script.sh (2422b), SKILL.md (6228b), tips.md (2010b), _meta.json (132b)\n\nFile v2.3.5:SKILL.md\n\n---\nversion: \"2.0.0\"\nname: ring-security\ndescription: \"Monitor and manage Ring doorbells and security cameras. Query device status, review motion events, manage modes, and export event history. Use when you need ring security capabilities. Triggers on: ring security.\"\nauthor: BytesAgain\n---\n\n# Ring Security\n\nYour Ring doorbell and camera system, accessible from the command line.\n\n## Overview\n\nThis 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.\n\n> **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.\n\n## Getting Started\n\n### Credentials\n\nRing uses email + password authentication with 2FA support:\n\n```bash\nexport RING_EMAIL=\"you@example.com\"\nexport RING_PASSWORD=\"your-password\"\n```\n\nOn first run, you'll be prompted for your 2FA code. The script caches the refresh token locally at `~/.ring-security/token.json`.\n\n### First Connection\n\n```bash\nbash scripts/ring-security.sh auth login\n# Enter 2FA code when prompted\n# Token cached for future use\n\nbash scripts/ring-security.sh auth check\n# Verify token is valid\n```\n\n---\n\n## Feature Walkthrough\n\n### Device Discovery\n\nWhen you first connect, the script maps all Ring devices on your account:\n\n```bash\n$ bash scripts/ring-security.sh devices\n\nRing Devices Found:\n┌──────────────────────┬─────────────────┬──────────┬─────────┐\n│ Name │ Type │ Battery │ Status │\n├──────────────────────┼─────────────────┼──────────┼─────────┤\n│ Front Door │ Doorbell Pro 2 │ N/A │ Online │\n│ Backyard │ Spotlight Cam │ 87% │ Online │\n│ Garage │ Stick Up Cam │ 45% │ Online │\n│ Side Gate │ Floodlight Cam │ N/A │ Offline │\n└──────────────────────┴─────────────────┴──────────┴─────────┘\n```\n\n### Live Status\n\n```bash\n# All devices at a glance\nbash scripts/ring-security.sh status\n\n# Specific device details\nbash scripts/ring-security.sh status \"Front Door\"\n\n# Battery levels across all devices\nbash scripts/ring-security.sh battery\n\n# Wi-Fi signal strength\nbash scripts/ring-security.sh signal\n```\n\n### Motion & Ring Events\n\nThis is the core of Ring monitoring — reviewing what happened and when.\n\n```bash\n# Recent events (last 20)\nbash scripts/ring-security.sh events\n\n# Events for a specific device\nbash scripts/ring-security.sh events \"Front Door\" --limit 50\n\n# Events in a time range\nbash scripts/ring-security.sh events --from \"2024-01-15 08:00\" --to \"2024-01-15 18:00\"\n\n# Motion events only\nbash scripts/ring-security.sh events --type motion\n\n# Ding (doorbell press) events only\nbash scripts/ring-security.sh events --type ding\n\n# Event details with snapshot URL\nbash scripts/ring-security.sh event \n```\n\n### Security Modes\n\nControl your Ring alarm system modes (requires Ring Alarm):\n\n```bash\n# Current mode\nbash scripts/ring-security.sh mode\n\n# Set mode\nbash scripts/ring-security.sh mode home\nbash scripts/ring-security.sh mode away\nbash scripts/ring-security.sh mode disarmed\n\n# Mode history\nbash scripts/ring-security.sh mode history\n```\n\n### Light Control\n\nFor Ring devices with built-in lights (Floodlight Cam, Spotlight Cam):\n\n```bash\n# Toggle lights\nbash scripts/ring-security.sh light on \"Backyard\"\nbash scripts/ring-security.sh light off \"Backyard\"\n\n# Siren\nbash scripts/ring-security.sh siren on \"Backyard\"\nbash scripts/ring-security.sh siren off \"Backyard\"\n```\n\n### Event Export & Analysis\n\n```bash\n# Export events as CSV\nbash scripts/ring-security.sh export csv events_jan.csv --days 30\n\n# Export as JSON\nbash scripts/ring-security.sh export json events_jan.json --days 30\n\n# Activity summary (events per device per day)\nbash scripts/ring-security.sh analytics --days 7\n\n# Peak activity hours\nbash scripts/ring-security.sh analytics hourly --days 30\n```\n\n## Example Output: Analytics\n\n```\nActivity Summary (Last 7 Days):\n────────────────────────────────\nFront Door: ████████████████████ 47 events\nBackyard: █████████████ 31 events\nGarage: ██████ 14 events\n\nPeak Hours:\n 08:00-09:00 ████████ 18 events (morning deliveries)\n 17:00-18:00 ██████████ 23 events (arrivals home)\n 22:00-23:00 ████ 9 events (wildlife/wind)\n\nMost Active Day: Tuesday (avg 15.2 events)\nQuietest Day: Sunday (avg 4.8 events)\n```\n\n## Automation Ideas\n\n**Daily security digest email:**\n```bash\n0 8 * * * bash /path/to/ring-security.sh analytics --days 1 | mail -s \"Ring Daily Digest\" you@email.com\n```\n\n**Low battery alert:**\n```bash\nbash scripts/ring-security.sh battery --below 20\n# Outputs only devices below 20%, exit code 1 if any found\n```\n\n**Motion spike detection:**\n```bash\n# Alert if more than 20 events in the last hour\nCOUNT=$(bash scripts/ring-security.sh events --hours 1 --count)\nif [ \"$COUNT\" -gt 20 ]; then\n echo \"Unusual activity: $COUNT events in the last hour\"\nfi\n```\n\n## Caveats\n\n- Ring API is unofficial — updates to the Ring app may temporarily break functionality\n- 2FA is required for new logins; the cached token typically lasts 2-4 weeks\n- Video downloads require a Ring Protect subscription\n- API rate limits are not publicly documented; the script includes conservative delays\n- Snapshot URLs expire after a few minutes — download them promptly\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\nRun `ring-security help` to see all available commands.\n\nFile v2.3.5:_meta.json\n\n{\n \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n \"slug\": \"ring-security\",\n \"version\": \"2.3.5\",\n \"publishedAt\": 1773663001316\n}\n\nFile v2.3.5:tips.md\n\n# Tips for Ring Security\n\n## Event Management\n\n1. **Check the `analytics` command regularly.** It shows activity patterns — unusually high event counts might indicate a problem (or just a windy day triggering your motion sensor).\n\n2. **Export events monthly.** Keep a local record with `export csv` in case you ever need to reference historical data. Ring's cloud retention depends on your subscription.\n\n3. **Tune motion sensitivity in the Ring app.** If you're getting too many false positives, adjust motion zones and sensitivity there — the API doesn't expose these settings.\n\n4. **Use `--type motion` vs `--type ding`** to separate actual doorbell presses from motion alerts.\n\n## Battery Life\n\n- Battery devices (Stick Up Cam, Spotlight Cam Battery) drain faster with:\n - High motion frequency\n - Cold weather\n - Live view usage\n - Poor Wi-Fi signal (more retries)\n- Use `battery --below 30` in a weekly cron to get early warnings\n- Wired devices (Doorbell Pro, Floodlight Cam) don't have this issue\n\n## Security Modes\n\n- **Home mode:** Disarms indoor cameras, keeps outdoor ones active\n- **Away mode:** Arms everything\n- **Disarmed:** All monitoring off (not recommended)\n- Set up mode changes in cron: arm at bedtime, disarm in the morning\n\n## Troubleshooting\n\n- **\"Token expired\"** — Run `auth login` again. You'll need your 2FA code.\n- **\"Device offline\"** — Check Wi-Fi. Power cycle the device. Check the Ring app for firmware updates.\n- **Events not showing** — There can be a 1-2 minute delay between event occurrence and API availability\n- **Slow API responses** — Ring's API can be sluggish during peak hours. The script retries automatically.\n\n## Privacy Notes\n\n- Ring events are stored in Amazon's cloud — be aware of data retention policies\n- Shared users on your Ring account can also see events\n- Video recordings require a Ring Protect subscription ($3.99/mo per device or $12.99/mo for all)\n- Consider local-only alternatives (like Frigate) if cloud storage concerns you\n\nArchive v2.3.4: 4 files, 6886 bytes\n\nFiles: scripts/ring.sh (8564b), SKILL.md (6192b), tips.md (2010b), _meta.json (132b)\n\nFile v2.3.4:SKILL.md\n\n---\nname: ring-security\ndescription: \"Monitor and manage Ring doorbells and security cameras. Query device status, review motion events, manage modes, and export event history. Use when you need ring security capabilities. Triggers on: ring security.\"\n---\n\n# Ring Security\n\nYour Ring doorbell and camera system, accessible from the command line.\n\n## Overview\n\nThis 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.\n\n> **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.\n\n## Getting Started\n\n### Credentials\n\nRing uses email + password authentication with 2FA support:\n\n```bash\nexport RING_EMAIL=\"you@example.com\"\nexport RING_PASSWORD=\"your-password\"\n```\n\nOn first run, you'll be prompted for your 2FA code. The script caches the refresh token locally at `~/.ring-security/token.json`.\n\n### First Connection\n\n```bash\nbash scripts/ring-security.sh auth login\n# Enter 2FA code when prompted\n# Token cached for future use\n\nbash scripts/ring-security.sh auth check\n# Verify token is valid\n```\n\n---\n\n## Feature Walkthrough\n\n### Device Discovery\n\nWhen you first connect, the script maps all Ring devices on your account:\n\n```bash\n$ bash scripts/ring-security.sh devices\n\nRing Devices Found:\n┌──────────────────────┬─────────────────┬──────────┬─────────┐\n│ Name │ Type │ Battery │ Status │\n├──────────────────────┼─────────────────┼──────────┼─────────┤\n│ Front Door │ Doorbell Pro 2 │ N/A │ Online │\n│ Backyard │ Spotlight Cam │ 87% │ Online │\n│ Garage │ Stick Up Cam │ 45% │ Online │\n│ Side Gate │ Floodlight Cam │ N/A │ Offline │\n└──────────────────────┴─────────────────┴──────────┴─────────┘\n```\n\n### Live Status\n\n```bash\n# All devices at a glance\nbash scripts/ring-security.sh status\n\n# Specific device details\nbash scripts/ring-security.sh status \"Front Door\"\n\n# Battery levels across all devices\nbash scripts/ring-security.sh battery\n\n# Wi-Fi signal strength\nbash scripts/ring-security.sh signal\n```\n\n### Motion & Ring Events\n\nThis is the core of Ring monitoring — reviewing what happened and when.\n\n```bash\n# Recent events (last 20)\nbash scripts/ring-security.sh events\n\n# Events for a specific device\nbash scripts/ring-security.sh events \"Front Door\" --limit 50\n\n# Events in a time range\nbash scripts/ring-security.sh events --from \"2024-01-15 08:00\" --to \"2024-01-15 18:00\"\n\n# Motion events only\nbash scripts/ring-security.sh events --type motion\n\n# Ding (doorbell press) events only\nbash scripts/ring-security.sh events --type ding\n\n# Event details with snapshot URL\nbash scripts/ring-security.sh event \n```\n\n### Security Modes\n\nControl your Ring alarm system modes (requires Ring Alarm):\n\n```bash\n# Current mode\nbash scripts/ring-security.sh mode\n\n# Set mode\nbash scripts/ring-security.sh mode home\nbash scripts/ring-security.sh mode away\nbash scripts/ring-security.sh mode disarmed\n\n# Mode history\nbash scripts/ring-security.sh mode history\n```\n\n### Light Control\n\nFor Ring devices with built-in lights (Floodlight Cam, Spotlight Cam):\n\n```bash\n# Toggle lights\nbash scripts/ring-security.sh light on \"Backyard\"\nbash scripts/ring-security.sh light off \"Backyard\"\n\n# Siren\nbash scripts/ring-security.sh siren on \"Backyard\"\nbash scripts/ring-security.sh siren off \"Backyard\"\n```\n\n### Event Export & Analysis\n\n```bash\n# Export events as CSV\nbash scripts/ring-security.sh export csv events_jan.csv --days 30\n\n# Export as JSON\nbash scripts/ring-security.sh export json events_jan.json --days 30\n\n# Activity summary (events per device per day)\nbash scripts/ring-security.sh analytics --days 7\n\n# Peak activity hours\nbash scripts/ring-security.sh analytics hourly --days 30\n```\n\n## Example Output: Analytics\n\n```\nActivity Summary (Last 7 Days):\n────────────────────────────────\nFront Door: ████████████████████ 47 events\nBackyard: █████████████ 31 events\nGarage: ██████ 14 events\n\nPeak Hours:\n 08:00-09:00 ████████ 18 events (morning deliveries)\n 17:00-18:00 ██████████ 23 events (arrivals home)\n 22:00-23:00 ████ 9 events (wildlife/wind)\n\nMost Active Day: Tuesday (avg 15.2 events)\nQuietest Day: Sunday (avg 4.8 events)\n```\n\n## Automation Ideas\n\n**Daily security digest email:**\n```bash\n0 8 * * * bash /path/to/ring-security.sh analytics --days 1 | mail -s \"Ring Daily Digest\" you@email.com\n```\n\n**Low battery alert:**\n```bash\nbash scripts/ring-security.sh battery --below 20\n# Outputs only devices below 20%, exit code 1 if any found\n```\n\n**Motion spike detection:**\n```bash\n# Alert if more than 20 events in the last hour\nCOUNT=$(bash scripts/ring-security.sh events --hours 1 --count)\nif [ \"$COUNT\" -gt 20 ]; then\n echo \"Unusual activity: $COUNT events in the last hour\"\nfi\n```\n\n## Caveats\n\n- Ring API is unofficial — updates to the Ring app may temporarily break functionality\n- 2FA is required for new logins; the cached token typically lasts 2-4 weeks\n- Video downloads require a Ring Protect subscription\n- API rate limits are not publicly documented; the script includes conservative delays\n- Snapshot URLs expire after a few minutes — download them promptly\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\nRun `ring-security help` to see all available commands.\n\nFile v2.3.4:_meta.json\n\n{\n \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n \"slug\": \"ring-security\",\n \"version\": \"2.3.4\",\n \"publishedAt\": 1773614459548\n}\n\nFile v2.3.4:tips.md\n\n# Tips for Ring Security\n\n## Event Management\n\n1. **Check the `analytics` command regularly.** It shows activity patterns — unusually high event counts might indicate a problem (or just a windy day triggering your motion sensor).\n\n2. **Export events monthly.** Keep a local record with `export csv` in case you ever need to reference historical data. Ring's cloud retention depends on your subscription.\n\n3. **Tune motion sensitivity in the Ring app.** If you're getting too many false positives, adjust motion zones and sensitivity there — the API doesn't expose these settings.\n\n4. **Use `--type motion` vs `--type ding`** to separate actual doorbell presses from motion alerts.\n\n## Battery Life\n\n- Battery devices (Stick Up Cam, Spotlight Cam Battery) drain faster with:\n - High motion frequency\n - Cold weather\n - Live view usage\n - Poor Wi-Fi signal (more retries)\n- Use `battery --below 30` in a weekly cron to get early warnings\n- Wired devices (Doorbell Pro, Floodlight Cam) don't have this issue\n\n## Security Modes\n\n- **Home mode:** Disarms indoor cameras, keeps outdoor ones active\n- **Away mode:** Arms everything\n- **Disarmed:** All monitoring off (not recommended)\n- Set up mode changes in cron: arm at bedtime, disarm in the morning\n\n## Troubleshooting\n\n- **\"Token expired\"** — Run `auth login` again. You'll need your 2FA code.\n- **\"Device offline\"** — Check Wi-Fi. Power cycle the device. Check the Ring app for firmware updates.\n- **Events not showing** — There can be a 1-2 minute delay between event occurrence and API availability\n- **Slow API responses** — Ring's API can be sluggish during peak hours. The script retries automatically.\n\n## Privacy Notes\n\n- Ring events are stored in Amazon's cloud — be aware of data retention policies\n- Shared users on your Ring account can also see events\n- Video recordings require a Ring Protect subscription ($3.99/mo per device or $12.99/mo for all)\n- Consider local-only alternatives (like Frigate) if cloud storage concerns you\n\nArchive v2.3.3: 4 files, 6887 bytes\n\nFiles: scripts/ring.sh (8564b), SKILL.md (6192b), tips.md (2010b), _meta.json (132b)\n\nFile v2.3.3:SKILL.md\n\n---\nname: ring-security\ndescription: \"Monitor and manage Ring doorbells and security cameras. Query device status, review motion events, manage modes, and export event history. Use when you need ring security capabilities. Triggers on: ring security.\"\n---\n\n# Ring Security\n\nYour Ring doorbell and camera system, accessible from the command line.\n\n## Overview\n\nThis 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.\n\n> **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.\n\n## Getting Started\n\n### Credentials\n\nRing uses email + password authentication with 2FA support:\n\n```bash\nexport RING_EMAIL=\"you@example.com\"\nexport RING_PASSWORD=\"your-password\"\n```\n\nOn first run, you'll be prompted for your 2FA code. The script caches the refresh token locally at `~/.ring-security/token.json`.\n\n### First Connection\n\n```bash\nbash scripts/ring-security.sh auth login\n# Enter 2FA code when prompted\n# Token cached for future use\n\nbash scripts/ring-security.sh auth check\n# Verify token is valid\n```\n\n---\n\n## Feature Walkthrough\n\n### Device Discovery\n\nWhen you first connect, the script maps all Ring devices on your account:\n\n```bash\n$ bash scripts/ring-security.sh devices\n\nRing Devices Found:\n┌──────────────────────┬─────────────────┬──────────┬─────────┐\n│ Name │ Type │ Battery │ Status │\n├──────────────────────┼─────────────────┼──────────┼─────────┤\n│ Front Door │ Doorbell Pro 2 │ N/A │ Online │\n│ Backyard │ Spotlight Cam │ 87% │ Online │\n│ Garage │ Stick Up Cam │ 45% │ Online │\n│ Side Gate │ Floodlight Cam │ N/A │ Offline │\n└──────────────────────┴─────────────────┴──────────┴─────────┘\n```\n\n### Live Status\n\n```bash\n# All devices at a glance\nbash scripts/ring-security.sh status\n\n# Specific device details\nbash scripts/ring-security.sh status \"Front Door\"\n\n# Battery levels across all devices\nbash scripts/ring-security.sh battery\n\n# Wi-Fi signal strength\nbash scripts/ring-security.sh signal\n```\n\n### Motion & Ring Events\n\nThis is the core of Ring monitoring — reviewing what happened and when.\n\n```bash\n# Recent events (last 20)\nbash scripts/ring-security.sh events\n\n# Events for a specific device\nbash scripts/ring-security.sh events \"Front Door\" --limit 50\n\n# Events in a time range\nbash scripts/ring-security.sh events --from \"2024-01-15 08:00\" --to \"2024-01-15 18:00\"\n\n# Motion events only\nbash scripts/ring-security.sh events --type motion\n\n# Ding (doorbell press) events only\nbash scripts/ring-security.sh events --type ding\n\n# Event details with snapshot URL\nbash scripts/ring-security.sh event \n```\n\n### Security Modes\n\nControl your Ring alarm system modes (requires Ring Alarm):\n\n```bash\n# Current mode\nbash scripts/ring-security.sh mode\n\n# Set mode\nbash scripts/ring-security.sh mode home\nbash scripts/ring-security.sh mode away\nbash scripts/ring-security.sh mode disarmed\n\n# Mode history\nbash scripts/ring-security.sh mode history\n```\n\n### Light Control\n\nFor Ring devices with built-in lights (Floodlight Cam, Spotlight Cam):\n\n```bash\n# Toggle lights\nbash scripts/ring-security.sh light on \"Backyard\"\nbash scripts/ring-security.sh light off \"Backyard\"\n\n# Siren\nbash scripts/ring-security.sh siren on \"Backyard\"\nbash scripts/ring-security.sh siren off \"Backyard\"\n```\n\n### Event Export & Analysis\n\n```bash\n# Export events as CSV\nbash scripts/ring-security.sh export csv events_jan.csv --days 30\n\n# Export as JSON\nbash scripts/ring-security.sh export json events_jan.json --days 30\n\n# Activity summary (events per device per day)\nbash scripts/ring-security.sh analytics --days 7\n\n# Peak activity hours\nbash scripts/ring-security.sh analytics hourly --days 30\n```\n\n## Example Output: Analytics\n\n```\nActivity Summary (Last 7 Days):\n────────────────────────────────\nFront Door: ████████████████████ 47 events\nBackyard: █████████████ 31 events\nGarage: ██████ 14 events\n\nPeak Hours:\n 08:00-09:00 ████████ 18 events (morning deliveries)\n 17:00-18:00 ██████████ 23 events (arrivals home)\n 22:00-23:00 ████ 9 events (wildlife/wind)\n\nMost Active Day: Tuesday (avg 15.2 events)\nQuietest Day: Sunday (avg 4.8 events)\n```\n\n## Automation Ideas\n\n**Daily security digest email:**\n```bash\n0 8 * * * bash /path/to/ring-security.sh analytics --days 1 | mail -s \"Ring Daily Digest\" you@email.com\n```\n\n**Low battery alert:**\n```bash\nbash scripts/ring-security.sh battery --below 20\n# Outputs only devices below 20%, exit code 1 if any found\n```\n\n**Motion spike detection:**\n```bash\n# Alert if more than 20 events in the last hour\nCOUNT=$(bash scripts/ring-security.sh events --hours 1 --count)\nif [ \"$COUNT\" -gt 20 ]; then\n echo \"Unusual activity: $COUNT events in the last hour\"\nfi\n```\n\n## Caveats\n\n- Ring API is unofficial — updates to the Ring app may temporarily break functionality\n- 2FA is required for new logins; the cached token typically lasts 2-4 weeks\n- Video downloads require a Ring Protect subscription\n- API rate limits are not publicly documented; the script includes conservative delays\n- Snapshot URLs expire after a few minutes — download them promptly\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\nRun `ring-security help` to see all available commands.\n\nFile v2.3.3:_meta.json\n\n{\n \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n \"slug\": \"ring-security\",\n \"version\": \"2.3.3\",\n \"publishedAt\": 1773611698952\n}\n\nFile v2.3.3:tips.md\n\n# Tips for Ring Security\n\n## Event Management\n\n1. **Check the `analytics` command regularly.** It shows activity patterns — unusually high event counts might indicate a problem (or just a windy day triggering your motion sensor).\n\n2. **Export events monthly.** Keep a local record with `export csv` in case you ever need to reference historical data. Ring's cloud retention depends on your subscription.\n\n3. **Tune motion sensitivity in the Ring app.** If you're getting too many false positives, adjust motion zones and sensitivity there — the API doesn't expose these settings.\n\n4. **Use `--type motion` vs `--type ding`** to separate actual doorbell presses from motion alerts.\n\n## Battery Life\n\n- Battery devices (Stick Up Cam, Spotlight Cam Battery) drain faster with:\n - High motion frequency\n - Cold weather\n - Live view usage\n - Poor Wi-Fi signal (more retries)\n- Use `battery --below 30` in a weekly cron to get early warnings\n- Wired devices (Doorbell Pro, Floodlight Cam) don't have this issue\n\n## Security Modes\n\n- **Home mode:** Disarms indoor cameras, keeps outdoor ones active\n- **Away mode:** Arms everything\n- **Disarmed:** All monitoring off (not recommended)\n- Set up mode changes in cron: arm at bedtime, disarm in the morning\n\n## Troubleshooting\n\n- **\"Token expired\"** — Run `auth login` again. You'll need your 2FA code.\n- **\"Device offline\"** — Check Wi-Fi. Power cycle the device. Check the Ring app for firmware updates.\n- **Events not showing** — There can be a 1-2 minute delay between event occurrence and API availability\n- **Slow API responses** — Ring's API can be sluggish during peak hours. The script retries automatically.\n\n## Privacy Notes\n\n- Ring events are stored in Amazon's cloud — be aware of data retention policies\n- Shared users on your Ring account can also see events\n- Video recordings require a Ring Protect subscription ($3.99/mo per device or $12.99/mo for all)\n- Consider local-only alternatives (like Frigate) if cloud storage concerns you\n\nArchive v2.3.2: 4 files, 6886 bytes\n\nFiles: scripts/ring.sh (8564b), SKILL.md (6192b), tips.md (2010b), _meta.json (132b)\n\nFile v2.3.2:SKILL.md\n\n---\nname: ring-security\ndescription: \"Monitor and manage Ring doorbells and security cameras. Query device status, review motion events, manage modes, and export event history. Use when you need ring security capabilities. Triggers on: ring security.\"\n---\n\n# Ring Security\n\nYour Ring doorbell and camera system, accessible from the command line.\n\n## Overview\n\nThis 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.\n\n> **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.\n\n## Getting Started\n\n### Credentials\n\nRing uses email + password authentication with 2FA support:\n\n```bash\nexport RING_EMAIL=\"you@example.com\"\nexport RING_PASSWORD=\"your-password\"\n```\n\nOn first run, you'll be prompted for your 2FA code. The script caches the refresh token locally at `~/.ring-security/token.json`.\n\n### First Connection\n\n```bash\nbash scripts/ring-security.sh auth login\n# Enter 2FA code when prompted\n# Token cached for future use\n\nbash scripts/ring-security.sh auth check\n# Verify token is valid\n```\n\n---\n\n## Feature Walkthrough\n\n### Device Discovery\n\nWhen you first connect, the script maps all Ring devices on your account:\n\n```bash\n$ bash scripts/ring-security.sh devices\n\nRing Devices Found:\n┌──────────────────────┬─────────────────┬──────────┬─────────┐\n│ Name │ Type │ Battery │ Status │\n├──────────────────────┼─────────────────┼──────────┼─────────┤\n│ Front Door │ Doorbell Pro 2 │ N/A │ Online │\n│ Backyard │ Spotlight Cam │ 87% │ Online │\n│ Garage │ Stick Up Cam │ 45% │ Online │\n│ Side Gate │ Floodlight Cam │ N/A │ Offline │\n└──────────────────────┴─────────────────┴──────────┴─────────┘\n```\n\n### Live Status\n\n```bash\n# All devices at a glance\nbash scripts/ring-security.sh status\n\n# Specific device details\nbash scripts/ring-security.sh status \"Front Door\"\n\n# Battery levels across all devices\nbash scripts/ring-security.sh battery\n\n# Wi-Fi signal strength\nbash scripts/ring-security.sh signal\n```\n\n### Motion & Ring Events\n\nThis is the core of Ring monitoring — reviewing what happened and when.\n\n```bash\n# Recent events (last 20)\nbash scripts/ring-security.sh events\n\n# Events for a specific device\nbash scripts/ring-security.sh events \"Front Door\" --limit 50\n\n# Events in a time range\nbash scripts/ring-security.sh events --from \"2024-01-15 08:00\" --to \"2024-01-15 18:00\"\n\n# Motion events only\nbash scripts/ring-security.sh events --type motion\n\n# Ding (doorbell press) events only\nbash scripts/ring-security.sh events --type ding\n\n# Event details with snapshot URL\nbash scripts/ring-security.sh event \n```\n\n### Security Modes\n\nControl your Ring alarm system modes (requires Ring Alarm):\n\n```bash\n# Current mode\nbash scripts/ring-security.sh mode\n\n# Set mode\nbash scripts/ring-security.sh mode home\nbash scripts/ring-security.sh mode away\nbash scripts/ring-security.sh mode disarmed\n\n# Mode history\nbash scripts/ring-security.sh mode history\n```\n\n### Light Control\n\nFor Ring devices with built-in lights (Floodlight Cam, Spotlight Cam):\n\n```bash\n# Toggle lights\nbash scripts/ring-security.sh light on \"Backyard\"\nbash scripts/ring-security.sh light off \"Backyard\"\n\n# Siren\nbash scripts/ring-security.sh siren on \"Backyard\"\nbash scripts/ring-security.sh siren off \"Backyard\"\n```\n\n### Event Export & Analysis\n\n```bash\n# Export events as CSV\nbash scripts/ring-security.sh export csv events_jan.csv --days 30\n\n# Export as JSON\nbash scripts/ring-security.sh export json events_jan.json --days 30\n\n# Activity summary (events per device per day)\nbash scripts/ring-security.sh analytics --days 7\n\n# Peak activity hours\nbash scripts/ring-security.sh analytics hourly --days 30\n```\n\n## Example Output: Analytics\n\n```\nActivity Summary (Last 7 Days):\n────────────────────────────────\nFront Door: ████████████████████ 47 events\nBackyard: █████████████ 31 events\nGarage: ██████ 14 events\n\nPeak Hours:\n 08:00-09:00 ████████ 18 events (morning deliveries)\n 17:00-18:00 ██████████ 23 events (arrivals home)\n 22:00-23:00 ████ 9 events (wildlife/wind)\n\nMost Active Day: Tuesday (avg 15.2 events)\nQuietest Day: Sunday (avg 4.8 events)\n```\n\n## Automation Ideas\n\n**Daily security digest email:**\n```bash\n0 8 * * * bash /path/to/ring-security.sh analytics --days 1 | mail -s \"Ring Daily Digest\" you@email.com\n```\n\n**Low battery alert:**\n```bash\nbash scripts/ring-security.sh battery --below 20\n# Outputs only devices below 20%, exit code 1 if any found\n```\n\n**Motion spike detection:**\n```bash\n# Alert if more than 20 events in the last hour\nCOUNT=$(bash scripts/ring-security.sh events --hours 1 --count)\nif [ \"$COUNT\" -gt 20 ]; then\n echo \"Unusual activity: $COUNT events in the last hour\"\nfi\n```\n\n## Caveats\n\n- Ring API is unofficial — updates to the Ring app may temporarily break functionality\n- 2FA is required for new logins; the cached token typically lasts 2-4 weeks\n- Video downloads require a Ring Protect subscription\n- API rate limits are not publicly documented; the script includes conservative delays\n- Snapshot URLs expire after a few minutes — download them promptly\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\nRun `ring-security help` to see all available commands.\n\nFile v2.3.2:_meta.json\n\n{\n \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n \"slug\": \"ring-security\",\n \"version\": \"2.3.2\",\n \"publishedAt\": 1773572233991\n}\n\nFile v2.3.2:tips.md\n\n# Tips for Ring Security\n\n## Event Management\n\n1. **Check the `analytics` command regularly.** It shows activity patterns — unusually high event counts might indicate a problem (or just a windy day triggering your motion sensor).\n\n2. **Export events monthly.** Keep a local record with `export csv` in case you ever need to reference historical data. Ring's cloud retention depends on your subscription.\n\n3. **Tune motion sensitivity in the Ring app.** If you're getting too many false positives, adjust motion zones and sensitivity there — the API doesn't expose these settings.\n\n4. **Use `--type motion` vs `--type ding`** to separate actual doorbell presses from motion alerts.\n\n## Battery Life\n\n- Battery devices (Stick Up Cam, Spotlight Cam Battery) drain faster with:\n - High motion frequency\n - Cold weather\n - Live view usage\n - Poor Wi-Fi signal (more retries)\n- Use `battery --below 30` in a weekly cron to get early warnings\n- Wired devices (Doorbell Pro, Floodlight Cam) don't have this issue\n\n## Security Modes\n\n- **Home mode:** Disarms indoor cameras, keeps outdoor ones active\n- **Away mode:** Arms everything\n- **Disarmed:** All monitoring off (not recommended)\n- Set up mode changes in cron: arm at bedtime, disarm in the morning\n\n## Troubleshooting\n\n- **\"Token expired\"** — Run `auth login` again. You'll need your 2FA code.\n- **\"Device offline\"** — Check Wi-Fi. Power cycle the device. Check the Ring app for firmware updates.\n- **Events not showing** — There can be a 1-2 minute delay between event occurrence and API availability\n- **Slow API responses** — Ring's API can be sluggish during peak hours. The script retries automatically.\n\n## Privacy Notes\n\n- Ring events are stored in Amazon's cloud — be aware of data retention policies\n- Shared users on your Ring account can also see events\n- Video recordings require a Ring Protect subscription ($3.99/mo per device or $12.99/mo for all)\n- Consider local-only alternatives (like Frigate) if cloud storage concerns you\n\nArchive v2.3.1: 4 files, 6889 bytes\n\nFiles: scripts/ring.sh (8564b), SKILL.md (6195b), tips.md (2010b), _meta.json (132b)\n\nFile v2.3.1:SKILL.md\n\n---\nname: ring-security\ndescription: \"Monitor and manage Ring doorbells and security cameras. Query device status, review motion events, manage modes, and export event history. Use when you need ring security capabilities. Triggers on: ring security.\"\n---\n\n# Ring Security\n\nYour Ring doorbell and camera ecosystem, accessible from the command line.\n\n## Overview\n\nThis 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.\n\n> **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.\n\n## Getting Started\n\n### Credentials\n\nRing uses email + password authentication with 2FA support:\n\n```bash\nexport RING_EMAIL=\"you@example.com\"\nexport RING_PASSWORD=\"your-password\"\n```\n\nOn first run, you'll be prompted for your 2FA code. The script caches the refresh token locally at `~/.ring-security/token.json`.\n\n### First Connection\n\n```bash\nbash scripts/ring-security.sh auth login\n# Enter 2FA code when prompted\n# Token cached for future use\n\nbash scripts/ring-security.sh auth check\n# Verify token is valid\n```\n\n---\n\n## Feature Walkthrough\n\n### Device Discovery\n\nWhen you first connect, the script maps all Ring devices on your account:\n\n```bash\n$ bash scripts/ring-security.sh devices\n\nRing Devices Found:\n┌──────────────────────┬─────────────────┬──────────┬─────────┐\n│ Name │ Type │ Battery │ Status │\n├──────────────────────┼─────────────────┼──────────┼─────────┤\n│ Front Door │ Doorbell Pro 2 │ N/A │ Online │\n│ Backyard │ Spotlight Cam │ 87% │ Online │\n│ Garage │ Stick Up Cam │ 45% │ Online │\n│ Side Gate │ Floodlight Cam │ N/A │ Offline │\n└──────────────────────┴─────────────────┴──────────┴─────────┘\n```\n\n### Live Status\n\n```bash\n# All devices at a glance\nbash scripts/ring-security.sh status\n\n# Specific device details\nbash scripts/ring-security.sh status \"Front Door\"\n\n# Battery levels across all devices\nbash scripts/ring-security.sh battery\n\n# Wi-Fi signal strength\nbash scripts/ring-security.sh signal\n```\n\n### Motion & Ring Events\n\nThis is the core of Ring monitoring — reviewing what happened and when.\n\n```bash\n# Recent events (last 20)\nbash scripts/ring-security.sh events\n\n# Events for a specific device\nbash scripts/ring-security.sh events \"Front Door\" --limit 50\n\n# Events in a time range\nbash scripts/ring-security.sh events --from \"2024-01-15 08:00\" --to \"2024-01-15 18:00\"\n\n# Motion events only\nbash scripts/ring-security.sh events --type motion\n\n# Ding (doorbell press) events only\nbash scripts/ring-security.sh events --type ding\n\n# Event details with snapshot URL\nbash scripts/ring-security.sh event \n```\n\n### Security Modes\n\nControl your Ring alarm system modes (requires Ring Alarm):\n\n```bash\n# Current mode\nbash scripts/ring-security.sh mode\n\n# Set mode\nbash scripts/ring-security.sh mode home\nbash scripts/ring-security.sh mode away\nbash scripts/ring-security.sh mode disarmed\n\n# Mode history\nbash scripts/ring-security.sh mode history\n```\n\n### Light Control\n\nFor Ring devices with built-in lights (Floodlight Cam, Spotlight Cam):\n\n```bash\n# Toggle lights\nbash scripts/ring-security.sh light on \"Backyard\"\nbash scripts/ring-security.sh light off \"Backyard\"\n\n# Siren\nbash scripts/ring-security.sh siren on \"Backyard\"\nbash scripts/ring-security.sh siren off \"Backyard\"\n```\n\n### Event Export & Analysis\n\n```bash\n# Export events as CSV\nbash scripts/ring-security.sh export csv events_jan.csv --days 30\n\n# Export as JSON\nbash scripts/ring-security.sh export json events_jan.json --days 30\n\n# Activity summary (events per device per day)\nbash scripts/ring-security.sh analytics --days 7\n\n# Peak activity hours\nbash scripts/ring-security.sh analytics hourly --days 30\n```\n\n## Example Output: Analytics\n\n```\nActivity Summary (Last 7 Days):\n────────────────────────────────\nFront Door: ████████████████████ 47 events\nBackyard: █████████████ 31 events\nGarage: ██████ 14 events\n\nPeak Hours:\n 08:00-09:00 ████████ 18 events (morning deliveries)\n 17:00-18:00 ██████████ 23 events (arrivals home)\n 22:00-23:00 ████ 9 events (wildlife/wind)\n\nMost Active Day: Tuesday (avg 15.2 events)\nQuietest Day: Sunday (avg 4.8 events)\n```\n\n## Automation Ideas\n\n**Daily security digest email:**\n```bash\n0 8 * * * bash /path/to/ring-security.sh analytics --days 1 | mail -s \"Ring Daily Digest\" you@email.com\n```\n\n**Low battery alert:**\n```bash\nbash scripts/ring-security.sh battery --below 20\n# Outputs only devices below 20%, exit code 1 if any found\n```\n\n**Motion spike detection:**\n```bash\n# Alert if more than 20 events in the last hour\nCOUNT=$(bash scripts/ring-security.sh events --hours 1 --count)\nif [ \"$COUNT\" -gt 20 ]; then\n echo \"Unusual activity: $COUNT events in the last hour\"\nfi\n```\n\n## Caveats\n\n- Ring API is unofficial — updates to the Ring app may temporarily break functionality\n- 2FA is required for new logins; the cached token typically lasts 2-4 weeks\n- Video downloads require a Ring Protect subscription\n- API rate limits are not publicly documented; the script includes conservative delays\n- Snapshot URLs expire after a few minutes — download them promptly\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\nRun `ring-security help` to see all available commands.\n\nFile v2.3.1:_meta.json\n\n{\n \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n \"slug\": \"ring-security\",\n \"version\": \"2.3.1\",\n \"publishedAt\": 1773539202506\n}\n\nFile v2.3.1:tips.md\n\n# Tips for Ring Security\n\n## Event Management\n\n1. **Check the `analytics` command regularly.** It shows activity patterns — unusually high event counts might indicate a problem (or just a windy day triggering your motion sensor).\n\n2. **Export events monthly.** Keep a local record with `export csv` in case you ever need to reference historical data. Ring's cloud retention depends on your subscription.\n\n3. **Tune motion sensitivity in the Ring app.** If you're getting too many false positives, adjust motion zones and sensitivity there — the API doesn't expose these settings.\n\n4. **Use `--type motion` vs `--type ding`** to separate actual doorbell presses from motion alerts.\n\n## Battery Life\n\n- Battery devices (Stick Up Cam, Spotlight Cam Battery) drain faster with:\n - High motion frequency\n - Cold weather\n - Live view usage\n - Poor Wi-Fi signal (more retries)\n- Use `battery --below 30` in a weekly cron to get early warnings\n- Wired devices (Doorbell Pro, Floodlight Cam) don't have this issue\n\n## Security Modes\n\n- **Home mode:** Disarms indoor cameras, keeps outdoor ones active\n- **Away mode:** Arms everything\n- **Disarmed:** All monitoring off (not recommended)\n- Set up mode changes in cron: arm at bedtime, disarm in the morning\n\n## Troubleshooting\n\n- **\"Token expired\"** — Run `auth login` again. You'll need your 2FA code.\n- **\"Device offline\"** — Check Wi-Fi. Power cycle the device. Check the Ring app for firmware updates.\n- **Events not showing** — There can be a 1-2 minute delay between event occurrence and API availability\n- **Slow API responses** — Ring's API can be sluggish during peak hours. The script retries automatically.\n\n## Privacy Notes\n\n- Ring events are stored in Amazon's cloud — be aware of data retention policies\n- Shared users on your Ring account can also see events\n- Video recordings require a Ring Protect subscription ($3.99/mo per device or $12.99/mo for all)\n- Consider local-only alternatives (like Frigate) if cloud storage concerns you","readmeExcerpt":"Skill: Ring Security Owner: bytesagain-lab Summary: Reference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Ring Security concepts, best practices, and implementation patterns. Tags: chinese:1.0.0, latest:3.0.1, productivity:1.0.0 Version history: v3.0.1 | 2026-03-24T01:44:10.979Z | user Fix description v3.0.0 | 2026-03-23T00:59:49.052Z | user Clean package v2.0.1 | 2026-03-18T10:49:45","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"# Run a full vulnerability scan\nring-security scan\n\n# Perform a security audit\nring-security audit\n\n# Quick check on a specific target\nring-security check \"web-server-01\"\n\n# Generate a security report\nring-security report"},{"language":"bash","snippet":"# Get hardening guidance\nring-security harden\n# Output: Step 1: Update | Step 2: Firewall | Step 3: Auth\n\n# Generate a random password\nring-security password\n# Output: e.g. \"aB3!xK9mQ2@nP7wL\"\n\n# Hash a string with SHA-256\nring-security hash \"my-secret-value\"\n# Output: SHA-256 hash of the input"},{"language":"bash","snippet":"# Check compliance status\nring-security compliance\n# Output: [ ] Access controls | [ ] Encryption | [ ] Logging\n\n# Check for active security alerts\nring-security alerts\n\n# Encrypt a file\nring-security encrypt \"sensitive-data.txt\""},{"language":"bash","snippet":"export RING_EMAIL=\"you@example.com\"\nexport RING_PASSWORD=\"your-password\""},{"language":"bash","snippet":"bash scripts/ring-security.sh auth login\n# Enter 2FA code when prompted\n# Token cached for future use\n\nbash scripts/ring-security.sh auth check\n# Verify token is valid"},{"language":"bash","snippet":"$ bash scripts/ring-security.sh devices\n\nRing Devices Found:\n┌──────────────────────┬─────────────────┬──────────┬─────────┐\n│ Name │ Type │ Battery │ Status │\n├──────────────────────┼─────────────────┼──────────┼─────────┤\n│ Front Door │ Doorbell Pro 2 │ N/A │ Online │\n│ Backyard │ Spotlight Cam │ 87% │ Online │\n│ Garage │ Stick Up Cam │ 45% │ Online │\n│ Side Gate │ Floodlight Cam │ N/A │ Offline │\n└──────────────────────┴─────────────────┴──────────┴─────────┘"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: \"ring-security\"\nversion: \"3.0.1\"\ndescription: \"Reference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Ring Security concepts, best practices, and implementation patterns.\"\nauthor: \"BytesAgain\"\nhomepage: \"https://bytesagain.com\"\nsource: \"https://github.com/bytesagain/ai-skills\"\ntags: [ring,security, reference]\ncategory: \"life\"\n---\n\n# Ring Security\n\nReference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Ring Security concepts, best practices, and implementation patterns. No API keys or credentials required.\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `intro` | intro reference |\n| `quickstart` | quickstart reference |\n| `patterns` | patterns reference |\n| `debugging` | debugging reference |\n| `performance` | performance reference |\n| `security` | security reference |\n| `migration` | migration reference |\n| `cheatsheet` | cheatsheet reference |\n\n## Output Format\n\nAll commands output plain-text reference documentation via heredoc. No external API calls, no credentials needed, no network access.\n\n---\n\n*Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n \"slug\": \"ring-security\",\n \"version\": \"3.0.1\",\n \"publishedAt\": 1774316650979\n}"},{"path":"skill-card.md","content":"## Description:\n\nReference tool for life - covers intro, quickstart, patterns and more. Quick lookup for Ring Security concepts, best practices, and implementation patterns.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[bytesagain-lab](https://clawhub.ai/user/bytesagain-lab)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill as a quick reference for Ring Security concepts, quickstart material, implementation patterns, troubleshooting, performance, security considerations, migration guidance, and cheat-sheet output.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill provides generic reference documentation rather than a deeply specialized Ring Security integration.\n\nMitigation: Treat the output as quick-reference guidance and review it against authoritative Ring Security requirements before using it for operational decisions.\n\n## Reference(s):\n\n- [Ring Security on ClawHub](https://clawhub.ai/bytesagain-lab/skills/ring-security)\n- [BytesAgain](https://bytesagain.com)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Guidance]\n\n**Output Format:** [Plain-text reference documentation with Markdown headings]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [No API keys, privileged access, network access, persistence, or destructive behavior are indicated by the security evidence.]\n\n## Skill Version(s):\n\n3.0.1 (source: server release evidence and SKILL.md frontmatter; script declares 3.0.0)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Reference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Ring Security concepts, best practices, and implementation patterns. Skill: Ring Security Owner: bytesagain-lab Summary: Reference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Ring Security concepts, best practices, and implementation patterns. Tags: chinese:1.0.0, latest:3.0.1, productivity:1.0.0 Version history: v3.0.1 | 2026-03-24T01:44:10.979Z | user Fix description v3.0.0 | 2026-03-23T00:59:49.052Z | user Clean package v2.0.1 | 2026-03-18T10:49:45","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":764,"uniquenessScore":53,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T00:16:50.738Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T00:16:50.738Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T03:53:16.501Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}