Connecting

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m
(half done)
Line 3: Line 3:
 
<br />
 
<br />
  
==OpenSim Available Viewers==
+
==Obtaining OpenSim Available Viewers==
OpenSimulator doesn't have the client program in it. Before you can connect to OpenSim, you'll need to have downloaded one of the any OpenSim compatible clients that can connect to OpenSim.
+
'''OpenSimulator doesn't have the client program in its distribution.''' You'll need to download an OpenSim compatible client before connecting to OpenSim grids.
 
{{:Compatible Viewers}}
 
{{:Compatible Viewers}}
  
Line 10: Line 10:
 
Some other viewers that can connect to Second Life can also connect to OpenSim. You can find them in [http://wiki.secondlife.com/wiki/Downloads Downloads#Second Life Wiki].
 
Some other viewers that can connect to Second Life can also connect to OpenSim. You can find them in [http://wiki.secondlife.com/wiki/Downloads Downloads#Second Life Wiki].
  
==Connecting with the Linden Viewer==
+
==Connecting to the Grid with Grid Selector (Recommended) ==
  
<span style="color:#ff0000;">'''***NOTE***''': These instructions apply to the Linden Labs viewer ONLY. Most other viewers have a more elegant method, called GridInfo protocol, to choose a grid. See the documentation for those viewers for more information.</span>
+
If you can find the grid you want to connect in the grid selector (The dropdown menu at the bottom of the screen to the right of the login button. If you can't find it, try Ctrl-Shift-G), then simply choose it and enter username/password provided by the grid administrators when you created your account on the grid.
  
Every OpenSim grid or instance will specify a '''loginuri''', which is a uri of the form '''http://someserver:9000''' (standalone mode) or '''http://someserver:8002''' (grid mode).  For instance, for osgrid, this is http://login.osgrid.org.
+
'''Basically, you can't login to OpenSim grids with other grid's accounts, including Second Life. You need to create separate accounts for each grids you want to login.''' When you choose the grid, some viewers shows the link to signup page, so create your account as per its instructions.
  
A list of major public grids can be found at [[Grid_List]]. OSGrid is just one of many available.
+
If you can't, then lookout for the Grid Manager interface. If there is, you can find it near the grid selector or in preference window. Usually, the only fields you have to fill in are:
  
All you have to do is to pass this '''loginuri''' command line parameters to the viewer and launch with it. See [http://wiki.secondlife.com/wiki/Viewer_parameters#Using_Viewer_parameters this wiki page (Viewer parameters#Using Viewer Parameters)] how to do that.
+
* '''Grid Name''' (or alike) - The name you can easily identify. OpenSim grids doesn't use this information, so you can name it freely.
 +
* '''Login URI''' - The most important information.<nowiki> It should be like "http://someserver:9000" or "http://someserver:8002". For instance, for osgrid, this is "http://login.osgrid.org/".</nowiki>
 +
 
 +
You will find the button "Get Grid Info" or alike. If you click it, it might fill other blank fields with some URIs, or show error dialog, or freeze. If you have problem with this button, don't click it and leave other fields empty. This problem is not so much an issue. It works anyway without them.
 +
 
 +
If it succeed, you will find the new entry in the grid selector.
 +
 
 +
For detailed instructions, see the documentation for each viewer.
 +
 
 +
==Connecting to the Grid with Viewer Parameter==
 +
 
 +
If you can't find grid selector, or you can find it but can't find the grid you want to login in the list and can't find grid manager, there are some other methods.
 +
 
 +
In any case, all you have to do is to pass this '''loginuri''' command line parameters to the viewer and launch with it. If you are using Second Life Viewer or Snowglobe-based viewers, see [http://wiki.secondlife.com/wiki/Viewer_parameters#Using_Viewer_parameters this wiki page (Viewer parameters#Using Viewer Parameters)] how to do that. The Linden viewer has a number of other options.  Some are useful, some are not. See [http://wiki.secondlife.com/wiki/Viewer_parameters#Parameter_reference Parameter Reference from Second Life Wiki] for detail.
 +
 
 +
For example, Second Life on Windows, and want to connect to OSGrid, quick-and-easy way would be like that:
 +
<pre>
 +
SecondLife.exe -loginuri <nowiki>http://login.osgrid.org/</nowiki> -loginpage <nowiki>http://www.osgrid.org/splash/
 +
</pre>
 
   
 
   
On OSX environments, if you have multiple viewers and multiple grids to connect to, you can try the following AppleScript (one could do something similar with a shell script).  Feel free to copy and modify for your own use.
+
On OSX, you can even use ActionScript, which enables you to select multiple grid to connect to. [[OSX_Grid_Selector_Script]]
--
+
--  This script selects a viewer and a grid for virtual worlds.
+
--
+
--
+
-- Variables for the two supported viewers.  More may be added here.
+
--
+
set lindenViewer to "\"/Applications/SecondLife/Second Life.app/Contents/MacOS/Second Life\""
+
+
set emeraldViewer to "\"/Applications/SecondLife/GreenLife Emerald Viewer.app/Contents/MacOS/GreenLife Emerald Viewer\""
+
--
+
-- Variables for options to select the specified grid.  Since the viewers
+
-- are based on the 2nd life viewer, the options are the same for each
+
-- viewer.  Also, connecting to the Second Life grid is the default option
+
-- if no other options are provided.
+
--
+
-- Currently, four grids are supported.  More may be easily added.
+
--
+
set lindenOptions to ""
+
+
set localStandalone to " -loginuri http://vw.server.lan:9000 -loginpage http://vw.server.lan/opensim/index.html"
+
+
set localGrid to " -loginuri http://vw.server.lan:8000 -loginpage http://vw.server.lan/opensim/index.html"
+
+
set osGridOptions to " -loginuri http://osgrid.org:8002 -loginpage http://osgrid.org/loginscreen.php -helperuri http://osgrid.org/"
+
--
+
-- Display dialog and select the viewer.
+
--
+
set dialogResult to display dialog "Choose viewer:
+
1) 2nd Life viewer
+
2) Emerald viewer:" default answer "1" with title "Select Viewer" with icon 1
+
+
set option to text returned of dialogResult
+
+
if option = "2" then
+
set viewer to emeraldViewer
+
else
+
set viewer to lindenViewer
+
end if
+
--
+
-- Display dialog and select the grid.
+
--
+
set dialogResult to display dialog "Choose server:
+
1) 2nd Life grid
+
2) local standalone
+
3) local grid
+
4) OS Grid" default answer "2" with title "Select Grid" with icon 1
+
+
set grid to text returned of dialogResult
+
+
if grid = "1" then
+
set options to lindenOptions
+
else if grid = "2" then
+
set options to localStandalone
+
else if grid = "3" then
+
set options to localGrid
+
else if grid = "4" then
+
set options to osGridOptions
+
else
+
set options to localStandalone
+
end if
+
--
+
-- Combine the grid and viewer and execute the result.
+
--
+
set command to viewer & options
+
do shell script command
+
 
+
===Linden Viewer options===
+
The Linden viewer has a number of other options.  Some are useful, some are not. See [http://wiki.secondlife.com/wiki/Viewer_parameters#Parameter_reference Parameter Reference from Second Life Wiki] for detail.
+
  
 
== Alternative Connection Approaches ==
 
== Alternative Connection Approaches ==

Revision as of 08:40, 16 April 2011


Obtaining OpenSim Available Viewers

OpenSimulator doesn't have the client program in its distribution. You'll need to download an OpenSim compatible client before connecting to OpenSim grids.


If you find a viewer, which can connect to OpenSimulator, then please add it to the bottom of the appropriate list.

Compatibility issues

Since OpenSimulator and viewers development is done by different teams with different timing and even goals, compatibility can not be assured. To connect to an older version of OpenSimulator, you may need to use an older version of your favourite viewer, which also could limit Hypergrid capability. In this case you should consult the support of your grid or chosen viewer.

Viewers

  • FireStorm Viewer - C++ based viewer for Linux/Mac/Win. Forked from Linden lab Second Life viewer. Successor to Phoenix viewer. Currently the most widely used viewer on Second Life.
    • Firestorm VR Mod - A modification to the Firestorm Vierwer to allow use of a Virtual Reality Head Mounted Display (VR HMD).
  • Dayturn - C++ based viewer for Win/Mac only. Forked from Kokua. Dayturn source code available on Bitbucket.
  • Cool VL Viewer - C++ based viewer for Linux x86_64/Linux aarch64/Mac/Win. Forked from SL v1 viewer (former name: Cool SL Viewer, first release 2007/11/16).
  • Radegast Metaverse Client - Radegast-ng is Light client, evolution of Radagast from libopenmetaverae project.
  • Scenegate - C++ based viewer with a focus on accessibility and onboarding. With a simplified UI more suitable to just visit worlds, rather than building (but the full UI is still accessible). Forked from Alchemy.
  • Alchemy Viewer - C++ based viewer for Linux/Mac/Win. Forked from Linden lab Second Life viewer.

Beta Viewers

Dayturn for Windows and MacOS https://bitbucket.org/dayturn/

OpenSim PBR Viewers

Phoenix-FirestormOS Phoenix FirestormOS Beta 7.1.4

Cool VL Viewer stable release with PBR, ALM and forward rendering modes.

Text-only Viewers

These are lightweight viewers, which either do not offer a graphical component or where the graphical component is not used by default. The function of these viewers however is to connect to a grid, chat, manage inventory, etc. Useful on systems with low specifications or for bringing an alt (alternate avatar) online without having your main avatar log out, or to quickly take care of messages, inventory, etc.

  • Mobile Grid Client - A Second Life and OpenSimulator messaging client for your Android powered device (mobile phone, cell phone, tablet...).

LLSD API Libraries

These are open source libraries for building viewers, clients, and tools that can connect to OpenSimulator.

Maintained Libraries:

  • libopenmetaverse - C# LLSD implementation. Maintained by OpenSimulator developers. BSD License
  • llbase-py - Python LLSD implementation. Maintained by Linden Labs. MIT License

Currently Unmaintained Libraries:

  • llsd-cpp - C++ LLSD implementation, last updated in 2010. MIT License
  • llsd-perl-new - Perl LLSD implementation. Last updated 2011. MIT License
  • llsd-php - PHP 4 LLSD implementation. Incomplete, supports XML serialization only. Used internally by Second Life developers. Last updated 2010. MIT License
  • llsd-java - Java LLSD implementation by Xugu Madison, last update ca 2014. BSD License.
  • JOpenMetaverse - Java LLSD implementation, last updated 2012. Linux, Windows, MacOS, Android Compatible. Also see jopenmetaverse introduction. LGPL 2.1 License
  • llsd-js - JavaScript LLSD implementation, last update in 2011. MIT License

Inactive Viewers or in unknown state

  • 3Di viewer Rei - C# based Web-browser plugin OpenSimulator viewer. 3Di website gone but 3Di Rei viewer source is still available on Github
  • Ascent - C++ based viewer for Linux/Mac/Win. Started as a fork of Inertia Viewer. Abandoned in 2010.
  • Dolphin - C++ based viewer for Linux/Mac/Win. Dolphin v1 was a fork of the Cool VL Viewer, with changes focused on sailing. v2/3 was a fork of SL viewer. Abandoned in 2015. Dolphin 3 Source still available on GitHub.
  • Emerald - C++ based viewer forked from Snowglobe (the second version fo the LL/SL open source viewer). Project halted and abandoned in 2010 after Emerald developer linked to DoS attack on SL and banned. Emerald source code still available on GitHub and Google Code Archive.
  • Hippo - C++ based viewer for Linux/Mac/Win. Forked from SL viewer and Cool VL Viewer. Abandoned in 2010. See also Hippo Viewer website.
  • Idealist - C# Multi-platform 32 bit viewer intended to be OpenSimulator focused
  • Imprudence - C++ based viewer forked from SL viewer v1.21. Development ended in 2010 and shifted to a new viewer called Kokua. Imprudence Viewer source is still available on GitHub
  • Inertia - C++ based viewer forked from Snowglobe SL viewer). Abandoned in 2010
  • LookingGlass - C#/Ogre based Viewer prototype. Development Ended in 2011. LookingGlass Viewer source is still available on GitHub
  • Meerkat - Viewer for Linux/Mac/Win in C++. Fork of SL viewer. Meerkat source available on GitHub. Meerkat binaries available via Google Code Archive. Development stopped in 2009
  • OnLook - C++ based viewer forked from Singularity. Inactive since 2014. OnLook Viewer Source is still available on GitHub.
  • Nicholaz Beresford's viewer - The first third party viewer. Fork of SL viewer. Development stopped in 2010.
  • OpenSim-Viewer - C#/C++/Xenko based, BSD licensed viewer written for OpenSimulator. Inactive since 2018.
  • OpenViewer - C#/Ogre based, BSD licensed viewer written as a companion to OpenSimulator. ca 2007/2008. Website went dark in 2009.
  • Phoenix - C++ based viewer. Forked from SL viewer. Replaced by Firestorm viewer.
  • RealXtend Naali/Tundra - Written from scratch C++/Ogre3D based viewer for Linux/Mac/Win, required ModRex in OpenSimulator. Development stopped in 2016, OpenSimulator support dropped in 2013.
  • Singularity - C++ based viewer for Linux/Mac/Win. Forked from the Ascent Viewer. Goal is to combine look of old SL viewer with modern features. Singularity source code available on GitHub.
  • Xenki - XABP-based OpenSimulator viewer prototype for IE web browser. Abandoned in 2009

Other Viewers

Some other viewers that can connect to Second Life can also connect to OpenSim. You can find them in Downloads#Second Life Wiki.

Connecting to the Grid with Grid Selector (Recommended)

If you can find the grid you want to connect in the grid selector (The dropdown menu at the bottom of the screen to the right of the login button. If you can't find it, try Ctrl-Shift-G), then simply choose it and enter username/password provided by the grid administrators when you created your account on the grid.

Basically, you can't login to OpenSim grids with other grid's accounts, including Second Life. You need to create separate accounts for each grids you want to login. When you choose the grid, some viewers shows the link to signup page, so create your account as per its instructions.

If you can't, then lookout for the Grid Manager interface. If there is, you can find it near the grid selector or in preference window. Usually, the only fields you have to fill in are:

  • Grid Name (or alike) - The name you can easily identify. OpenSim grids doesn't use this information, so you can name it freely.
  • Login URI - The most important information. It should be like "http://someserver:9000" or "http://someserver:8002". For instance, for osgrid, this is "http://login.osgrid.org/".

You will find the button "Get Grid Info" or alike. If you click it, it might fill other blank fields with some URIs, or show error dialog, or freeze. If you have problem with this button, don't click it and leave other fields empty. This problem is not so much an issue. It works anyway without them.

If it succeed, you will find the new entry in the grid selector.

For detailed instructions, see the documentation for each viewer.

Connecting to the Grid with Viewer Parameter

If you can't find grid selector, or you can find it but can't find the grid you want to login in the list and can't find grid manager, there are some other methods.

In any case, all you have to do is to pass this loginuri command line parameters to the viewer and launch with it. If you are using Second Life Viewer or Snowglobe-based viewers, see this wiki page (Viewer parameters#Using Viewer Parameters) how to do that. The Linden viewer has a number of other options. Some are useful, some are not. See Parameter Reference from Second Life Wiki for detail.

For example, Second Life on Windows, and want to connect to OSGrid, quick-and-easy way would be like that:

SecondLife.exe -loginuri http://login.osgrid.org/ -loginpage <nowiki>http://www.osgrid.org/splash/

On OSX, you can even use ActionScript, which enables you to select multiple grid to connect to. OSX_Grid_Selector_Script

Alternative Connection Approaches

Via a Web Browser

You can also set up a Browser Protocol Handler which will make opensim:// links in your browser do the expected thing, and launch the right OpenSim viewer.

Personal tools
General
About This Wiki