/ الدليل / الملعب / media-library-organizer-skill
● مجتمع Innei ⚡ فوري

media-library-organizer-skill

بواسطة Innei · Innei/media-library-organizer-skill

يهيّئ مكتبات الوسائط لـ Jellyfin/Plex/Emby — ينظّف الملفات غير المهمة، يدمج الحلقات المتناثرة، يوحّد أسماء المجلدات، ويتحقق من الاكتمال مقابل TMDB.

مهارة Claude Code (مع سكريبتات bash مستقلة) تنظّم مكتبات الأفلام والمسلسلات والأنمي بشكل منهجي لخوادم الوسائط. تمسح المجلدات وتزيل الملفات غير المهمة (.DS_Store وبقايا SMB والمجلدات الفارغة)، وتدمج النسخ المكررة حسب العنوان والسنة والجودة، وتوحّد مجلدات مجموعات الإصدارات المتناثرة، وتوحّد الأسماء إلى صيغة Title (Year)، وتتحقق من قاعدة بيانات TMDB لتحديد الحلقات الناقصة. السلامة على مستويات: فقط عمليات حذف الملفات غير المهمة الموثوقة تعمل بدون رقابة — التغييرات الكبيرة تنتظر موافقتك.

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

media-library-organizer-skill.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "media-library-organizer-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Innei/media-library-organizer-skill",
        "~/.claude/skills/media-library-organizer-skill"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "media-library-organizer-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Innei/media-library-organizer-skill",
        "~/.claude/skills/media-library-organizer-skill"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "media-library-organizer-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Innei/media-library-organizer-skill",
        "~/.claude/skills/media-library-organizer-skill"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "media-library-organizer-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Innei/media-library-organizer-skill",
        "~/.claude/skills/media-library-organizer-skill"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "media-library-organizer-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Innei/media-library-organizer-skill",
        "~/.claude/skills/media-library-organizer-skill"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "media-library-organizer-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/Innei/media-library-organizer-skill",
          "~/.claude/skills/media-library-organizer-skill"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add media-library-organizer-skill -- git clone https://github.com/Innei/media-library-organizer-skill ~/.claude/skills/media-library-organizer-skill

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: media-library-organizer-skill

تحضير مكتبة تحميلات فوضويّة لـ Jellyfin

👤 مستخدمو خادم الوسائط المنزلي الذين لديهم مجلد تحميلات فوضوي ⏱ ~60 min intermediate

متى تستخدمه: قبل توجيه Jellyfin إلى مجلد مليء بفوضى أسماء مجموعات الإصدارات.

المتطلبات الأساسية
  • المهارة مثبتة — git clone https://github.com/Innei/media-library-organizer-skill ~/.claude/skills/media-library-organizer-skill
  • مفتاح TMDB API للتحقق من الاكتمال — themoviedb.org -> Settings -> API -> free key
الخطوات
  1. المسح والتحليل
    استخدم media-library-organizer على /media/downloads. مسح فقط — اعرض قائمة الملفات غير المهمة والنسخ المكررة والحلقات المتناثرة.✓ تم النسخ
    → تقرير يحتوي على 3 أقسام: ملفات غير مهمة / نسخ مكررة / متناثرة
  2. التنظيف التلقائي للملفات غير المهمة (مستوى آمن)
    تابع التنظيف من الملفات غير المهمة (.DS_Store وبيانات SMB والمجلدات الفارغة).✓ تم النسخ
    → حذفات صغيرة، لا توجد أي مخاطرة
  3. التأكيد ودمج النسخ المكررة
    الآن دمج النسخ المكررة — سأوافق على كل واحدة.✓ تم النسخ
    → موافقات واحدة تلو الأخرى مع عرض العنوان والسنة والجودة
  4. توحيد أسماء المجلدات
    أعد التسمية إلى صيغة Title (Year) — حذّر إذا كان هناك أي شيء يُذاع حاليًا.✓ تم النسخ
    → تحذير البذور يظهر قبل إعادة التسمية
  5. التحقق عبر TMDB
    تحقق من عدد الحلقات مقابل TMDB — اعرض قائمة الناقصة.✓ تم النسخ
    → قائمة الحلقات الناقصة لكل عرض

