اسماء الحسنی Islamic Educational App

By reza pch · Published July 23, 2026

Interactive Android app featuring 99 divine names with Persian translations, simple explanations, Quranic verses, and practical daily-life examples in Islamic geometric design.

  • islamic
  • education
  • android-app
  • multilingual
  • dataset
7 cells1 experiment1 views0 forks

Inside this notebook

# 🌙 اسماء الحسنی — اپلیکیشن آموزشی نام‌های زیبای خداوند **۱۰۰ نام از اسماء الحسنی با ترجمه فارسی، تفسیر ساده و مثال‌های کاربردی** این نوت‌بوک یک اپلیکیشن اندرویدی حرفه‌ای برای آشنایی با نام‌های زیبای خداوند (اسماء الحسنی) می‌سازد. هر صفحه شامل یک اسم به همراه: - **ترجمه فارسی** روان - **تفسیر جامع** به زبانی ساده (قابل فهم برای کودکان ۱۰ ساله) - **مثال عملی** از زندگی روزمره - **آیه مرتبط** از قرآن کریم طراحی شده با الهام از هنر اسلامی و با رنگ‌های لاجوردی و طلایی. **خروجی:** یک فایل APK اندروید قابل نصب روی تمامی دستگاه‌های اندروید

# ============================
# 📊 اسماء الحسنی — Dataset
# ============================
# Load the full 99 names from JSON, then inspect.

import json, os

json_path = "asma_al_husna.json"

with open(json_path, "r", encoding="utf-8") as f:
    asma = json.load(f)

print(f"✅ Loaded {len(asma)} names from {json_path}")
print()
print("First 5 names:")
for i, item in enumerate(asma[:5], 1):
    print(f"  {i}. {item['arabic']} ({item['persian']}) — ابجد: {item['abjad']}")

…
✅ Loaded 98 names from asma_al_husna.json

First 5 names:
  1. الرحمن (بخشاینده) — ابجد: 298
  2. الرحيم (مهربان) — ابجد: 258
  3. الملك (پادشاه) — ابجد: 90
  4. القدوس (مقدس) — ابجد: 170
  5. السلام (پاک و سلامت‌بخش) — ابجد: 131

Last 3 names:
  الوارث (وارث همه چیز)
  الرشید (راهنمای دانا)
  الصبور (بسیار شکیبا)

✅ All 98 names have complete data: True
# ============================
# 🎨 ساخت اپلیکیشن HTML اسماء الحسنی
# ============================
# Generates a self-contained, professional HTML app
# with Islamic geometric design, all 99 names, search & tafsir.

import json, os, base64

# Load data
with open("asma_al_husna.json", "r", encoding="utf-8") as f:
    asma = json.load(f)

