🎬 Entertainment Arsenal

ترسانة ترفيه قانونية مجانية: أفلام · مسلسلات · قنوات بث · ألعاب · موسيقى · بودكاست · تحميل. كل السكربتات تُشغَّل عبر /usr/bin/python3 (يملك المكتبات).

📂 السكربتات (كلها مُختبرة حياً 2026-06-06)

🆓 streaming_free.py — أفلام/مسلسلات حديثة بث مجاني (Pluto TV + Tubi — قانوني ✅)

streaming_free.py categories     # أقسام Pluto VOD
streaming_free.py movies [cat]   # 🆓 أفلام مجانية حديثة
streaming_free.py series [cat]   # 🆓 مسلسلات مجانية
streaming_free.py new            # 🆕 الأحدث في VOD
streaming_free.py search "title" # بحث
streaming_free.py watch <slug>   # رابط مشاهدة مجاني (Pluto)
streaming_free.py live           # 138 قناة Pluto حية
streaming_free.py tubi "title"   # بحث Tubi

Pluto API عام بلا مفتاح ✅. بث مجاني بإعلانات (FAST) — قانوني 100%. للأفلام الحديثة (مشاهدة مجانية).

🆕 now_showing.py — جديد / يُعرض الآن

now_showing.py cinema [region]   # 🎬 في السينما الآن (TMDB)
now_showing.py new [region]      # 🆕 أحدث الإصدارات
now_showing.py upcoming [region] # 🔜 قريباً
now_showing.py trending          # 🔥 الأكثر رواجاً
now_showing.py tv_new            # 🆕 مسلسلات تُعرض اليوم (بلا مفتاح ✅)
now_showing.py where "title"     # أين تشاهده قانونياً

الأفلام الحديثة الحصرية = معلومات + أين تُشاهد قانونياً (لا تحميل — محمية بحقوق). cinema/new/upcoming/trending تحتاج مفتاح TMDB مجاني.

🎬 library.py — مكتبة أفلام/كرتون/مسلسلات كاملة (مشاهدة + تحميل — Internet Archive قانوني مجاني ✅)

28,000+ فيلم · 26,000+ كرتون · 9,600+ عربي · وثائقي — قابلة للمشاهدة والتحميل الفعلي:

library.py movies [query]      # أفلام كاملة (28K)
library.py cartoon [query]     # كرتون/أنيميشن (26K)
library.py arabic [query]      # محتوى عربي (9.6K)
library.py series [query]      # مسلسلات
library.py docs [query]        # وثائقي
library.py search "title" [kind]
library.py watch <id>          # ✅ روابط مشاهدة/بث مباشر
library.py download <id>       # ✅ تحميل الفيلم كاملاً (مُختبر — MP4 صالح)
library.py info <id>           # تفاصيل + الملفات

المحتوى public-domain/مرخص — قانوني للمشاهدة والتحميل. للأفلام الحديثة (بث مجاني): Tubi/Pluto/Plex + YouTube الرسمي.

🎞️ movies_tv.py — معلومات أفلام ومسلسلات (metadata)

movies_tv.py show "severance"        # معلومات مسلسل + الحلقة القادمة (TVMaze، بلا مفتاح ✅)
movies_tv.py next "the last of us"   # متى الحلقة القادمة
movies_tv.py schedule [KW] [date]    # ما يُعرض اليوم
movies_tv.py movie "interstellar"    # معلومات فيلم (يحتاج OMDB/TMDB)
movies_tv.py where "dune"            # أين تُشاهد (TMDB watch providers / JustWatch)
movies_tv.py recommend scifi family  # توصيات (TMDB)

🎮 games.py — ألعاب (CLI)

games.py free                # ألعاب Epic المجانية الآن (بلا مفتاح ✅)
games.py info "elden ring"   # معلومات لعبة (RAWG)
games.py top [genre]         # أفضل الألعاب (RAWG)
games.py deals "cyberpunk"   # روابط صفقات (Steam/GOG/ITAD)

▶️ Games Hub (تشغيل مباشر داخل البورتال — entertainment-hub/games_hub.py) 🆕 2026-06-12

