مرجع الأوامر

نظرة عامة

iconchanger <command> [options]

الأوامر

status

عرض حالة الإعدادات الحالية.

iconchanger status

يعرض:

• عدد الأسماء البديلة المُهيّأة للتطبيقات
• عدد الأيقونات المخزنة مؤقتًا
• حالة البرنامج المساعد

list

عرض قائمة بجميع الأسماء البديلة والأيقونات المخزنة مؤقتًا.

iconchanger list

يعرض جدولًا بجميع الأسماء البديلة المُهيّأة وجميع إدخالات الأيقونات المخزنة مؤقتًا.

set-icon

تعيين أيقونة مخصصة لتطبيق.

iconchanger set-icon <app-path> <image-path>

المعاملات:

• app-path — مسار التطبيق (مثل /Applications/Safari.app)
• image-path — مسار صورة الأيقونة (PNG، JPEG، ICNS، إلخ.)

أمثلة:

# تعيين أيقونة مخصصة لـ Safari
iconchanger set-icon /Applications/Safari.app ~/icons/safari.png

# المسارات النسبية تعمل أيضًا
iconchanger set-icon /Applications/Slack.app ./slack-icon.icns

remove-icon

إزالة أيقونة مخصصة واستعادة الأيقونة الأصلية.

iconchanger remove-icon <app-path>

مثال:

iconchanger remove-icon /Applications/Safari.app

restore

استعادة جميع الأيقونات المخصصة المخزنة مؤقتًا. مفيد بعد تحديث النظام أو عندما تُعيد التطبيقات تعيين أيقوناتها.

iconchanger restore [options]

الخيارات:

• --dry-run — معاينة ما سيتم استعادته دون إجراء تغييرات
• --verbose — عرض مخرجات مفصلة لكل أيقونة
• --force — الاستعادة حتى لو بدت الأيقونة دون تغيير

أمثلة:

# استعادة جميع الأيقونات المخزنة مؤقتًا
iconchanger restore

# معاينة ما سيحدث
iconchanger restore --dry-run --verbose

# فرض استعادة كل شيء
iconchanger restore --force

export

تصدير الأسماء البديلة وإعدادات الأيقونات المخزنة مؤقتًا إلى ملف JSON.

iconchanger export <output-path>

مثال:

iconchanger export ~/Desktop/my-icons.json

import

استيراد ملف إعدادات.

iconchanger import <input-path>

الاستيراد يضيف عناصر جديدة فقط — لا يستبدل أو يزيل الإدخالات الموجودة.

مثال:

iconchanger import ~/Desktop/my-icons.json

validate

التحقق من صحة ملف إعدادات قبل الاستيراد.

iconchanger validate <file-path>

يتحقق من بنية JSON والحقول المطلوبة وسلامة البيانات دون إجراء تغييرات.

مثال:

iconchanger validate ~/Desktop/my-icons.json

escape-jail

الخروج من سجن squircle في macOS Tahoe بإعادة تطبيق الأيقونات المضمّنة كأيقونات مخصصة. الأيقونات المخصصة تتجاوز فرض squircle، مما يحافظ على شكل الأيقونة الأصلي.

iconchanger escape-jail [app-path] [options]

المعاملات:

• app-path — (اختياري) مسار حزمة .app محددة. إذا لم يُحدد، تتم معالجة جميع التطبيقات في /Applications.

الخيارات:

• --dry-run — معاينة ما سيتم تنفيذه دون إجراء تغييرات
• --verbose — عرض مخرجات مفصلة

أمثلة:

# الخروج من السجن لجميع التطبيقات في /Applications
iconchanger escape-jail

# معاينة ما سيحدث
iconchanger escape-jail --dry-run --verbose

# الخروج من السجن لتطبيق محدد
iconchanger escape-jail /Applications/Safari.app

::: warning الأيقونات المخصصة لا تدعم أوضاع Clear أو Tinted أو Dark في macOS Tahoe. تبقى كصور نقطية ثابتة. :::

completions

توليد سكربتات إكمال الأوامر للصدفة لدعم الإكمال بالضغط على Tab.

iconchanger completions <shell>

المعاملات:

• shell — نوع الصدفة: zsh أو bash أو fish

أمثلة:

# Zsh (أضف إلى ~/.zshrc)
source <(iconchanger completions zsh)

# Bash (أضف إلى ~/.bashrc)
source <(iconchanger completions bash)

# Fish
iconchanger completions fish > ~/.config/fish/completions/iconchanger.fish