CmdVault — مخزن الأوامر البرمجية / Command Line Vault

العربية | English

---

العربية

مخزن الأوامر البرمجية CmdVault — أداة ويب ذات مظهر برمجي متقدم لتخزين وتنظيم ومزامنة أسطر الأوامر البرمجية الخاصة بك بأمان وسهولة.

تم تصميم CmdVault ليكون الخيار الأمثل للمطورين ومدراء الأنظمة لحفظ أسطر الأوامر الأكثر استخداماً والوصول إليها فورياً. بفضل تصميمه الأنيق المستوحى من بيئات المطورين ودعمه للمظهر الداكن واللمسات المضيئة (Neon Coder Aesthetic)، يساعدك CmdVault على الاحتفاظ بإنتاجيتك دون الحاجة لتذكر الأوامر المعقدة.

---

🌟 المميزات الرئيسية

1. خيارات تخزين مرنة ومتعددة:

   • تخزين المتصفح (localStorage): خيار خادم خفي (Serverless) لحفظ البيانات محلياً داخل متصفحك مباشرة بشكل سريع وآمن.
   • ملف JSON (عبر خادم PHP): تخزين البيانات في ملف .json محلي على خادم الاستضافة الخاص بك مع إمكانية تحديد مسار مجلد مخصص وتحديثه من الإعدادات.
   • مزامنة ووردبريس (WordPress API Sync): خيار مزامنة البيانات عبر قواعد بيانات موقع ووردبريس الخاص بك باستخدام إضافة CmdVault API Plugin المتوفرة على GitHub، والتي تدعم الاتصال الآمن والمصادقة المتقدمة.

2. تنظيم متقدم متعدد الأبعاد:

   • المجلدات (Folders): لتصنيف وتوزيع الأوامر على مشاريع أو بيئات تشغيل مختلفة.
   • التصنيفات (Categories): تصنيف الأوامر بالألوان المخصصة لتسهيل التعرف البصري عليها.
   • الوسوم (Tags): لإضافة وسوم مرنة وقابلة لإعادة التسمية والبحث السريع.

3. لوحة تحكم تفاعلية ذكية:

   • الأوامر المثبتة (Pinned Commands): لتثبيت الأوامر الأكثر استخداماً في أعلى لوحة التحكم للوصول السريع بضغطة زر.
   • الأوامر الأخيرة (Recent Commands): قسم ذكي لتتبع الأوامر المضافة أو المستخدمة حديثاً.
   • نسخ فوري (Quick Copy): زر نسخ فوري للأوامر مع مؤثرات بصرية تفاعلية تفيد بنجاح عملية النسخ للحافظة.

4. اختصارات لوحة المفاتيح والـ HUD:

   • البحث الفوري: شريط بحث ذكي وفعال للوصول للأوامر باستخدام الاختصار Ctrl + K.
   • الاختصارات العالمية (Global Keybinds): إمكانية تعيين اختصار لوحة مفاتيح مخصص لكل أمر لنسخه مباشرة في أي وقت دون فتح النافذة، مع ظهور إشعار HUD تفاعلي يؤكد إتمام العملية.

5. نقل وتصدير البيانات بسلاسة:

   • الترقية التلقائية (Data Migration): إمكانية نقل كافة بياناتك وأوامرك المحفوظة تلقائياً عند التبديل بين أنواع التخزين المختلفة (مثال: نقل من تخزين المتصفح إلى مزامنة ووردبريس).
   • التصدير والاستيراد: إمكانية تصدير كامل بيانات الأداة إلى ملف .json خارجي واستيراده في أي وقت لحفظ نسخ احتياطية.

6. تخصيص كامل وواجهة ثنائية اللغة:

   • واجهة مستخدم متكاملة تدعم اللغتين العربية والإنجليزية مع ضبط كامل لاتجاه النصوص والمحاذاة (LTR / RTL).
   • تخصيص الخطوط وأحجامها لتناسب راحتك البصرية أثناء البرمجة.

---

🔗 روابط هامة

• 🌐 الموقع الرسمي لـ CmdVault: https://cmdvault.shjrh.clooud/
• 🛠️ لاستخدام الأداة مباشرة: https://cmdvault.shjrh.clooud/tool
• 📢 للمزيد من المعلومات والتحديثات: https://ih4xz.pro/projects/cmdvault/

---

🚀 التثبيت والتشغيل

1. التشغيل المحلي أو عبر الاستضافة (أداة الويب الرئيسية)

للوصول للأداة أو تثبيتها على خادم الويب الخاص بك:

1. قم برفع ملفات المشروع إلى خادم الويب الخاص بك (يدعم خوادم الويب مثل Apache أو Nginx).
2. تأكد من توفر بيئة PHP 7.0+ لتتمكن من استخدام خيار التخزين عبر ملف JSON (api.php).
3. قم بتهيئة صلاحيات الكتابة والقراءة لمجلد البيانات (data/) لكي يتمكن السكربت من حفظ ملف commands.json وتعديله.