ثلاث طبقات قانونية في تبويب «🎮 ألعاب» بالهاب: 1. ▶ العب الآن — 18 لعبة HTML5 مجانية/مفتوحة المصدر. 13 تعمل داخل الهاب مباشرة (iframe)، 5 تفتح بنافذة (الموقع يمنع iframing). تصنيفات: ألغاز/أركيد/استراتيجية/عائلي/كلمات/متعدد/تصويب/ورق. (2048، تتريس؋ باكمان؋ شطرنج؋ سودوكو؋ داما؋ ووردل؋ XO لعبتنا؋ slither/agar/skribbl …). 2. 🆓 مجانية Epic — الألعاب المجانية للاقتناء الآن (Epic الرسمي) → تفتح صفحة المتجر. 3. 🔍 معلومات لعبة — بحث بالاسم → تقييمات + منصات + روابط (RAWG إن وجد مفتاح، وإلا Steam/GOG/IGDB/Epic/itch).

games_hub.py playable [genre]   # الألعاب القابلة للتشغيل المباشر
games_hub.py epic               # مجانية Epic الآن
games_hub.py info "the witcher"  # معلومات + روابط

Hub routes: /api/games/playable?genre= · /api/games/epic · /api/games/info?q= · /games/xo (لعبتنا المحلية). قانوني 100%: ألعاب مفتوحة المصدر/public-domain/توزيع مجاني رسمي — لا قرصنة.

🔥 Discover (جديد ورائج — entertainment-hub/discover.py) 🆕 2026-06-12

مصادر مجانية بلا مفتاح (معلومات عامة فقط):

• 🔥 الأكثر رواجاً — أشهر المسلسلات (TVMaze weight + rating).
• 📅 يُعرض اليوم — جدول بث اليوم (TVMaze schedule).
• 🔍 بحث مسلسل — معلومات + الحلقة القادمة.
• OMDB enrichment (مفتاح موجود): IMDb + Rotten Tomatoes rating لأي عنوان.
• الضغط على أي عنوان → يقفز للبحث الشامل ليجده في اشتراكاتك/المجاني.

discover.py trending      # الأكثر رواجاً
discover.py airing [US]   # يُعرض اليوم
discover.py show "name"   # معلومات مسلسل
discover.py omdb "title"  # IMDb + RT rating

Routes: /api/discover/trending|airing|show?q=|rating?t=&y=.

🕹️ Retro Emulation (محاكيات أونلاين — retro.py + templates/emu.html) 🆕 2026-06-12

محرك EmulatorJS (open-source) يعمل 100% داخل المتصفح (WASM، CDN) — 14 نظامًا: Atari 2600/7800/Lynx · NES · SNES · GB/GBC/GBA · Sega MD/MS/GG · N64 · PlayStation (PSX) · NDS · Arcade(MAME).

• 🕹️ ألعاب جاهزة: ROMs قانونية مجمّعة (Alter Ego freeware + Micro Mages PD ×2) — تعمل فوراً.
• 📂 حمّل ROM: المستخدم يحمّل أي لعبة يملكها — client-side بالكامل (لا تُرفع لأي خادم).
• 🔍 مكتبة Homebrew: بحث Archive.org لألعاب homebrew/public-domain قانونية.
• Save/load states + virtual gamepad + netplay (Create a Room) مدمجة في EmulatorJS.
• EJS_threads=false (أوسع توافق) + فحص WebGL مع رسالة واضحة إن غير مدعوم.

retro.py library|systems|homebrew "q"

Routes: /api/retro/library · /api/retro/homebrew?q= · /emu?rom=&sys=&name= · /roms/<sys>/<file>. ⚠️ التحقق: المحاكي يحتاج WebGL (متوفر على أي جهاز حقيقي)؛ headless browser بلا WebGL = لا يرسم (قيد اختبار فقط).

📺 EPG — بحث دليل البرامج عبر كل الاشتراكات (epg.py) 🆕 2026-06-12

أقوى فكرة: ابحث عن برنامج/مباراة/فيلم (عربي أو إنجليزي) داخل جداول برامج كل القنوات → يقول في أي قناة يُعرض (الآن/قريباً) + رابط تشغيل مباشر.

• الآلية: جلب XMLTV (xmltv.php) لكل اشتراك + parse + فهرسة البرامج + ربط channel→stream_id عبر epg_channel_id.
• الاشتراكات التي توفر EPG: Adam vip new (171K برنامج) · K8 (204K) · Supreme · xiptv. (بعضها بلا EPG: MH/Bazoka/Cartoon/Lion).
• فلتر 🔴 يُعرض الآن + ترتيب (الآن أولاً ثم القريب).
• الأداء: cold ~25ث (جلب 130MB guides) · warm 0.2-0.4ث ⚡ (cache TTL 30د + pre-warm في الخلفية).

