Pre 1.20 Client parameters

From Second Life Wiki
Jump to: navigation, search

Commandline Options

-option <argument1> <argument2> Description

-skin <directory>

load skins/<directory>/skin.xml as the default UI appearance (incomplete)


activate (incomplete) Korean UI translation

-spanish activate (incomplete) Spanish UI translation
-techtag <param>

unknown (but requires a parameter)

-simple  ?
-yield <ms> yield some idle time to local host (changed from -cooperative)
-ignorepixeldepth ignore pixel depth settings
-url <url> handles secondlife://sim/x/y/z URLs
-nothread run VFS (Virtual File System) in single thread
-nomultiple block multiple viewers (secondlife.exe instances)
-multiple allow multiple viewers

reset preferences, run in safe mode

-noconsole hide the console if not already hidden
-login <first> <last> <password>

log in as a user

-set <variable> <value>

specify value of a particular configuration variable; can be used multiple times in a single command-line

-settings <filename> specify configuration filename; default is "settings.ini"
-logfile <logfile> change the log filename

do not request inventory library


logs in local time, not UTC

-errmask <mask>

32-bit bitmask for error type mask


debug mask


run without simulator


delete files in cache

-noprobe disable hardware probe

FMOD is the API used to distort sound while moving

-nosound no sound
-noaudio no audio (different thank above?)
-quitafter <seconds>

SL quits after elapsed time

-loginuri <URI>

login server and CGI script to use


deprecated; use "-user" instead

-user <user_server_ip> specify user server in dotted quad
--dmz See Grids::DMZ (DeMilitarized Zone)
--agni See Grids::Agni, Main Grid
--colo See Grids::Colo, Preview Grid
--siva See Grids::Siva, Preview Grid
--durga See Grids::Durga, Preview Grid
-outbw <number> set outgoing bandwidth
-inbw <number> set incoming bandwidth
-drop <number> drop number% of incoming network packets
-port <port number> Set the TCP port for the client; useful to run multiple instances of SL on the same local home network. Values that may work: 13000 and 13001 (Valid numbers are 13000 to 13050)
-dialog some arcane dialog box that is impossible to raise

Using Client Parameters

There are many ways of passing command line options to the viewer. These are among the most common and useful:

Command Line

From all supported platforms, arguments may be specified manually when running the viewer from a shell.

Windows Shortcuts

Create a shortcut to the SecondLife.exe executable. Edit the shortcut properties and add any of the above options in the first editable text field. The arguments go at the end of the line, *after* the closing quotation mark, if any.

OS X Parameter File

In OS X, create a file called Second and list the options you like, one per line.

Visual Studio

In Visual Studio, the command line paramaters are in the Debug Options pane of the newview project preferences. Ensure newview is your startup project, and launch the compiled viewer from within the debugger for these options to take effect.


In XCode, first select "newview" under the "Executables" group in XCode. Then open the "Get Info" dialog and click the "Arguments" tab. Add any of the above options to the "Arguments to be passed on launch" pane.

Altered Behavior

The link from -cooperative to -yield seems to have dissapeared with 1.13.1 -- Evidenced in the log:

2007-01-09T10:16:14Z WARNING: Possible unknown keyword -yield

2007-01-09T10:16:14Z INFO:

2007-01-09T10:16:14Z usage: viewer [options]

2007-01-09T10:16:14Z options:

2007-01-09T10:16:14Z -login <first> <last> <password> log in as a user

2007-01-09T10:16:14Z -loginuri <URI> login server and CGI script to use

2007-01-09T10:16:14Z -helperuri <URI> helper web CGI prefix to use

2007-01-09T10:16:14Z -settings <filename> specify the filename of a

2007-01-09T10:16:14Z configuration file

2007-01-09T10:16:14Z default is settings.ini

2007-01-09T10:16:14Z -set <variable> <value> specify the value of a particular

2007-01-09T10:16:14Z configuration variable

2007-01-09T10:16:14Z -user <user_server_ip> specify userserver in dotted quad

2007-01-09T10:16:14Z -god log in as god if you have god access

2007-01-09T10:16:14Z -purge delete files in cache

2007-01-09T10:16:14Z -safe reset preferences, run in safe mode

2007-01-09T10:16:14Z -noutc logs in local time, not UTC

2007-01-09T10:16:14Z -nothread run vfs in single thread

2007-01-09T10:16:14Z -noinvlib Do not request inventory library

2007-01-09T10:16:14Z -multiple allow multiple viewers

2007-01-09T10:16:14Z -nomultiple block multiple viewers

2007-01-09T10:16:14Z -ignorepixeldepth ignore pixel depth settings

2007-01-09T10:16:14Z -cooperative [ms] yield some idle time to local host

2007-01-09T10:16:14Z -skin ui/branding skin folder to use

2007-01-09T10:16:14Z -noprobe disable hardware probe

There seem to be more options listed in the wiki than the viewer's log reports.

Does the viewer still silently recognize them, or have they been removed?

Perhaps these should be brought into sync with How It Should Be (TM)


Name Desciption User Server Login CGI
DMZ LL Internal Grid

Agni Main SL Grid

Colo Old Preview Grid (1.6--)

Siva New Preview Grid (1.7)

Durga New Preview Grid (1.8)