Skip to content

Free, open-source macOS cleaner. CleanMyMac alternative with zero telemetry. Native SwiftUI, scheduled auto-cleaning, Xcode/Homebrew/system cache cleanup. MIT licensed.

feat: Arabic (ar) localization + sidebar localization fix (#70)

Ziad39ffed0c6108
diff --git a/PureMac/Views/Components/EmptyStateView.swift b/PureMac/Views/Components/EmptyStateView.swift
index a21241a..bbfad6d 100644
--- a/PureMac/Views/Components/EmptyStateView.swift
+++ b/PureMac/Views/Components/EmptyStateView.swift
@@ -1,13 +1,13 @@
import SwiftUI
struct EmptyStateView: View {
- let title: String
+ let title: LocalizedStringKey
let systemImage: String
- let description: String
+ let description: LocalizedStringKey
var action: (() -> Void)?
- var actionLabel: String?
+ var actionLabel: LocalizedStringKey?
- init(_ title: String, systemImage: String, description: String, action: (() -> Void)? = nil, actionLabel: String? = nil) {
+ init(_ title: LocalizedStringKey, systemImage: String, description: LocalizedStringKey, action: (() -> Void)? = nil, actionLabel: LocalizedStringKey? = nil) {
self.title = title
self.systemImage = systemImage
self.description = description
@@ -29,7 +29,7 @@ struct EmptyStateView: View {
.multilineTextAlignment(.center)
.frame(maxWidth: 300)
if let action, let label = actionLabel {
- Button(label, action: action)
+ Button(action: action) { Text(label) }
.buttonStyle(.borderedProminent)
.padding(.top, 4)
}
diff --git a/PureMac/Views/MainWindow.swift b/PureMac/Views/MainWindow.swift
index d01b42c..071eb52 100644
--- a/PureMac/Views/MainWindow.swift
+++ b/PureMac/Views/MainWindow.swift
@@ -25,14 +25,14 @@ struct MainWindow: View {
let smartSize = appState.categoryResults[.smartScan]?.totalSize ?? appState.totalJunkSize
let smartBadge = smartSize > 0 ? ByteCountFormatter.string(fromByteCount: smartSize, countStyle: .file) : nil
var items: [SidebarItem] = [
- SidebarItem(section: .cleaning(.smartScan), label: CleaningCategory.smartScan.rawValue, icon: CleaningCategory.smartScan.icon, badge: smartBadge, group: "Home"),
- SidebarItem(section: .apps, label: "Installed Apps", icon: "square.grid.2x2", badge: "\(appState.installedApps.count)", group: "Applications"),
- SidebarItem(section: .orphans, label: "Orphaned Files", icon: "doc.questionmark", badge: appState.orphanedFiles.count > 0 ? "\(appState.orphanedFiles.count)" : nil, group: "Applications"),
+ SidebarItem(section: .cleaning(.smartScan), label: LocalizedStringKey(CleaningCategory.smartScan.rawValue), icon: CleaningCategory.smartScan.icon, badge: smartBadge, group: .home),
+ SidebarItem(section: .apps, label: "Installed Apps", icon: "square.grid.2x2", badge: "\(appState.installedApps.count)", group: .applications),
+ SidebarItem(section: .orphans, label: "Orphaned Files", icon: "doc.questionmark", badge: appState.orphanedFiles.count > 0 ? "\(appState.orphanedFiles.count)" : nil, group: .applications),
]
for category in CleaningCategory.scannable {
let size = appState.categoryResults[category]?.totalSize ?? 0
let badge = size > 0 ? ByteCountFormatter.string(fromByteCount: size, countStyle: .file) : nil
- items.append(SidebarItem(section: .cleaning(category), label: category.rawValue, icon: category.icon, badge: badge, group: "Cleaning"))
+ items.append(SidebarItem(section: .cleaning(category), label: LocalizedStringKey(category.rawValue), icon: category.icon, badge: badge, group: .cleaning))
}
return items
}
@@ -40,9 +40,8 @@ struct MainWindow: View {
private var sidebar: some View {
List(selection: $selectedSection) {
let grouped = Dictionary(grouping: allSidebarItems, by: \.group)
- let order = ["Home", "Applications", "Cleaning"]
- ForEach(order, id: \.self) { group in
- Section(group) {
+ ForEach(SidebarGroup.allCases, id: \.self) { group in
+ Section(group.title) {
ForEach(grouped[group] ?? [], id: \.section) { item in
HStack {
Label(item.label, systemImage: item.icon)
@@ -81,10 +80,22 @@ struct MainWindow: View {
}
}
+private enum SidebarGroup: Hashable, CaseIterable {
+ case home, applications, cleaning
+
+ var title: LocalizedStringKey {
+ switch self {
+ case .home: return "Home"
+ case .applications: return "Applications"
+ case .cleaning: return "Cleaning"
+ }
+ }
+}
+
private struct SidebarItem {
let section: AppSection
- let label: String
+ let label: LocalizedStringKey
let icon: String
let badge: String?
- let group: String
+ let group: SidebarGroup
}
diff --git a/PureMac/ar.lproj/Localizable.strings b/PureMac/ar.lproj/Localizable.strings
new file mode 100644
index 0000000..f25edfa
--- /dev/null
+++ b/PureMac/ar.lproj/Localizable.strings
@@ -0,0 +1,136 @@
+/* Full Disk Access Banner */
+"Full Disk Access Required" = "يلزم منح الوصول الكامل إلى القرص";
+"PureMac needs Full Disk Access to scan Trash, Mail, Desktop, Documents, and Homebrew cache." = "يحتاج PureMac إلى الوصول الكامل للقرص لفحص سلة المهملات والبريد وسطح المكتب والمستندات وذاكرة التخزين المؤقت لـ Homebrew.";
+"Open Settings" = "فتح الإعدادات";
+
+/* Top Bar */
+"Macintosh HD" = "Macintosh HD";
+"%@ free" = "%@ متاحة";
+"Auto-clean: " = "التنظيف التلقائي: ";
+
+/* Sidebar */
+"CLEANING" = "التنظيف";
+"Last cleaned: %@" = "آخر تنظيف: %@";
+"Home" = "الرئيسية";
+"Applications" = "التطبيقات";
+"Cleaning" = "التنظيف";
+"Installed Apps" = "التطبيقات المثبّتة";
+"Orphaned Files" = "الملفات اليتيمة";
+"Select a category from the sidebar to get started." = "اختر فئة من الشريط الجانبي للبدء.";
+
+/* Smart Scan */
+"Smart Scan" = "الفحص الذكي";
+"Click Scan to start" = "انقر على فحص للبدء";
+"Total" = "الإجمالي";
+"Used" = "المستخدمة";
+"Free" = "المتاحة";
+"Purgeable" = "قابلة للتحرير";
+"junk found" = "ملفات غير مرغوبة";
+"Your Mac is clean!" = "جهاز Mac نظيف!";
+"freed up" = "تم تحريرها";
+"Cleaning..." = "جارٍ التنظيف...";
+"Scanning..." = "جارٍ الفحص...";
+"%lld/%lld items" = "%lld/%lld عنصر";
+
+/* Category Detail */
+"All Clean!" = "كل شيء نظيف!";
+"No junk files found in this category." = "لا توجد ملفات غير مرغوبة في هذه الفئة.";
+"Not scanned yet" = "لم يتم الفحص بعد";
+"Click Scan to analyze this category" = "انقر على فحص لتحليل هذه الفئة";
+"%lld of %lld selected" = "%lld من %lld محدد";
+"Select All" = "تحديد الكل";
+"Deselect All" = "إلغاء تحديد الكل";
+"%lld items" = "%lld عنصر";
+
+/* Buttons */
+"Scan" = "فحص";
+"Re-scan" = "إعادة الفحص";
+"Scan Again" = "فحص مرة أخرى";
+"Done" = "تم";
+"Clean (%@)" = "تنظيف (%@)";
+"Clean %lld items (%@)" = "تنظيف %lld عنصر (%@)";
+
+/* Settings - Schedule */
+"Schedule" = "الجدولة";
+"Automatic Cleaning" = "التنظيف التلقائي";
+"Automatically scan and clean your Mac on a schedule" = "فحص جهاز Mac وتنظيفه تلقائيًا وفق جدول زمني";
+"Scan Interval" = "الفاصل الزمني للفحص";
+"Automation" = "الأتمتة";
+"Auto-clean after scan" = "التنظيف التلقائي بعد الفحص";
+"Minimum junk size to trigger clean:" = "الحد الأدنى لحجم الملفات لبدء التنظيف:";
+"50 MB" = "50 ميغابايت";
+"100 MB" = "100 ميغابايت";
+"250 MB" = "250 ميغابايت";
+"500 MB" = "500 ميغابايت";
+"1 GB" = "1 غيغابايت";
+"Auto-purge purgeable space" = "تحرير المساحة القابلة للإزالة تلقائيًا";
+"Show notification on completion" = "إظهار إشعار عند الانتهاء";
+"Status" = "الحالة";
+"Last run" = "آخر تشغيل";
+"Next run" = "التشغيل التالي";
+"Never" = "أبدًا";
+"Not scheduled" = "لم تُجدول";
+
+/* Settings - General */
+"General" = "عام";
+"App Behavior" = "سلوك التطبيق";
+"Launch at login" = "التشغيل عند تسجيل الدخول";
+"Show in Dock" = "إظهار في Dock";
+"Show menu bar icon" = "إظهار أيقونة في شريط القوائم";
+"Safety" = "الأمان";
+"PureMac will never delete system-critical files. Only caches, logs, temporary files, and user-selected items are removed." = "لن يحذف PureMac أبدًا ملفات النظام الأساسية. لا تُزال سوى ذاكرة التخزين المؤقت والسجلات والملفات المؤقتة والعناصر التي يحددها المستخدم.";
+
+/* Settings - About */
+"About" = "حول";
+"Version 1.0.0" = "الإصدار 1.0.0";
+"A free, open-source Mac cleaning utility.\nKeep your Mac fast, clean, and optimized." = "أداة مجانية ومفتوحة المصدر لتنظيف الـ Mac.\nحافظ على سرعة جهازك ونظافته وكفاءته.";
+"GitHub Repository" = "مستودع GitHub";
+"MIT License" = "رخصة MIT";
+
+/* Cleaning Categories */
+"System Junk" = "ملفات النظام غير المرغوبة";
+"User Cache" = "ذاكرة التخزين المؤقت للمستخدم";
+"AI Apps" = "تطبيقات الذكاء الاصطناعي";
+"Mail Files" = "ملفات البريد";
+"Trash Bins" = "سلة المهملات";
+"Large & Old Files" = "الملفات الكبيرة والقديمة";
+"Purgeable Space" = "المساحة القابلة للإزالة";
+"Xcode Junk" = "ملفات Xcode غير المرغوبة";
+"Brew Cache" = "ذاكرة التخزين المؤقت لـ Brew";
+
+/* Category Descriptions */
+"Scan everything at once" = "فحص كل شيء مرة واحدة";
+"System caches, logs, and temporary files" = "ذاكرة التخزين المؤقت للنظام والسجلات والملفات المؤقتة";
+"Application caches and browser data" = "ذاكرة التخزين المؤقت للتطبيقات وبيانات المتصفح";
+"Logs, caches, and temporary files from local AI apps" = "السجلات وذاكرة التخزين المؤقت والملفات المؤقتة لتطبيقات الذكاء الاصطناعي المحلية";
+"Downloaded mail attachments" = "مرفقات البريد التي تم تنزيلها";
+"Files in your Trash" = "الملفات الموجودة في سلة المهملات";
+"Files over 100 MB or older than 1 year" = "الملفات التي يزيد حجمها عن 100 ميغابايت أو الأقدم من سنة";
+"APFS purgeable disk space" = "مساحة القرص القابلة للإزالة في APFS";
+"Derived data, archives, and simulators" = "البيانات المشتقة والأرشيفات والمحاكيات";
+"Homebrew download cache" = "ذاكرة التخزين المؤقت لتنزيلات Homebrew";
+
+/* Schedule Intervals */
+"Every Hour" = "كل ساعة";
+"Every 3 Hours" = "كل 3 ساعات";
+"Every 6 Hours" = "كل 6 ساعات";
+"Every 12 Hours" = "كل 12 ساعة";
+"Daily" = "يوميًا";
+"Weekly" = "أسبوعيًا";
+"Every 2 Weeks" = "كل أسبوعين";
+"Monthly" = "شهريًا";
+
+/* Notifications */
+"Found %@ of junk files." = "تم العثور على %@ من الملفات غير المرغوبة.";
+
+/* Node Cache */
+"Node Cache" = "ذاكرة التخزين المؤقت لـ Node";
+"npm, yarn, and pnpm download caches" = "ذاكرة التخزين المؤقت لتنزيلات npm وyarn وpnpm";
+"npm cache" = "ذاكرة التخزين المؤقت لـ npm";
+"yarn classic cache" = "ذاكرة التخزين المؤقت لـ yarn الكلاسيكي";
+"pnpm content-addressable store" = "مخزن المحتوى المُعنوَن لـ pnpm";
+
+/* Docker Cache */
+"Docker Cache" = "ذاكرة التخزين المؤقت لـ Docker";
+"Docker images, containers, and build cache" = "صور Docker والحاويات وذاكرة التخزين المؤقت للبناء";
+"Reclaimable (run `docker system prune -af`)" = "قابلة للاسترداد (شغّل `docker system prune -af`)";
diff --git a/PureMac/en.lproj/Localizable.strings b/PureMac/en.lproj/Localizable.strings
index 37ee79e..d54fd1e 100644
--- a/PureMac/en.lproj/Localizable.strings
+++ b/PureMac/en.lproj/Localizable.strings
@@ -11,6 +11,12 @@
/* Sidebar */
"CLEANING" = "CLEANING";
"Last cleaned: %@" = "Last cleaned: %@";
+"Home" = "Home";
+"Applications" = "Applications";
+"Cleaning" = "Cleaning";
+"Installed Apps" = "Installed Apps";
+"Orphaned Files" = "Orphaned Files";
+"Select a category from the sidebar to get started." = "Select a category from the sidebar to get started.";
/* Smart Scan */
"Smart Scan" = "Smart Scan";
diff --git a/PureMac/es.lproj/Localizable.strings b/PureMac/es.lproj/Localizable.strings
index 03b7a56..b188f86 100644
--- a/PureMac/es.lproj/Localizable.strings
+++ b/PureMac/es.lproj/Localizable.strings
@@ -11,6 +11,12 @@
/* Sidebar */
"CLEANING" = "LIMPIEZA";
"Last cleaned: %@" = "Última limpieza: %@";
+"Home" = "Inicio";
+"Applications" = "Aplicaciones";
+"Cleaning" = "Limpieza";
+"Installed Apps" = "Apps instaladas";
+"Orphaned Files" = "Archivos huérfanos";
+"Select a category from the sidebar to get started." = "Selecciona una categoría en la barra lateral para comenzar.";
/* Smart Scan */
"Smart Scan" = "Análisis inteligente";
diff --git a/PureMac/ja.lproj/Localizable.strings b/PureMac/ja.lproj/Localizable.strings
index 7bf567c..23023af 100644
--- a/PureMac/ja.lproj/Localizable.strings
+++ b/PureMac/ja.lproj/Localizable.strings
@@ -11,6 +11,12 @@
/* Sidebar */
"CLEANING" = "クリーニング";
"Last cleaned: %@" = "最終クリーン: %@";
+"Home" = "ホーム";
+"Applications" = "アプリケーション";
+"Cleaning" = "クリーニング";
+"Installed Apps" = "インストール済みアプリ";
+"Orphaned Files" = "孤立ファイル";
+"Select a category from the sidebar to get started." = "サイドバーからカテゴリを選択して始めてください。";
/* Smart Scan */
"Smart Scan" = "スマートスキャン";
diff --git a/PureMac/zh-Hans.lproj/Localizable.strings b/PureMac/zh-Hans.lproj/Localizable.strings
index c9c030b..ad39d9e 100644
--- a/PureMac/zh-Hans.lproj/Localizable.strings
+++ b/PureMac/zh-Hans.lproj/Localizable.strings
@@ -11,6 +11,12 @@
/* Sidebar */
"CLEANING" = "清理";
"Last cleaned: %@" = "上次清理:%@";
+"Home" = "主页";
+"Applications" = "应用程序";
+"Cleaning" = "清理";
+"Installed Apps" = "已安装应用";
+"Orphaned Files" = "孤立文件";
+"Select a category from the sidebar to get started." = "从侧边栏选择一个类别开始。";
/* Smart Scan */
"Smart Scan" = "智能扫描";
diff --git a/PureMac/zh-Hant.lproj/Localizable.strings b/PureMac/zh-Hant.lproj/Localizable.strings
index d83665d..668be15 100644
--- a/PureMac/zh-Hant.lproj/Localizable.strings
+++ b/PureMac/zh-Hant.lproj/Localizable.strings
@@ -11,6 +11,12 @@
/* Sidebar */
"CLEANING" = "清理";
"Last cleaned: %@" = "上次清理:%@";
+"Home" = "首頁";
+"Applications" = "應用程式";
+"Cleaning" = "清理";
+"Installed Apps" = "已安裝應用程式";
+"Orphaned Files" = "孤立檔案";
+"Select a category from the sidebar to get started." = "從側邊欄選擇一個類別開始。";
/* Smart Scan */
"Smart Scan" = "智慧掃描";
diff --git a/README.md b/README.md
index eb9089e..5f996a4 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,7 @@
<p align="center">
<b>English</b> |
+ <a href="docs/README.ar.md">العربية</a> |
<a href="docs/README.es.md">Español</a> |
<a href="docs/README.ja.md">日本語</a> |
<a href="docs/README.zh-Hans.md">简体中文</a> |
diff --git a/docs/README.ar.md b/docs/README.ar.md
new file mode 100644
index 0000000..e9dff95
--- /dev/null
+++ b/docs/README.ar.md
@@ -0,0 +1,166 @@
+<p align="center">
+ <img src="../screenshot.png" alt="PureMac" width="700">
+</p>
+
+<p align="center">
+ <a href="../README.md">English</a> |
+ <b>العربية</b> |
+ <a href="README.es.md">Español</a> |
+ <a href="README.ja.md">日本語</a> |
+ <a href="README.zh-Hans.md">简体中文</a> |
+ <a href="README.zh-Hant.md">繁體中文</a>
+</p>
+
+<h1 align="center">PureMac</h1>
+
+<p align="center" dir="rtl">
+ <b>أداة مجانية ومفتوحة المصدر لإدارة التطبيقات وتنظيف النظام على macOS.</b><br>
+ إزالة التطبيقات بالكامل. العثور على الملفات اليتيمة. تنظيف ملفات النظام غير المرغوبة.<br>
+ بلا اشتراكات. بلا تتبع. بلا جمع بيانات.
+</p>
+
+<p align="center">
+ <a href="https://github.com/momenbasel/PureMac/releases/latest"><img src="https://img.shields.io/github/v/release/momenbasel/PureMac?style=flat-square&label=%D8%AA%D9%86%D8%B2%D9%8A%D9%84" alt="أحدث إصدار"></a>
+ <a href="https://github.com/momenbasel/PureMac/actions/workflows/build.yml"><img src="https://img.shields.io/github/actions/workflow/status/momenbasel/PureMac/build.yml?style=flat-square&label=Build" alt="حالة البناء"></a>
+ <img src="https://img.shields.io/badge/macOS-13.0+-blue?style=flat-square" alt="macOS 13.0+">
+ <img src="https://img.shields.io/badge/Swift-5.9-orange?style=flat-square" alt="Swift 5.9">
+ <a href="../LICENSE"><img src="https://img.shields.io/github/license/momenbasel/PureMac?style=flat-square" alt="رخصة MIT"></a>
+ <a href="https://github.com/momenbasel/PureMac/stargazers"><img src="https://img.shields.io/github/stars/momenbasel/PureMac?style=flat-square" alt="النجوم"></a>
+ <a href="https://github.com/momenbasel/PureMac/releases"><img src="https://img.shields.io/github/downloads/momenbasel/PureMac/total?style=flat-square&label=%D8%A7%D9%84%D8%AA%D9%86%D8%B2%D9%8A%D9%84%D8%A7%D8%AA" alt="التنزيلات"></a>
+</p>
+
+<p align="center">
+ <a href="#التثبيت">التثبيت</a> -
+ <a href="#الميزات">الميزات</a> -
+ <a href="#لقطات-الشاشة">لقطات الشاشة</a> -
+ <a href="#المساهمة">المساهمة</a>
+</p>
+
+---
+
+<div dir="rtl">
+
+## التثبيت
+
+### Homebrew (موصى به)
+
+```bash
+brew update
+brew install --cask puremac
+```
+
+### التنزيل المباشر
+
+نزّل أحدث ملف `.dmg` من صفحة [Releases](https://github.com/momenbasel/PureMac/releases/latest)، ثم افتحه واسحب PureMac إلى `/Applications`.
+
+> موقّع وموثّق باستخدام Apple Developer ID — يُثبَّت دون ظهور تحذيرات Gatekeeper.
+
+### البناء من الكود المصدري
+
+```bash
+brew install xcodegen
+git clone https://github.com/momenbasel/PureMac.git
+cd PureMac
+xcodegen generate
+xcodebuild -project PureMac.xcodeproj -scheme PureMac -configuration Release -derivedDataPath build build
+open build/Build/Products/Release/PureMac.app
+```
+
+## الميزات
+
+### أداة إزالة التطبيقات
+- اكتشاف جميع التطبيقات المثبّتة في `/Applications` و `~/Applications`
+- محرّك اكتشاف ملفات اعتمادي يقوم على **المطابقة بعشرة مستويات** (مُعرِّف الحزمة، اسم الشركة، الـ entitlements، مُعرِّف الفريق، بيانات Spotlight الوصفية، اكتشاف الحاويات)
+- **ثلاث مستويات حساسية**: Strict (آمن) و Enhanced (متوازن) و Deep (شامل)
+- عرض جميع الملفات المرتبطة: ذاكرة التخزين المؤقت، والتفضيلات، والحاويات، والسجلات، وملفات الدعم، ووكلاء التشغيل
+- حماية تطبيقات النظام — يُستبعَد 27 تطبيقًا من Apple من قائمة الإزالة
+- عرض رئيسي/تفصيلي: جدول التطبيقات على اليمين، والملفات المكتشفة على اليسار
+
+### العثور على الملفات اليتيمة
+- اكتشاف الملفات المتبقية في `~/Library` من تطبيقات سبق إزالتها
+- مقارنة محتوى الـ Library بمُعرِّفات جميع التطبيقات المثبّتة
+- تنظيف الملفات اليتيمة بنقرة واحدة
+
+### تنظيف النظام
+- **الفحص الذكي** — فحص بنقرة واحدة لجميع الفئات
+- **ملفات النظام غير المرغوبة** — ذاكرة التخزين المؤقت للنظام والسجلات والملفات المؤقتة
+- **ذاكرة التخزين المؤقت للمستخدم** — اكتشاف ديناميكي لذاكرة التخزين المؤقت لكل التطبيقات (دون قوائم مكتوبة مسبقًا)
+- **مرفقات البريد** — مرفقات البريد التي تم تنزيلها
+- **سلة المهملات** — تفريغ كل سلال المهملات
+- **الملفات الكبيرة والقديمة** — ملفات يزيد حجمها عن 100 ميغابايت أو أقدم من سنة
+- **المساحة القابلة للإزالة** — اكتشاف المساحة القابلة للإزالة في APFS
+- **ملفات Xcode غير المرغوبة** — DerivedData والأرشيفات وذاكرة التخزين المؤقت للمحاكيات
+- **ذاكرة التخزين المؤقت لـ Brew** — ذاكرة تنزيلات Homebrew (مع دعم HOMEBREW_CACHE مخصص)
+- **التنظيف المجدوَل** — فحص تلقائي وفق فترات قابلة للتخصيص
+
+### تجربة أصيلة في macOS
+- مبنيّ على SwiftUI باستخدام مكوّنات macOS الأصلية
+- `NavigationSplitView` و `Toggle` و `ProgressView` و `Form` و `GroupBox` و `Table`
+- يتبع المظهر الفاتح/الداكن للنظام تلقائيًا
+- دون تدرّجات لونية مخصصة أو أساليب ويب دخيلة
+- إعداد تمهيدي عند أول تشغيل يشمل ضبط الوصول الكامل إلى القرص
+
+### الأمان
+- تأكيد قبل كل عملية حذف حاسمة
+- حماية من هجمات الروابط الرمزية — يتم حل المسارات والتحقق منها قبل الحذف
+- حماية تطبيقات النظام — لا يمكن إزالة تطبيقات Apple
+- لا يتم تحديد الملفات الكبيرة والقديمة تلقائيًا
+- تسجيل منظّم عبر `os.log` (يظهر في تطبيق "وحدة التحكم")
+
+</div>
+
+## لقطات الشاشة
+
+| الإعداد التمهيدي | أداة إزالة التطبيقات |
+|---|---|
+| ![الإعداد التمهيدي](../screenshots/onboarding.png) | ![أداة إزالة التطبيقات](../screenshots/app-uninstaller.png) |
+
+| ملفات النظام غير المرغوبة | ملفات Xcode غير المرغوبة |
+|---|---|
+| ![ملفات النظام غير المرغوبة](../screenshots/system-junk.png) | ![ملفات Xcode غير المرغوبة](../screenshots/xcode-junk.png) |
+
+| ذاكرة التخزين المؤقت للمستخدم |
+|---|
+| ![ذاكرة التخزين المؤقت للمستخدم](../screenshots/user-cache.png) |
+
+<div dir="rtl">
+
+## البنية المعمارية
+
+```
+PureMac/
+ Logic/Scanning/ - محرّك الفحص الاعتمادي وقاعدة المواقع والشروط
+ Logic/Utilities/ - التسجيل المنظّم
+ Models/ - نماذج البيانات والأخطاء المُنمّطة
+ Services/ - محرّك الفحص ومحرّك التنظيف والمجدوِل
+ ViewModels/ - حالة التطبيق المركزية
+ Views/ - واجهات SwiftUI الأصلية
+ Apps/ - واجهات أداة إزالة التطبيقات
+ Cleaning/ - الفحص الذكي وواجهات الفئات
+ Orphans/ - أداة الملفات اليتيمة
+ Settings/ - إعدادات قائمة على Form الأصلي
+ Components/ - مكوّنات مشتركة
+```
+
+المكوّنات الأساسية:
+- **AppPathFinder** — محرّك مطابقة اعتمادي بعشرة مستويات لاكتشاف ملفات التطبيقات
+- **Locations** — أكثر من 120 مسارًا للبحث في نظام ملفات macOS
+- **Conditions** — 25 قاعدة مطابقة خاصة بتطبيقات بعينها للحالات الاستثنائية (Xcode وChrome وVS Code وغيرها)
+- **AppInfoFetcher** — بيانات Spotlight الوصفية مع اعتماد Info.plist بديلًا لاكتشاف التطبيقات
+- **Logger** — تسجيل موحّد عبر `os.log` من Apple
+
+## المساهمة
+
+المساهمات مرحّب بها. راجع [CONTRIBUTING.md](../CONTRIBUTING.md) للاطلاع على الإرشادات.
+
+المجالات التي تحظى بترحيب خاص:
+- إعدادات جاهزة لفلاتر الحجم والتاريخ في واجهات الفئات
+- تغطية باستخدام XCTest لـ AppState ومحرّك الفحص
+- الترجمة إلى لغات إضافية
+- تصميم أيقونة التطبيق
+
+## الرخصة
+
+رخصة MIT. راجع [LICENSE](../LICENSE) للتفاصيل.
+
+</div>
diff --git a/docs/README.es.md b/docs/README.es.md
index 64bf643..197ed0b 100644
--- a/docs/README.es.md
+++ b/docs/README.es.md
@@ -4,6 +4,7 @@
<p align="center">
<a href="../README.md">English</a> |
+ <a href="README.ar.md">العربية</a> |
<b>Español</b> |
<a href="README.ja.md">日本語</a> |
<a href="README.zh-Hans.md">简体中文</a> |
diff --git a/docs/README.ja.md b/docs/README.ja.md
index 954a5c1..e8f8003 100644
--- a/docs/README.ja.md
+++ b/docs/README.ja.md
@@ -4,6 +4,7 @@
<p align="center">
<a href="../README.md">English</a> |
+ <a href="README.ar.md">العربية</a> |
<a href="README.es.md">Español</a> |
<b>日本語</b> |
<a href="README.zh-Hans.md">简体中文</a> |
diff --git a/docs/README.zh-Hans.md b/docs/README.zh-Hans.md
index 109fde1..eb04407 100644
--- a/docs/README.zh-Hans.md
+++ b/docs/README.zh-Hans.md
@@ -4,6 +4,7 @@
<p align="center">
<a href="../README.md">English</a> |
+ <a href="README.ar.md">العربية</a> |
<a href="README.es.md">Español</a> |
<a href="README.ja.md">日本語</a> |
<b>简体中文</b> |
diff --git a/docs/README.zh-Hant.md b/docs/README.zh-Hant.md
index b3f0962..2361210 100644
--- a/docs/README.zh-Hant.md
+++ b/docs/README.zh-Hant.md
@@ -4,6 +4,7 @@
<p align="center">
<a href="../README.md">English</a> |
+ <a href="README.ar.md">العربية</a> |
<a href="README.es.md">Español</a> |
<a href="README.ja.md">日本語</a> |
<a href="README.zh-Hans.md">简体中文</a> |