🎥 Yi Home 1080p — Telegram Control System

A complete remote surveillance and control system for the Yi Home 1080p camera running yi-hack-allwinner v2 firmware by roleoroleo. Control your camera, receive automatic alerts, and communicate bidirectionally — all through a Telegram bot.

• 📷 On-demand snapshot and video recording via Telegram commands
• 🚨 Automatic motion alerts with photo
• 🔊 Automatic sound alerts with snapshot + 15s audio clip
• 🎙️ Bidirectional voice intercom — speak through Telegram, hear through the camera speaker
• 💡 Blue LED control — turn on/off remotely
• 🔆 Infrared control — turn on/off remotely
• 🔕 Silent mode — suppress notifications without stopping the watchers
• 📊 System status — IP, uptime, memory, process PIDs
• 🔄 Remote reboot

├── config.env              # Bot credentials (NOT included — create manually)
├── lower_half_init.sh      # System startup and process launcher
├── telegram_control.sh     # Telegram bot: command reception and processing
├── watch_motion.sh         # Motion detection watcher
├── watch_sound.sh          # Sound detection watcher
└── intercom.sh             # Bidirectional voice intercom

The following ARM-precompiled binaries must be present on the camera:

All binaries should be placed in /tmp/sd/yi-hack/bin/.

Download curl by @moparisthebest.

Download ffmpeg by @johnvansickle.

ssh root@<camera-ip>

# Copy all .sh files to the scripts directory
chmod +x /tmp/sd/yi-hack/script/*.sh
mkdir -p /tmp/sd/yi-hack/motion

cat > /tmp/sd/yi-hack/script/config.env << 'EOF'
#!/bin/sh
BOT_TOKEN="YOUR_BOT_TOKEN_HERE"
CHAT_ID="YOUR_CHAT_ID_HERE"
EOF

1. Open Telegram and search for @BotFather
2. Send /newbot and follow the instructions
3. Copy the token to BOT_TOKEN in config.env
4. Get your CHAT_ID by sending a message to your bot and visiting: https://api.telegram.org/bot<TOKEN>/getUpdates

sh /tmp/sd/yi-hack/script/watch_motion.sh &
sleep 5
sh /tmp/sd/yi-hack/script/watch_sound.sh &
sleep 5
sh /tmp/sd/yi-hack/script/telegram_control.sh &

The scripts start automatically on boot via lower_half_init.sh.

if watch_sound.sh doesnt start execute this on shell:

ssh root@<camara_ip>
# Actual value
cat /tmp/sd/yi-hack/etc/system.conf | grep RTSP_AUDIO

# If empty, activate
sed -i 's/^RTSP_AUDIO=$/RTSP_AUDIO=pcm/' /tmp/sd/yi-hack/etc/system.conf

# Check it
cat /tmp/sd/yi-hack/etc/system.conf | grep RTSP_AUDIO

The camera uses different audio formats per direction:

The intercom uses a 30-block circular buffer (~15s of prior audio) to ensure the beginning of sentences is not lost when voice detection triggers.

Each script writes its own log to /tmp/:

tail -f /tmp/telegram_control.log
tail -f /tmp/watch_motion.log
tail -f /tmp/watch_sound.log
tail -f /tmp/intercom.log

Logs are stored in /tmp/ and are lost on reboot.

Full technical documentation is available in yi_telegram_documentation.odt, covering architecture, script internals, audio format discovery, installation steps, and troubleshooting.

Use this software at your own risk.

• This project is unofficial and is not affiliated with, endorsed by, or supported by Yi Technology Co., Ltd.
• Installing this software may void your device warranty.
• This software enables audio and video recording and remote monitoring. You are solely responsible for complying with all applicable laws regarding surveillance and privacy in your jurisdiction, and for obtaining any necessary consent from individuals who may be recorded.
• You are solely responsible for securing access to your Telegram bot and camera credentials. The authors accept no liability for unauthorised access or data breaches resulting from insecure configuration.
• The authors accept no liability for any damage, data loss, legal issues, or any other consequence arising from the use of this software.

See the LICENSE file for the full legal text.

This project is licensed under the MIT License — see the LICENSE file for details.

The license includes an additional disclaimer covering device warranty, privacy compliance, security responsibilities, and limitation of liability.

If you enjoy this project, please consider supporting its maintenance with a donation. Thanks!!

Click here or use the below QR code or push the button to donate via PayPal