beyonddiana / andromeda-viewer

Small web-client for connecting to the virtual world of Second Life and OpenSimulator.

Andromeda-Viewer

Small web-client for connecting to the virtual world of Second Life™ and OpenSimulator.

This viewer is not production ready!

Contributing

Feel free to contribute in any way you like. You can't program? You are still needed!

Please read and review the documentation. You can find it in the doc-folder.

Having questions?

Contact me at any time.

How to get started

You need to have node.js version 12.16.0 or higher installed and a Second Life account or an account on an OpenSimulator Grid. More on node.js and npm.js (npm.js comes with node.js). You can check your installed version with the command node -v.

To start open a terminal window (cmd or PowerShell on windows) in your working copy of this project. And run the command npm install. This will install all dependencies.

After that run npm run build to build the client side and make the viewer useable.

Then run npm start to start the server. Now you can use the viewer under http://127.0.0.1:8000/.

git clone https://github.com/Terreii/andromeda-viewer.git
cd andromeda-viewer
npm install
npm run build
npm start

If you want to start developing you should run npm run dev instead. It will build the viewer every time you make a change, start the server and also starts pouchdb-server.

npm run dev

For more information how to use npm, please read the npm-documentation.

To make the setup-process easier, everything needed for this project should be a npm dependency.

npm scripts for this project

command	what it does
npm run build	Builds the viewer for production. The viewer is in an unusable state after cloning.
npm run dev	Builds the viewer. It continues to run and build the viewer when a file changes. This is the recommended build command while developing!
npm run start-server-dev	Runs the server in development. Intended to be run with npm run dev-server.
npm run dev-server	Like npm run dev but configured to proxy to the server which runs on npm start or npm run start-server-dev. Intended to be used for developing the server together with the client.
npm test	Runs all tests. Please run this before committing!
npm run test-coverage	Runs all test and outputs a test coverage report. And will open the report.
npm run test:docs	Runs textlint and alex.js for catching misspelled, insensitive, inconsiderate writing in the documentation.
npm run type-docs	Builds and opens the type documentation.
npm run open-type-docs	Opens the existing type documentation.
npm run update-files	Updates all capabilities names and UDP-Messages.
npm run update-coc	Updates the CODE_OF_CONDUCT.md
npm run update-contrib	Updates the CONTRIBUTING.md
npm run fix:docs	Runs textlint --fix.
npm run fix:style	Runs standard --fix. It can fix many standard style rules.
npm run fix	Runs npm run npm run fix:docs and npm run fix:style.
npm start	Starts the server. The viewer can then be used on the local computer. This is for production. npm run build must be run first.

Enter those commands in a terminal (cmd or PowerShell on Windows) and press enter to run them.

Getting SL Protocol documentation

The SL-Wiki has most documentation for the SL-protocol.

Known Issues

If testing fails to start on MacOS.

Disclaimer

Second Life(TM) is a product by Linden Lab. Linden Lab is not involved with this project!

This is a third-party viewer! Use it on your own risk!