K-Grid using the Emerald Client

Screen shot 2009-10-17 at 6.12.53 PM

25 October 2009 – update – I got confirmation from Robin that the suggestions for doing this in Windows works. Also, I added a change suggested by Silas that explains what you need to tweak in the command line if you are using Windows 7.
19 October 2009 – update – wouldn’t you know it? One day after I created this, there was a new version of Emerald created with a change in the app’s name, so I updated a few things. Also, BeBoo gave a hint on how to adapt Emerald to K-Grid in Windows, so I added some more info about that too.

K-Grid is an OpenSim -based virtual world. I previously created a blog post on how to create a K-Grid account and use the “Hippo” client. That still should work, but the Hippo client is no longer being supported.

The good news is there is a client available called “Emerald” that you may like even more – it is based on the Second Life client’s code, but they have made a few changes that are cool. I am a noob with it, since I just started using it yesterday.

Note that I have only done this on a Mac – this will work on Windows, too, but of course there will be some differences. If someone wants to tell me  what Windows users need to do differently, I will add it here (email pais.kidd at sbcglobal.net).

  1. Get a K-Grid Account: First off, if you don’t have a K-Grid account, you can create one at k-grid.com
  2. Download and Install the Emerald Client: Now, download the Emerald viewer (formally known as “Emerald GreenLife”). Their home page is here. The official download page is here. Be sure to get it from their website, since the code is available,  and others could compile versions that steal your passwords or other nasty stuff. If you are paranoid, download the source code, go over it, and compile your own version.
  3. Tell Emerald how to connect to K-Grid: At this point, once you do the install, if you run it, it will connect to Second Life, so we need to tell it to connect to K-Grid. This is the part that I can describe for the Mac. Hopefully later I will have more info how to do this in windows.

Mac Method:

  • Move the “Emerald Viewer.app” (or whatever the app name is) to your Applications folder (or where ever you want to install it).
  • If you want to use Emerald for Second Life as well as K-Grid, make a copy of the Emerald  .app package file, and use one copy for SL and one for K-Grid.
  • If you aren’t doing it already, use the Finder to go to the Emerald .app package file. If you didn’t know it already, a .app is really like a folder with various files and folders that the application may use, so now we need to get inside so we can modify one of those files. Control-click on the Emerald .app package file that you want to use for K-Grid, and select “Show Package Contents”
Screen shot opening the Emerald.app package file

Screen shot opening the Emerald.app package file

  • So now you are looking at the files and folders of the app’s package contents… look in the “Contents” folder, then within that, the “Resources” folder to find the “arguments.txt” file. This file contains the command line arguments used when the actual executable file is called to start Emerald. (There are probably more elegant ways to do this, but I am just creating a quick way to get at this).

Screen shot navigating within the Emerald .app package to the

  • Edit that file so it contains the following text. After you copy and paste the following text to replace what is currently in the arguments.txt file, you need to make sure each argument is preceded by a double hyphen (so it looks like the image of this below)

--channel "Emerald Viewer" --settings settings_emeraldviewer.xml --loginuri http://grid.k-grid.com:8002 --loginpage http://K-grid.com/loginscreen.php --helperuri https://secure.k-grid.com

Note that this is all one line (no carriage returns). It looks like this in the text editor:


Screen shot of editing the contents of the arguments.txt file

Screen shot of editing the contents of the arguments.txt file


  • Now return to the Applications folder, double click the Emerald .app package file you just changed, and you should see the K-Grid login screen, that looks something like this (the background image and other stuff changes a lot, but you get the idea):

Screen shot 2009-10-18 at 2.44.10 PM

Windows Method:

    • I haven’t been able to test this, since I can’t seem to get the client to deal with Vista running under VMware on my Mac – however, BeBob posted a comment today that suggests to do the following
    • Right click on the shortcut (either the icon if you installed one on your desktop, or link in the program menu), and select “Properties”
    • You can then edit the command line arguments that the shortcut uses to start the Emerald program – you will find this text string in the “Target” blank (see the screen shot below).

      Screen Shot of the Emerald program shortcut properties

      Screen Shot of the Emerald program shortcut properties

    • I suggest playing with this, since I am only guessing how to edit this. Perhaps make a copy of the shortcut and experiment with that, so if it doesn’t work you can start over. I started the text edit program, copied the contents of the Target blank, then pasted it in the editor so I could edit it. Below is my guess of what should be used to replace the contents of the Target property:

    • For Windows 7, if you are running 64 bit version, there is a slight change in the path to the program executable – the addition of “(x86)” – the rest is the same:
    • One more note: if this string is too long, you can eliminate the “ -set SystemLanguage en-us” part and use the rest.
    • Thanks to BeBoo for the initial windows hint – thanks for Robin for letting me know it works, thanks to Jim Builder for the hint about removing the extra text, and thanks to Silas for the hint about Windows 7.


6 responses to “K-Grid using the Emerald Client

  1. Pingback: k-grid info « Pais Kidd’s Weblog

  2. Great info Pais!

  3. Thanks very much for this info, Pais. For Windows, they just have to right-click the shortcut and put all that at the end of the text already in the Target field.

  4. Pingback: K-Grid Chat on iPhone « Pais Kidd’s Weblog

  5. Pingback: K-Grid is now meta7 « Pais Kidd’s Weblog

  6. Thanks Pais! Very helpful for us fanboys :)

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s