Using Second Life URLs (SLurls)

Template:Needs Translation/es Template:Needs Translation/el Template:Needs Translation/he Template:Needs Translation/it Template:Needs Translation/ja Template:Needs Translation/ko Template:Needs Translation/nl Template:Needs Translation/hu Template:Needs Translation/no Template:Needs Translation/da Template:Needs Translation/sv Template:Needs Translation/tr Template:Needs Translation/pl Template:Needs Translation/pt Template:Needs Translation/ru Template:Needs Translation/th Template:Needs Translation/uk Template:Needs Translation/zh-Hans Template:Needs Translation/zh-Hant

Second Life APIs

• Registration API

• Map API

• Inventory API
• Live Data Feeds
• Media Plugin API

• Marketplace API for Viewers

Unofficial APIs

• Search API
• Snapshot API
• World API
• Picture Service

What is a SLURL?

A Second Life URL (SLURL) is a teleport link to a location in Second Life. If you have Second Life installed, using a SLURL will automatically transport you to that location inworld. If you don't yet have Second Life, just click the Sign Up NOW link to go to a simple registration page; after registering and downoading the Second Life Viewer, you will automatically start out at the specified location. See also the following Knowledge Base articles: SL Knowledge Base: How do I invite someone who isn't currently inworld to a specific location? SL Knowledge Base: I don't want people to use a SLURL to access my land SL Knowledge Base: I followed a SLURL and it took me to the wrong place! The http://slurl.com website is implemented using the Second Life Map API. If you have a website, you can use it as well to embed Second Life maps on your pages, in the same way you can embed Google Maps. See Map API for more information.

<videoflash>B47ojt8IMD8</videoflash>

How it works

Use a SLURL to direct people to inworld locations as follows:

• Create a SLURL, either using SLURL Builder, or "manually."
• Share the SLURL with a person who you want to tell about something in Second Life.
• They click the SLURL. It's a web link like any other.
• They'll see a http://slurl.com page and more info, if you provided it. Like this:

If the person doesn't have Second Life

The page at http://www.slurl.com will display a link to SIGN UP NOW for free. From the sign-up up page, they can quickly register, download the Second Life Viewer, and log in. When they first log in, they will initially arrive at the destination specified by the SLURL, not the default start location on Help Island. A quick tutorial will open upon their initial arrival to help them get started.

Providing new users the ability to sign up for Second Life directly from http://www.slurl.com is sometimes referred to as DirectSLURL. For more information, see the announcement of Direct SLURL.

If the person has Second Life

If the Second Life Viewer is not already running, it will start.

• When they log in, they'll be at the location specified by the SLURL.
• If they're already logged in, a Place Information window opens in the Second Life Viewer (for example, as shown at right).
• When they click on the Teleport button in this window, they will be instantly teleported to the location specified by the SLURL. Alternatively, they can click Show on Map to display the target location on the inworld map, or simply close the window if they don't want to be teleported.

Details

On Windows, a SLURL opens the most recently installed Viewer.

There isn't an immediate way to change which Viewer launches SLURLs, so if you have the current released Viewer and a Release Candidate, whichever was installed most recently will start. You can change this by reinstalling the Viewer.

Every SLURL page's SLURL title and Teleport Now button link to a "secondlife://" address, which is an URI scheme which opens Second Life. This is different from the familiar "http://" used for webpages.

The reason why it's advantageous to post "http://" SLURLs instead of direct "secondlife://" addresses in webpages and such is for the benefit of people who don't have Second Life yet. Giving them a "secondlife://" URL doesn't work, since it depends on SL being installed. A SLURL serves as a friendly intro to tell them about Second Life as-needed and where they'll be going, instead of leading them blindly.

Constructing SLURLs

The basic format for a SLURL is:

http://slurl.com/secondlife/<region>/<x>/<y>/<z>?param=value&param=value...

Where:

• <region> is the name of the destination region
• <x> and <y> are the east/west and north/south coordinates of the destination; <z> is the vertical (height) coordinate.
• The question mark (?) and the parameters that follow it are optional and provide additional information to be displayed in the slurl.com page; see Query string parameters for more informatiom.

Making beautiful SLURLs

The first step to making beautiful SLURLs is adding explanatory text and a picture to give it more context and information.

For example, say you've got an island in Second Life you want to invite people to. This base URL works:

http://slurl.com/secondlife/Here/54/105/47

But it tells nothing about the destination. Compare this to the following:

http://slurl.com/secondlife/Here/54/105/47/?title=An%20island%20of%20fun%21

Click on the link to to see that it provides more descriptive information.

Use SLURLBuilder to easily make beautiful SLURLs.

Query string parameters

Supply SLURL query string parameters to set the window title, image, and text. Parameters are just name=value pairs. Just like a standard URL, precede the first parameter pair with a question mark (?), and all subsequent parameter pairs with an ampersand (&).

Parameter	Description	Example
title	Title text to display in the teleport window.	To specify the window title "Come to My Island!" use title=Come%20To%20My%20Island For example: http://slurl.com/secondlife/Ahern/50/50/50/?title=Come%20To%20My%20Island
img	URL of image to display in teleport window. Must be a complete (absolute) URL, and preferably a small image of 256x256 pixels or less.	To display this example image, use img=http://slurl.com/examples/forsale.png For example: http://slurl.com/secondlife/Ahern/50/50/50/?img=http://slurl.com/examples/forsale.png
msg	Message text to display in the teleport window	To specify the message text "Your text here", use msg=Your%20text%20here For example: http://slurl.com/secondlife/Ahern/50/50/50/?msg=Your%20text%20here.

Shortening SLURLs

SLURLs, especially if they have text and a picture included (see example), can get quite lengthy. This makes them difficult to paste into places like emails, which may have line breaks that mangle the SLURL. Plus, they look unsightly!

You can use a 3rd-party URL-shortening service to condense a SLURL and make it easier to share. There are dozens of these out there, including:

• Snurl - No relation to SLURL, but the similar URL and basic stats tracking makes it an easy choice.
• TinyURL - One of the first and most popular.

If you have a webserver with customizable redirect, you can do something similar. For example, try: http://torley.com/here and watch how the SLURL expands to its full length in your web browser's address bar.

Further information

Share SLURLs with postcards

You can send snapshots from Second Life to any email address. These are called postcards. All you need to do is: Click Snapshot button on the toolbar at the bottom of your screen. Select the "postcard" option Click Send, type your recipient's email and descriptive text, and click Send again. Within minutes, they'll get it — with a SLURL! One popular popular way to use them is emailing them to social sites to show off! See example on Flickr, and notice how the "Visit Tiny" link is a SLURL! This is great, because the picture (said to be worth 1,000 words) gives you an idea what to expect. However, emailing straight to Flickr doesn't work as expected due to how postcard templates are arranged. To work around this, social sites like SLBuzz, Snapzilla, and Koinup have stepped in to provide better crossposting in addition to their own dedicated hosting.

<videoflash>cBDAYizCvOI</videoflash>

For more info on Second Life snapshots and how to make the best of postcard SLURLs, see:

• Torley's Guide to High-Quality Photography
• Show off your newest Second Life postcards automagically

Using SLURLs for easy travel

<videoflash>ceIzvl0TYVc</videoflash>

• Read related blog post
• Download high-quality version

Changing your login location

<videoflash>7IQs_ljiAkQ</videoflash>

• Download high-quality version

Teleport location history

<videoflash>DIAhBRaeNiE</videoflash>

• Download high-quality version

Other references

• Template:SLurl - Need to add SLURLs to a wiki page here? This will help!
• Slurlblogger - Useful tool by Ordinal Malaprop which "can send notes with SLurls to email, or directly to a blog".