From Cinemar Wiki
Jump to: navigation, search






MusicLobby 3 Application

Getting Started

Make sure MainLobby3 Server, MainLobby3 client, J River Media Center, MusicLobbyServer Plugin (installs on J River PC) and the MusicLobby user interface are installed (see above).

Start MainLobby 3 (Assumes MediaCenter and MLServer 3 is already open)

Move your mouse to the top of the screen to reveal the MainLobby menu bar or hit F9 key. This assumes that you haven’t locked the menu bar from opening (see MainLobby User Guide).

Select Open

Browse to the file (If you would like this to be your default startup scene when loading MainLobby, you may select OPTIONS | DISPLAY and locate as your default startup scene. Click Save.)

Press OK

MusicLobby should automatically connect to Media Center MusicLobby Server Plugin via port 7000. Once connected, the MusicLobby Server Plugin will connect to MLServer’s Media Center plugin for licensing approval. This can take a minute or so. You should then see that Media Center server is licensed and for how many zones.

Configuring the MusicLobby 3 User Interface within MainLobby

Open MLServer 3, Media Center 12 and MainLobby 3 client.

Navigate to using Open from the MainLobby menu bar.

Once musiclobby.swf is open in the, click Options and then Setup. Towards the top of the window, make sure it says Connected. If it does not, make sure the Domain / Port is directed to the PC hosting MLServer3. Use localhost (if on same PC), the PC Windows name, or the IP address for the PC. IP address is most reliable if your LAN is configured with static IP addressing (highly recommended).

If you make changes to the Setup scene, click Save to save your settings. All settings are saved in the musiclobby.ini file if you want to manually edit or backup these settings.

MusicLobby 3 uses a broadcast method of connecting between a MainLobby Client and the MusicLobby Server plugin. No configuration is required other than to ensure that the ports 7000 and broadcast port UDP 55402 are open on all firewalls and routers. You may have to reboot after making these firewall / antivirus permissions settings for them to come into effect.

In the Base View Scheme field, the default should be: Media Library\ If you have created custom views in Media Center, this is where you can modify what view MusicLobby defaults to on launch.

Select a Zone from the drop down choices that MusicLobby 3 will use on startup. Click Save. You must be connected to the Media Center to see these drop down choices as they are generated and managed by Media Center (this assumes you have already created zones within Media Center).

Set what default view you want MusicLobby 3 to open with (“Thumbnail / Jukebox / Valet”)

Configuring MusicLobby 3 user interface options

In the Setup Options window, you can select / deselect what user interface features display on the scene. You can also color tint some of the features.

You can choose to not use the standard user interface features and replace them with custom MainLobby buttons that use supported MLServeCmds (see MainLobby User Guide for information on how to add and configure a MainLobby button). See “MLServer Commands” below.

You can also put MainLobby 3 client into Design mode and click some of the MusicLobby.swf graphical elements and move them on the scene. Save your changes by clicking Save in the MainLobby menu bar. The transport controls, the volume bar, the elapsed indicator, the zone toggle, the elapsed graphical indicator are able to be placed on a MainLobby scene.

Variables that can be edited in the MusicLobby.ini file > jukeboxcodeprefix=9999 (Changing this number allows user to modify code when in Jukebox Mode) > exitjukeboxcode=99 (Changing this two digit number to another one allows customization of the exit feature in Jukebox Mode)

Troubleshooting / FAQ

I was using the MusicLobby trial, and now want to install the licensed version – what do I do?

Backup your customizations you have done in trial (your mls files) and Uninstall MainLobby trial in Windows Add / Remove Programs and install the licensed versions.

How do I know which version of MusicLobby I'm running?

The version number is located in the MusicLobby OPTIONS > SETUP Panel.

How do I know if I'm connected to the Server?

From MusicLobby, press OPTIONS > SETUP. At the top of the Setup Panel you'll notice a green or red light. Red Light means you are not connected, green means you have successfully connected to the server computer.

Nothing is displaying in MusicLobby

Double check to make sure there is a musiclobby.ini file in the same folder as musiclobby.swf

Check to see if you are connected in the Configuration panel (Green means you are connected, red means you are not connected)

If you are running MediaCenter and MusicLobby on the same computer, verify the ports are identical in MediaCenter and MusicLobby. If all else fails, you may try changing the port to another number such as 7005 in both places. If this works, you have something else on port 7000 that really should be changed and MusicLobby put back on the now available port 7000.

If you are trying to connect from a remote computer, the musiclobby.ini file on the client machine will need to be configured with the server domain name of the server computer.