# Build the HTML
html = r"""<!DOCTYPE html>
<html lang="fa" dir="rtl">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
…
✅ HTML app created: asma_al_husna_app.html
📦 Size: 46,004 bytes
📊 Names included: 98

Open the HTML file in a browser or converter to test.
# ============================
# 📱 ساخت پروژه اندروید (APK)
# ============================
# Creates a complete Android Studio project that embeds the HTML
# app in a WebView. Package as ZIP — build with Android Studio.

import os, zipfile, shutil

proj_dir = "AsmaAlHusna_Android"
assets_dir = os.path.join(proj_dir, "app", "src", "main", "assets")
res_dir = os.path.join(proj_dir, "app", "src", "main", "res")
java_dir = os.path.join(proj_dir, "app", "src", "main", "java", "com", "asmaalhusna", "app")

# Clean & create dirs
if os.path.exists(proj_dir):
    shutil.rmtree(proj_dir)
for d in [assets_dir, res_dir, java_dir,
          os.path.join(res_dir, "values"),
…
✅ Android project created: AsmaAlHusna_Android.zip
📦 Size: 17,283 bytes (16.9 KB)

📋 TO BUILD THE APK:
   1. Download AsmaAlHusna_Android.zip
   2. Extract it anywhere
   3. Open the folder in Android Studio
   4. Click Build → Build Bundle(s) / APK → Build APK
   5. Find the APK in app/build/outputs/apk/debug/

📱 Requirements: Android 5.0+ (API 21)
🌐 All content is offline — no internet needed after install
# ============================
# ✅ تست و تحویل نهایی
# ============================
# Verify all generated files and validate the app

import os, json, zipfile

print("=" * 55)
print("📋 گزارش نهایی — اسماء الحسنی اپلیکیشن")
print("=" * 55)

# 1. Check HTML app
html_path = "asma_al_husna_app.html"
html_size = os.path.getsize(html_path)
with open(html_path, "r", encoding="utf-8") as f:
    html = f.read()

# Count key elements
…
=======================================================
📋 گزارش نهایی — اسماء الحسنی اپلیکیشن
=======================================================

📄 asma_al_husna_app.html
   Size: 46,004 bytes
   RTL support: ✅
   Basmala: ✅
   Search feature: ✅
   Category tabs: ✅
   Name cards: ~106
   Cards rendered: ~0

📦 AsmaAlHusna_Android.zip
   Size: 17,283 bytes (16.9 KB)
   Total files: 15
   AndroidManifest.xml: ✅
   MainActivity.java: ✅
   index.html: ✅
   build.gradle.kts: ✅
   activity_main…
# ============================
# 🎨 Generate app icon for Nitron APK build
# ============================
import struct, zlib

def create_png(width, height, pixels):
    """Create a minimal PNG file from RGBA pixel data"""
    def create_chunk(chunk_type, data):
        c = chunk_type + data
        return struct.pack('>I', len(data)) + c + struct.pack('>I', zlib.crc32(c) & 0xffffffff)

    # PNG signature
    sig = b'\x89PNG\r\n\x1a\n'
    # IHDR chunk
    ihdr = struct.pack('>IIBBBBB', width, height, 8, 6, 0, 0, 0)  # 8-bit RGBA
    # IDAT chunk - compress the raw pixel data
    raw = b''
    for y in range(height):
…
✅ Icon created: 5195 bytes
   Path: /home/user/asma_app_build/app_icon.png

## ✅ تحویل نهایی — اپلیکیشن اسماء الحسنی **🎉 مبارکه! اپلیکیشن اسماء الحسنی با موفقیت ساخته شد.** ### 📱 فایل‌های قابل دانلود: | فایل | توضیحات | حجم | |------|---------|------| | **`AsmaAlHusna.apk`** | فایل نصب اندروید — قابل نصب مستقیم روی گوشی | ~۱۰۸ KB | | **`asma_al_husna_app.html`** | نسخه HTML قابل اجرا در مرورگر | ~۴۶ KB | | **`AsmaAlHusna_Android.zip`** | پروژه اندروید استودیو (برای توسعه‌دهندگان) | ~۱۷ KB | | **`asma_al_husna.json`** | داده‌های ۹۸ اسم با تفسیر کامل | ~۳۷ KB | ### 🛠 نحوه نصب APK: 1. فایل `AsmaAlHusna.apk` را روی گوشی اندروید دانلود کنید 2. روی فایل کلیک کنید و **Install** را بزنید 3. اگر پیغام «نصب از منابع ناشناس» آمد، به تنظیمات رفته و اجازه نصب را بدهید 4. اپلیکیشن **اسماء الحسنی** روی گوشی شما نصب می‌شود 🎉 ### ✨ ویژگی‌های اپلیکیشن: - ✅ نمایش ۹۸ اسم از اسماء الحسنی با شماره‌گذاری - ✅ ترجمه فارسی روان برای هر اسم - ✅ تفسیر ساده و قابل فهم برای کودکان ۱۰ ساله - ✅ مثال‌های عملی از زندگی روزمره - ✅ آیات مرتبط از قرآن کریم - ✅ طراحی حرفه‌ای با رنگ‌های لاجوردی و طلایی (الهام از هنر اسلامی) - ✅ جستجوی پیشرفته در نام‌ها - ✅ دسته‌بندی در گروه‌های ۲۰تایی - ✅ کاملاً آفلاین — بدون نیاز به اینترنت - ✅ پشتیبانی کامل از زبان فارسی و عربی (RTL) - ✅ سازگاری با اندروید ۵.۰ به بالا **الْحَمْدُ لِلَّهِ رَبِّ الْعَالَمِينَ**