AMaL adalah sebuah mesin smart kiosk (anjungan pintar) berlisensi AGPL dengan semangat FLOSS (Free Libre Open Source Software) yang dirancang khusus untuk menunjang informasi dan edukasi di lingkungan masjid.
Tidak hanya sekedar menampilkan jadwal sholat, pengumuman, dan mutiara hikmah, AMaL juga dibekali dengan mesin komputasi astronomi (real-time) dengan fitur:
- 🌒 Visualisasi penampakan hilal secara dinamis
- 🕋 Perhitungan Rashdul Qiblah (kalibrasi arah kiblat)
- 🌘 Prediksi kejadian gerhana matahari dan bulan
- 📅 Konversi penanggalan Masehi, Hijriah, dan Jawa (Pasaran/Kurup)
Arsitektur AMaL Secara arsitektur, AMaL dapat beroperasi 100% luring (offline) tanpa memerlukan koneksi internet. AMaL juga dioptimalkan agar dapat berjalan lancar pada Mini PC atau Single Board Computer (SBC) seperti Raspberry Pi.
Filosofi AMaL
- Edukasi: AMaL ditujukan sebagai media informasi dan edukasi bagi umat terutama terkait peristiwa astronomi Islam guna mendorong sikap saling menghargai perbedaan.
- Amal Jariyah: AMaL dirilis di bawah lisensi AGPL untuk memastikan sistem ini selamanya terbuka, tidak pernah diprivatisasi, dan tetap menjadi milik umat sehingga bebas digunakan olah masjid manapun. Keterbukaan lisensi ini memastikan setiap kontributor yang menyempurnakan dan menyebarkan kodenya turut merajut untaian amal jariyah yang manfaatnya mengalir tiada terputus.
Catatan: AMaL menggunakan data dari proyek berikut:
- Audio Al-Quran per ayat dari everyayah
- Metadata, teks Arab, dan terjemahan Bahasa Indonesia dari tanzil.net
Fitur-fitur AMaL dapat dikelompokkan menjadi 4 pilar utama:
Tidak ada lagi penyesuaian (offset) hari secara manual. AMaL menghitung posisi benda langit secara mandiri.
- Kalender Hijriah Komputasional: Dihitung langsung menggunakan algoritma astronomi berdasarkan kriteria Wujudul Hilal, MABIMS, dan KHGT.
- Sistem Penanggalan Lengkap & Kultural: Tampilan utamanya adalah kelender Hijrian dan Masehi. AMaL juga memiliki pilihan menampilkan kalender Jawa sebagai warisan budaya lokal.
- Jadwal Sholat & Arah Kiblat: Disesuaikan dengan presisi titik koordinat lokal masjid.
- Pengingat Puasa: Menampilkan jadwal puasa wajib dan sunnah secara otomatis di layar utama.
- Manajemen Hari Libur: Mengakomodasi hari libur/besar rutin tahunan (Hijriah/Masehi) maupun kejadian insidentil.
- Audio: Memperdengarkan murottal Al Quran dan/atau tarhim otomatis menjelang adzan serta Adzan. Fungsi murottal, tarhim, dan adzan ini dapat dinonaktifkan oleh takmir. Selain itu takmir juga dapat memutar murottal secara manual.
Mesin pengumunan otomatis yang dinamis sebagai sarana komunikasi antara takmir dan jemaah.
- Transparansi Keuangan (Kas Masjid): Slide informasi keuangan sederhana yang menampilkan rekapitulasi saldo, pemasukan, dan pengeluaran masjid.
- Pengumuman Berbobot Cerdas: Pengumuman (dapat berupa teks/gambar) dilengkapi dengan batas waktu dan bobot prioritas. Semakin dekat dengan batas waktu, pengumuman akan semakin sering muncul di layar.
- Manajemen Konten Fleksibel: Fitur Aktif/Sembunyikan memungkinkan takmir mengarsipkan pengumuman atau mutiara hikmah sementara waktu tanpa perlu menghapus datanya.
- Mutiara Hikmah: Menampilkan kutipan ayat, hadits, atau kata mutiara secara bergantian.
- Running Text: Teks berjalan untuk informasi singkat dan cepat.
Menjadikan anjungan masjid AMaL sebagai media edukasi sains bagi jemaah.
- Planetarium Mini Real-Time: Visualisasi posisi Matahari ☀️ dan Bulan 🌙 serta arah cahaya dan bayangan matahari yang bergerak secara presisi sesuai posisinya di langit masjid saat itu.
- Ilustrasi Fase Bulan Harian: Menampilkan gambar fase bulan secara visual dan akurat setiap harinya.
- Edukasi Rashdul Qiblah: Memberikan informasi dinamis peristiwa Istiwa A'zam (saat matahari tepat di atas Ka'bah) atau Rashdul Qiblah global dan Rashdul Qiblah lokal (saat matahari atau bayangan matahari searah dengan arah kiblat) guna mengingatkan jemaah mengkalibrasi arah kiblat lokal.
- Edukasi Penentuan Awal Bulan: Menampilkan hasil komputasi posisi hilal saat matahari terbenam menjelang hari Ijtima terdekat pada saat sebelum dan sesudahnya.
- Edukasi Gerhana: Pengambilalihan layar (takeover) dengan informasi terkait sholat shunah kusuf dan khusuf menjelang terjadinya gerhana matahari atau bulan.
Memberikan kemudahan administrator dan menjaga keawetan perangkat keras (hardware).
- 100% Standalone: Bekerja penuh secara luring (offline). Tidak bergantung pada API eksternal dan koneksi internet, sangat cocok untuk masjid di daerah pelosok.
- Proteksi Layar (Tri-State Display): Dilengkapi mode Screensaver (Jam Melayang) untuk jam-jam siang yang sepi, dan mode Blackout (Layar Mati Total) pada malam hari untuk menghemat listrik dan mencegah burn-in (layar berbayang) pada monitor/TV.
- Fitur Simulasi (Mesin Waktu): Administrator dapat memutar waktu sistem untuk melihat bagaimana tampilan AMaL pada waktu tertentu (misal: menguji tampilan menjelang gerhana, simulasi menjelang Rashdul Qiblah atau simulasi Ijtima).
- Panel Pengaturan (Settings): Antarmuka khusus untuk mengatur informasi dan koordinat masjid, menyesuaikan kriteria kalender Hijriah, pengaturan masa tunggu Iqomah, hingga durasi waktu shalat untuk mematikan layar pada saat shalat dilaksanakan.
- Manajemen Pengguna: Akses login berlapis untuk administrator dan operator harian (Takmir).
Catatan: Menu Pengaturan Jam saat ini hanya berjalan pada OS Linux dan aplikasi dijalankan oleh pengguna yang dapat mengunakan perintah sudo tanpa password.
Video singkat dapat dilihat pada: Video AMaL
| Fitur | Gambar |
|---|---|
| Tampilan Utama |  |
| Edukasi Hilal (Menjelang Ijtima) |  |
| Panel Administrasi |  |
Panduan lengkap untuk memasang AMaL di komputer lokal atau Raspberry Pi. Catatan: jika dipasang di Raspberry Pi maka diperlukan pemasangan RTC. AMaL telah dicoba dan berjalan dengan baik pada Raspberry Pi 4 Model B dengan OS DietPi dengan ntp untuk sinkronisasi waktu.
- Python 3.9+
-
Kloning repositori AMaL:
git clone [https://github.com/aswinte/AMaL.git](https://github.com/aswinte/AMaL.git)
-
Jalankan skrip instalasi:
cd AMaL chmod +x install.sh ./install.shatau lakukan dengan cara manual berikut:
cd AMaL python3 -m venv venv source venv/bin/activate # Untuk Windows: venv\Scripts\activate pip install -r requirements.txt
-
Jalankan aplikasi
python main.py
Buka peramban dan akses http://localhost:5000 dari mesin lokal atau http://ip_mesin:5000 dari komputer lain.
-
Akses admin dapat dilakukan dari http://localhost:5000/admin atau http://ip_mesin:5000/admin
-
Login admin default menggnakan
username: admindanpassword: admin.
Catatan: Pada saat pertama kali dijalankan, Amal akan mulai melakukan perhitungan posisi hilal untuk setiap pergantian bulan pada tahun berjalan. Proses ini akan membutuhkan waktu.
Kami sangat menunggu kontribusi dari komunitas! Jika Anda ingin menambahkan fitur, memperbaiki bug, atau menyempurnakan dokumentasi, silakan buat Pull Request.
Proyek ini didistribusikan di bawah lisensi GNU AGPLv3. Lihat berkas LICENSE untuk informasi lebih lanjut. Pada intinya, Anda bebas menggunakan, memodifikasi, dan mendistribusikan perangkat lunak ini, dengan syarat perbaikan/modifikasi yang Anda lakukan harus dikembalikan ke ranah publik/sumber terbuka dengan lisensi yang sama.
Keywords / Tags: Smart Kiosk Masjid, Jadwal Sholat Digital, Aplikasi Masjid Offline, Raspberry Pi Kiosk, Islamic Astronomy, Penghitung Arah Kiblat, Software Masjid Open Source, Jam Masjid Digital, Jadwal Shalat, Display Masjid, Jam Masjid Digital, TV Masjid, Kalender Hijriah, MABIMS, KGHT, Rukyatul Hilal, Imkanur Rukyat, Rasdhul Qiblah.