🇮🇩 Indonesia · 🇬🇧 English
Bot WhatsApp otomatis berbasis Python yang menandai status WhatsApp kontak sebagai "sudah dibaca" secara real-time menggunakan Neonize — Python wrapper untuk whatsmeow.
Disclaimer: Proyek ini bukan produk resmi WhatsApp/Meta. Gunakan dengan bijak dan sesuai ketentuan layanan WhatsApp.
| Fitur | Keterangan |
|---|---|
| 👁️ Auto-read status | Menandai status WhatsApp sebagai dibaca secara otomatis |
| ⚡ Neonize + whatsmeow | Koneksi stabil berbasis Go bridge |
| 🔑 Pairing Code | Login via kode — tanpa scan QR |
| 🗄️ SQLite | Sesi login tersimpan, tidak perlu pairing ulang |
| 🐍 uv | Setup cepat tanpa ribet virtual environment manual |
| 📋 PM2 Ready | Log bersih dengan flush=True, siap dijalankan via PM2 |
wsr-py/
├── main.py # Entry point bot
├── db.sqlite3 # Database sesi (dibuat otomatis)
├── pyproject.toml # Konfigurasi project & dependensi
├── uv.lock # Lockfile dependensi
├── .python-version # Versi Python
├── .gitignore
└── README.md
db.sqlite3sudah masuk.gitignore— sesi login tidak akan ikut ter-commit.
Windows (PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"macOS / Linux:
curl -LsSf https://astral.sh/uv/install.sh | shgit clone https://github.com/irwanx/whatsapp-status-reader.git
cd whatsapp-status-readeruv syncuv run main.pyPertama kali run — bot akan meminta nomor HP:
Masukkan nomor HP (contoh: 628123456789): 628123456789
[19:04:26] 📱 Pair code: ABCD-1234
Masukkan kode tersebut di WhatsApp: Setelan → Perangkat Tertaut → Tautkan Perangkat.
Setelah berhasil:
[19:04:48] 🔗 Logged as 628123456789
[19:04:55] 👁️ Status dari 628987654321 ditandai dibaca
Run berikutnya — bot langsung konek tanpa pairing ulang.
Cocok untuk server/VPS agar bot berjalan terus di background.
npm install -g pm2Pastikan sudah pairing dulu (
uv run main.py) sebelum pakai PM2, karena PM2 tidak bisa menerima input interaktif.
pm2 start "uv run main.py" --name wsr-botpm2 logs wsr-bot # lihat log real-time
pm2 status # cek status bot
pm2 restart wsr-bot # restart bot
pm2 stop wsr-bot # stop bot
pm2 startup # auto-start saat server reboot
pm2 save # simpan konfigurasi PM2- Fork repositori ini
- Buat branch baru:
git checkout -b feat/nama-fitur - Commit:
git commit -m "feat: tambah fitur X" - Push:
git push origin feat/nama-fitur - Buat Pull Request
A Python-based WhatsApp bot that automatically marks WhatsApp statuses as "read" in real-time using Neonize, a Python wrapper for whatsmeow.
Disclaimer: This is not an official WhatsApp/Meta product. Use responsibly and in accordance with WhatsApp's Terms of Service.
| Feature | Description |
|---|---|
| 👁️ Auto-read status | Automatically marks WhatsApp statuses as read |
| ⚡ Neonize + whatsmeow | Stable connection via Go bridge |
| 🔑 Pairing Code | Login via code — no QR scan needed |
| 🗄️ SQLite | Session persists, no re-pairing needed |
| 🐍 uv | Fast setup without manual venv hassle |
| 📋 PM2 Ready | Clean logs with flush=True, ready for PM2 |
wsr-py/
├── main.py # Bot entry point
├── db.sqlite3 # Session database (auto-created)
├── pyproject.toml # Project config & dependencies
├── uv.lock # Dependency lockfile
├── .python-version # Python version pin
├── .gitignore
└── README.md
git clone https://github.com/irwanx/whatsapp-status-reader.git
cd whatsapp-status-reader
uv sync
uv run main.pyOn first run, enter your phone number (628xxxxxxxx) and enter the pairing code in WhatsApp: Settings → Linked Devices → Link a Device.
Subsequent runs will reuse the saved session automatically.
Pair your account first (
uv run main.py) before using PM2, since PM2 can't handle interactive input.
npm install -g pm2
pm2 start "uv run main.py" --name wsr-bot
pm2 logs wsr-bot
pm2 startup && pm2 save