الهوم لاب: مختبرك في البيت الأدلة التقنية

موسيقاك وكتبك الصوتية مع Navidrome وAudiobookshelf

كيف تحول مجلد الموسيقى والكتب الصوتية إلى خدمتين على سيرفر البيت، ولماذا ظهرت العناوين العربية مشوهة وفشل البحث العربي في التطبيقات، وكيف ينتقل مكان توقفك في الكتاب بين الأجهزة.

موسيقاك وكتبك الصوتية مع Navidrome وAudiobookshelf

في كثير من البيوت مكتبة صوتية لا يراها أحد: أقراص CD قديمة نسخت إلى ملفات MP3 قبل خمس عشرة سنة، وتسجيلات دروس ومحاضرات، وكتب صوتية اشتراها أحد أفراد العائلة أو نزلها من مكتبات مجانية، وكلها في مجلد على قرص خارجي لا يفتحه إلا من يعرف مكانه. والبديل الذي يستخدمه أغلب الناس اشتراك في خدمة بث موسيقى وخدمة كتب صوتية، وهو مريح، ولكنه لا يحتوي ملفاتك أنت، ولا يبقى لك منه شيء إذا توقفت عن الدفع.

وفي هذا المقال نحول هذا المجلد إلى خدمتين على سيرفر البيت: Navidrome للموسيقى، وهو سيرفر صغير يتكلم لغة Subsonic التي تفهمها عشرات التطبيقات على الجوال والحاسوب، وAudiobookshelf للكتب الصوتية، وهو مبني لما تحتاجه الكتب ولا تحتاجه الموسيقى: الفصول، ومكان التوقف الذي ينتقل معك من الجوال إلى الحاسوب. وقد شرحنا في ما هو الهوم لاب لماذا يستحق المختبر المنزلي أن يخدم البيت، وهنا سوف نشغل الخدمتين في Docker بمكتبة حقيقية برخص مفتوحة: مقطوعات لشوبان من مشروع Musopen في الملك العام، ومقطوعة عود برخصة CC BY-SA، وفصول من كتاب «كليلة ودمنة» بقراءة متطوعي LibriVox باللغة العربية.

وسوف نناقش في هذا المقال:

  • لماذا خدمتان وليس سيرفراً واحداً، وأين يقف Jellyfin من الموسيقى والكتب.
  • تشغيل Navidrome وAudiobookshelf في ملف Docker Compose واحد، وخطأ في اسم متغير أوقف الفحص الدوري دون أن يشتكي أحد.
  • الوسوم Tags هي المكتبة: ملفات تقول أسماؤها شيئاً ووسومها شيئاً آخر، وعنوان عربي ظهر حروفاً مشوهة.
  • واجهة Subsonic البرمجية بطلبات حقيقية، والبحث بالعربية الذي نجح في الويب وفشل في التطبيقات.
  • تحويل الصوت للجوال: FLAC وMP3 وOpus بالأرقام.
  • Audiobookshelf: الكتاب كمجلد ملفات أم ملف M4B بفصول، ومن أين تأتي الأسماء.
  • مزامنة مكان التوقف بين جهازين بطلبات حقيقية، والنسخ الاحتياطي لكل خدمة.

لماذا خدمتان وليس سيرفراً واحداً؟

قد يتساءل البعض: أليس Jellyfin يشغل الموسيقى والكتب أيضاً؟ والإجابة نعم، فهو يقبل مكتبة موسيقى ومكتبة كتب، وإذا كنت تشغله أصلاً للأفلام فقد يكفيك. ولكن الموسيقى والكتب الصوتية تختلفان عن الأفلام في الطريقة التي يستمع بها الناس. فالموسيقى تسمع في السيارة وأثناء العمل، بتطبيق خفيف يحفظ الأغاني على الجوال للاستماع دون اتصال، ويقفز بين آلاف المقطوعات، ويبحث بالفنان والملحن. والكتاب الصوتي يسمع على أيام وأسابيع، وأهم ما فيه أن تعود إلى نفس الجملة التي توقفت عندها، على أي جهاز، وأن ترى الفصول بأسمائها.

ولهذا ظهرت أدوات متخصصة لكل نوع. وNavidrome مكتوب بلغة Go، ويعمل كملف تنفيذي واحد، واستهلك في تجربتنا 54 ميجابايت من الذاكرة فقط، ولا يقدم تطبيقات خاصة به، وإنما يطبق واجهة Subsonic البرمجية المعروفة منذ سنوات، ومعها امتدادات OpenSubsonic، فيعمل مع أي تطبيق يدعمها، وصفحة التطبيقات فيها العشرات لـ Android وiOS والحاسوب والويب. أما Audiobookshelf فمكتوب بلغة JavaScript، واستهلك 52 ميجابايت، وله تطبيقاته الخاصة على الجوال، وكل تصميمه مبني حول الكتاب: المؤلف والراوي والسلسلة والفصول وتقدم كل مستخدم. والصورة التالية تبين كيف تعمل الخدمتان معاً في البيت:

رسم لمجلدين: /music فيه ملفات الموسيقى بوسومها ويقرؤه Navidrome الذي يقرأ الوسوم وليس أسماء الملفات ويقدم واجهة ويب وواجهة Subsonic API ويحول الصوت عند الطلب بأداة ffmpeg وذاكرته 54 MiB، ثم تطبيقات Subsonic على الجوال والحاسوب والمتصفح، ومجلد /audiobooks فيه مجلد لكل كتاب ويقرؤه Audiobookshelf الذي يفهم الفصول ويحفظ موضع كل مستخدم ويزامنه بين الأجهزة وذاكرته 52 MiB، ثم تطبيق Audiobookshelf والحاسوب بنفس الكتاب ونفس الموضع
سيرفران صغيران، كل واحد مصمم لنوع مختلف من الاستماع

فمتى يكفيك Jellyfin وحده؟ إذا كانت الموسيقى في بيتك قليلة، وتسمع أغلبها على التلفاز أو الحاسوب، ولا يحتاج أحد أن يحفظها على الجوال للاستماع دون اتصال، فمكتبة موسيقى في Jellyfin تكفي ولا داعي لخدمة إضافية. أما إذا كانت المكتبة بآلاف المقطوعات، أو كان أحد في البيت يريد تطبيقاً خاصاً بالموسيقى في السيارة، فهنا يظهر الفرق، لأن Navidrome يفتح لك كل تطبيقات Subsonic بدل تطبيق واحد. وكذلك الكتب: Jellyfin يشغل الكتاب الصوتي كملف، ولكن الفصول والراوي والسلسلة ومكان التوقف بين الأجهزة هي ما بني له Audiobookshelf أصلاً. ولا يوجد مانع من تشغيل الثلاثة معاً على نفس الجهاز، فاستهلاك الخدمتين الصغيرتين من الذاكرة نحو خمس ما يستهلكه Jellyfin أثناء التشغيل.

التشغيل في Docker Compose

الخدمتان خفيفتان لدرجة أن تشغيلهما في ملف واحد منطقي، ولكل واحدة مجلد بياناتها، والمجلدات الصوتية مربوطة للقراءة فقط لأن أياً منهما لا يحتاج أن يكتب فيها. وقد ثبتنا الإصدارين: Navidrome 0.64.2 وAudiobookshelf 2.38.0 الذي صدر قبل يوم واحد من التجربة:

services:
  navidrome:
    image: deluan/navidrome:0.64.2
    container_name: navidrome
    ports:
      - "4533:4533"
    environment:
      ND_LOGLEVEL: info
      ND_SCANNER_SCHEDULE: "@every 1h"
      ND_SESSIONTIMEOUT: 24h
      ND_DEFAULTLANGUAGE: ar
    volumes:
      - navidrome-data:/data
      - /srv/music:/music:ro
    restart: unless-stopped
  audiobookshelf:
    image: ghcr.io/advplyr/audiobookshelf:2.38.0
    container_name: audiobookshelf
    ports:
      - "13378:80"
    environment:
      TZ: Asia/Riyadh
    volumes:
      - /srv/audiobooks:/audiobooks:ro
      - abs-config:/config
      - abs-metadata:/metadata
    restart: unless-stopped