النتيجة: يتعرّف Jellyfin/Plex على كل شيء؛ الفجوات الناقصة واضحة.

المزالق
  • إعادة التسمية تكسر بذرة تورنت نشطة — تحذر المهارة؛ توقف التورنت أو استخدم hard-link قبل إعادة التسمية
  • دمج النسخ ذات الجودة المختلفة يفقد النسخة الجيدة — تعطي المهارة الأولوية للجودة الأعلى — تحقق مرة أخرى قبل التأكيد
اجمعها مع: filesystem

دمج مكتبة أنمي مع مجموعات إصدارات مختلطة

👤 مجمعو الأنمي ⏱ ~45 min intermediate

متى تستخدمه: مكتبة الأنمي الخاصة بك تحتوي على 3 مجموعات إصدارات لكل عرض في مجلدات مختلفة.

الخطوات
  1. المسح
    امسح /anime عن أنماط الحلقات المتناثرة عبر مجموعات الإصدارات.✓ تم النسخ
    → مرشحو الدمج لكل عرض
  2. اختر النسخة الأساسية لكل عرض
    لكل مرشح، اختر مجموعة الإصدارات ذات الجودة الأعلى ودمج الآخرين فيها (أو احذفها).✓ تم النسخ
    → مجلدات نظيفة لكل عرض

النتيجة: مجلد واحد لكل عرض بتسمية متسقة.

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

media-library-organizer-skill + filesystem

تحرير ملفات NFO أو sidecars مخصصة أثناء نفس الجلسة

أثناء التنظيم، أضف أيضًا ملفات .nfo لكل فيلم برقم TMDB.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
scan root path بداية أي جلسة تنظيم 0 — local
clean_junk root path, safe_only=true أول مرة مدمرة 0
merge_duplicates duplicate pair list بعد الموافقة على النسخ المكررة 0
normalize_names root path بعد التنظيف 0
verify_tmdb show paths, TMDB_API_KEY فحص الاكتمال TMDB free quota

التكلفة والحدود

تكلفة التشغيل

حصة API
TMDB: المستوى المجاني كريم لمكتبات المنزل
الرموز لكل استدعاء
منخفضة — المهارة تنسق في الغالب shell
التكلفة المالية
مجاني
نصيحة
امسح أولاً فقط؛ لا تحرق الرموز على التحليل الكامل حتى تلتزم بالتنظيف

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: قراءة/كتابة نظام الملفات على جذر المكتبة فقط
تخزين بيانات الاعتماد: مفتاح TMDB في متغير البيئة
نقل البيانات الخارجي: TMDB API للتحقق من الاكتمال (البيانات الوصفية العامة فقط)
لا تمنح أبدًا: لا تشغّل كـ root على قرص الوسائط — استخدم مستخدماً بامتياز الكتابة على المكتبة فقط

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

كل شيء تم وضع علامة عليه كـ 'ملفات غير مهمة'

أشرت إليه في مجلد غير وسائط — تأكد من الجذر

تحقق: ls /media/downloads
التحقق من TMDB يرجع 401

TMDB_API_KEY مفقود أو غير صحيح

تحقق: curl https://api.themoviedb.org/3/movie/550?api_key=$TMDB_API_KEY
Jellyfin لا يزال لا يكتشف بعد إعادة التسمية

فرض إعادة مسح المكتبة؛ تحقق من أن المجلد يطابق التسمية المتوقعة من Jellyfin

البدائل

media-library-organizer-skill مقابل البدائل

البديلمتى تستخدمهاالمقايضة
FileBotتريد واجهة رسومية مع قوائم مدمجةمدفوعة، بدون حلقة Claude
tinyMediaManagerالتركيز على البيانات الوصفية بدلاً من تنظيف الملفات غير المهمةبدون دمج أو معالجة الحلقات المتناثرة

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills