If you have not already, we suggest setting your Plex username to something else rather than email which is displayed on your posts in forum. You can change the username at https://app.plex.tv/desktop#!/account
Welcome to our forums! Please take a few moments to read through our Community Guidelines (also conveniently linked in the header at the top of each page). There, you'll find guidelines on conduct, tips on getting the help you may be searching for, and more!

[Release] elCinema Metadata agent

monta874monta874 Posts: 12Members ✭✭



I have developed a metadata agent that manages Arabic movies/theater. This metadata agent will retrieve the metadata available on elCinemawhich is the biggest online Arabic movie database. Since elCinema has no public API, I have taken advantage of the HTML parsing, so take into consideration that this could lead to higher data transfer.


This module is still in beta and I would appreciate any bug reports via Github issue tracker on this page. To get the best results, follow the standard plex naming convention for movies.


Below are current adjustable settings:

  • The ability to get output information in logs - This is for debugging purposes. Defualt: Off.
  • Include theatre media in search result. - It´s not possible to determine if the media is a movie or theatre, and that many arabic theatre has the same name as the movie. There is no alternative but to give the user the ability to filter out the results. Defualt: Off.
  • Include the English working title with the Arabic, if it exists - If enabled, The English work title will be included in the media-title in Plex. It will have the format 'arabic-title (english-title)'. Defualt: On.
  • The ability to translate arabizi to arabic. - Most of the arabic movies is named with arabizi(arabic in latin-script, e.g. '7abibi' or 'habibi' will be converted to 'حبيبي'), this will provide much better search results. Take into consideration that this could also provide poor results if the naming is not done with Arabizi. This functionality will not manipulate names given with Arabic characters, only latin charecters. (Note. This mechanism is available through Yamil and is available in a seperat class and file). Defualt: On.
  • Choose to retrieve metadata in Arabic or English By setting the agent as the default agent for a library, you have the possibility to choose between retrieving metadata either in Arabic or English. It is also possible to choose a language when you issue a search manually.



  • Unzip the downloaded ZIP file(link bellow).
  • Rename the unzipped folder from 'Elcinema.bundle-master' to 'Elcinema.bundle'
  • Move 'Elcinema.bundle' to your Plex plugins folder
    • Linux: /var/lib/plexmediaserver/Library/Application Support/Plex Media Server/Plug-ins
    • Mac: /Library/Application Support/Plex Media Server/Plug-ins 
    • Windows: *disk*:\Users\*username*\AppData\Local\Plex Media Server\Plug-ins
  • Restart Plex Media Server


# Download: here

# Github repo: here


Best regards


  • mbtsmmbtsm Posts: 13Members ✭✭

    working with me 

    تمام يعطيك العافيع

    بوسترات ماتطلع  

    بعض الافلام مافيه لها داتا 

    عموما خطوه الى الامام 

  • HiSoC8YHiSoC8Y Posts: 34Members, Plex Pass Plex Pass

    Excellent work, it works, but it's not perfect.  We can help you with providing the feedback to improve it if you are interested.

    I'm not getting the actors and posters.

  • hkaiahkaia Posts: 2Members

    we need you to update it if you can please :)

  • aimanzaimanz Posts: 17Members, Plex Pass Plex Pass

    thank you so much :-bd

    شكراً جزيلاً الصراحه عمل جبار يعطيك ألف عافيه

  • bdrummbdrumm Posts: 22Members, Plex Pass Plex Pass

    Very good stuff!! Thank you!

  • YasserLotfyYasserLotfy Posts: 9Members ✭✭

    I can't make it work !

    an example:

    • صنع في مصر (2014)
    1. Cover-1.jpg
    2. Cover-2.jpg
    3. صنع في مصر (2014).mkv

    Any help please ???

  • thamorethamore Posts: 3Members, Plex Pass Plex Pass


    Thanks for your great work. The agent isn't working so may you please update it. It will be valuable for everybody if you do please.

    Best regards,

Sign In or Register to comment.