volumes:
  navidrome-data:
  abs-config:
  abs-metadata:

في الإعداد أعلاه لاحظ التالي:

  • Navidrome يحفظ قاعدة SQLite والصور المؤقتة في /data، ويقرأ الموسيقى من /music، ويعمل على المنفذ 4533.
  • Audiobookshelf يفصل بين /config وفيه قاعدة البيانات، و/metadata وفيه الأغلفة والسجلات والنسخ الاحتياطية، وتنبه صفحة التثبيت في Docker إلى أن /config يجب أن يكون على نفس الجهاز وليس على مجلد شبكة، لأنه قاعدة SQLite.
  • متغير الفحص الدوري اسمه ND_SCANNER_SCHEDULE، وهذا السطر بالذات له قصة نرويها الآن.

متغير باسم قديم أوقف الفحص الدوري بصمت

في أول تشغيل كتبنا المتغير بالاسم ND_SCANSCHEDULE: 1h، وهو الاسم الذي ستجده في أمثلة كثيرة على الإنترنت، ثم قرأنا السجل:

                          Version: 0.64.2 (10114574)

time="2026-11-18T11:55:38Z" level=info msg="No configuration file found. Loaded configuration only from environment variables"
time="2026-11-18T11:55:38Z" level=info msg="Creating DB Schema"
time="2026-11-18T11:55:43Z" level=info msg="Starting signaler"
time="2026-11-18T11:55:43Z" level=info msg="Periodic scan is DISABLED"
time="2026-11-18T11:55:43Z" level=info msg="Starting scheduler"
time="2026-11-18T11:55:43Z" level=info msg="Periodic backup is DISABLED"
time="2026-11-18T11:55:48Z" level=info msg="Scanner: Finished scanning all libraries" duration=2.66s
time="2026-11-18T11:55:55Z" level=warning msg="Artist not found in deezer" artist="Andy R. Jordan"

السطر المهم Periodic scan is DISABLED: الفحص الدوري موقوف رغم أننا طلبناه. والسبب في صفحة خيارات الإعداد: الخيار الحالي اسمه Scanner.Schedule ومتغيره ND_SCANNER_SCHEDULE، وقيمته الافتراضية 0 أي موقوف، أما الاسم القديم فلم يعد يقرأ ولم يظهر أي تحذير. وهذا النوع من الأخطاء هو الأسوأ، لأن السيرفر يعمل ويبدو كل شيء صحيحاً، ثم تضيف ألبوماً جديداً بعد شهر ولا يظهر، فتظن أن الملف معطوب. لذلك اقرأ أسطر البدء في السجل بعد أي تغيير في المتغيرات، فهي تقول لك ما فهمه السيرفر وليس ما كتبته أنت.

وفي نفس السجل لاحظ أمرين آخرين: الفحص الأول لسبعة ملفات أخذ 2.66 ثانية، أي أن Navidrome سريع جداً في الفحص، والسطر الأخير يقول إن السيرفر سأل خدمة Deezer عن صورة الفنان ولم يجده. وهذا لأن Navidrome يستخدم افتراضياً وكلاء Agents خارجيين لجلب صور الفنانين ونبذهم، وهم Last.fm وListenBrainz وDeezer، وتذكر صفحة الخيارات أن المتغير ND_ENABLEEXTERNALSERVICES=false يوقف كل الاتصالات الخارجية، ومعها جمع البيانات المجهولة وصور خلفية صفحة الدخول. فإذا كنت تريد سيرفراً لا يتصل بأحد فهذا هو المتغير.

ثم أنشأنا حساب المدير، وهو أول حساب يسجل، ثم تحققنا من الواجهة البرمجية بطلب ping، وسوف نشرح طريقة الدخول في قسم Subsonic:

{"subsonic-response":{"status":"ok","version":"1.16.1","type":"navidrome","serverVersion":"0.64.2 (10114574)","openSubsonic":true}}

كيف يفحص Navidrome المكتبة؟

الفاحص في Navidrome يمر على المجلدات واحداً واحداً، ويقرأ وسوم كل ملف صوتي، ويحفظ في قاعدة SQLite المقطوعات والألبومات والفنانين والمشاركين، ثم يبني منها فهرس البحث. وكل مجلد يكتب سطراً في السجل بعد أن ينتهي، ومن تجربتنا:

level=info msg="Scanner: Completed processing folder" audioCount=5 elapsed=2.38s imageCount=0 library="Music Library" plsCount=0 tracksImported=5 tracksMissing=0
level=warning msg="Playlists will not be imported, as there are no admin users yet. They will be imported automatically once an admin user is created."
level=info msg="Scanner: Finished scanning all libraries" duration=2.66s

وفي هذه الأسطر لاحظ التالي: imageCount=0 يعني أن المجلد لا يحتوي صورة غلاف، فيعتمد Navidrome على الصورة داخل الملف إن وجدت، ثم على الوكلاء الخارجيين. وtracksMissing هو عدد المقطوعات التي كانت في القاعدة واختفت من القرص، وهو الرقم الذي تراقبه بعد أن تنقل ملفات أو تعيد ترتيبها. والسطر التحذيري يقول إن ملفات قوائم التشغيل M3U الموجودة في مجلد الموسيقى لن تستورد حتى ينشأ حساب المدير، لأنها تحتاج مالكاً. ويذكر توثيق Navidrome أنه يراقب المكتبة ويستورد الملفات الجديدة تلقائياً، ومعه الفحص الدوري الذي ضبطناه كل ساعة كاحتياط، لأن مراقبة الملفات قد لا تعمل على بعض المجلدات المشتركة عبر الشبكة.

وهناك ملاحظة أخرى من صفحة التوافق تستحق الذكر: معرفات العناصر في Navidrome نصوص دائماً، مثل 2sYnv97N9q194eqQOT2LBA التي رأيتها في المخرج، وبعض التطبيقات القديمة تحاول تحويلها إلى أرقام لأن Subsonic الأصلي كان يستخدم أرقاماً، فتفشل في فتح الألبومات. فإذا رأيت تطبيقاً يعرض القوائم ولا يفتح أي ألبوم، فهذا هو السبب الأرجح، وابحث عن تطبيق آخر من القائمة الرسمية.

الوسوم Tags هي المكتبة

أهم جملة في توثيق Navidrome موجودة في دليل الوسوم: Navidrome ينظم المكتبة بالكامل من الوسوم داخل الملفات، ولا يستخدم أسماء المجلدات ولا أسماء الملفات لتجميع المقطوعات. والوسوم الأساسية التي يطلبها لكل ملف هي العنوان Title والفنان Artist والألبوم Album وفنان الألبوم Album Artist ورقم المقطوعة Track Number. وقد ظهر لنا في التجربة لماذا هذه الجملة مهمة، من ملفات لم نكتبها نحن.

ملفات تقول أسماؤها شيئاً ووسومها شيئاً آخر

نزلنا خمس مقطوعات قصيرة من مقدمات شوبان Op. 28 بصيغة FLAC من مجموعة Musopen في Internet Archive، وهي مرخصة CC0. وقبل أن نضعها في المكتبة قرأنا وسومها بالأداة ffprobe، فوجدنا هذا في ملف واحد منها:

== Preludes, Op. 28 - No. 10 'The night moth'.flac
format|duration=32.022971|tag:ARTIST=Jeannette Fang|tag:GENRE=Classical|tag:ALBUM=The Complete Works of Frédéric Chopin|tag:album_artist=Various Artists|...|tag:TITLE=Prelude op. 28 no. 14|tag:track=64|...|tag:COMPILATION=1|tag:RELEASEDATE=2015|tag:COMPOSER=Frédéric Chopin

اسم الملف يقول المقدمة رقم 10، ووسم العنوان يقول رقم 14. ووجدنا نفس الاختلاف في ملفين آخرين: الملف رقم 14 وسمه رقم 11، والملف رقم 7 وسمه «no. 7, 8». أي أن من رفع المجموعة سمى الملفات بطريقة وكتب الوسوم بطريقة أخرى، ولا نعرف أيهما الصحيح دون أن نستمع ونقارن بالنوتة. والذي يهمنا هنا ماذا يعرض Navidrome، فسألناه عن الألبوم بالواجهة البرمجية:

