How does the Basic Home Menu Editor in DefaultWideHD work? (1 Viewer)


Super Moderator
  • Team MediaPortal
  • January 23, 2008
    South Central Wisconsin
    United States of America United States of America
    Country flag
    • Thread starter
    • Moderator
    • #1
    If I wanted to use the BHME in another skin, is there a programming guide?

    Are there annotated xmls to study so I could grasp how each section works, and how the editor adds the menu items to Basic Home?

    What xmls are needed for the process?

    Is there a way to edit the label text to change the name used on the BH button?

    Can you add a label that doesn't have a hyperlink?

    How do you access the list of plugins and screens?

    What is the code for getting everything to fall into place?

    Thanks for any help.



    Design Group Manager
  • Team MediaPortal
  • August 13, 2007
    Germany Germany
    Country flag
    Hi Chuck, in general it´s easy:
    All xmls named BasicHomeEditor.blabla.xml are the files needed.
    Here a short explanation of all the relevant files:
    • BasicHomeEditorDefines.xml: Here are all plugins listed with their (translated) names, their hyperlinks, their hover images etc. Here you may change labels or add plugins
    • BasicHomeEditor.xml: The GUI for cofiguring the items to be shown in main menus and submenus as well as the desired layout. This you may adapt to your needs regarding fonts, button textures etc.
    • BasicHomeEditor.main.calc.xml and BasicHomeEditor.sub.calc.xml: Here is the logic (calculation) for the placement of the items in main menus and submenus. These files must not be changed!
    • BasicHomeEditor.main.Carousel.xml and BasicHomeEditor.sub.Carousel.xml have the layout for the items to be shown on BasicHome with their animation, width, height, position etc. for the Carousel layout - may be adapted to your needs
    • BasicHomeEditor.main.horz.xml and BasicHomeEditor.sub.horz.xml have the layout for the items to be shown on BasicHome with their animation, width, height, position etc. for the Horizontal (scroll) layout - may be adapted to your needs
    • BasicHomeEditor.main.text.xml and BasicHomeEditor.sub.text.xml have the layout for the items to be shown on BasicHome with their animation, width, height, position etc. for the Horizontal Text only layout - may be adapted to your needs
    In BasicHome.xml these xmls are referenced like this:
      <include condition="#(eq(#hedit.mode,'Carousel'))">BasicHomeEditor.main.Carousel.xml</include>
      <include condition="#(eq(#hedit.mode,'Carousel'))">BasicHomeEditor.sub.Carousel.xml</include>
      <include condition="#(eq(#hedit.mode,'Horizontal (scroll)'))">BasicHomeEditor.main.horz.xml</include>
      <include condition="#(eq(#hedit.mode,'Horizontal (scroll)'))">BasicHomeEditor.sub.horz.xml</include>
      <include condition="#(eq(#hedit.mode,'Horizontal Text only'))">BasicHomeEditor.main.text.xml</include>
      <include condition="#(eq(#hedit.mode,'Horizontal Text only'))">BasicHomeEditor.sub.text.xml</include>
      <include condition="#(neq(#hedit.mode,'Horizontal Text only'))">BasicHomeInfoRecentlyAdded.xml</include>
      <include condition="#(eq(#hedit.mode,'Horizontal Text only'))">BasicHomeInfoRecentlyAddedText.xml</include>
    In settings_GUI_Skin.xml the BasicHomeEditor files are referenced like this:
    All BasicHomeEditor.blabla.xml have short inline documentation in their code so you may get sufficient information about how the magic works.
    You will note that I make extensive use of skin expressions, so the BasicHomeEditor is also a great example of how to use those.

    Additionally to the relevant files above are the two xmls for LMH: BasicHomeInfoRecentlyAdded.xml and BasicHomeInfoRecentlyAddedText.xml providing the lastest media information for BasicHome.

    Now it´s your turn!
    Dive into the BasicHome Editor world and have fun :D ;)
    Last edited:

    Users Who Are Viewing This Thread (Users: 0, Guests: 1)

    OP Similar threads Forum Replies Date
    da3dsoul Does MP2 not have any active devs? General 8
    C Hauppauge HVR-1265 -- does it work with MP1? MediaPortal 1 Talk 1
    M [solved] WTV Files does not play on client, MPEG files works well General 1
    D Does Schedules Direct work with mp 1.24? General Support 3
    J [solved] Blu-ray disc playback does not work. Bugreports 15
    horned_reaper [solved] When playing music Fanart does not shuffle Fanart Handler 20
    bigboss97 Does anyone has a SoundGraph imon remote file for MP2 to share? General 0
    horned_reaper [solved] When playing music Fanart does not appear immediately after downloading Fanart Handler 272
    D [solved] EPG Buddy for MP2 - Does it work? General 5
    L [solved] Why does Mediaportal 2 need access to my webcam? General 2
    R Directx 9.0 June 2010 does not install on Windows 10 x64, ends up with weird failure / no debug file Installation, configuration support 0
    M What does MP homeserver detection need at the client end, and what does the server need to transmit? General 6
    R TV menu icon does not work to return from sub-menu item Submit: Bug Reports 4
    N [confirm] Calling RemoveScheduleForProgramAsync does not stop the recording if it is currently in progress MediaPortal 2 1
    drumrob Time does not fit in white space 1.22 Pre Release 6
    N [Finished] [MP2-806] Playing a recorded radio program does not show screen to allow skipping forward, etc MediaPortal 2 141
    N [confirm] Playing a recording, then pressing stop does not leave cursor on the recording MediaPortal 2 21
    N [Finished] [MP2-783] Mapping Ctrl+Right as Next also does Right action when pressed. MediaPortal 2 21
    BlueMax1916 [Question] What does MP2 Server Service have to do with MediaPortal 2 3
    P Mediaportal does not allow my TV tuner to enter low power state General Support 1
    greybox 1.20 final does not update video duration automatically 1.20 10
    greybox 1.20 final does not update video duration automatically 1.20 Pre Release 1
    Terra MPTray does not start with Windows General Support 2
    A LNB supply voltage does not switch off General Support 0
    G Splash screen option pack does not download. StreamedMP 8
    Similar threads

    Top Bottom