Panduan Pengurus SIWAK
Panduan singkat memasang SIWAK di TV masjid dan mengaturnya dari HP lewat https://siwak.alfianys.id/admin. Semua langkah bisa dilakukan tanpa keahlian teknis.
1. Yang dibutuhkan
- TV Android atau TV box Android (Android 5.0 ke atas) dengan remote.
- Internet di masjid (Wi-Fi atau kabel). Tanpa internet SIWAK tetap berjalan dengan data terakhir.
- Akun Google pengurus yang sudah didaftarkan oleh super admin SIWAK. Bila belum, minta didaftarkan dengan menyebutkan alamat email Google dan nama masjid.
2. Memasang aplikasi di TV
- Di TV, buka peramban atau aplikasi pengelola berkas, lalu unduh APK terbaru dari https://siwak.alfianys.id/api/public/latest-apk. Cara lain: salin berkas APK ke flashdisk.
- Buka berkas APK. Bila TV meminta izin Instal aplikasi tidak dikenal, izinkan untuk aplikasi yang dipakai membuka berkas tersebut.
- Buka SIWAK. Saat pertama kali, TV meminta izin Tampil di atas aplikasi lain. Izinkan agar SIWAK bisa dibuka kembali dari jauh bila tertutup.
Saat dibuka, SIWAK memeriksa versi baru di GitHub dan menawarkan pemasangannya. Pengaturan tidak hilang saat aplikasi diperbarui.
3. Menghubungkan TV ke server
- Di TV: tekan tombol tengah remote pada jam → Pengaturan → Hubungkan ke server. TV menampilkan kode 8 angka dan QR.
- Di HP: buka https://siwak.alfianys.id/admin, masuk dengan Google, pilih masjid, lalu menu TV → Hubungkan TV.
- Ketik kode 8 angka, atau tekan Scan QR dan arahkan kamera HP ke QR di TV.
- Beri nama TV (misalnya "Serambi"), lalu tekan Hubungkan.
- Dalam beberapa detik layar TV berganti. Catat PIN yang muncul di HP: PIN ini dipakai untuk membuka menu pengaturan di TV. PIN bisa dilihat lagi kapan saja di menu TV.
Kode berlaku 10 menit dan dibuat ulang otomatis. Bila muncul "Kode tidak ditemukan", periksa angka di layar TV lalu coba lagi.
4. Peran pengurus
| Peran | Boleh |
|---|---|
| Operator | Teks berjalan, slide dan panel informasi, pengumuman segera, pratinjau, membuka SIWAK dari jauh |
| Admin masjid | Semua yang boleh operator, ditambah jadwal, suara, tampilan, hadits, menghubungkan dan melepas TV, PIN, log aktivitas |
| Super admin | Semua masjid, pengguna, dan pustaka hadits pusat |
Pengurus yang mengelola lebih dari satu masjid bisa berpindah masjid lewat pilihan Pindah masjid di bagian atas halaman masjid.
5. Mengatur tampilan TV
Semua perubahan sampai ke TV paling lama 1 menit setelah disimpan.
- Jadwal: lokasi masjid, koreksi menit per waktu shalat (agar sama dengan jadwal Kemenag setempat), jadwal manual, penyesuaian tanggal Hijriah, jeda iqamah, layar Jumat.
- Suara: bunyi menjelang adzan dan iqamah (bip, tik, atau audio unggahan sendiri).
- Tampilan: tata letak (Bar bawah atau Galeri), tema warna, jam, mode istirahat malam, logo dan gambar latar, Mutiara Hadits, dan opsi Selalu kembali ke SIWAK.
- Teks berjalan: pesan bergilir di bawah layar, bisa diberi tanggal mulai dan selesai.
- Slide & info: slide gambar atau hadits, serta panel kas, petugas Jumat, agenda, dan hari besar.
- Pratinjau: simulasi layar TV dengan pengaturan yang tersimpan.
Jadwal shalat dihitung dari koordinat masjid dengan metode Kemenag RI. Selalu cocokkan dengan jadwal resmi Kementerian Agama setempat dan pakai koreksi menit bila ada selisih.
6. Pengumuman segera
Untuk kabar mendadak (misalnya kendaraan menghalangi jalan atau perubahan tempat kajian):
- Buka menu Pengumuman (atau tombol Kirim pengumuman di halaman TV).
- Tulis isinya (maksimal 200 karakter), pilih Semua TV atau satu TV, lalu pilih masa tayang: 30 menit, 1 jam, 2 jam, hari ini, atau pilih sendiri.
- Tekan Kirim pengumuman. Banner merah muncul di bagian atas layar TV dalam 1 menit.
Banner tidak tampil saat layar shalat, hitung mundur iqamah, dan khutbah Jumat. Pengumuman bisa dicabut sebelum waktunya dari daftar Sedang tayang.
7. Hadits
Admin masjid bisa menambah hadits untuk masjidnya sendiri dan memilih kategori hadits yang tampil. Hadits dari pustaka pusat sudah diperiksa super admin. Hadits buatan masjid bisa diajukan ke pustaka pusat agar dipakai masjid lain. Pastikan teks, terjemah, dan sumbernya benar sebelum ditayangkan.
8. Memantau TV dari jauh
Menu Semua TV dan halaman TV masjid menampilkan keadaan setiap TV:
| Tanda | Arti | Yang bisa dilakukan |
|---|---|---|
| Hijau, "SIWAK tampil" | TV online dan SIWAK sedang di layar | Tidak perlu apa-apa |
| Kuning, "SIWAK di latar belakang" | TV online, tetapi aplikasi lain sedang dibuka | Tekan Buka SIWAK |
| Merah, "Offline sejak …" | TV mati, internet putus, atau aplikasi dihentikan (tanpa kabar 5 menit) | Periksa listrik dan internet di masjid |
| "Jam TV selisih N menit" | Jam TV meleset | Di TV: Setelan → Tanggal & waktu → aktifkan waktu otomatis |
Perintah Buka SIWAK, Sinkron sekarang, dan Mulai ulang SIWAK sampai ke TV paling lama 1 menit. Tombol Riwayat menampilkan kejadian setiap TV (online, offline, galat, pembaruan).
9. PIN dan pengaturan di TV
Saat terhubung ke server, menu pengaturan di TV dikunci PIN 6 angka. Di admin web: menu TV → Kelola → Lihat (PIN tampil 30 detik) atau Buat PIN baru. Lima kali salah memasukkan PIN, TV meminta menunggu 5 menit.
10. Melepas TV
- Dari HP: menu TV → Kelola → Lepas TV.
- Dari TV: pengaturan terbatas → Lepas dari server.
TV kembali ke mode mandiri dengan pengaturan terakhir dari server, dan bisa dihubungkan lagi kapan saja. Pada mode mandiri, cuaca hanya tampil bila pengurus mengisi kunci OpenWeather miliknya sendiri di pengaturan TV.
11. Bila ada masalah
| Masalah | Coba ini |
|---|---|
| "Email ini belum terdaftar" saat masuk | Minta super admin mendaftarkan email Google Anda |
| Perubahan tidak sampai ke TV | Pastikan TV online (hijau), lalu tekan Sinkron sekarang |
| SIWAK tidak bisa dibuka dari jauh | Di TV: Setelan → Aplikasi → SIWAK → Tampil di atas aplikasi lain → Izinkan |
| Jadwal berbeda beberapa menit | Atur koreksi menit di menu Jadwal |
| Lupa PIN TV | Lihat di admin web, menu TV → Kelola → Lihat |
Pertanyaan dan laporan masalah: alfian123yudi@gmail.com atau GitHub Issues.