1iI9aod4Cn8Y6xRRJyP6GT | 59 | Prelude op. 28 no. 1 | Jeannette Fang | flac 558kbps 32s | 59 - Prelude op. 28 no. 1.flac | composer: ["Frédéric Chopin"]
2irvSF32gxvRqbXCS5UmR1 | 61 | Prelude op. 28 no. 11 | Jeannette Fang | flac 581kbps 40s | 61 - Prelude op. 28 no. 11.flac | composer: ["Frédéric Chopin"]
2SU80HKg52V31ohKGOufYd | 64 | Prelude op. 28 no. 14 | Jeannette Fang | flac 488kbps 32s | 64 - Prelude op. 28 no. 14.flac | composer: ["Frédéric Chopin"]
5yDkfaFIHgd9qkOvpNnWje | 74 | Prelude op. 28 no. 5 | Jeannette Fang | flac 538kbps 35s | 74 - Prelude op. 28 no. 5.flac | composer: ["Frédéric Chopin"]
2Udh39cvcbv30UW9b0Cmrt | 76 | Prelude op. 28 no. 7, 8 | Jeannette Fang | flac 447kbps 33s | 76 - Prelude op. 28 no. 7, 8.flac | composer: ["Frédéric Chopin"]

وفي هذا المخرج لاحظ التالي:

  • العنوان من الوسم دائماً، ولا أثر لأسماء الملفات. وحتى المسار الذي ترجعه الواجهة 59 - Prelude op. 28 no. 1.flac ليس مساراً حقيقياً، وإنما مسار تبنيه من الوسوم، وتشرح صفحة توافق Subsonic أن Navidrome لا يدعم التصفح بالمجلدات، ويرجع شجرة مصطنعة بالشكل /Artist/Album/01 - Song.mp3.
  • أرقام المقطوعات 59 و61 و64 من ترتيبها في المجموعة الكاملة، فرتبها Navidrome بها.
  • الألبوم ظهر تحت Various Artists، لأن وسم فنان الألبوم كذلك ومعه علامة المجموعة COMPILATION=1، وظهرت العازفة Jeannette Fang كفنانة لكل مقطوعة، وشوبان كملحن Composer في قائمة المشاركين.

والدرس أن تصلح الوسوم قبل أن تضيف الملفات إلى المكتبة، بأداة مثل MusicBrainz Picard أو Mp3tag أو Kid3، وليس أسماء الملفات، فكل تطبيق يتصل بالسيرفر سوف يعرض ما في الوسوم. والصورة التالية الألبوم كما يظهر في واجهة Navidrome:

لقطة صفحة ألبوم في واجهة Navidrome: The Complete Works of Frédéric Chopin لفنان Various Artists بتاريخ 2015 وخمس مقطوعات مدتها 02:55 وحجمها 11.4 MB ونوع Classical، وجدول المقطوعات بالأرقام 59 و61 و64 و74 و76 وعناوين Prelude op. 28 والعازفة Jeannette Fang وجودة FLAC
العناوين والأرقام والفنان كلها من الوسوم، وليس من أسماء الملفات

عنوان عربي ظهر حروفاً مشوهة

هذه المشكلة يعرفها كل من نسخ أغاني عربية من أقراص قديمة: الأغنية تعمل، ولكن عنوانها في المشغل حروف لاتينية غريبة. والسبب أن صيغة وسوم MP3 القديمة ID3v2.3 تحفظ النص إما بترميز UTF-16 وإما بترميز Latin-1، وكثير من برامج Windows القديمة كانت تكتب الحروف العربية بترميز Windows-1256 داخل إطار مكتوب عليه Latin-1، فيقرؤها كل برنامج حديث على أنها حروف أوروبية. وقد شرحنا هذا النوع من التشويه بالتفصيل في ترميز النصوص من ASCII إلى UTF-8.

ولكي نرى ما يفعله Navidrome بذلك، أخذنا مقطوعة العود للعازف Andy R. Jordan، وهي منشورة برخصة CC BY-SA 3.0 في Wikimedia Commons دون عنوان وصنعنا منها نسختين بسكربت Python صغير بمكتبة mutagen: الأولى بوسوم عربية بترميز UTF-8 في ID3v2.4، والثانية بنفس النصوص العربية مكتوبة بالطريقة القديمة:

latin = lambda s: s.encode('cp1256').decode('latin-1')   # what an old Windows tagger stored
for k, v in [(TIT2, 'موسيقى عود بترميز قديم'), (TALB, 'اختبار الترميز'), (TPE1, 'Andy R. Jordan'), (TRCK, '2')]:
    t.add(k(encoding=0, text=latin(v)))
t.save(v2_version=3)

ثم سألنا Navidrome عن الألبومات:

4cdphId0DHhC12V3RJMJE4 | ÇÎÊÈÇÑ ÇáÊÑãíÒ | Andy R. Jordan | 1 songs
2sYnv97N9q194eqQOT2LBA | The Complete Works of Frédéric Chopin | Various Artists | 5 songs
196PKArDYjmPLJB4qbl4Db | عود | Andy R. Jordan | 1 songs

الألبوم بترميز UTF-8 ظهر «عود» كما يجب، أما الآخر فظهر ÇÎÊÈÇÑ ÇáÊÑãíÒ، وهي نفس بايتات «اختبار الترميز» مقروءة كحروف أوروبية. وNavidrome هنا لا يخطئ، فهو يقرأ ما يقوله الملف عن نفسه بالضبط، والخطأ في الملف. والصورة التالية الألبومات الثلاثة في الواجهة:

لقطة قائمة الألبومات في Navidrome: ألبوم بعنوان حروف لاتينية مشوهة للفنان Andy R. Jordan، وألبوم The Complete Works of Frédéric Chopin بصورة شوبان للفنان Various Artists، وألبوم بعنوان عود للفنان Andy R. Jordan
نفس النص العربي بطريقتين، والفرق كله في الملف

والحل أن تصلح الوسوم مرة واحدة قبل الإضافة، فأدوات الوسوم الحديثة مثل Kid3 وMp3tag تحول ترميز الوسوم إلى UTF-8، وبعضها يسمح باختيار الترميز الأصلي عند القراءة. ولاحظ أن صورة شوبان في الألبوم الثاني لم تكن في الملفات، وإنما جلبها Navidrome من الوكلاء الخارجيين، وهذا مثال على ما يتوقف إذا أوقفت الخدمات الخارجية.

رسم بقسمين: الأول اسم الملف Preludes Op. 28 No. 10 The night moth ووسم العنوان Prelude op. 28 no. 14 ورقم 64 والألبوم والفنان، وNavidrome عرض العنوان من الوسم ووضع الألبوم تحت Various Artists، والثاني نفس النص العربي بطريقتين في ملف MP3: UTF-8 في ID3v2.4 ظهر عود وموسيقى عود، وWindows-1256 في إطار Latin-1 ظهر حروفاً مشوهة، والبحث عن عود عبر Subsonic API رجع بلا نتائج وفي واجهة الويب وجد الألبوم
ما رآه Navidrome فعلاً من الوسوم

الملحن والعازف والأسماء العربية

الموسيقى الكلاسيكية تكشف ضعف الوسوم البسيطة أكثر من غيرها، لأن لكل مقطوعة ملحناً وعازفاً وأحياناً قائد فرقة، والوسم الواحد Artist لا يتسع لهم. ولذلك يقرأ Navidrome وسوماً للأدوار مثل COMPOSER، وقد رأينا في التجربة أنه سجل شوبان ملحناً والعازفة فنانة، فيمكنك أن تبحث عن «chopin» فتجد كل ما لحنه، وعن «fang» فتجد كل ما عزفته. وهذا يعتمد على أن الوسم موجود في الملف أصلاً، ومجموعة Musopen كانت مكتوبة بعناية في هذه النقطة رغم خطأ العناوين.

