Difference between revisions of "User:Dzonatas Sol/Communicator"

From Second Life Wiki
Jump to navigation Jump to search
(→‎Step-by-Step Guide: wikify, gnome#, format)
Line 6: Line 6:
== Step-by-Step Guide ==
== Step-by-Step Guide ==


* compile against Snowglobe Trunk sources:
=== Compile Against Snowglobe Trunk Sources ===
svn co http://svn.secondlife.com/svn/linden/projects/2009/snowglobe/trunk
* $ svn co http://svn.secondlife.com/svn/linden/projects/2009/snowglobe/trunk
* get current libraries and artwork
=== Get Current Libraries and Artwork ===
wget http://automated-builds-secondlife-com.s3.amazonaws.com/oss-viewer/slviewer-linux-libs-oss-viewer-1.23.4.139024.tar.gz http://automated-builds-secondlife-com.s3.amazonaws.com/oss-viewer/slviewer-artwork-oss-viewer-1.23.4.139024.zip
* $ wget http://automated-builds-secondlife-com.s3.amazonaws.com/oss-viewer/slviewer-linux-libs-oss-viewer-1.23.4.139024.tar.gz http://automated-builds-secondlife-com.s3.amazonaws.com/oss-viewer/slviewer-artwork-oss-viewer-1.23.4.139024.zip
ln -s trunk/ linden
* $ ln -s trunk/ linden
unzip slviewer-artwork-oss-viewer-1.23.4.139024.zip
* $ unzip slviewer-artwork-oss-viewer-1.23.4.139024.zip
tar xzf slviewer-linux-libs-oss-viewer-1.23.4.139024.tar.gz
* $ tar xzf slviewer-linux-libs-oss-viewer-1.23.4.139024.tar.gz
* prepare
=== Prepare ===
cd linden/indra/
* $ cd linden/indra/
./develop.py configure
* $ ./develop.py configure
* apply patch. Do it inside <code>linden/</code>
=== Apply Patch ===
cd ../
Do it inside <code>linden/</code>  
cp (...)/snow-375.0.9.6.patch.txt .
* $ cd ../
patch -p1 < snow-375.0.9.6.patch.txt
* $ cp (...)/snow-375.0.9.6.patch.txt .
* compile
* $ patch -p1 < snow-375.0.9.6.patch.txt
cd indra/viewer-linux-i686-relwithdebinfo
=== Compile ===
make
* $ cd indra/viewer-linux-i686-relwithdebinfo
* run Communicator and Snowglobe
* $ make
** after compilation you get <code>(...)/linden/indra/viewer-linux-i686-relwithdebinfo/newview/Snowglobe-i686-1.3.0.0.tar.bz2</code> - copy it somewhere and extract it
=== Install Gnome# Desktop ===
** run Snowglobe
Communicator needs depends on Gnome# Desktop runtime, install if you haven't already:
** get and extract Dzonatas Sol's Communicator (separate build) - currently http://mono.dzonux.net/file/communicator.0.9.6.zip
** run <code>communicator.exe</code>
** login in Snowglobe
** use the toolbar '''Communicate''' button to show the detached windows
 
Above notes provided by [https://jira.secondlife.com/browse/SNOW-375?focusedCommentId=151296&page=com.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel#action_151296 Opensource Obscure].
 
=== Gnome# ===
 
You'll need to install Gnome#:
* Debian/Unbuntu:
* Debian/Unbuntu:
** apt-get install gnome-desktop-sharp2
** apt-get install gnome-desktop-sharp2
Line 41: Line 31:
** [http://ftp.novell.com/pub/mono/gtk-sharp/gtk-sharp-2.12.9-2.win32.msi Gtk# 2.12 for Windows]
** [http://ftp.novell.com/pub/mono/gtk-sharp/gtk-sharp-2.12.9-2.win32.msi Gtk# 2.12 for Windows]
** Or, see here for latest: http://www.go-mono.com/mono-downloads/download.html
** Or, see here for latest: http://www.go-mono.com/mono-downloads/download.html
=== Run Communicator and Snowglobe ===
* after compilation you get <code>(...)/linden/indra/viewer-linux-i686-relwithdebinfo/newview/Snowglobe-i686-1.3.0.0.tar.bz2</code> - copy it somewhere and extract it
* run Snowglobe
* get and extract Dzonatas Sol's Communicator (separate build) - currently http://mono.dzonux.net/file/communicator.0.9.6.zip
* run <code>communicator.exe</code>
* login in Snowglobe
* use the toolbar '''Communicate''' button to show the detached windows
Also see original notes provided by [https://jira.secondlife.com/browse/SNOW-375?focusedCommentId=151296&page=com.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel#action_151296 Opensource Obscure].


== Options ==
== Options ==

Revision as of 10:11, 11 December 2009

MonoVida-20090701a.png

Please feel free to update this page as needed.

Notes related to SNOW-375 on how to download, compile, install, and run the viewer with detached windows.

Step-by-Step Guide

Compile Against Snowglobe Trunk Sources

Get Current Libraries and Artwork

Prepare

  • $ cd linden/indra/
  • $ ./develop.py configure

Apply Patch

Do it inside linden/

  • $ cd ../
  • $ cp (...)/snow-375.0.9.6.patch.txt .
  • $ patch -p1 < snow-375.0.9.6.patch.txt

Compile

  • $ cd indra/viewer-linux-i686-relwithdebinfo
  • $ make

Install Gnome# Desktop

Communicator needs depends on Gnome# Desktop runtime, install if you haven't already:

Run Communicator and Snowglobe

  • after compilation you get (...)/linden/indra/viewer-linux-i686-relwithdebinfo/newview/Snowglobe-i686-1.3.0.0.tar.bz2 - copy it somewhere and extract it
  • run Snowglobe
  • get and extract Dzonatas Sol's Communicator (separate build) - currently http://mono.dzonux.net/file/communicator.0.9.6.zip
  • run communicator.exe
  • login in Snowglobe
  • use the toolbar Communicate button to show the detached windows

Also see original notes provided by Opensource Obscure.

Options

Communicator Command Line

As of 0.9.6, these options are available:

$ communicator.exe --uri=http://host.tld:port --port=number
  • --uri : overrides default outgoing URI connection to the viewer
  • --port : overrides default incoming port connection to communicator

Snowglobe Preferences

These preferences can be found in the debug menu of the viewer:

  • InterfaceAllowConnections : To allow connections or deny all connections
  • InterfaceAllowRemoteConnections : To allow/deny remote connections
  • InterfaceServerPort : The port number of the API

Repository

Use git to clone the repository:

$ git clone http://gitweb.dzonux.net/project/communicator.git

There are a few branches:

master              - source branch of current version
communicator        - latest development branch (merges into master, tagged into X.X.X)
communicator.X.X.X  - tagged branches of specific version X
snowglobe           - latest development branch with changes for communicator
Upstream-X.X.X      - snapshot of oss-viewer branch in LL's repository

You can also browse the repository.

Issues

  • Need to automatically spawn Communicator when Snowglobe starts. Currently have to spawn separately.
  • Need a preference panel option to set address of Web/REST server port. (Used to connect from communicator to viewer asynchronously.)
  • Need a preference panel option to set address of default TCP dial-out port. (Used to connect from viewer to communicator synchronously.)
  • Update cmake build-package to include communicator and extra libs if specified on cmake config or make command, but not to include by default.
  • Need a debug option to Hide/Show built-in communicator windows when detached windows are shown.

Also see the issue tracker for MonoVida Communicator.