epg.py search "the last word"   # بحث برنامج
epg.py search "مباراة" --now      # فقط الآن
epg.py now <sub> <stream_id>    # ماذا يُعرض على قناة

Routes: /api/epg/search?q=&now=1 · /api/epg/channel/<sub>/<sid>. UI: تبويب 📺 دليل البرامج.

🔴 DVR — تسجيل + Snapshot من القنوات (recorder.py) 🆕 2026-06-12

ffmpeg server-side: لقطة JPEG أو تسجيل MP4 مؤقت (5ث–1ساعة) من أي بث حي.

• أزرار 📸 لقطة / 🔴 سجّل 60ث / 5دق / 📁 تسجيلاتي داخل مشغّل القنوات الحية (IPTV + free).
• مختبر حياً: snapshot 40KB JPEG صالح + recording 12ث → MP4 4.7MB مدته 12.1ث ✅.
• cleanup في keepalive: حذف >7أيام + cap 5GB.

recorder.py snap <url> [name] | rec <url> [name] [seconds] | jobs

Routes: /api/rec/snapshot|start|stop/<id>|jobs (يقبل ?u= أو ?sub=&kind=&sid= أو ?cid=) · /recordings/<file>. ⚖️ قانوني: time-shift/DVR شخصي لبث تملك حق مشاهدته — لا إعادة توزيع.

⏰ جدولة التسجيل + صفحة التنزيلات 🆕 2026-06-12

• جدولة زمنية: سجّل قناة في وقت محدد مستقبلاً (datetime-local) + تكرار (مرة/يومي/أسبوعي). scheduler thread يفحص كل 20ث ويُطلق عند الوقت.
• صفحة 📁 التنزيلات (تبويب): كل التسجيلات + اللقطات المحفوظة في recordings/ مع ▶ عرض + ⬇ تحميل + قسم المجدولة (إلغاء).
• مختبر حياً: جدولت تسجيل 40ث مستقبلاً → scheduler أطلقه في وقته → أنتج MP4 4.5MB ظهر في التنزيلات ✅. download link HTTP 200 video/mp4.

recorder.py sched <url> <name> <start_iso> <duration> [once|daily|weekly]
recorder.py schedlist | downloads

Routes: /api/rec/schedule?when=&tzoff=&duration=&repeat= · /api/rec/scheduled · /api/rec/schedule/cancel/<id> · /api/rec/downloads.

⚡ Performance (2026-06-12 enhancement)

• TTL cache في unified_search (كتالوجات الاشتراكات 15د + alive 10د) → VOD search 14s→04s warm، live 2.6s→0.9s.
• Background pre-warm عند إقلاع الهاب (thread) → أول بحث سريع.
• ملاحظة تشغيلية: الهاب يعمل user=node (flask مثبت لـnode)؛ ملف iptv_subscriptions.json ملكه node:node 0600 (خاص وآمن). HUB_SECRET ثابت في env.sh.

📺 channels.py — قنوات بث حية (IPTV-org، 39,000+ قناة عالمية، قانوني مجاني، بلا مفتاح ✅)

مفصولة لفئات للوصول السريع + XXX مستبعد دائماً (آمن للعائلة):

channels.py arabic [category]    # 🌙 المحتوى العربي (1094 قناة، الكويت/الخليج أولاً)
channels.py kids [arabic|en]     # 🧒 الأطفال (آمن: عربي 43 · إنجليزي 490 · عالمي 1033)
channels.py science [arabic|en]  # 🔬 ثقافي+علمي+وثائقي (عربي 79 · عالمي 2845)
channels.py world [category]     # 🌍 كل المحتوى العالمي (39,000+)
channels.py country US [news]    # قنوات دولة محددة
channels.py search "mbc"         # بحث بالاسم
channels.py categories           # كل التصنيفات
channels.py url <channel_id>     # روابط البث
channels.py play <channel_id>    # أمر تشغيل جاهز (mpv/streamlink)

الفئات المنفصلة (سريعة الوصول): 🌙 عربي · 🧒 أطفال · 🔬 ثقافي/علمي · 🌍 عالمي. كل الفئات الـ 30 متاحة عبر world <cat>: movies(1608) sports(2400) news(2226) music(1849) religious(2354) series comedy documentary culture science education ... بلا نقص.