وفي الموسيقى العربية مشكلة إضافية: نفس الاسم يكتب بأكثر من طريقة، بالهمزة ودونها، وبالتاء المربوطة أو الهاء، وبالحروف العربية مرة وبالحروف اللاتينية مرة. وNavidrome يجمع الألبومات والفنانين بالنص كما هو، فإذا كتب اسم المطرب بطريقتين في ألبومين ظهر فنانان مختلفان. لذلك اختر كتابة واحدة لكل اسم واكتبها في كل الملفات، ويوصي دليل الوسوم في Navidrome بنفس الشيء للأسماء الإنجليزية: قرر هل الاسم «AC/DC» أم «ACDC» والتزم به. وإذا كانت المكتبة كبيرة فأداة مثل MusicBrainz Picard تطابق الألبومات مع قاعدة بيانات عامة وتكتب الوسوم بطريقة موحدة، ولكن تأكد بعدها أن الأسماء العربية لم تتحول إلى كتابة لاتينية إذا كنت تريدها عربية.

واجهة Subsonic البرمجية: ما تستخدمه كل التطبيقات

Subsonic سيرفر موسيقى قديم، وما بقي منه هو واجهته البرمجية التي أصبحت معياراً تتبعه سيرفرات كثيرة، وأضاف إليها مجتمع OpenSubsonic امتدادات حديثة، وNavidrome يعلن أنه متوافق معها بالقيمة "openSubsonic":true في رد ping. والمهم أن تفهم طريقة الدخول فيها، لأنها سبب أغلب مشاكل التطبيقات: كل طلب يحمل اسم المستخدم u، وقيمة عشوائية s تسمى Salt، ورمزاً t هو هاش MD5 لكلمة المرور مضافاً إليها نفس القيمة العشوائية، فلا تنتقل كلمة المرور نفسها. والدالة التالية هي ما استخدمناه لكل الطلبات:

sub(){ m=$1; shift; S=$(openssl rand -hex 6); TK=$(printf '%s' "$ND_PASS$S" | md5sum | cut -d' ' -f1); curl -s -G "$N/rest/$m" --data-urlencode "u=admin" --data-urlencode "t=$TK" --data-urlencode "s=$S" --data-urlencode "v=1.16.1" --data-urlencode "c=hl2-lab" --data-urlencode "f=json" "$@"; }

ولاحظ ما تعنيه هذه الطريقة: السيرفر يحتاج كلمة المرور نفسها لكي يحسب نفس الهاش ويقارن، ولذلك يحفظها Navidrome بطريقة قابلة للاسترجاع، والهاش MD5 ضعيف أصلاً. لذلك لا تفتح Navidrome على الإنترنت دون HTTPS، ولا تستخدم كلمة مرور حسابك فيه في أي مكان آخر، وأعط كل فرد في العائلة حساباً مستقلاً. ثم سألنا عن الفنانين:

sub getArtists
index A | Andy R. Jordan | albums 2
index V | Various Artists | albums 1

والفهرس هنا بفناني الألبومات وليس بكل الفنانين، لذلك لم تظهر العازفة ولا الملحن في هذه القائمة، مع أنهما يظهران في البحث كما سوف نرى.

البحث بالعربية: نجح في الويب وفشل في التطبيقات

بحثنا بالطلب search3، وهو ما تستخدمه تطبيقات الجوال عندما تكتب في خانة البحث، بكلمات إنجليزية وعربية:

search3 'chopin': artists Frédéric Chopin | albums The Complete Works of Frédéric Chopin | songs 5
search3 'fang': artists Jeannette Fang | albums The Complete Works of Frédéric Chopin | songs 5
search3 'prelude': artists  | albums  | songs 5
search3 'عود': artists  | albums  | songs 0
search3 'موسيقى': artists  | albums  | songs 0
search3 'عود*': artists 0 | albums  | songs
search3 'caenaio': artists 0 | albums ÇÎÊÈÇÑ ÇáÊÑãíÒ | songs ãæÓíÞì ÚæÏ ÈÊÑãíÒ ÞÏíã

كل كلمة إنجليزية وجدت ما تبحث عنه، ومنها الملحن والعازفة، أما الكلمات العربية فلم تجد شيئاً، رغم أن الألبوم اسمه «عود» حرفياً. والأغرب السطر الأخير: كلمة caenaio وجدت الألبوم المشوه، لأنها النص المشوه بعد أن يحول Navidrome الحروف الأوروبية إلى حروف لاتينية بسيطة. فبحثنا في قاعدة البيانات نفسها، ووجدنا أن عمود البحث فيه الكلمات العربية:

موسيقى عود| andy jordan r. عود موسيقى
ÇÎÊÈÇÑ ÇáÊÑãíÒ| andy caenaio cieecn jordan r.
عود| andy jordan r. عود

ثم بحثنا بالواجهة البرمجية الخاصة بواجهة الويب، وهي غير واجهة Subsonic:

album?name=عود -> 1 عود
song?title=عود -> 1 موسيقى عود
album?name=chopin -> 1 The Complete Works of Frédéric Chopin

أي أن البحث العربي يعمل في واجهة الويب، ولا يعمل في طلب search3 الذي تستخدمه التطبيقات، في هذا الإصدار. والسبب الأرجح في طريقة تجهيز جملة البحث قبل تمريرها إلى فهرس البحث، فالفهرس الكامل FTS5 في القاعدة معرف بالمقسم unicode61 الذي يفهم الحروف العربية، والكلمات العربية موجودة فيه. وفي مستودع المشروع إصلاح مغلق لمشكلة قريبة تخص أسماء الفنانين بغير الحروف اللاتينية بعد الانتقال إلى FTS5. لذلك إذا كانت مكتبتك عربية فجرب البحث من التطبيق الذي تستخدمه العائلة فعلاً قبل أن تعتمد عليه، وتابع ملاحظات الإصدارات القادمة، وحتى ذلك الحين فالبحث العربي من واجهة الويب يعمل. وإذا أردت أن تفهم لماذا البحث في النص العربي أصعب من غيره، فقد شرحنا ذلك في البحث في النصوص العربية.

أي صيغة تحفظ بها الأرشيف؟ FLAC أم MP3 أم Opus

قبل أن تملأ القرص بالموسيقى يجب أن تفرق بين صيغة الأرشيف وصيغة الاستماع. فالصيغة بلا فقد Lossless مثل FLAC تحفظ الصوت كما هو على القرص المضغوط بالضبط، وتضغطه بطريقة يمكن عكسها مثل ضغط ملف ZIP، كما شرحنا في كيف يعمل ضغط البيانات. والصوت على القرص المضغوط معدله 1411 كيلوبت في الثانية، ومقطوعات شوبان في تجربتنا كانت بصيغة FLAC بمعدلات بين 447 و581 كيلوبت كما رجعت من Navidrome، أي أن FLAC ضغطها إلى نحو ثلث الحجم دون أن يضيع شيء. أما الصيغ بفقد Lossy مثل MP3 وAAC وOpus فتحذف من الصوت ما يقدر المرمز أن الأذن لن تلاحظه، فتصغر الملف كثيراً، ولكن ما حذف لا يعود.

والقاعدة العملية من ذلك ثلاث نقاط. الأولى: احفظ الأرشيف بأعلى صيغة عندك، FLAC إذا نسخت أقراصك بنفسك، والملف الأصلي كما هو إذا اشتريته MP3. والثانية: لا تحول أرشيفاً بفقد إلى صيغة أخرى بفقد لتوفر المساحة، فتحويل MP3 بمعدل 320 إلى Opus بمعدل 96 يجمع خسارة المرمزين معاً، وهذا يشبه ما شرحناه عن الفيديو في دليل Tdarr. والثالثة: اترك التحويل لصيغة الاستماع إلى Navidrome عند الطلب، كما سوف نرى في القسم التالي، فهو رخيص ويعطي كل جهاز ما يناسبه دون أن تغير الأرشيف.

ولتحسب المساحة: ساعة FLAC بنحو 500 كيلوبت في الثانية تساوي نحو 225 ميجابايت، فألف ألبوم مدة كل منها ساعة تحتاج نحو 225 جيجابايت، وهذا قليل على أقراص اليوم. أما الكتب الصوتية فأغلبها كلام بمعدل منخفض، ففصول LibriVox كانت MP3 بمعدل 64 كيلوبت، أي نحو 29 ميجابايت للساعة، والكتاب الطويل بعشرين ساعة أقل من 600 ميجابايت.

تحويل الصوت للجوال

ملفات FLAC بلا فقد، وهي أفضل صيغة لأرشيفك، ولكنها كبيرة على بيانات الجوال. ولذلك يحول Navidrome الصوت عند الطلب بأداة ffmpeg داخل ال Container، والتطبيق هو الذي يطلب الصيغة والمعدل. وطلبنا نفس المقطوعة التي مدتها 40 ثانية بثلاث طرق:

curl -s -o /tmp/out.bin -w "%{size_download} bytes in %{time_total}s, first byte %{time_starttransfer}s\n" \
  "$N/rest/stream?id=$ID&u=admin&t=$TK&s=$S&v=1.16.1&c=hl2-lab&format=opus&maxBitRate=96"
format=raw: 3013933 bytes in 0.045858s, first byte 0.007355s
Content-Type: audio/flac
format=mp3&maxBitRate=128: 644116 bytes in 4.012680s, first byte 2.591207s
Content-Type: audio/mpeg
format=opus&maxBitRate=96: 492018 bytes in 0.895733s, first byte 0.227890s
Content-Type: audio/ogg
رسم أعمدة لنفس المقطوعة ومدتها 40 ثانية: FLAC كما هو 3.01 MB وأول بايت بعد 0.007 ثانية، وMP3 بمعدل 128 حجمه 0.64 MB وأول بايت بعد 2.59 ثانية، وOpus بمعدل 96 حجمه 0.49 MB وأول بايت بعد 0.23 ثانية
نفس المقطوعة بثلاث صيغ عبر طلب stream

وفي هذه الأرقام لاحظ التالي:

  • FLAC كما هو 3 ميجابايت لأربعين ثانية، أي نحو 270 ميجابايت لساعة استماع، وهذا مقبول على Wi-Fi البيت فقط.
  • Opus بمعدل 96 كيلوبت أعطى 0.49 ميجابايت، أي سدس الحجم تقريباً، وهو ترميز حديث يعطي جودة جيدة بمعدلات منخفضة، والأنسب للجوال إذا كان التطبيق يدعمه.
  • أول طلب MP3 انتظر 2.6 ثانية قبل أول بايت، لأن ffmpeg بدأ لأول مرة في ذلك الطلب، وما بعده كان أسرع. أي أن أول أغنية بعد إعادة تشغيل السيرفر قد تتأخر قليلاً.

ولكي تعرف أثر الصيغة على بيانات الجوال احسبها بالساعة: Opus بمعدل 96 كيلوبت يساوي نحو 43 ميجابايت لكل ساعة استماع، وMP3 بمعدل 128 نحو 58 ميجابايت، وFLAC كما هو نحو 225 ميجابايت. فإذا كان أحد أفراد البيت يستمع ساعة كل يوم في الطريق، فالشهر بصيغة Opus نحو 1.3 جيجابايت، وبصيغة FLAC نحو 6.8 جيجابايت، والفرق كله يأتي من إعداد واحد في التطبيق. والأفضل من ذلك أن تحفظ القوائم التي يسمعها كل يوم على الجوال وهو في البيت، فأغلب تطبيقات Subsonic تدعم الاستماع دون اتصال، وعندها لا يستهلك الطريق شيئاً، ولا يحتاج السيرفر أن يكون متاحاً من الخارج إلا للمقطوعات الجديدة.

وتحويل الصوت رخيص جداً مقارنة بتحويل الفيديو الذي قسناه في دليل Jellyfin، لذلك لا تقلق من عدد المستمعين في البيت. وإذا أردت أن تفهم ما يحدث داخل ffmpeg فقد شرحناه في FFmpeg عملياً.

التطبيقات على الجوال والحاسوب

لا يقدم Navidrome تطبيقاً للجوال، وهذا مقصود: كل تطبيق يدعم واجهة Subsonic أو OpenSubsonic يعمل معه، وصفحة التطبيقات في موقعه تجمع العشرات لـ Android وiOS والحاسوب والويب، ومنها تطبيقات مع CarPlay وAndroid Auto وحفظ للاستماع دون اتصال. والنصيحة العملية عند الاختيار أن تتحقق من ثلاثة أشياء: أن التطبيق يدعم OpenSubsonic وليس Subsonic القديم فقط، لأن بعض المزايا مثل الأدوار المتعددة للفنانين تعتمد على الامتدادات، وأنه يطلب صيغة Opus أو MP3 بمعدل تحدده أنت للجوال، وأن البحث العربي فيه يعمل مع مكتبتك كما رأينا في القسم السابق.

أما واجهة الويب المدمجة فتكفي للاستماع على الحاسوب، وفيها قوائم التشغيل والمفضلة والمشاركة برابط. ولاحظ أن لغة الواجهة لم تتغير إلى العربية في تجربتنا رغم المتغير ND_DEFAULTLANGUAGE: ar، مع أن العربية موجودة ضمن 36 لغة في قائمة الترجمات، والسبب في وصف الخيار نفسه: يحدد اللغة عند الدخول من متصفح جديد فقط، ويبقى اختيار كل مستخدم في متصفحه، فيغيرها كل فرد من إعداداته الشخصية.

Audiobookshelf: الكتاب ليس ألبوماً

الكتاب الصوتي في Audiobookshelf هو مجلد، كما تشرح صفحة تنظيم المجلدات: مجلد لكل كتاب، يمكن أن يكون داخل مجلد المؤلف ومجلد السلسلة بالشكل {Author}/{Series}/{Book}، وفيه ملفات الصوت والغلاف. ويمكن أن يكون الكتاب ملفاً واحداً بصيغة M4B فيه الفصول. وقد بنينا الكتاب بالطريقتين من نفس الفصول الستة لنرى الفرق:

/srv/audiobooks
└── عبد الله بن المقفع
    ├── كليلة ودمنة (مختارات)
    │   ├── cover.jpg
    │   ├── kalilawadimna_01_ibnalmuqaffa_64kb.mp3
    │   ├── kalilawadimna_16_ibnalmuqaffa_64kb.mp3
    │   ├── ...
    │   └── kalilawadimna_26_ibnalmuqaffa_64kb.mp3
    └── كليلة ودمنة (M4B)
        └── كليلة ودمنة (مختارات).m4b

ولأسماء المجلدات في Audiobookshelf قواعد تفيدك عندما لا تكون في الملفات وسوم جيدة، كما تفصلها صفحة تنظيم المجلدات: مجلد المؤلف ثم مجلد السلسلة ثم مجلد الكتاب، ورقم الكتاب في السلسلة يكتب بالشكل Vol 1 في أول اسم المجلد أو بعد شرطة ومسافة، وسنة النشر في أول الاسم أو بعد رقم السلسلة، واسم الراوي بين قوسين معقوفين مثل {Sam Tsoutsouvas}. ومن الأمثلة في الصفحة مجلد باسم Vol 1 - 1994 - Wizards First Rule {Sam Tsoutsouvas}، فيفهم منه الرقم والسنة والعنوان والراوي. والصفحة تذكر أيضاً أي وسم في ملفات الصوت يقابل أي حقل، فوسم composer مثلاً يقرأ كاسم الراوي، وهذا يفسر لماذا تظهر بعض الكتب براو غريب إذا كان من صنع الملف قد وضع في هذا الوسم شيئاً آخر.

والفصول من تسجيل LibriVox لكتاب «كليلة ودمنة» باللغة العربية، وهو في الملك العام، ومنشور في صفحته على Internet Archive، واخترنا منه ستة فصول قصيرة. أما ملف M4B فبنيناه بأداة ffmpeg: جمعنا الملفات، وكتبنا لكل فصل بدايته ونهايته بالمللي ثانية في ملف بيانات FFMETADATA، وأخذنا عنوان كل فصل من وسم الملف الأصلي، ثم حولنا الصوت إلى AAC بقناة واحدة ووضعنا الغلاف داخل الملف:

ffmpeg -v error -y -f concat -safe 0 -i /tmp/list.txt -i /tmp/meta.txt -i kalila_2608.jpg \
  -map 0:a -map 2:v -map_metadata 1 -map_chapters 1 \
  -c:a aac -b:a 64k -ac 1 -c:v copy -disposition:v attached_pic "كليلة ودمنة (مختارات).m4b"
