# Arroxy — محمّل يوتيوب (+ 2000 موقع) مجاني ومفتوح المصدر لـ Windows وmacOS وLinux
**4K · 1080p60 · HDR · Surround/Dolby audio · Playlists · MP3 · Shorts · Music · Channels · Subtitles · SponsorBlock · +2000 sites**
**اقرأ بـ:** [Afaan Oromoo](README.om.md) · [Bahasa Indonesia](README.id.md) · [Deutsch](README.de.md) · [English](README.md) · [Español](README.es.md) · [Français](README.fr.md) · [Italiano](README.it.md) · [Kiswahili](README.sw.md) · [O'zbekcha](README.uz.md) · [Polski](README.pl.md) · [Português](README.pt.md) · [Tiếng Việt](README.vi.md) · [Türkçe](README.tr.md) · [አማርኛ](README.am.md) · **العربية** · [اردو](README.ur.md) · [پښتو](README.ps.md) · [فارسی](README.fa.md) · [বাংলা](README.bn.md) · [हिन्दी](README.hi.md) · [ไทย](README.th.md) · [မြန်မာဘာသာ](README.my.md) · [Ελληνικά](README.el.md) · [Русский](README.ru.md) · [Српски](README.sr.md) · [Українська](README.uk.md) · [中文](README.zh.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [繁體中文](README.zh-Hant.md)
[](https://github.com/antonio-orionus/Arroxy/releases/latest) [](https://github.com/antonio-orionus/Arroxy/actions/workflows/release.yml) [](https://orionus.dev/arroxy/)   
نزِّل مقاطع الفيديو وShorts والموسيقى والقنوات والبودكاست والمقاطع الصوتية من **يوتيوب وأكثر من 2000 موقع مدعوم** — حتى 4K HDR بـ 60 إطاراً في الثانية، أو بصيغ MP3 / AAC / Opus. يعمل محلياً على Windows وmacOS وLinux. **لا إعلانات، لا حشو، لا عروض ترويجية.**
[**↓ تنزيل أحدث إصدار**](#install) · [**الموقع الإلكتروني**](https://orionus.dev/arroxy/) · [التشغيل الأول على Windows](#windows-first-launch) · [التشغيل الأول على macOS](#macos-first-launch) · [التشغيل الأول على Linux](#linux-first-launch)
[](https://discord.gg/ueGvXwQH8y)
إذا وفّر لك Arroxy الوقت، فإن ⭐ يساعد الآخرين على اكتشافه.
> **What is Arroxy?** Arroxy is a free, open-source desktop GUI that downloads videos, audio, playlists, and subtitles from YouTube and 2000+ other [yt-dlp](https://github.com/yt-dlp/yt-dlp)-supported sites. It runs on Windows 10/11, macOS 11+ (Intel + Apple Silicon), and Linux (AppImage, Flatpak, tar.gz). MIT licensed. No account, no ads, no usage limits. Distributed via [Winget](https://winget.run/pkg/AntonioOrionus/Arroxy), [Scoop](https://github.com/antonio-orionus/scoop-bucket), [Homebrew Cask](https://github.com/antonio-orionus/homebrew-arroxy), Flatpak, AppImage, and direct download.
>
> _Last updated: 2026-10-11._
---
## المحتويات
- [التثبيت والتشغيل الأول](#install)
- [التشغيل الأول على Windows](#windows-first-launch)
- [التشغيل الأول على macOS](#macos-first-launch)
- [لماذا قد تظهر لك تحذيرات](#why-warning)
- [التشغيل الأول على Linux](#linux-first-launch)
- [التحقق من تنزيلك (SHA256)](#verify)
- [لماذا Arroxy](#why)
- [الميزات](#features)
- [الخصوصية](#privacy)
- [الأسئلة الشائعة](#faq)
- [خارطة الطريق](#roadmap)
- [ادعم Arroxy](#support)
- [مبني باستخدام](#tech)
---
## التثبيت والتشغيل الأول
**Windows**
```bash
winget install AntonioOrionus.Arroxy
```
**macOS**
```bash
brew install --cask antonio-orionus/arroxy/arroxy
```
**Linux**
AppImage:
```bash
curl -fsSL https://raw.githubusercontent.com/antonio-orionus/Arroxy/main/scripts/install.sh | sh
```
Flatpak:
```bash
curl -fsSL https://raw.githubusercontent.com/antonio-orionus/Arroxy/main/scripts/install.sh | sh -s -- --flatpak
```
الإصدارات متاحة لمعمارية x86_64 فقط. لا يوجد `curl`؟ استبدل `curl -fsSL` بـ `wget -qO-`.
| النظام | الصيغة |
| --- | --- |
| Windows | [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-win-x64-Setup.exe) [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-win-x64-Portable.exe) |
| macOS | [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-mac-arm64.dmg) [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-mac-x64.dmg) |
| Linux | [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-linux-x64.AppImage) [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-linux-x64.flatpak) [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/Arroxy-linux-x64.tar.gz) |
| Verify | [](https://github.com/antonio-orionus/Arroxy/releases/latest/download/SHA256SUMS) |
[**احصل على أحدث إصدار →**](https://github.com/antonio-orionus/Arroxy/releases/latest)
### التشغيل الأول على Windows
عند التشغيل الأول قد تظهر **"Windows protected your PC"** أو **"Unknown publisher."** ينطبق هذا على كلٍّ من `Arroxy-win-x64-Setup.exe` و`Arroxy-win-x64-Portable.exe`. Arroxy مجاني ومفتوح المصدر وإصدارات Windows غير موقَّعة بشهادة مدفوعة، لذا يُعلِّمها SmartScreen. هذا **لا** يعني تلقائياً أن Arroxy غير آمن. للمتابعة:
1. انقر **More info**.
2. انقر **Run anyway**.
#### إذا علّم Windows Defender الملف أو أزاله
أحياناً تُعلِّم خوارزميات Defender التجريبية مثبّتات NSIS غير الموقَّعة وNSIS Electron المحمولة باعتبارها مشبوهة. إذا عزل Defender ملف `Arroxy-win-x64-Setup.exe` أو `Arroxy-win-x64-Portable.exe`، فاستعده من **Windows Security → Virus & threat protection → Protection history**، ثم أضف ملف Arroxy التنفيذي كعنصر مسموح به ضمن **Manage settings → Add or remove exclusions**. كما هو الحال مع SmartScreen، السبب هو غياب توقيع الناشر لا وجود برنامج خبيث.
> حمِّل Arroxy من صفحة GitHub Releases الرسمية فقط. إذا حصلت على الملف من موقع آخر أو أرسله إليك أحد، احذفه وحمِّل نسخة جديدة من المصدر الرسمي. الكود المصدري عام ويمكنك مراجعته أو بناء Arroxy بنفسك إن أردت.
تفضّل Scoop؟ `scoop bucket add arroxy https://github.com/antonio-orionus/scoop-bucket && scoop install arroxy`
### التشغيل الأول على macOS
Arroxy غير موقَّع رمزياً لـ macOS بعد، لذلك قد يعرض Gatekeeper الرسالة المخيفة *"Arroxy.app is damaged and can't be opened"* بعد تثبيته من DMG. تعني هذه الرسالة أن macOS وضع تطبيقاً غير موقَّع في quarantine؛ ولا تعني أن ملفات التطبيق تالفة فعلاً. على macOS الحالي، الإصلاح الموثوق هو Terminal:
1. اسحب `Arroxy.app` من DMG المثبَّت إلى `/Applications`.
2. افتح Terminal وشغّل هذين الأمرين:
```bash
xattr -dr com.apple.quarantine /Applications/Arroxy.app
open /Applications/Arroxy.app
```
الأمر الأول يزيل سمة quarantine من نسخة Arroxy المثبّتة لديك. الأمر الثاني يشغّل التطبيق. قد يطلب `sudo` كلمة مرور Mac؛ ولن يعرض Terminal أي أحرف أثناء كتابتها.
**Apple Silicon مقابل Intel:** على Mac من سلسلة M (M1 / M2 / M3 / M4)، نزِّل DMG الإصدار `arm64`. على أجهزة Intel، نزِّل DMG الإصدار `x64`. تشغيل الإصدار الخاطئ يعمل عبر Rosetta لكنه أبطأ بشكل ملحوظ.
> تُنتَج إصدارات macOS عبر CI على أجهزة Apple Silicon وIntel. إذا واجهت مشاكل، يرجى [فتح تقرير](../../issues) — تعليقات مستخدمي macOS تُشكِّل دورة الاختبار بفاعلية.
### لماذا قد تظهر لك تحذيرات
Arroxy مفتوح المصدر ومرخَّص بـ MIT. إصدارات Windows وmacOS **غير موقَّعة رمزياً** — شهادات Apple Developer ID وWindows EV للتوقيع الرمزي تكلّف كل منها مئات الدولارات سنوياً، وهو ما يتحمّله المشروع المستقل من جيبه. وبدون تلك التوقيعات، سيحذّرك Windows SmartScreen وmacOS Gatekeeper عند الإطلاق الأول. تعني هذه التحذيرات *أن نظام تشغيلك لا يتعرّف على الناشر* — ولا تعني أن Arroxy برنامج خبيث.
ثلاث طرق للتحقق من Arroxy بنفسك، بترتيب متصاعد من الصرامة:
- **اقرأ الكود المصدري.** كل سطر موجود على [GitHub](https://github.com/antonio-orionus/Arroxy) ويمكنك [بناؤه من المصدر](#tech).
- **تحقق من SHA256.** طابق ملفك مع [`SHA256SUMS`](../../releases/latest) المنشور — راجع [التحقق من تنزيلك](#verify) أدناه.
- **أجرِ فحصاً بطرف ثالث.** ارفع الملف إلى [VirusTotal](https://www.virustotal.com).
### التشغيل الأول على Linux
تعمل AppImages مباشرة — دون تثبيت. تحتاج فقط إلى تعيين الملف كقابل للتنفيذ.
**مدير الملفات:** انقر بزر الأيمن على `.AppImage` ← **خصائص** ← **أذونات** ← مكِّن **السماح بتنفيذ الملف كبرنامج**، ثم انقر نقراً مزدوجاً.
**Terminal:**
```bash
chmod +x Arroxy-linux-x64.AppImage
./Arroxy-linux-x64.AppImage
```
إذا فشل التشغيل بعد ذلك، شغّله دون تركيب — لا حاجة إلى حزمة FUSE:
```bash
./Arroxy-linux-x64.AppImage --appimage-extract-and-run
```
**تكامل سطح المكتب الاختياري:** ثبِّت [AppImageLauncher](https://github.com/TheAssassin/AppImageLauncher) مرة واحدة، وأي AppImage تنقر عليه نقراً مزدوجاً سيُسجَّل تلقائياً في قائمة تطبيقاتك — دون الحاجة إلى إنشاء ملف `.desktop` يدوياً.
**أرشيف عادي (بدون FUSE، بدون تثبيت):**
إصدار `.tar.gz` هو التطبيق نفسه بدون غلاف AppImage — فك ضغطه في أي مكان وشغّله. بلا مثبِّت وبلا حزمة FUSE.
```bash
tar xzf Arroxy-linux-x64.tar.gz
./Arroxy-linux-x64/arroxy
```
**تنزيلات لينكس في صفحة الإصدارات متاحة لمعمارية x86_64 فقط.** على أجهزة ARM64 (Raspberry Pi، Asahi Linux) يُثبَّت Flatpak لكنه يفشل عند التشغيل برسالة `bwrap: execvp ldconfig: Exec format error`.
التحقق من تنزيلك (SHA256)
يُنشر مع كل إصدار ملف `SHA256SUMS` إلى جانب الملفات الثنائية. للتحقق من عدم تلف تنزيلك أو العبث به أثناء النقل، احسب هاش ملفك محلياً وطابقه مع السطر المقابل في `SHA256SUMS`. افتح صفحة الإصدار الأخير → **Assets** → نزِّل `SHA256SUMS`.
**Windows (PowerShell أو Command Prompt):**
```powershell
certutil -hashfile Arroxy-win-x64-Setup.exe SHA256
```
**macOS (Terminal):**
```bash
shasum -a 256 Arroxy-mac-arm64.dmg
```
**Linux (Terminal):**
```bash
sha256sum Arroxy-linux-x64.AppImage
```
تريد فحصاً لبرامج الخبيثة من طرف ثالث؟ ارفع الملف على [VirusTotal](https://www.virustotal.com). بضع إشارات هيوريستية عامة من محركات صغيرة أمر طبيعي لتطبيقات Electron غير الموقَّعة؛ أما الكشف الواسع من محركات رئيسية فيكون مدعاة قلق حقيقية.
Windows: المثبِّت مقابل المحمول
| | NSIS Installer | Portable `.exe` |
| ------------- | :----------------------: | :---------------------: |
| يتطلب التثبيت | نعم | لا — يعمل من أي مكان |
| التحديث التلقائي | ✅ داخل التطبيق | ❌ تنزيل يدوي |
| سرعة التشغيل | ✅ أسرع | ⚠️ بداية باردة أبطأ |
| يُضاف إلى قائمة ابدأ | ✅ | ❌ |
| سهولة إلغاء التثبيت | ✅ | ❌ احذف الملف |
**التوصية:** استخدم مثبِّت NSIS للتحديثات التلقائية والتشغيل الأسرع. استخدم `.exe` المحمول لخيار بدون تثبيت وبدون سجل.
---
## لماذا Arroxy
مقارنة جنباً إلى جنب مع أكثر البدائل شيوعاً:
| | Arroxy | 4K Video Downloader | JDownloader | Y2Mate / online converters | Browser extensions |
| ---------- | :----: | :-----------------: | :---------: | :------------------------: | :----------------: |
| مجاني، بدون مستوى مميز | ✅ | ⚠️ | ✅ | ⚠️ | ⚠️ |
| مفتوح المصدر | ✅ | ❌ | ❌ | ❌ | ⚠️ |
| معالجة محلية فقط | ✅ | ✅ | ✅ | ❌ | ✅ |
| لا تسجيل دخول ولا تصدير كوكيز | ✅ | ⚠️ | ⚠️ | ⚠️ | ✅ |
| لا حدود للاستخدام | ✅ | ⚠️ | ✅ | 🚫 | ⚠️ |
| تطبيق سطح مكتب متعدد الأنظمة | ✅ | ✅ | ✅ | N/A | ❌ |
| ترجمات + SponsorBlock | ✅ | ⚠️ | ❌ | ❌ | ❌ |
Arroxy مبني لغرض واحد: الصق رابطاً، احصل على ملف محلي نظيف. لا حسابات، لا عروض ترويجية، لا جمع بيانات.
---
## الميزات
### الجودة والصيغ
- حتى **4K UHD (2160p)**، 1440p، 1080p، 720p، 480p، 360p
- **معدل إطارات عالٍ** محفوظ كما هو — 60 fps، 120 fps، HDR
- **الصوت** — تصدير الصوت فقط بصيغ MP3 أو M4A/AAC أو Opus أو WAV. في التنزيلات التفاعلية، اختر مسارات surround/Dolby الأصلية للمصدر (AC-3، E-AC-3، 5.1، DRC) عند توفرها، أو اضبط إعدادًا افتراضيًا عامًا **تفضيل المحيطي / Dolby**
- إعدادات سريعة: *أفضل جودة* · *متوازن* · *ملف صغير*
### الخصوصية والتحكم
- معالجة محلية 100% — تذهب التنزيلات مباشرة من يوتيوب إلى قرصك
- لا تسجيل دخول، لا كوكيز، لا ربط بحساب Google
- الملفات تُحفظ مباشرة في المجلد الذي تختاره
### سير العمل
- **اختصار تنزيل عام** — انسخ رابطاً في أي تطبيق واضغط `Ctrl+Shift+D` (`Cmd+Shift+D` على macOS)؛ يضيفه Arroxy إلى الطابور بملف التعريف النشط دون فتح النافذة، ويؤكد ذلك إشعار. مُفعَّل افتراضياً وقابل لإعادة التعيين
- **أوضاع بدء مرنة** — اختر تنزيلًا فرديًا موجّهًا، أو منتقي قائمة تشغيل/قناة، أو لصق روابط دفعة واحدة، أو Quick Download بالإعدادات الافتراضية المحفوظة
- **طابور تنزيل مركزي** — كل مهمة فردية أو قائمة تشغيل أو دفعة روابط أو تنزيل سريع تصل إلى مكان واحد لمتابعة التقدم والإيقاف المؤقت والاستئناف والإلغاء وإعادة المحاولة والتحكم في الأولوية
- **مراقبة الحافظة** — انسخ رابط يوتيوب ويملأ Arroxy الحقل تلقائياً عند العودة للتطبيق (قابل للتفعيل في الإعدادات المتقدمة)
- **تنظيف الروابط تلقائياً** — يحذف معاملات التتبع (`si`، `pp`، `utm_*`، `fbclid`، `gclid`) ويفك روابط `youtube.com/redirect`
- **وضع الشريط** — إغلاق النافذة يبقي التنزيلات تعمل في الخلفية
- **30 لغة** — يكتشف لغة النظام تلقائيًا ويمكن تبديلها في أي وقت
- **مزامنة قوائم التشغيل** — يعيد فحص قائمة التشغيل مقابل مجلد محلي لتخطي الفيديوهات التي نُزّلت من قبل؛ وينشئ ملف قائمة تشغيل `.m3u` يتم تحديثه مع تنزيل كل فيديو
- **تحكم في السرعة والإيقاع** — حدّد نطاق التنزيل، واضبط عدد أجزاء الفيديو التي تُنزَّل في وقت واحد، وأضف تأخيرات بين الطلبات باستخدام إعدادات جاهزة (*إيقاف · متوازن · حذر · مخصص*)
- **قوالب أسماء الملفات** — سمِّ تنزيلاتك كما تريد باستخدام `{title}` و`{uploader}` و`{id}` و`{date}` و`{resolution}` و`{playlist_index}`، بشكل عام أو لكل ملف تعريف تنزيل
- **التنزيلات في وقت واحد وإعادة المحاولة التلقائية** — اختر عدد التنزيلات التي تعمل في الوقت نفسه، ودع Arroxy يعيد محاولة تنزيل واجه عطلًا في الشبكة أو الخادم، مع انتظار أطول قبل كل محاولة
- **ملفات تعريف لكل عنصر في قائمة التشغيل** — عيّن لكل فيديو في قائمة التشغيل ملف تعريف تنزيل خاص به بدلاً من إعداد واحد للقائمة بأكملها، بحيث يمكن لعملية واحدة أرشفة بعضها بجودة كاملة واستخراج الباقي بصيغة MP3
### الترجمات والمعالجة اللاحقة
- **ترجمات** بصيغ SRT أو VTT أو ASS — يدوية أو مولَّدة تلقائياً، بأي لغة متاحة
- حفظها بجانب الفيديو، أو تضمينها في `.mkv`، أو تنظيمها في مجلد فرعي `Subtitles/`
- **دفعات الترجمات فقط** — الصق قائمة روابط أو افتح قائمة تشغيل، واختر الترجمات، واحصل على ملفات الترجمة فقط لكل فيديو
- **SponsorBlock** — تخطي الرعاة أو وضع علامة فصل عليهم، المقدمات والخواتم والترويج الذاتي
- **بيانات وصفية مضمّنة** — العنوان، تاريخ الرفع، القناة، الوصف، الصورة المصغرة، وعلامات الفصول تُكتب في الملف
### YouTube + 2000 موقع
- **YouTube — بالكامل** — الفيديوهات وShorts والقنوات وقوائم التشغيل وYouTube Music والبودكاست تُعالَج كمصادر أولى
- **أكثر من 2000 موقع آخر** عبر yt-dlp — Vimeo وTwitch وTwitter/X وTikTok وSoundCloud وBandcamp وBilibili وBBC iPlayer وarchive.org وغيرها الكثير
- **الصوت فقط والترجمات** تعملان على كل موقع مدعوم، ليس يوتيوب فحسب
- إذا تغيَّر موقع ما، يُصدر yt-dlp إصلاحات أسبوعياً ويحدِّث Arroxy الملف التنفيذي تلقائياً عند التشغيل
اختصار تنزيل عام انسخ رابطاً في أي مكان واضغط مرة واحدة — يدخل الطابور ويبدأ التنزيل
ملفات تعريف لكل عنصر في قائمة التشغيل امنح كل فيديو ملف تعريف خاصًا به — احفظ بعضها بدقة 4K وخذ الباقي بصيغة MP3
صفحة التنزيل السريع الصق رابطًا ونزّله فورًا بملفك النشط
ملفات تنزيل قابلة لإعادة الاستخدام احفظ التنسيق والجودة والإخراج كإعدادات مسبقة — أعد استخدامها لكل تنزيل
مسارات صوت متعددة اللغات اختر لغة الصوت الدقيقة التي يوفرها الفيديو
صوت Surround / Dolby يتم اكتشاف مسارات 5.1 وDolby والحفاظ عليها
وضع الروابط المجمّعة الصق قائمة، وأزل التكرارات تلقائيًا، وضعها كلها في الطابور دفعة واحدة
قائمة تنزيل متوازية عدة تنزيلات في وقت واحد مع تقدم مباشر
---
## الخصوصية
تُجلب التنزيلات مباشرة عبر [yt-dlp](https://github.com/yt-dlp/yt-dlp) من يوتيوب إلى المجلد الذي تختاره — لا شيء يمر عبر خادم طرف ثالث. سجل المشاهدة والتنزيل والروابط ومحتوى الملفات تبقى على جهازك.
يرسل Arroxy قياسات مجهولة ومجمّعة عبر [OpenPanel](https://openpanel.dev) — بما يكفي فقط لفهم الأعطال والأخطاء والملاحظات وأنظمة التشغيل وإصدارات التطبيق. لا URLs، لا عناوين فيديو، لا مسارات ملفات، لا معلومات حساب، لا بصمة رقمية، ولا بيانات شخصية. معرّف كل تثبيت عشوائي وغير مرتبط بهويتك. يمكنك إيقافه من الإعدادات.
---
## الأسئلة الشائعة
**هل هو مجاني حقاً؟**
نعم — مرخَّص بـ MIT، بدون مستوى مميز، بدون قيود على الميزات.
**ما جودات الفيديو التي يمكنني تنزيلها؟**
كل ما يوفره يوتيوب: 4K UHD (2160p)، 1440p، 1080p، 720p، 480p، 360p، بالإضافة إلى الصوت فقط. تدفقات 60 fps و120 fps وHDR محفوظة كما هي.
**هل يمكنني استخراج الصوت فقط بصيغة MP3؟**
نعم. اختر *صوت فقط* من قائمة الصيغ ثم اختر MP3 أو M4A/AAC أو Opus أو WAV.
**هل أحتاج إلى حساب يوتيوب أو كوكيز؟**
افتراضياً، لا — يعمل Arroxy دون حساب YouTube أو تسجيل دخول أو تصدير كوكيز. يتوفر دعم اختياري للكوكيز في الإعدادات المتقدمة (Cookies source: file or browser) للمحتوى الذي يتطلب مصادقة، مثل الفيديوهات المقيَّدة بالعمر أو المخصَّصة للأعضاء فقط. وهو معطَّل افتراضياً. إذا فعّلته، فإن ويكي yt-dlp يشير إلى أن [الأتمتة المعتمدة على الكوكيز قد تُعلِّم حساب Google](https://github.com/yt-dlp/yt-dlp/wiki/Extractors#exporting-youtube-cookies)؛ في هذه الحالة يكون الحساب البديل المؤقت الخيار الأكثر أماناً.
**هل سيستمر في العمل عند تغيير يوتيوب لشيء ما؟**
يُحدَّث yt-dlp تلقائياً عند الإطلاق، ويُصدر Arroxy إصلاحات بسرعة عندما يُغيِّر YouTube شيئاً ما. وإن واجهت مشكلة، يتوفر دعم اختياري للكوكيز في الإعدادات المتقدمة كحل احتياطي.
**ما اللغات المتاحة في Arroxy؟**
30 لغة جاهزة مباشرة: Afaan Oromoo · Bahasa Indonesia · Deutsch · English · Español · Français · Italiano · Kiswahili · O'zbekcha · Polski · Português · Tiếng Việt · Türkçe · አማርኛ · العربية · اردو · پښتو · فارسی · বাংলা · हिन्दी · ไทย · မြန်မာဘာသာ · Ελληνικά · Русский · Српски · Українська · 中文 · 日本語 · 한국어 · 繁體中文. يكتشف Arroxy لغة نظام التشغيل عند التشغيل الأول، ويمكنك التبديل في أي وقت من منتقي اللغة في شريط الأدوات. توجد ملفات Runtime locale JSON في src/shared/i18n/locales/، وتوجد كتالوجات PO الخاصة بالمترجمين في i18n/locales/ — افتح PR على GitHub للمساهمة.
**هل أحتاج إلى تثبيت شيء آخر؟**
لا. يُحمَّل yt-dlp تلقائياً عند الإطلاق الأول ويُخزَّن على جهازك؛ أمّا ffmpeg وffprobe فيأتيان داخل التطبيق. بعد ذلك، لا تحتاج أي إعداد إضافي.
**هل يمكنني تنزيل قوائم التشغيل أو القنوات بالكامل؟**
نعم — كلاهما. الصق رابط قائمة تشغيل أو قناة (مثل `youtube.com/@handle` أو `/channel/UC…` أو `/c/Name` أو `/user/Old`)؛ اختر عدد العناصر التي تريد فحصها، ثم أضف القائمة كلها إلى الطابور أو اختر فيديوهات محددة. ستأتي فلاتر نطاق التاريخ قريبًا.
**يقول macOS إن "التطبيق تالف" — ماذا أفعل؟**
هذا Gatekeeper في macOS يحظر تطبيقاً غير موقَّع، وليس تلفاً فعلياً. راجع [macOS first launch](#macos-first-launch) لأوامر Terminal التي تزيل quarantine وتشغّل Arroxy.
**هل تنزيل فيديوهات يوتيوب قانوني؟**
للاستخدام الشخصي الخاص، يُقبَل هذا عموماً في معظم الولايات القضائية. أنت مسؤول عن الامتثال لـ [شروط خدمة](https://www.youtube.com/t/terms) يوتيوب وقوانين حقوق النشر في بلدك.
---
## خارطة الطريق
ما زال مخططًا — تقريبًا بترتيب الأولوية:
| الميزة | الوصف |
| ---------------- | ---------------- |
| **فلاتر قوائم التشغيل والقنوات** | فلاتر نطاق التاريخ عند تعداد قائمة تشغيل أو قناة |
| **تفضيلات مسارات الصوت في YouTube** | تعيين تفضيل مسار لغة الكلام على مستوى التطبيق، مع تجاوزات لكل profile عندما يوفر YouTube عدة مسارات صوتية |
| **تسجيل دخول بمتصفح داخل التطبيق** | فتح نوافذ متصفح داخل Arroxy لتسجيل الدخول واستخدام cookies الخاصة بالموقع دون تصديرها يدوياً |
| **تنزيل فيديو بنقرة واحدة** | بدء تنزيل فيديو بنقرة واحدة من رابط مكتشف أو ملصوق باستخدام ملفك النشط |
| **استرداد أقوى بإعادة المحاولة** | مسار إعادة محاولة جديد للتنزيلات التي تقطعها اتصالات إنترنت غير موثوقة أو إشكالية |
| **درج مدير تنزيلات كامل** | تحويل درج قائمة الانتظار إلى مدير أوسع، بما في ذلك تغيير مجلدات الوجهة للعناصر المصطفة |
| **التنزيلات المجدولة** | بدء قائمة في وقت محدد (تشغيل ليلي) |
| **قص المقاطع** | تنزيل جزء فقط بتحديد وقت البداية والنهاية |
| **حزمة AUR** | التثبيت على Arch Linux وOmarchy باستخدام `yay -S arroxy-bin` |
هل لديك ميزة في ذهنك؟ [افتح طلباً](../../issues) — مدخلات المجتمع تُشكِّل الأولويات.
---
## ادعم Arroxy
Arroxy مجاني ومرخّص بموجب MIT — بلا إعلانات وبلا نسخة مدفوعة. إذا كان يوفّر وقتك، يمكنك دعم تطويره عبر Bitcoin أو Tron: العناوين موجودة في [DONATE.md](DONATE.md)، وهو المصدر الرسمي الوحيد لها. لن يرسل إليك Arroxy عنواناً عبر البريد الإلكتروني أو الرسائل المباشرة أبداً. منح المستودع نجمة والإبلاغ عن الأخطاء وتحسين الترجمات تساعد بالقدر نفسه.
---
## مبني باستخدام
Stack
- **Electron** — بيئة سطح المكتب متعددة الأنظمة
- **React 19** + **TypeScript** — واجهة المستخدم
- **Tailwind CSS v4** — التنسيق
- **Zustand** — إدارة الحالة
- **yt-dlp** + **ffmpeg** — محرك التنزيل والدمج (يُجلب yt-dlp وقت التشغيل؛ ويُضمَّن ffmpeg/ffprobe وقت البناء)
- **Vite** + **electron-vite** — أدوات البناء
- **Vitest** + **Playwright** — اختبارات الوحدة والشامل
البناء من المصدر
### المتطلبات الأساسية — جميع الأنظمة
| الأداة | الإصدار | التثبيت |
| ------- | ------- | ------- |
| Git | أي إصدار | [git-scm.com](https://git-scm.com) |
| Node.js | 24.16.0 | `mise install` أو `.node-version` |
| Bun | 1.2.23 | `mise install` أو `package.json` `packageManager` |
الموصى به: ثبّت `mise` ثم شغّل `mise install` داخل checkout. من دون mise، فعّل Node.js من `.node-version` وBun من `package.json` يدوياً قبل `bun run bootstrap`.
### Windows
```powershell
powershell -c "irm bun.sh/install.ps1 | iex"
```
قد تحتاج إلى Visual Studio Build Tools وPython لإعادة البناء الأصلية.
### macOS
```bash
brew install mise
xcode-select --install
```
بعد الاستنساخ، شغّل `mise trust && mise install` من داخل checkout. إذا كان shell لديك يستخدم بالفعل `fnm` أو `nvm` أو Bun عبر Homebrew، ففعّل mise في `~/.zshrc` لكي يستخدم Arroxy Node.js 24.16.0 و Bun 1.2.23:
```bash
printf '
# mise
if command -v mise >/dev/null 2>&1; then
eval "$(mise activate zsh)"
fi
' >> ~/.zshrc
exec zsh
```
### Linux (Ubuntu / Debian)
```bash
curl -fsSL https://bun.sh/install | bash
# اعتماديات البناء وتشغيل Electron
sudo apt install -y build-essential python3 tar libgtk-3-0 libnss3 libasound2t64
# اختبارات E2E فقط (يحتاج Electron إلى شاشة)
sudo apt install -y xvfb
```
### الاستنساخ والتشغيل
```bash
git clone https://github.com/antonio-orionus/Arroxy
cd Arroxy
mise trust
mise install # موصى به؛ تخطّه إذا فعّلت الأدوات المثبتة يدوياً
bun run bootstrap
bun run doctor
bun run dev # تطبيق Electron مع عارض Vite
```
### بناء حزمة قابلة للتوزيع
```bash
bun run build # فحص الأنواع + التجميع
bun run dist # حزمة للنظام الحالي
bun run dist:win # حزم أهداف Windows على مضيف مدعوم
```
> يثبّت `bun run bootstrap` الاعتماديات، ويعيد بناء اعتماديات تطبيق Electron، ويتحقق من Electron، ويجهز ffmpeg/ffprobe المضمنين للتطوير، ويثبّت Playwright Chromium. يُدار yt-dlp وقت التشغيل داخل مجلد بيانات التطبيق؛ ويأتي ffmpeg وffprobe مضمنين مع كل إصدار من Arroxy.
---
## Troubleshooting
### App won't open / no window appears
The Arroxy process starts but no window shows up. Most often this is a GPU driver hang during startup. Try, in order:
**1. Check the log.** It records startup, GPU info, and any crash. Path:
| Platform | Path |
| -------- | -------------------------------- |
| Windows | `%APPDATA%\Arroxy\logs\main.log` |
| macOS | `~/Library/Logs/Arroxy/main.log` |
| Linux | `~/.config/Arroxy/logs/main.log` |
**2. Launch with hardware acceleration disabled.** Open a terminal / Command Prompt and run the executable with a flag:
```bash
# Windows (Portable) — PowerShell, run from the folder containing the exe
.\Arroxy-win-x64-Portable.exe --disable-gpu
# Windows (Portable) — Command Prompt (cmd.exe), from the same folder
Arroxy-win-x64-Portable.exe --disable-gpu
# Windows (Installed) — works in both PowerShell and cmd.exe
"%LOCALAPPDATA%\Programs\Arroxy\Arroxy.exe" --disable-gpu
# macOS
/Applications/Arroxy.app/Contents/MacOS/Arroxy --disable-gpu
# Linux (AppImage)
./Arroxy-linux-x64.AppImage --disable-gpu
```
If that works, the GPU/driver is the cause. Make the change permanent (next step).
**3. Persist the flag via `argv.json`.** Create the file at:
| Platform | Path |
| -------- | ------------------------------------------------ |
| Windows | `%APPDATA%\Arroxy\argv.json` |
| macOS | `~/Library/Application Support/Arroxy/argv.json` |
| Linux | `~/.config/Arroxy/argv.json` |
With contents:
```json
{ "disable-hardware-acceleration": true }
```
Arroxy reads this before opening any window, so it works even when the window never appeared.
**4. Other flags worth trying** (combine if needed): `--disable-software-rasterizer`, `--disable-gpu-sandbox`, `--in-process-gpu`.
**5. Stale window position.** If the window may be opening off-screen (multi-monitor change since last run), delete `\window-state.json` and relaunch.
**6. Still stuck?** Open an issue with your OS version and any output from running with `--enable-logging --v=1`. If the app window does open, attach the file from **Settings → Save diagnostics file**: it holds both logs and your app details, with your user folder name removed. Otherwise attach `main.log`.
---
## شروط الاستخدام
Arroxy أداة للاستخدام الشخصي الخاص فقط. أنت مسؤول مسؤولية كاملة عن ضمان امتثال تنزيلاتك لـ [شروط خدمة](https://www.youtube.com/t/terms) يوتيوب وقوانين حقوق النشر في ولايتك القضائية. لا تستخدم Arroxy لتنزيل أو إعادة إنتاج أو توزيع محتوى ليس لديك حق استخدامه. المطوّرون غير مسؤولين عن أي إساءة استخدام.
## Star History