Make aure you have a default zone configured in the MusicLobby user interface Setup.

MusicLobby doesn't fill my screen

Adjust your display settings to your appropriate monitor resolution in MainLobby's Display panel, press OK and then press SAVE from MainLobby's menu bar. Then restart MainLobby for your new settings to take effect.

How do I return to the previous screen from the Valet screen?

Valet was designed for entertaining guests and prevents unauthorized access by hiding the Options menu button. You can return to the previous screen by pressing/clicking in the lower left corner of your screen.

Cover Art isn't displaying within MusicLobby

Verify image shows up in Media Center

Make sure you have a socket connection and that Media Center is loaded before MusicLobby (You should see some text above/below cover are display area)

Verify the image is a JPG (MusicLobby will not display any other type ie .bmp)

Verify the image is 72 dpi (scanned cover art may be set at a higher dpi)

Make sure the JPG is non-progressive (Download LView Pro for batch converting)

JPG files should not be embedded within the MP3 tag

Make sure that ports 7000 and port 8123 are open on all firewalls and routers.

Within MediaCenter, go to the Playing Now view and add the column to display coverart path. This will show you what coverart MediaCenter is using. With this knowledge you can troubleshoot specific coverart issues that are impacting MusicLobby (like an embedded image, a wrong file type, a corrupt file etc).

Posted by ghadlock:

"Force" JRiver to reference the external image files so that they'd feed over to MusicLobby, even though all of the mp3 files had embedded cover art:

From feedback received in the J River forum, it turns out that this is possible by following these steps:

You can disable tag writing before adding linked cover art. The embedded images will stay intact.

1. Tools > Options > General > Update tags when file info changes (untick)
2. Right-click > Cover art > Remove Cover art
3. Right-click > Cover art > Quick Find...
4. Tools > Options > General > Update tags when file info changes (tick)

This will update the image file in J River to the external image lcoation, and still leave the embedded images intact.

The Background Skin is not displaying full screen

MusicLobby was designed and optimized for a 1024x768 screen resolution. If you are running a higher resolution such as 1280x1024, you can scale the background image. From MainLobby, press OPTIONS In the Background Skin line, adjust the scale percentage on the right to 125% instead of 100 for a 1280x1024 display. Depending on your actual screen dimension, the scaling value may vary.

How are the Albums sorted while in the Jukebox? They don't appear to be in any order.

The Albums are all randomized to simulate a real jukebox.

How do I exit out of the Jukebox Screen?

The Jukebox is intended for entertaing guests but still allows a knowledgable user to enter secret command codes into the jukebox LCD to gain access to many more features. A list of these codes appears above.

I don’t see any playlists or coverart?

Make sure that you have a default Zone configured and saved in Setup.

MusicLobby doesn't scale or work well with overlays

The 0019 music library scene loads musiclobby.swf via a jpgloader button. This has a couple of downsides. It uses an auto scaling routine to fill the screen, a problem if you are using an overlay like most 0019 screens.

Also if you scale and move the swf, upon revisiting the scene you have two swf files. One scaled and the other at default location.

One answer is too either create a new scene, or remove the jpgloader and load musiclobby.swf as a background FX. You can now scale the swf to match your overlays (1024x768 88%, an x offset of 80 and y about 30 works nicely) and jukebox now works within your work area.

I use the swf transport controls and on my overlay I have had added a zone selector and Zone Display. I had some trouble getting the zone change stuff to work and came up with a workaround.

MusicLobby Custom Zone Controls

The default Zone controls are way too small IMO, so I moved them to the overlay screen with a little display showing the current zone name.

For my custom zone controls I use MLCyclestates. mlmediacenter_mulclient_{{clientname}}_selzone is the server variable I set.

mlmediacenter_[your servername here]_zonename1, 2 and 3 is the value I use to set it to.

Sample MLCyclestate command. For zones two and three replace the 1 with 2 and 3 respectivly.

SetVariable|mlmediacenter_mulclient_{{clientname}}_selzone~{{mlmediacenter_[your servername here]_zonename1}}

[your servername here] = hostname of your server, if you aren't sure open command prompt on your JRMC machine and type hostname.

I use this variable as it is the one musiclobby.swf uses for Zone Names;{{mlmediacenter_[your servername here]_zonename1}}.

This works also on the default 0019 screens.

Upon migration to background FX method of using musiclobby.swf I found this no longer worked. I added a further command to the cyclestates for each zone.


KG3100 is my JRMCs server name. Replace this with your JRMC server name.

This is basically two commands, first one sets the variable with the zone name, second one tells the client to use the new zone name.

Couple of gotchas:

1. Upon exiting or revisting the scene your cyclestates might be out of sync. Use options, more and sync them on startup/shutdown or both! Use the following command to sync the MLCyclestates, use which ever zonename matches your statup setting in the swf, options, setup screen.


2. I found my zone names were being sometimes converted to lowercase mid command, in my display I use the Liquid Crystal font which changes the zone name to all uppercase. To my mind it looks better.

Media Center doesn’t start

If Media Center does not start, your system could be missing the file msinet.ocx from the windows/system32 dir. It can be found in a CAB with an INF to install it. No reboot required.

Jukebox Mode

When MusicLobby 3 is in Jukebox mode, the below “secret” codes can be used. “Secret” so your guests can’t modify the control of the player.

Jukebox Mode Codes

0000 00 Show Now Playing

8888 XX Set Volume to XX

9999 00 Display Supported Command Codes

9999 10 Toggle Play/Append Mode

9999 20 Clear Playlist

9999 30 Previous Zone

9999 31 Next Zone

9999 40 Previous Track

9999 49 Pause

9999 50 Play

9999 51 Stop

9999 60 Next Track

9999 69 Volume Down

9999 70 Mute

9999 71 Volume Up

9999 80 Toggle Continuous Play

9999 90 Shuffle Playlist

9999 98 Minimize MainLobby

How do I exit out of the Jukebox Screen?

The Jukebox is intended for entertaining guests but still allows a knowledgeable user to enter secret command codes into the jukebox LCD to gain access to many more features. A list of these codes appears above.

How are the Albums sorted while in the Jukebox? They don't appear to be in any order.

The Albums are all randomized to simulate a real jukebox.

Variables Created

These variables will be created for each client registered with the system:


htpc = MusicLobbyServer Name

Zone 1 = Zone 1 through as many as exist in JRMC

Office = MuL Client name - one for each connected


mlmediacenter_htpc_Zone 1_currentvolume
mlmediacenter_htpc_Zone 1_mutestatus
mlmediacenter_htpc_Zone 1_curalbum 
mlmediacenter_htpc_Zone 1_curartist 
mlmediacenter_htpc_Zone 1_curimage 
mlmediacenter_htpc_Zone 1_curtitle 
mlmediacenter_htpc_Zone 1_curtitleduration
mlmediacenter_htpc_Zone 1_curtitleposition
mlmediacenter_htpc_Zone 1_curtitlepercentcomplete
mlmediacenter_htpc_Zone 1_nextalbum 
mlmediacenter_htpc_Zone 1_nextartist 
mlmediacenter_htpc_Zone 1_nextimage 
mlmediacenter_htpc_Zone 1_nexttitle 
mlmediacenter_htpc_Zone 1_playbackstatus 
mlmediacenter_htpc_Zone 1_prevalbum 
mlmediacenter_htpc_Zone 1_prevartist 
mlmediacenter_htpc_Zone 1_previmage 
mlmediacenter_htpc_Zone 1_prevtitle 

NOTE: Case sensitivity and must use Zone name

Usage in a Button Label:

{{mlmediacenter_{{CLIENTNAME}}_zone 1_curimage}}

JPG Image or Flash

{{mlmediacenter_{{CLIENTNAME}}_zone 1_curimage}}|width=130|height=130

Advanced examples

Multizone and Multiclient volume indicator


MLServer Commands

Zone synch (zones must be expressed as numeric and start from 1):

MLServeCMD.MLMediaCenter|<<MuLServerName>>~null~ZoneSynch~1(source)~2(destination) Example:


Once synched, you can stop each zone individually.

MLServeCMD.MLMediaCenter|MULServerName~Zonename or ZoneNumber~Command

  • Send a commands to a specified zone. Remember that you must change to the desired zone before sending any commands. (ZoneName is defined in JRMC Zone Manager):

MLMediaCenter|MuLServerName~zonename or zonenumber~PlayFile|PathandFilename

Sample multizone Play command:


Play Status variable:


Other similar commands - replace PlayFile above:





MLServeCMD.MLMediaCenter|MuLServerName~zonename or zonenumber~Play

MLServeCMD.MLMediaCenter|MuLServerName~zonename or zonenumber~Stop

MLServeCMD.MLMediaCenter|MuLServerName~zonename or zonenumber~Next

MLServeCMD.MLMediaCenter|MuLServerName~zonename or zonenumber~Previous

MLServeCMD.MLMediaCenter|MuLServerName~zonename or zonenumber~Shuffle

MLServeCMD.MLMediaCenter|MuLServerName~zonename or zonenumber~ToggleShuffle

MLServeCMD.MLMediaCenter|MuLServerName~zonename or zonenumber~Mute

MLServeCMD.MLMediaCenter|MuLServerName~zonename or zonenumber~VolumeDown

MLServeCMD.MLMediaCenter|MuLServerName~zonename or zonenumber~VolumeUp

MLServeCMD.MLMediaCenter|MuLServerName~zonename or zonenumber~SetVolume~20

MLServeCMD.MLMediaCenter|MuLServerName~zonename or zonenumber~NEXTZONE

MLServeCMD.MLMediaCenter|MuLServerName~zonename or zonenumber~PREVZONE

MLServeCMD.MLMediaCenter|MuLServerName~zonename or zonenumber~clearCurrentPlaylist

Advanced Command Examples

Multizone / Multiclient Volume control example


Multizone / Multiclient Play control example


Client side commands










MLServeCmd.MLCmd|myClient1~MLMusicLobby|connectTo~serverDomain~serverPort~Zone 1

To change a client to manage a different Media Center PC: This involves creating a new musiclobby.ini for the specifics of the second Media Center PC. Just copy the musiclobby.ini file and rename to musiclobby1.ini. Then, execute this command from a button in MainLobby:


This reloads the new musiclobby1.ini file settings. You can now go into MusicLobby setup and configure this new server (like the IP address of the second server, the startup zone, etc.). Rerun the command above and you should now be using the new settings and connected to the second Media Center server.

Sample as MLServeCmd: MLServeCmd.MLCmd|myClient1~MLMusicLobby|changeView~playing

To change a client to a different zone:

MLServeCMD.MLMediaCenter|server~anyzonehere~ClientSetZone~clientname~zonename or zonenumber

Server must be a server that is currently registered with MLMediaCenter

anyzonehere is any zone

To send a command to a specific zone:

MLServeCMD.MLMediaCenter|Server~Zonename or ZoneNumber~Command


{{mlmediacenter_{{CLIENTNAME}}_zone 1_curimage}}

JPG Image or Flash

{{mlmediacenter_{{CLIENTNAME}}_zone 1_curimage}}|width=130|height=130

Sample multi command MLServeCmd to start a playlist (Rock is the sample playlist name in the example):


Configuring your UNO-S2 Keypad to control J RIVER Media Center

1) Make sure you've installed and properly configured the MLCav66 Plugin, J River and MLMediaCenter

2) Double click on MLCav66 from the MLServer Plugins Window

Let's assume you want the UNO-S2 keypad in Zone 4 and Source 3 to control Zone 1 of J River MediaCenter

3) From the Configuration tab of the MLCav66 Plugin select the PLUS symbol next to CAV66

4) Select the PLUS symbol next to Zone 4

5) Select the PLUS symbol next to Src 3

6) Select the PLUS symbol next to Uno

7) Select the text labeled Next

8) Paste the following into the MLServeCmd at the bottom where <<MuLServerName>> is replaced with where your J River computer name is running:


9) Press Save

10) Repeat these steps for the following commands respectively: Play, Previous and Stop




11) Start a song playing in J River MediaCenter and make sure you have the audio connected to Source 3 of the Russound. Once you can hear the audio in Zone 4 of your Russound Zone, select one of the four UNO-S2 keys we've assigned the command to.

NOTE: Make sure Allow MLServer Command Triggers is checked from the Configuration tab. If you want to use the UNO remote, be sure to check the box labeled Allow CAV Event Triggers

If you want all Zones/Source info to be duplicated, you can right-click on the Zone and select COPY ZONE. Then right-click and Paste to other Zones.

The other buttons can be assigned to any MLServeCmd supported, which could include Lighting, Arming your Security, Getting Weather temperature, etc. Manual update of plugin(s):


1.) Read this document

2.) Search

3.) Post question on forum

If you are asked to provide a communications log of a MusicLobby 3 issue:

1.) Start up JRMC

2.) Goto MusicLobbyServer and select the Event Log Tab

3.) Check the checkbox to enable event log.

4.) Shutdown and restart JRMC.

5.) Go through sequence to reproduce issue

6.) Goto MusicLobbyServer and click on Event Log Tab. Deselect checkbox.

7.) Compress and attach the MuLServerLog.TXT file located where MusicLobbyServer.OCX resides.


New Feature Requests

(smoothtlk) disable the license server broadcast function