ffprobe -v error -show_chapters -show_entries format=duration -of compact "كليلة ودمنة (مختارات).m4b"
chapter|id=0|time_base=1/1000|start=0|start_time=0.000000|end=226115|end_time=226.115000|tag:title=01 - مقدمة صاحب النسخة
chapter|id=1|time_base=1/1000|start=226115|start_time=226.115000|end=552332|end_time=552.332000|tag:title=16 - الباب الخامس : الناسك وابن عرس
chapter|id=2|time_base=1/1000|start=552332|start_time=552.332000|end=931290|end_time=931.290000|tag:title=23 - الباب الثاني عشر : الإسوار واللبؤة الشعهر
chapter|id=3|time_base=1/1000|start=931290|start_time=931.290000|end=1179792|end_time=1179.792000|tag:title=24 - الباب الثالث عشر : الناسك والضيف
chapter|id=4|time_base=1/1000|start=1179792|start_time=1179.792000|end=1493392|end_time=1493.392000|tag:title=25 - الباب الرابع عشر : الحمامة والثعلب ومالك الحزين
chapter|id=5|time_base=1/1000|start=1493392|start_time=1493.392000|end=1675857|end_time=1675.857000|tag:title=26 - خاتمة الكتاب
format|duration=1675.857000

ستة فصول بعناوينها العربية داخل ملف واحد مدته 1675.9 ثانية. ثم أنشأنا مكتبة كتب في Audiobookshelf على /audiobooks وطلبنا الفحص، فظهر في السجل Library scan ... completed in 0:01 | 2 Added | 0 Updated | 0 Missing، وسألنا عن الكتابين:

d3887052-89c2-4616-a467-ec7c75aeee1e | كليلة ودمنة [Kalila wa dimna] | Abdullah Ibn al-Muqaffaʿ | files 6 | chapters 6 | dur 1675 | عبد الله بن المقفع/كليلة ودمنة (مختارات)
9e51e97e-be7e-468d-9522-5378608b72f8 | كليلة ودمنة (مختارات) | عبد الله بن المقفع | files 1 | chapters 6 | dur 1676 | عبد الله بن المقفع/كليلة ودمنة (M4B)

كلا الكتابين له ستة فصول، ففي الأول أصبح كل ملف فصلاً باسم وسم عنوانه، وفي الثاني قرأ Audiobookshelf الفصول من داخل الملف. ولكن لاحظ العنوان والمؤلف: الكتاب الأول اسمه «كليلة ودمنة [Kalila wa dimna]» ومؤلفه بالحروف اللاتينية، مع أن المجلد عربي، والثاني اسمه ومؤلفه عربيان. والسبب ظهر في السجل عند الفحص:

[LibraryScanner] Library metadata precedence changed since last scan. From [Unset] to [folderStructure,audioMetatags,nfoFile,txtFiles,opfFile,absMetadata]

هذا ترتيب مصادر البيانات، وكل مصدر يأتي بعد غيره يغلبه، كما تشرح صفحة البيانات الوصفية للكتب: بنية المجلدات هي الأضعف، ثم وسوم ملفات الصوت، ثم ملفات NFO وTXT وOPF، ثم بيانات Audiobookshelf نفسها. وملفات LibriVox تحمل في وسومها العنوان «كليلة ودمنة [Kalila wa dimna]» والمؤلف بالحروف اللاتينية، فغلبت اسم المجلد العربي. أما ملف M4B فكتبنا وسومه بالعربية بأنفسنا، فظهر كما نريد. وتستطيع أن تغير هذا الترتيب لكل مكتبة، أو أن تعدل بيانات الكتاب من الواجهة، وعندها تحفظ في بيانات Audiobookshelf التي تغلب كل شيء.

رسم بقسمين: مجلد فيه ستة ملفات MP3 أصبح كل ملف فيه فصلاً باسم وسم العنوان وأخذ العنوان والمؤلف من الوسوم وليس من المجلد، وملف M4B واحد بفصول داخله بنيناه بأداة ffmpeg ووسومه عربية فظهر العنوان والمؤلف بالعربية، وأسفلهما ترتيب مصادر البيانات folderStructure ثم audioMetatags ثم nfoFile ثم txtFiles ثم opfFile ثم absMetadata
نفس الفصول بشكلين، والأسماء من أقوى مصدر في الترتيب

والصورة التالية المكتبة في واجهة Audiobookshelf، ولاحظ الشريط الأصفر أسفل غلاف الكتاب الثاني، وهو التقدم الذي سوف نصنعه في القسم التالي:

لقطة مكتبة Audiobookshelf باسم الكتب الصوتية وفيها كتابان بنفس الغلاف: كليلة ودمنة (مختارات) لعبد الله بن المقفع، وكليلة ودمنة [Kalila wa dimna] لـ Abdullah Ibn al-Muqaffa مع شريط تقدم أصفر أسفل الغلاف
الكتابان في المكتبة، وأسماؤهما من مصادر مختلفة
💡
عندما أنشأنا المكتبة باسم «الكتب الصوتية» من سطر أوامر Windows، وصل الاسم إلى السيرفر علامات استفهام ????? ???????. والسبب ليس في Audiobookshelf، وإنما في أن النص العربي داخل وسيط الأمر يمر بترميز الواجهة القديم في Windows. والحل أن تضع JSON في ملف وترسله بالخيار --data-binary @file.json، فيصل بايتاً بايتاً كما هو.

ما يفعله Audiobookshelf بالكتب غير التشغيل

بنينا ملف M4B بأداة ffmpeg لنفهم ما يحدث داخله، ولكن Audiobookshelf نفسه يقدم هذه الأدوات من الواجهة، كما تذكر صفحة التعريف: محرر للفصول يمكنه أن يبحث عن أسماء الفصول، وأداة تدمج ملفات الكتاب في ملف M4B واحد، وأداة تكتب البيانات من قاعدة Audiobookshelf داخل ملفات الصوت نفسها، وجلب البيانات والأغلفة من عدة مزودين. ومعها دعم البودكاست مع التنزيل التلقائي للحلقات الجديدة، وقراءة الكتب الإلكترونية بصيغ EPUB وPDF. لذلك إذا كانت عندك كتب مقسمة إلى عشرات الملفات بأسماء سيئة، فالأسهل أن تضيفها كما هي ثم تصلح الفصول والبيانات من الواجهة، ثم تدمجها في ملف واحد إذا أردت ملفاً سهل النقل.

ولاحظ ما تعنيه الأداة الثالثة: Audiobookshelf لا يعدل ملفاتك من تلقاء نفسه، وكل ما تكتبه في الواجهة يحفظ في قاعدته وفي ملفات metadata.json بجانب البيانات، حتى تطلب أنت كتابته في الملفات. وهذا ما يجعل ربط مجلد الكتب للقراءة فقط ممكناً في الاستخدام اليومي، أما إذا أردت أن تستخدم أدوات الدمج والكتابة فتحتاج أن تربطه للكتابة في تلك الفترة فقط.

مزامنة مكان التوقف بين الأجهزة

هذه هي الميزة التي تجعل Audiobookshelf يستحق التثبيت: تستمع إلى فصل في السيارة على الجوال، ثم تكمل في البيت من الحاسوب من نفس الجملة. ولكي نرى ما يحدث فعلاً، نفذنا بأنفسنا الطلبات التي يرسلها تطبيق الجوال. أولاً يبدأ الجهاز جلسة تشغيل للكتاب، ويعرف نفسه باسم واسم جهاز:

curl -s -X POST $A/api/items/$I/play -H "Authorization: Bearer $T" -H 'Content-Type: application/json' --data-binary @play.json
session 4aaea6f1-ee60-4b8b-a397-add7810d2bf1 playMethod 0 startTime 0 tracks 6 /api/items/d3887052-89c2-4616-a467-ec7c75aeee1e/file/5348024561881539

رجع السيرفر بجلسة طريقة تشغيلها 0، أي تشغيل مباشر للملفات دون تحويل، مع روابط الملفات الستة. ثم يرسل الجهاز موضعه كل فترة أثناء الاستماع، وأرسلنا أنه وصل إلى الثانية 745.5 بعد أن استمع 120 ثانية، ثم أغلقنا الجلسة:

echo '{"currentTime":745.5,"timeListened":120,"duration":1675.857}' > sync.json
curl -s -X POST $A/api/session/$S/sync  -H "Authorization: Bearer $T" -H 'Content-Type: application/json' --data-binary @sync.json
curl -s -X POST $A/api/session/$S/close -H "Authorization: Bearer $T" -H 'Content-Type: application/json' --data-binary @sync.json

ثم دخلنا بنفس الحساب من «جهاز ثان»، أي بتسجيل دخول جديد أعطى رمزاً مختلفاً، وسألنا عن التقدم في الكتاب، ثم بدأنا جلسة تشغيل منه:

second device token differs: yes
progress 745.5 44.5% isFinished false lastUpdate 2026-11-18T12:08:01.276Z
device lab-browser startTime 745.5 chapter: 23 - الباب الثاني عشر : الإسوار واللبؤة الشعهر
رسم لمزامنة الموضع: الجوال يبدأ جلسة تشغيل بالطلب POST /api/items/id/play ثم يرسل الموضع كل فترة بالطلب POST /api/session/sid/sync مع currentTime 745.5، وAudiobookshelf يحفظ الموضع لكل مستخدم وكتاب progress 44.5%، والحاسوب بعد ساعة يفتح نفس الكتاب فيبدأ من startTime 745.5 في فصل الإسوار واللبؤة الشعهر
الموضع ملك المستخدم وليس الجهاز

الجهاز الثاني بدأ من الثانية 745.5 بالضبط، داخل الفصل الثالث، والتقدم 44.5%. وهذا هو المعنى العملي لكلمة «مزامنة»: الموضع محفوظ للمستخدم على السيرفر، وكل جهاز يسأل عنه عند البدء، ولا يعرف أحدهما عن الآخر شيئاً. والصورة التالية صفحة الكتاب في الواجهة بعد ذلك، وفيها «Your Progress: 44%» و«15 min remaining»:

لقطة صفحة كتاب في Audiobookshelf: الغلاف وعنوان كليلة ودمنة [Kalila wa dimna] والمؤلف والنوع speech والمدة 27 دقيقة والحجم 13.43 MB، وصندوق Your Progress 44% مع 15 min remaining وتاريخ البدء، وزر Play، ورابط الصفحة في Internet Archive، وأقسام Chapters 6 وAudio Tracks 6 وLibrary Files 7
التقدم الذي أرسلناه من «الجوال» ظاهر في صفحة الكتاب

وفي إحصاءات الاستماع وجدنا ملاحظة تستحق الذكر: مجموع الاستماع 240 ثانية وليس 120، لأننا أرسلنا نفس المدة timeListened مع طلب المزامنة ومع طلب الإغلاق، فجمعها السيرفر مرتين. أي أن هذه القيمة زيادة يرسلها الجهاز منذ آخر مزامنة، وليست المجموع، والتطبيقات الرسمية ترسلها بهذه الطريقة. وهذا مثال على أن قراءة الواجهة البرمجية بطلبات حقيقية تعلمك ما لا تقوله الوثائق.

أما تطبيق الجوال نفسه فتذكر صفحة التعريف بالمشروع أن له تطبيقات Android وiOS مع الاستماع دون اتصال، وأنه يحفظ التقدم لكل مستخدم ويزامنه بين الأجهزة، وهو ما رأيناه هنا بالطلبات. وإذا استمعت دون اتصال، فالتطبيق يرسل التقدم عندما يعود الاتصال.

حسابات العائلة في الخدمتين

لكل خدمة حساباتها المستقلة، وهذا مقصود، فالموسيقى والكتب لا تحتاجان نفس الصلاحيات. ففي Navidrome يحفظ كل حساب ما استمع إليه وتقييماته وقوائمه، ويذكر توثيقه أنه يدعم أكثر من مكتبة موسيقى مع صلاحيات لكل مستخدم، فيمكنك أن تجعل مكتبة الأطفال منفصلة عن مكتبة الكبار، أو أن تفصل تسجيلات الدروس عن الموسيقى. ولاحظ أن Navidrome يحسب المقطوعة «مسموعة» عندما يرسل التطبيق طلب scrobble، وليس عندما يطلب الملف بطلب stream، كما تذكر صفحة التوافق، ولذلك قد ترى إحصاءات استماع مختلفة بين تطبيق وآخر بحسب طريقة كل تطبيق.

أما في Audiobookshelf فالحساب هو صاحب التقدم في كل كتاب، كما رأينا في المزامنة، ولذلك لا تجعل فردين يستمعان بنفس الحساب، وإلا فسوف يقفز كل واحد منهما إلى موضع الآخر كل مرة. وتذكر صفحة التعريف أنه يدعم أكثر من مستخدم مع صلاحيات مخصصة، فيمكنك أن تعطي الأطفال حساباً يرى مكتبة كتبهم فقط، ولا يستطيع أن يحذف شيئاً أو ينزل الملفات.

الوصول من خارج البيت

الموسيقى والكتب تسمع في السيارة والعمل أكثر مما تسمع في البيت، ولذلك يحتاج الجوال أن يصل إلى السيرفر من الخارج، والطريقة الأسلم كما في كل خدمات البيت أن يكون عبر WireGuard. وإذا اخترت أن تنشر الخدمتين خلف Reverse Proxy مثل Caddy فهناك ملاحظتان: Audiobookshelf يعمل افتراضياً تحت المسار /audiobookshelf، كما ظهر في سجله ROUTER_BASE_PATH=/audiobookshelf، فتأكد أن ال Proxy يمرر المسارات كما هي، وصفحة التوثيق فيها مثال Caddy جاهز. وNavidrome بطريقة دخول Subsonic يجب ألا يعمل دون HTTPS على الإنترنت أبداً، للسبب الذي شرحناه في قسم الواجهة البرمجية.

النسخ الاحتياطي Backup

الخدمتان تحفظان شيئين صغيرين مهمين: من استمع إلى ماذا، والمستخدمين، والقوائم، ومواضع الكتب. أما الملفات الصوتية نفسها فلا تنسخها أي منهما، وتذكر ذلك صفحة كل منهما صراحة، فهي في نظام النسخ الاحتياطي العام للبيت كما شرحنا في قاعدة 3-2-1.

وفي Navidrome تشرح صفحة النسخ الاحتياطي أن النسخ الدوري يضبط بالمتغيرات ND_BACKUP_PATH وND_BACKUP_SCHEDULE وND_BACKUP_COUNT، وأنها تنسخ قاعدة البيانات فقط. ونفذنا الأمر اليدوي:

docker exec -e ND_BACKUP_PATH=/data/backup navidrome navidrome backup create
time="2026-11-18T12:12:09Z" level=info msg="Backup complete" elapsed=1.73s path=/data/backup/navidrome_backup_2026.11.18_12.12.07.db

نسخة حجمها 729 كيلوبايت في أقل من ثانيتين. وإذا كنت تدير Docker من Git Bash على Windows فقد ترى بدل ذلك المسار C:/Program Files/Git/data/backup، لأن Git Bash يحول أي وسيط يبدأ بشرطة مائلة إلى مسار Windows قبل أن يصل إلى Docker، والحل أن تضع MSYS_NO_PATHCONV=1 قبل الأمر. وهذا خطأ يقع فيه كل من يدير Docker من Windows، ويظهر أحياناً كملف كتب في مكان لا تتوقعه داخل ال Container.

ولاحظ ثلاث ملاحظات من نفس الصفحة قبل أن تعتمد على هذه النسخ: الأمر اليدوي لا يحذف النسخ القديمة، والحذف يحدث في دورة النسخ التلقائي التالية حتى يصل العدد إلى ND_BACKUP_COUNT، أو بالأمر navidrome backup prune. والاستعادة تمسح القاعدة الحالية وتنسخ فوقها، ويجب أن يكون Navidrome موقوفاً تماماً أثناءها، وإلا فسوف يكتب السيرفر في القاعدة أثناء استبدالها. والنسخ التلقائي موقوف افتراضياً، وقد رأيت في السجل Periodic backup is DISABLED، فلا تفترض أنه يعمل لأنك رأيت الأمر في التوثيق.

