Your help is needed

Admin Komet, 913 days ago

MediaElch currently lacks a bit of documentation. I think it's not easy for a first time user to know where to start, what all the settings mean and so on.

What do you think which feature should be explained a little bit more?

What was not clear to you when you first used MediaElch?

  • Donator

    ticao2, 904 days ago

    Hello Komet

    My language is not English. It is the Portuguese of Brazil. pt-BR.
    I use Google translate. So sorry the writing failure.

    For me the options of advancedsettings.xml file were confusing.
    Found in 2 or 3 different locations.
    I gathered all the information I found and made a advancedsettings.xml Model.
    Maybe it will help new users.
    If possible, make the necessary technical and spelling corrections.
    I have doubts:
    1- "set the complete path to the log file"
    2- "subtitle"

    thank you

    <?xml version="1.0" encoding="utf-8"?>
    <!-- x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x -->
    <!-- portableMode = This settings is only available on Windows. -->
    <!-- Default is "false". -->
    <!-- If set to "false" MediaElch store its "Settings", "Temporary Files" and "Caches" in standard locations based on your OS. -->
    <!-- If set to "true" MediaElch store its "Settings", "Temporary Files" and "Caches" in the application directory. -->


    <!-- x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x -->
    <!-- log = This settings enable "debug" -->
    <!-- Default is "false". -->
    <!-- If you want to enable debug mode change "false" to "true" and set a complete path to a log file. -->


    <!-- x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x -->
    <!-- sorttokens = Ignoring articles when sorting. -->
    <!-- This function is "false" or "true" in the option "Global" > option "Ignore Articles When Sorting". -->
    <!-- Default is "false" or not ticket. When ticket option them is "true". -->
    <!-- To change the sort tokens you can add or remove as much token items as you want. -->


    <!-- x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x -->
    <!-- certifications = Only when data is loaded from a scraper -->
    <!-- Defines a mapping which is applied. -->
    <!-- To change mapping you can add or remove as much certification items as you want. -->

            <map from="AAAA" to="e AAAAA" />
            <map from="G" to="e Livre" />
            <map from="Rated G" to="e Livre" />
            <map from="TV-G" to="e Livre" />
            <map from="Rated TV-G" to="e Livre" />
            <map from="TV-Y" to="e Livre" />
            <map from="Rated TV-Y" to="e Livre" />
            <map from="PG" to="e 10" />
            <map from="Rated PG" to="e 10" />
            <map from="TV-PG" to="e 10" />
            <map from="Rated TV-PG" to="e 10" />
            <map from="TV-Y7" to="e 10" />
            <map from="Rated TV-Y7" to="e 10" />
            <map from="TV-Y7-FV" to="e 10" />
            <map from="Rated TV-Y7-FV" to="e 10" />
            <map from="PG-13" to="e 14" />
            <map from="Rated PG-13" to="e 14" />
            <map from="TV-14" to="e 14" />
            <map from="Rated TV-14" to="e 14" />
            <map from="R" to="e 16" />
            <map from="Rated R" to="e 16" />
            <map from="TV-MA" to="e 16" />
            <map from="Rated TV-MA" to="e 16" />
            <map from="NC-17" to="e 18" />
            <map from="Rated NC-17" to="e 18" />
            <map from="A" to="e Livre" />
            <map from="M/3" to="e Livre" />
            <map from="M/6" to="e Livre" />
            <map from="M/12" to="e 12" />
            <map from="M/14" to="e 14" />
            <map from="M/16" to="e 16" />
            <map from="M/18" to="e 18" />
            <map from="M/18-P" to="e 18" />

    <!-- x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x -->
    <!-- genres = Only when data is loaded from a scraper -->
    <!-- Defines a mapping which is applied. -->
    <!-- To change mapping you can add or remove as much genre items as you want. -->

            <map from="Aaa" to="Bbb" />
            <map from="Comedy" to="Comédia" />
            <map from="Faroeste" to="Western" />
            <map from="Film Noir" to="Film-Noir" />
            <map from="Music" to="Musical" />
            <map from="Mystery" to="Mistério" />
            <map from="SciFi" to="Sci-Fi" />
            <map from="Science Fiction" to="Sci-Fi" />
            <map from="Ficção científica" to="Sci-Fi" />

    <!-- x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x -->
    <!-- countries = Only when data is loaded from a scraper -->
    <!-- Defines a mapping which is applied. -->
    <!-- To change mapping you can add or remove as much countries items as you want. -->

            <map from="Xxx" to="Yyy" />
            <map from="Belgium" to="Bélgica" />
            <map from="Canada" to="Canadá" />
            <map from="Czech Republic" to="Tchecoslováquia" />
            <map from="Denmark" to="Dinamarca" />
            <map from="France" to="França" />
            <map from="Federal Republic of Yugoslavia" to="Iugoslávia" />
            <map from="Germany" to="Alemanha" />
            <map from="Italy" to="Itália" />
            <map from="Japan" to="Japão" />
            <map from="Libya" to="Líbia" />
            <map from="Norway" to="Noruega" />
            <map from="Poland" to="Polônia" />
            <map from="Russia" to="Rússia" />
            <map from="Russian Federation" to="Rússia" />
            <map from="Serbia and Montenegro" to="Sérvia e Montenegro" />
            <map from="South Korea" to="Coreia" />
            <map from="Spain" to="Espanha" />
            <map from="Sweden" to="Suécia" />
            <map from="Switzerland" to="Suíça" />
            <map from="United Kingdom" to="UK" />
            <map from="United States of America" to="USA" />
            <map from="United States" to="USA" />
            <map from="US" to="USA" />
            <map from="Yugoslavia" to="Iugoslávia" />

    <!-- x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x -->
    <!-- studios = Only when data is loaded from a scraper -->

    <!-- useFirstStudioOnly = Default is "false". -->
    <!-- If is set to "true" then only the first studio will be written to the nfo file. This is the same what XBMC does. -->

    <!-- map = Defines a mapping which is applied. -->
    <!-- To change mapping you can add or remove as much studios items as you want. -->

            <map from="Studio Xxx" to="Studio Yyy" />
            <map from="Universal Pictures" to="Universal" />
            <map from="Metro-Goldwyn-Mayer (MGM)" to="MGM" />
            <map from="Metro-Goldwyn-Mayer" to="MGM" />
            <map from="Leland Hayward Productions" to="Leland" />
            <map from="Twentieth Century Fox Film Corporation" to="20th Century Fox" />
            <map from="Twentieth Century Fox" to="20th Century Fox" />
            <map from="RKO Radio Pictures" to="RKO" />
            <map from="United" to="United Artists" />

    <!-- x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x -->
    <!-- Stream Details = Only when loading stream details -->

    <!-- audioCodecs and videoCodecs -->
    <!-- Applies the same mapping as described above. -->
    <!-- To change mapping you can add or remove as much Audio Codec and/or Video Codec items as you want. -->

            <map from="aaaaa" to="AAA" />
            <map from="MPA1L2" to="MP2" />
            <map from="MPA1L3" to="MP3" />
            <map from="mp3" to="MP3" />
            <map from="ac3" to="AC-3" />

            <map from="vvvvv" to="VVV" />
            <map from="v_mpeg4/iso/avc" to="h264" />
            <map from="27" to="h264" />
            <map from="mpeg2" to="MPEG-2" />
            <map from="V_mpeg2" to="MPEG-2" />

    <!-- x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x -->
    <!-- fileFilters = defines the extensions of files MediaElch will scan and/or rename. -->

    <!-- Video Files = will be scan and rename. -->
    <!-- Multiple video file extensions can be added comma separated. -->

    <!-- Subtitle External Files = Only for rename function. Not for scan. -->
    <!-- Multiple subtitle file extensions can be added comma separated. -->
    <!-- A special case is subtitle. These files will also be renamed when renaming a movie. -->




  • Donator

    schimi2k, 873 days ago

    Hey Komet :)

    first - mediaelch is getting better and better - well done ! its realy great

    i was testing some other tools similar like mediaelch, because i missed some "sorting" tools... BUT...

    i didnt know that the "FILTER" field on top is SO POWERFULL !!!

    maybe u can explain this field a bit more, because some people will love this feature i think ( like i do now )

    THX again for the best mediatool out there ! keep going

  • ludi, 871 days ago


    I had trouble with the usage of the "Add Genre" and "Add Tags" items in the extended tab. Indeed, I wrote a tag into the field, but it was not written to the nfo file.

    Only later did I realise, that it was meant to create a set of genres/tags by hitting Return after entering each genre/tag. Later, once the set has been created, the genres and tags are listed under the appropriate fields, and the user can activate the desired tag/genre for the selected file.

    That said, it would be great, if it was possible to activate a genre/tag for a multiple selection of files. (


  • ludi, 870 days ago

    A small follow up on the "Add Tag" problem I talked about above: a simple "Add" button on the right of the tag input field might make the UI clearer. In fact, the button might compell people to click on it, and they might understand how it works, seeing the word appear below the input field.

  • Donator

    AaronP, 416 days ago

    Hello. I have realled loved MediaElch far more than any other media manager and am excited to see it get documentation and continue development. 

    My confusion generally stemmed from a lack of dialog boxes upon executing a command. Say, for instance, that I wanted to scrape a band for NFO. If I excute the scrape command and the information is pulled down then I am 100% sure the program executed my command. However, if I scrape and nothing happens there are no dialog boxes to tell me why. For all I know the button itself might be cosmetic, unconnected to any actual code. 

    This form of contextual documentation would go a long way to help new users.

  • mcm57, 410 days ago

    Hi, thanks for developing this great tool.

    I'm really new to media elch (2 days) and I want to post only what I'm missing as starter documentation until now. This is no critic - the tool seems to be great, but if I did not look for a tool to handle missing episodes, I would have stopped as trying to use for a first time is not clear.


    a) First problem was to find the place where I could enter the directories containing my series. Tokk me for sure at least one hour to find. Some first steps guid would vbe very nice. [This problem is solved - I've detected the config dialog]

    b) "Serien neu laden (F5)" is running a long tme (I've stored app 6000 episodes currently). OK, should be. But I did not yet detect a way to serach my directories for new series / episodes without this. I assume there will be a faster way - but how ? [open]

    c) I still do not understand what the colours in the series display indicate. I assume that red indicates "changed" as it turns green after saving. But at first use I assumed that red indicates some problem. Also I do not yet guess what the asterix in front of the series name indicates. The fact that stores series sometimes (but not always - I do not know why - loose the asterix and get moved to the end of the list cuased some confusion as I thought the have been deleted by some misuse... A shot description would be very helpful. [partly open]

    d) There should be a way to wriet the nfo files to use with Kodi. I did not yet detect how this can be done. [open]

    e) Sync with Kodi is described shortly - but theres no description what is done during syn, which information is stored / deleted / moved from where to where? I did not try the function as I do not want to destroy my Kodi DB  oreven some files ...

    f) The export requires some templates. I'm still searching where to get an example. Maybe one example could be packaged into the installation or at least a link to the templates could be added to the text telling that a template should be installed. [open]


    Please read this post ONLY as feedback from a new user. Not as an critic at your work. For long term user all these "problems" will be very as clear as for a windows user the way to copy a file. I only want to give feedback what I personally am (or was) missing.



  • mcm57, 410 days ago

    Could not find an edit possibility.

    So I use a new post instead of adapting my last one. Sorry if I'm blind :-)

    -) What does "Stream Details laden" do?  I do not yet fidure out. [open]

    -) I just detecte that the episodes do not contain a description after marking the series and clicking "Informationen laden". Th Series decritpion is OK. An when I select a single episode an click on "Information laden" the episode guide is populated. I assume this should be possible without clicken every single episode...

    -) I did not yet guess what exactly the star left of the series and episodes title indicates. In addition I've a symbol showing 2 rotating arrows ("reload" ?)  betwenn most but not all episode entries. Currently I have no idea what this indicates.