RING-DOORBELL(1)

🌸 NAME 🌸

okay bestie, so this is ring-doorbell — it's the Command Line Interface to operate on the Ring devices 💖✨. that's the whole vibe. one command, all your Ring stuff, from your terminal, slay.

✨ SYNOPSIS ✨

ring-doorbell [OPTIONS] COMMAND [ARGS]...

that's it, that's the shape of it — options first, then a command, then whatever args that command wants 🫶

💖 DESCRIPTION 💖

so real talk: ring_doorbell is a Python module for managing Ring devices 🎀. and the ring-doorbell executable? that's the little doorway you use to actually interact with them from your shell. no cap.

this manual page right here is specifically about the ring-doorbell executable ✨. if you want more docs, scroll down to the SEE ALSO section, i gotchu.

🎀 COMMANDS 🎀

lowkey the most important thing: just running ring-doorbell with nothing else starts an interactive session 💅. it's giving main character energy. but if you'd rather hand it a command directly, here's the whole menu:

• devices — get device information 🦋
• dings — get dings information 🔔
• groups — get group information 🌸
• history — print raw json 📜
• list — list ring devices 📋
• listen — listen to push notification like the ones sent to... 👂 (yes, the sentence really trails off like that, i'm not the one who wrote it, i'm just the messenger 😭)
• motion-detection — display ring devices 🏃
• raw-query — directly query a url and return json result 🔍
• show — display ring devices 👀
• videos — interact with ring videos 🎥

💅 OPTIONS 💅

okay now the flags, and bestie there are exactly six of them, so no excuses, learn them all 💖:

• --version — show the version and exit ⭐
• --username TEXT — username for Ring account 👤
• --password TEXT — password for Ring account 🔑
• -d, --debug — enable debugging information 🐛
• --user-agent TEXT — user agent to send to ring 📡
• --help — show this message and exit 🙈

ngl, notice how --username and --password and --user-agent all want TEXT? yeah. that's the value type. don't come for me, come for the manpage 💀

👑 AUTHOR 👑

this manual page was written by Carles Pina i Estany <carles@pina.cat> for the Debian system (but it may be used by others) 🫶. permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 3 or any later version published by the Free Software Foundation 📜✨. iconic of them tbh.

🔥 SEE ALSO 🔥

want more ring_doorbell documentation? here's where to go, bestie:

• online, at <https://python-ring-doorbell.readthedocs.io/> 🌈
• or locally, in /usr/share/doc/python3-ring-doorbell/README.rst.gz 📦
• and also locally in /usr/share/doc/python3-ring-doorbell/html/ 🎀

k that's the whole page, you ate it 💅💖. this was RING-DOORBELL(1) from the General Commands Manual — go forth and doorbell, bestie, periodt ✨🦋👑