وفي Audiobookshelf تذكر صفحة النسخ الاحتياطية أن النسخة تشمل قاعدة البيانات والأغلفة المحفوظة في /metadata، وأنها لا تشمل ملفات الكتب ولا الأغلفة الموجودة بجانبها، وأن النسخة من تثبيت Linux لا تستعاد على Windows دون تعديل يدوي. وطلبنا نسخة بالواجهة البرمجية:

2026-11-18T1511 backups/2026-11-18T1511.audiobookshelf 65356 2.38.0

65 كيلوبايت لمكتبة فيها كتابان. وكلا الخدمتين تحفظ نسخها داخل مجلد بياناتها، أي على نفس القرص، فانسخ هذا المجلد إلى خارجه كما شرحنا في النسخة خارج السيرفر.

أخطاء شائعة

  • إصلاح أسماء الملفات بدل الوسوم: Navidrome لا يقرأ الأسماء، فالملف الذي اسمه صحيح ووسمه خاطئ يظهر بالوسم.
  • وسوم عربية بترميز قديم: تظهر حروفاً مشوهة في كل التطبيقات، وتصلحها مرة واحدة بأداة وسوم حديثة.
  • أسماء متغيرات من أمثلة قديمة: ND_SCANSCHEDULE لم يعد يقرأ، والسجل يقول Periodic scan is DISABLED دون تحذير. اقرأ أسطر البدء بعد كل تغيير.
  • الاعتماد على البحث العربي في التطبيقات دون تجربة: في تجربتنا عمل في الويب وفشل في search3.
  • فتح Navidrome على الإنترنت دون HTTPS: طريقة دخول Subsonic تعتمد على هاش MD5 لكلمة المرور.
  • توقع أن يأخذ Audiobookshelf الاسم من المجلد دائماً: وسوم الملفات تغلب بنية المجلدات في الترتيب الافتراضي.
  • الظن بأن النسخة الاحتياطية تشمل الملفات: الخدمتان تنسخان قاعدة البيانات فقط.
  • حساب واحد لكل العائلة في Audiobookshelf: الموضع ملك الحساب، فيقفز كل فرد إلى موضع غيره في الكتاب.
  • تحويل أرشيف MP3 إلى Opus لتوفير المساحة: تجمع خسارة مرمزين، واترك التحويل للسيرفر عند الطلب.

قائمة تحقق Checklist

البندكيف تتحقق
إصدارات مثبتةالوسمان رقمان مثل 0.64.2 و2.38.0
المجلدات للقراءة فقط:ro على مجلد الموسيقى ومجلد الكتب
الفحص الدوري يعمللا يوجد Periodic scan is DISABLED في سجل Navidrome
الوسومكل ملف فيه العنوان والفنان والألبوم وفنان الألبوم ورقم المقطوعة، والعربية بترميز UTF-8
البحث العربيكلمة عربية من مكتبتك تجد نتيجة في التطبيق الذي تستخدمه العائلة
صيغة الجوالالتطبيق يطلب Opus أو MP3 بمعدل محدد خارج البيت
الكتبمجلد لكل كتاب، والفصول ظاهرة، والاسم من المصدر الذي تريده
المزامنةاستمع على جهاز ثم افتح الكتاب من جهاز آخر، فيبدأ من نفس الموضع
النسخ الاحتياطينسخ القاعدتين دورياً إلى خارج القرص، والملفات في نظام النسخ العام

تدريب عملي

  1. اختر عشرة ملفات MP3 عربية قديمة من مكتبتك، واقرأ وسومها بالأمر ffprobe -show_entries format_tags، وصنفها: UTF-8 سليم، أو ترميز قديم مشوه، أو بلا وسوم. ثم أصلح الثاني والثالث وأضفها إلى Navidrome.
  2. ابن ملف M4B من كتاب صوتي مقسم إلى ملفات، بنفس طريقة ملف FFMETADATA أعلاه، وقارن في Audiobookshelf أسماء الفصول والعنوان بين المجلد والملف.

الخلاصة

  • Navidrome للموسيقى وAudiobookshelf للكتب، وكل منهما يستهلك نحو 50 ميجابايت من الذاكرة، ويعملان معاً في ملف Compose واحد.
  • Navidrome يبني المكتبة من الوسوم وحدها، فأصلح الوسوم قبل الإضافة، والعناوين العربية تحتاج ترميز UTF-8 وإلا ظهرت مشوهة.
  • كل تطبيقات Subsonic وOpenSubsonic تعمل معه، وطريقة دخولها بهاش MD5 تجعل HTTPS إلزامياً على الإنترنت.
  • في تجربتنا عمل البحث العربي في واجهة الويب وفشل في طلب search3 الذي تستخدمه التطبيقات، فجربه في تطبيقك قبل أن تعتمد عليه.
  • تحويل الصوت رخيص، وOpus بمعدل 96 أعطى سدس حجم FLAC تقريباً.
  • في Audiobookshelf الكتاب مجلد أو ملف M4B بفصول، والأسماء من أقوى مصدر في ترتيب البيانات، والموضع محفوظ للمستخدم فيبدأ أي جهاز من نفس الثانية.
  • احفظ الأرشيف بأعلى صيغة عندك، FLAC أو الملف الأصلي، ودع Navidrome يحول للجوال عند الطلب، فساعة Opus نحو 43 ميجابايت مقابل نحو 225 لساعة FLAC.
  • النسخ الاحتياطية في الخدمتين للقواعد فقط، والنسخ التلقائي في Navidrome موقوف افتراضياً، فاضبطه، واحم الملفات في نظام النسخ العام للبيت.
دليلمكتبة أفلامك ومسلسلاتك في البيت مع Jellyfinكيف تحول مجلد أفلام العائلة إلى مكتبة بأسماء عربية وحسابات للأطفال مع Jellyfin، وكم يكلف التحويل فعلاً، ولماذا ظهرت الترجمة العربية مربعات فارغة وكيف أصلحناها.دليلصورك العائلية بعيداً عن Google Photos مع Immichكيف تنقل صور العائلة إلى سيرفرك مع Immich، وماذا يحدث فعلاً عند التعرف على الوجوه والبحث بالعربية على المعالج، وكيف تحمي الصور بنسخة احتياطية حقيقية.دليلJellyfin أم Plex أم Emby؟ مقارنة على نفس المكتبةشغلنا Jellyfin وPlex على نفس الجهاز والملفات وقسنا الإقلاع والذاكرة والتحويل، وقرأنا الأسعار والحسابات من الصفحات الرسمية، لتعرف أي سيرفر وسائط يناسب بيتك ولماذا.دليلHome Assistant مع ESPHome: أتمتة المستودع على سيرفركنترجم برنامجاً حقيقياً للوحة ESP32، ونشغل الجهاز نفسه على السيرفر مع Home Assistant، ونكتب أتمتة تشغل الضاغط الاحتياطي، ثم نفصل الجهاز لنرى ما يحدث.دليلالنسخ الاحتياطي بقاعدة 3-2-1 واختبار الاستعادةكيف تحدد كم بيانات تقبل أن تخسر، وتبني نسخاً لا يستطيع المخترق حذفها، وتتأكد أنك تستطيع استعادتها فعلاً.دليلالاستضافة الذاتية Self-hosting للمستخدم المنزليست خدمات تجمع صور العائلة وملفاتها وكلمات مرورها وأفلامها وأجهزتها الذكية على جهاز واحد في بيتك، وبأي ترتيب تبدأ.

سجل التحديثات

18 نوفمبر 2026: كتابة الدليل واختباره على Navidrome 0.64.2 وAudiobookshelf 2.38.0 في Docker، مع وسوم بمكتبة mutagen 1.47 وملف M4B بأداة FFmpeg.

نشرة عرب رووت | ArabRoot

معرفة تستحق مكاناً في بريدك.

مقالات مختارة وأدوات مفيدة وأفكار لمشروعك القادم، في رسالة واحدة كل أسبوع.

يمكنك إلغاء الاشتراك متى شئت. الخصوصية

تم استلام طلبك. افتح بريدك واضغط رابط التأكيد لإتمام الاشتراك.