# marzipano

> A 360° media viewer for the modern web

Latest version **0.10.2** (published 2021-03-18) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install marzipano
pnpm add marzipano
yarn add marzipano
bun add marzipano
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.10.2 |
| Published | 2021-03-18 |
| First published | 2015-04-20 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 4 |
| Unpacked size | 1.4 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2258 |
| Author | Google Inc. |
| Maintainers | manuelcabral, tjgq |

## Links

- npm: https://www.npmjs.com/package/marzipano
- Repository: https://github.com/google/marzipano
- Homepage: http://www.marzipano.net
- Issues: https://github.com/google/marzipano/issues
- npm.io page: https://npm.io/package/marzipano

## Dependencies (4)

- [bowser](https://npm.io/package/bowser.md) 1.9.4
- [hammerjs](https://npm.io/package/hammerjs.md) 2.0.4
- [gl-matrix](https://npm.io/package/gl-matrix.md) 3.3.0
- [minimal-event-emitter](https://npm.io/package/minimal-event-emitter.md) 1.0.0

## Recent versions

- 0.10.2 (latest) — 2021-03-18
- 0.10.1 — 2020-12-23
- 0.10.0 — 2020-12-23
- 0.9.1 — 2019-11-24
- 0.9.0 — 2019-04-15
- 0.8.0 — 2018-10-29
- 0.7.2 — 2018-07-15
- 0.7.1 — 2018-02-23
- 0.7.0 — 2018-02-23
- 0.6.0 — 2017-11-04
- 0.5.5 — 2017-08-30
- 0.5.4 — 2017-03-27
- 0.5.3 — 2016-12-05
- 0.5.2 — 2016-12-01
- 0.5.1 — 2016-05-20
- … 7 more at https://npm.io/package/marzipano/versions

## README

# Marzipano

A 360° media viewer for the modern web.

This is not an official Google product.

Check out our website at http://www.marzipano.net/,
including the [demos](http://www.marzipano.net/demos.html)
and the [documentation](http://www.marzipano.net/docs.html).

Please report bugs using the [issue tracker](https://github.com/google/marzipano/issues). If you have any questions, head over to our [discussion forum](https://groups.google.com/forum/#!forum/marzipano).

### User guide

You can include Marzipano in your project in two different ways:

* Obtain the `marzipano.js` file from the latest release at
  http://www.marzipano.net and copy them into your project.

* Install Marzipano as a dependency using the `npm` package manager and
  `require` it as a module.

### Developer guide

This is an `npm`-based project.
A [Node.js](http://www.nodejs.org) installation is required for development.

Some dependencies expect the Node.js interpreter to be called `node`. However,
on Debian and Ubuntu systems, the binary installed by the `nodejs` package is
called `nodejs`. To work around this, install the `nodejs-legacy` package, or
use [nvm](https://github.com/creationix/nvm) instead.

Run `npm install` to install the dependencies. If you haven't in a while,
bring them up to date with `npm update`.

Run `npm run dev` to serve this directory at `http://localhost:8080`.
While this script is running, the demos are live-reloaded whenever the source
files are edited.

Run `npm test` to automatically run the browser-based test suite on all
available browsers in your system.

Run `npm run livetest` to serve the browser-based test suite at `http://localhost:7357`.
While this script is running, the test suite is live-reloaded whenever the
source or test files are edited.

### Maintainer guide

Before preparing a release, make sure there are no uncommitted changes and
verify that the tests pass and all of the demos work correctly.

Update the `CHANGELOG` file and bump the version number in `package.json`.
Create a new commit containing only the changes to these two files, tag it with
`git tag vX.Y.Z`, and push it to GitHub with `git push --tags`.

Run `npm run release` to prepare a new release.

Run `npm run deploy` to deploy the release to the website.

Run `npm publish` to publish the release to the npm registry.

---
_Source: https://npm.io/package/marzipano · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._