2. تهيئة مزامنة ووردبريس (إضافة المزامنة الخلفية)

لتفعيل خيار التخزين السحابي الآمن عبر ووردبريس:

1. قم بتحميل إضافة ووردبريس من مستودع GitHub المخصص: CmdVault-WP.
2. قم برفع إضافة ووردبريس وتفعيلها على موقعك.
3. قم بإنشاء "كلمة مرور تطبيق" (Application Password) لحساب المستخدم الخاص بك في لوحة تحكم ووردبريس.
4. من إعدادات CmdVault، اختر نوع التخزين WordPress API وأدخل بيانات الرابط والمستخدم والمصادقة للبدء في مزامنة وحفظ الأوامر بأمان داخل قاعدة بيانات موقعك.

---

English

CmdVault — A sleek, coder-aesthetic command line manager designed to help developers and system administrators store, organize, and quick-copy CLI commands securely and efficiently.

With its terminal-inspired dark design, neon accent highlights, and robust features, CmdVault ensures you never lose a complex Docker, Git, or Kubernetes command line again. Keep your workflow uninterrupted by syncing, searching, and managing your commands directly.

---

🌟 Key Features

1. Hybrid Storage Backends:

   • Browser Storage (localStorage): Fully serverless, fast option to keep your database locally in your browser.
   • JSON File Storage (via PHP): Store commands on your own server in a standard .json format using a simple backend API (api.php), with folder configurations modifiable in settings.
   • WordPress API Sync: Connect securely to your WordPress site via our custom companion plugin CmdVault API Plugin on GitHub to store and sync commands directly in your database.

2. Hierarchical Organization:

   • Folders: Keep different projects, servers, or deployment environments logically separated.
   • Categories: Group commands using customizable color tags for visual ease.
   • Tags: Apply searchable labels to commands, with renaming and removal utilities.

3. Interactive & High-Performance Dashboard:

   • ⚡ Pinned Commands: Highlight your top commands at the head of your dashboard.
   • 🕐 Recent Commands: Automatically log and access your most recently added or updated commands.
   • Quick Copy: Click to copy any command line with visual clipboard confirmation feedback and success notifications.

4. Advanced Hotkeys & HUD Notification:

   • Fuzzy Search: Filter through title, command line, description, or tags with a quick-focus shortcut (Ctrl + K).
   • Custom Keybinds: Set global shortcuts (e.g., Ctrl+Shift+D) for individual commands. Copy them instantly without leaving your terminal, accompanied by a dynamic HUD overlay confirming the copy.

5. Seamless Migration & Portability:

   • Automatic Migration: Swap storage backends directly from Settings and let CmdVault automatically transfer your commands, folders, and categories.
   • Backup & Restore: Export your data as a clean JSON file, or import it to easily seed another client or restore a backup.

6. Customizable & Fully Bilingual UI:

   • Supports both Arabic and English with dedicated layout direction shifting (LTR / RTL).
   • Adjustable code font styles and typography sizes for maximum readability.

---

🔗 Important Links

• 🌐 Official CmdVault Site: https://cmdvault.shjrh.clooud/
• 🛠️ To Use The Tool Directly: https://cmdvault.shjrh.clooud/tool
• 📢 Information & Updates: https://ih4xz.pro/projects/cmdvault/

---

🚀 Installation & Setup

1. Web / Self-Host Deployment (Main Web Tool)

To run CmdVault on your own local server or cloud hosting:

1. Clone or upload the repository files to your web server (compatible with Apache, Nginx, IIS, etc.).
2. Ensure you are running PHP 7.0+ to support local file operations via api.php.
3. Set appropriate write/read permissions on the data/ directory so the PHP backend can generate and write to commands.json.

2. WordPress Synchronization Setup (Backend REST API Connector)

To enable server database sync with WordPress:

1. Download the WordPress plugin from its dedicated GitHub repository: CmdVault-WP.
2. Upload the plugin directory to your WordPress site and activate it.
3. Generate an "Application Password" for your administrator/editor account in the WordPress dashboard.
4. Open the CmdVault settings, switch the storage type to WordPress API, input your WordPress URL and credentials, and enjoy instant, secure database syncing.

---

📄 License / الترخيص

This project is open-source software licensed under the GNU GPL v3 License. For full terms, please inspect the LICENSE file in the root of the project.

هذا المشروع مفتوح المصدر ومحمي بموجب رخصة GNU GPL v3. للاطلاع على كامل الشروط والأحكام، يرجى مراجعة ملف الترخيص في المجلد الرئيسي للمشروع.