{"id":20945933,"url":"https://github.com/terreii/andromeda-viewer","last_synced_at":"2025-08-10T21:09:39.058Z","repository":{"id":34501695,"uuid":"38442553","full_name":"Terreii/andromeda-viewer","owner":"Terreii","description":"Small web-client for connecting to the virtual world of Second Life and OpenSimulator.","archived":false,"fork":false,"pushed_at":"2023-06-05T15:59:07.000Z","size":23125,"stargazers_count":19,"open_issues_count":36,"forks_count":7,"subscribers_count":8,"default_branch":"latest","last_synced_at":"2024-05-27T12:13:26.850Z","etag":null,"topics":["opensimulator","reactjs","secondlife","web","webapp"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Terreii.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-07-02T16:03:08.000Z","updated_at":"2024-05-04T18:56:29.000Z","dependencies_parsed_at":"2023-02-13T18:46:17.822Z","dependency_job_id":null,"html_url":"https://github.com/Terreii/andromeda-viewer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Terreii%2Fandromeda-viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Terreii%2Fandromeda-viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Terreii%2Fandromeda-viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Terreii%2Fandromeda-viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Terreii","download_url":"https://codeload.github.com/Terreii/andromeda-viewer/tar.gz/refs/heads/latest","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225269891,"owners_count":17447605,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["opensimulator","reactjs","secondlife","web","webapp"],"created_at":"2024-11-18T23:51:16.606Z","updated_at":"2024-11-18T23:51:17.196Z","avatar_url":"https://github.com/Terreii.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Andromeda-Viewer\nSmall web-client for connecting to the virtual world of [Second Life](https://secondlife.com)™ and [OpenSimulator](http://opensimulator.org/wiki/Main_Page).\n\n[![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg)](http://standardjs.com/)\n[![Dependency Status](https://david-dm.org/Terreii/andromeda-viewer.svg)](https://david-dm.org/Terreii/andromeda-viewer)\n[![devDependency Status](https://david-dm.org/Terreii/andromeda-viewer/dev-status.svg)](https://david-dm.org/Terreii/andromeda-viewer#info=devDependencies)\n[![Build Status](https://travis-ci.org/Terreii/andromeda-viewer.svg?branch=master)](https://travis-ci.org/Terreii/andromeda-viewer)\n[![Known Vulnerabilities](https://snyk.io/test/github/Terreii/andromeda-viewer/badge.svg)](https://snyk.io/test/github/Terreii/andromeda-viewer)\n\n_**This viewer is not production ready!**_\n\n## Contributing\nFeel free to contribute in any way you like. You can't program? You are still needed!\n\nPlease read and review the documentation. You can find it in the **doc-folder**.\n\n#### Having questions?\nContact me at any time.\n\n### How to get started\nYou need to have **[node.js](https://nodejs.org/) version 12.16.0 or higher** installed and a *Second Life* account or an *account on an [OpenSimulator Grid](http://opensimulator.org/wiki/Grid_List)*. [More on node.js and npm.js](https://docs.npmjs.com/getting-started/what-is-npm) (npm.js comes with node.js). You can check your installed version with the command `node -v`.\n\nTo 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.\n\nAfter that run `npm run build` to build the client side and make the viewer useable.\n\nThen run `npm start` to start the server. Now you can use the viewer under http://127.0.0.1:8000/.\n\n```sh\ngit clone https://github.com/Terreii/andromeda-viewer.git\ncd andromeda-viewer\nnpm install\nnpm run build\nnpm start\n```\n\nIf 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.\n\n```sh\nnpm run dev\n```\n\nFor more information how to use npm, please read the [npm-documentation](https://docs.npmjs.com/).\n\nTo make the setup-process easier, everything needed for this project should be a npm dependency.\n\n### npm scripts for this project\n\ncommand | what it does\n--------|-------------\n`npm run build` | Builds the viewer for production. The viewer is in an unusable state after cloning.\n`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!\n`npm run start-server-dev` | Runs the server in development. Intended to be run with `npm run dev-server`.\n`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**.\n`npm test` | Runs all tests. Please run this before committing!\n`npm run test-coverage` | Runs all test and outputs a test coverage report. And will open the report.\n`npm run test:docs` | Runs [textlint](https://textlint.github.io/) and [alex.js](https://alexjs.com/) for catching misspelled, insensitive, inconsiderate writing in the documentation.\n`npm run type-docs` | Builds and opens the type documentation.\n`npm run open-type-docs` | Opens the existing type documentation.\n`npm run update-files` | Updates all [capabilities names](http://wiki.secondlife.com/wiki/Category:Capabilities) and [UDP-Messages](http://wiki.secondlife.com/wiki/Category:Messages).\n`npm run update-coc` | Updates the CODE_OF_CONDUCT.md\n`npm run update-contrib` | Updates the CONTRIBUTING.md\n`npm run fix:docs` | Runs `textlint --fix`.\n`npm run fix:style` | Runs `standard --fix`. It can fix many standard style rules.\n`npm run fix` | Runs npm run `npm run fix:docs` and `npm run fix:style`.\n`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.\n\nEnter those commands in a terminal (cmd or PowerShell on Windows) and press enter to run them.\n\n### Getting SL Protocol documentation\nThe [SL-Wiki](http://wiki.secondlife.com/wiki/Protocol) has most documentation for the SL-protocol.\n\n### Known Issues\n\n[If testing fails to start on MacOS](https://github.com/Terreii/andromeda-viewer/blob/latest/README-create-react-app.md).\n\n## Disclaimer\n[Second Life(TM)](https://secondlife.com) is a product by [Linden Lab](http://www.lindenlab.com/). Linden Lab is not involved with this project!\n\nThis is a third-party viewer! _Use it on your own risk!_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fterreii%2Fandromeda-viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fterreii%2Fandromeda-viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fterreii%2Fandromeda-viewer/lists"}