🔞 adult_gate.py — محتوى +18 (محمي بكلمة سر)

adult_gate.py status              # هل البوابة مُعدّة
adult_gate.py verify "<pw>"        # تحقق من كلمة السر
adult_gate.py list "<pw>" [filt]   # قنوات +18 (369 قناة، محمية)
adult_gate.py url "<pw>" <id>      # رابط البث (محمي)

الحماية (خاص بين د. وائل و OpenClaw فقط):

• كلمة السر غير مخزّنة كنص — فقط hash (PBKDF2-SHA256 + salt، 200k iter) في secrets/.adult_gate_hash (mode 600).
• أُرسلت كلمة السر لإيميل د. وائل (Hotmail+Gmail) مرة واحدة.
• 5 محاولات خاطئة → قفل 60s.
• الوصول: د. وائل يرسل كلمة السر في الشات → verify → فتح الوصول لتلك الجلسة.
• محتوى +18 محجوب تماماً عن arabic/kids/science/world/country (_safe filter).

🎵 music_media.py — موسيقى وبودكاست وتحميل

music_media.py song "bohemian rhapsody"   # بحث أغنية (iTunes، بلا مفتاح ✅)
music_media.py artist "queen"             # أبرز أغاني فنان
music_media.py podcast "lex fridman"      # بحث بودكاست + RSS feed
music_media.py download <url> [audio|video] # تحميل (yt-dlp، محتوى قانوني فقط)
music_media.py info <url>                 # معلومات بدون تحميل

🔧 الأدوات المثبّتة

• yt-dlp ✅ (تحميل من 1000+ موقع) · ffmpeg ✅ · streamlink ✅ (بث حي)
• توليد موسيقى أصلية: skill suno-music (أغانٍ بكلمات) + MiniMax Music (instrumental رخيص)

🔑 المفاتيح المجانية (اختيارية — تفتح ميزات إضافية)

تعمل الترسانة الأساسية بلا أي مفتاح. لميزات أعمق (معلومات أفلام، توصيات، معلومات ألعاب) سجّل مجاناً:

• TMDB (أفلام + توصيات + watch providers): themoviedb.org/settings/api → TMDB_API_KEY
• OMDB (تقييمات IMDb/RottenTomatoes): omdbapi.com/apikey.aspx → OMDB_API_KEY
• RAWG (معلومات ألعاب): rawg.io/apidocs → RAWG_API_KEY

كلها مجانية 100%. تُضاف لـ secrets/env.sh.

⚖️ القاعدة القانونية (إلزامية)

• ✅ معلومات/مواعيد/توصيات/بحث = مسموح دائماً (بيانات عامة).
• ✅ IPTV-org = يفهرس فقط بثاً عاماً مجانياً قانونياً.
• ✅ yt-dlp = للمحتوى القانوني/العام/المملوك فقط.
• ❌ لا نتعامل مع محتوى مقرصن أو اشتراكات مدفوعة محمية (Netflix/OSN/Shahid streams).

🔄 التحديث الدوري (cron)

• تحديث المحتوى اليومي (12:00 الكويت) → refresh_content.sh: جديد السينما + رواج + ألعاب مجانية + عدّ المكتبة. digest إن وجد جديد.
• ألعاب Epic المجانية الأسبوعية (خميس 18:00) → تنبيه بالألعاب الجديدة.
• state: memory/entertainment-refresh-state.json.

🔧 Series Episode Resolution + MKV Remux (2026-06-12 — إصلاح جذري)

• المسلسلات: Xtream يحتاج episode_id لا series_id (/series/{series_id}.mp4 = HTTP 422). الحل: xt_series_info → seasons/episodes → /api/iptv/series/<sub>/<sid> + /api/iptv/episode/<sub>/<eid>/<ext>. UI: مختار مواسم+حلقات.
• MKV/AVI/FLV: المتصفح لا يشغّلها في <video> رغم h264+aac. الحل: /api/remux = ffmpeg remux on-the-fly → fragmented MP4 (copy codecs، بلا re-encode). _playable_url يوجّه non-native ext للـ remux تلقائياً.
• مُختبر: Detective Conan mkv → video 720×400 readyState=4 يشغّل في المتصفح ✅.