SIWAK

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

2. Memasang aplikasi di TV

  1. 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.
  2. Buka berkas APK. Bila TV meminta izin Instal aplikasi tidak dikenal, izinkan untuk aplikasi yang dipakai membuka berkas tersebut.
  3. 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

  1. Di TV: tekan tombol tengah remote pada jam → Pengaturan → Hubungkan ke server. TV menampilkan kode 8 angka dan QR.
  2. Di HP: buka https://siwak.alfianys.id/admin, masuk dengan Google, pilih masjid, lalu menu TV → Hubungkan TV.
  3. Ketik kode 8 angka, atau tekan Scan QR dan arahkan kamera HP ke QR di TV.
  4. Beri nama TV (misalnya "Serambi"), lalu tekan Hubungkan.
  5. 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 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):

  1. Buka menu Pengumuman (atau tombol Kirim pengumuman di halaman TV).
  2. 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.
  3. 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

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.