Difference between revisions of "Viewer parameters"
Rand Linden (talk | contribs) |
|||
| Line 6: | Line 6: | ||
== Command Line Options == | == Command Line Options == | ||
{| | {| {{Prettytable}} | ||
!-option <argument> [<optional argument>] | |-{{Hl2}} | ||
|- | ! -option <argument> [<optional argument>] | ||
! Description | |||
! Overridden Setting | |||
|- | |||
||--help | ||--help | ||
||Show a message box with available options listed. | ||Show a message box with available options listed. | ||
Revision as of 12:20, 12 June 2009
| Help Portal: |
Avatar | Bug Fixes | Communication | Community | Glossary | Land & Sim | Multimedia | Navigation | Object | Video Tutorials | Viewer | Wiki | Misc |
For versions of Second Life prior 1.20 see: Pre 1.20 Client parameters
Command Line Options
| -option <argument> [<optional argument>] | Description | Overridden Setting |
|---|---|---|
| --help | Show a message box with available options listed. | |
| --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) | ViewerPort |
| --drop <percentage> | Specify a percentage of packets to drop. | PacketDropPercentage |
| --inbw <bits per sec> | Specify input bandwidth limit. | InBandwidth |
| --outbw <bits per sec> | Specify output bandwidth limit. | OutBandwidth |
| --grid <grid choice> | Specify the grid to connect to. Can be an IP address. | GridChoice |
| --loginuri <URI> | Login server to connect to. | LoginURI |
| --helperuri | Helper web cgi prefix to use ??? | HelperURI |
| --debugviews | Enable UI view debugging info. | DebugViews |
| --skin <folder> | Specify the skin folder to use. (eg. korean, spanish) | SkinFolder |
| --autologin | Login in as last saved user. | AutoLogin |
| --quitafter <secs> | Have the client quit after the specified duration. | QuitAfterSeconds |
| --rotate | Force the Avatar to rotate to the right. (For Testing) | RotateRight |
| --noaudio | Disable sound from the client. | NoAudio |
| --nosound | Disable sound from the client. | NoAudio |
| --noprobe | Disable hardware checking at startup. | NoHardwareProbe |
| --noquicktime | Disable use of quicktime by the client. | NoQuickTime |
| --nopreload | Disable precaching of sound and bitmaps used by the client. | NoPreload |
| --purge | Force the client to clear cached downloads during startup. | PurgeCacheOnNextStartup |
| --noinvlib | Do not request inventory library. | NoInventoryLibrary |
| --log | Log network messages. | LogMessages |
| --logfile <filename> | Specify a file name for log output. | UserLogFile |
| --settings <filename> | Specify the name of the user settings file. | UserSettingsFile |
| --set <setting> <value> | Specify the value of the named setting. | Maps to <setting> arg. |
| --login <firstname> <lastname> <password> | Specify login info. | UserLoginInfo |
| --god | Log in as god if you have god access. | ConnectAsGod |
| --console <show> | Show a debugging console (Windows only) | ShowConsoleWindow |
| --safe | Reset preferences, run in safe mode. | SafeMode |
| --multiple | Allow multiple viewers running concurrently. | AllowMultipleViewers |
| --novoice | Disable voice chat. | DisableVoice |
| --url <SLURL> | Specify the starting region and position (eg. secondlife://Ahern/128/128).
This must be the last parameter on the command line. |
SecondLifeURL |
| --ignorepixeldepth | Ignore pixel depth settings. | IgnorePixelDepth |
| --cooperative <ms to yield> | Yield specified time to host on each frame. | YieldTime |
| --no-verify-ssl-cert | Disable SSL certificate verification. | NoVerifySSLCert |
| --channel <name> | Specify version channel name. (For Testing) | VersionChannelName |
| --qa | Enable UI features for used for testing. | QAMode |
| --crashonstartup | Crashes on startup. For QA use. | |
| --loginpage arg | Login authentication page to use. |
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.
Linux
Open the gridargs.dat file found in your Second Life folder, using your favorite text editor. Add any of the above options to the file, separated either by a space or a newline. Save the file. The next time Second Life is launched, it will be launched with the added options.
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.
OS X Applescripts
An alternative (and often easier) way to launch Second Life is to use an AppleScript. To do this, go into /Applications/AppleScript and open Script Editor. Open a new document and paste the following text into it:
do shell script "\"/Applications/Second Life.app/Contents/MacOS/Second Life\" -grid Aditi"
The script includes a parameter as an example, which will send you to the beta grid, change the parameters as you please. Once you're happy with the parameters, hit the "Compile" button, then go to File -> Save As, and save the script as an Application, and select "Run Only" (may be "Execute" on OS X.4 Tiger). If you want to tweak the script then you can save it as not run-only, and/or save a copy as "Script".
Now simply double-click the Application you've compiled, and SL will launch with the parameters you chose. NOTE: If SL launches then immediately quits, them you will need to open it normally as there is likely an update available, so download it and your script will work again, there is a Jira issue for this.
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.
Specifying new command line parameters
New command line parameters can be added to the client via the configuration file app_settings/cmd_line.xml. Using this file a command line paramter can be mapped to a user setting. Parameter can have the following options:
- desc - A description of the paramter.
- short - a single character to map to the paramter.
- count - the number of tokens to follow a option.
- compose - true if the option can be specified multiple times.
- positional - true if the option can be specified without --name.
- last_option - true if the option should be the last option.
- map-to - specify a user setting to map the option to.
The file uses LLSD syntax. Use the existing options as reference.