Pre 1.20 Client parameters
| Help Portal: |
Avatar | Bug Fixes | Communication | Community | Glossary | Land & Sim | Multimedia | Navigation | Object | Video Tutorials | Viewer | Wiki | Misc |
Commandline Options
| -option <argument1> <argument2> | Description |
|
-skin <directory> |
load skins/<directory>/skin.xml as the default UI appearance (incomplete) |
| -korean |
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 |
| -safe |
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 |
| -log | |
| -noinvlib |
do not request inventory library |
| -noutc | |
| -errmask <mask> | |
| -debugst |
debug mask |
| -local |
run without simulator |
| -purge |
delete files in cache |
| -noprobe | disable hardware probe |
| -nofmod |
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 |
| --autologin | |
| -helperuri | |
| -loginuri <URI> |
login server and CGI script to use |
| -space |
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 |
| -previous |
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 Life.app/Contents/Resources/arguments.txt 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.
XCode
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)
Grids
| 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) |