<p align="center">
<img src="https://avatars0.githubusercontent.com/u/9430521" style="width: 150px;" />
<h1 align="center" style="width: 60%; margin-left: auto; margin-right: auto;">Universal Viewer</h1>
<p align="center">
A community-developed open source project on a mission<br/> to help you share your 📚📜📰📽️📻🗿 with the 🌎
</p>
</p>
<br/>
<p align="center">
<a href="#-sponsors"><a href="https://opencollective.com/universalviewer/sponsors">
  <img src="https://opencollective.com/universalviewer/sponsors/badge.svg" alt="Sponsors on Open Collective" />
</a>
<a href="https://app.netlify.com/sites/uv/deploys">
<img src="https://api.netlify.com/api/v1/badges/91dc58e8-49dd-495f-98bb-84570a0edb7c/deploy-status" />
</a>
<a href="https://github.com/UniversalViewer/universalviewer/blob/main/LICENSE.txt">
  <img src="https://img.shields.io/npm/l/universalviewer.svg" alt="License" />
</a>
</p>
<p align="center"><a href="https://docs.google.com/forms/d/e/1FAIpQLSeHLD0kng5aXvGFsNN_tJGsZMTnp08Hv2F6kdGsJRb6bT0NWw/viewform" rel="nofollow"><strong>#</strong> Slack
</a> &nbsp;&nbsp;&nbsp;&nbsp;<a href="https://bsky.app/profile/universalviewer.io"> <strong>@</strong> Bluesky</a> &nbsp;&nbsp;&nbsp;&nbsp;<a href="https://x.com/universalviewer"> <strong>@</strong> X</a> &nbsp;&nbsp;&nbsp;&nbsp; <a href="https://glammr.us/@universalviewer"> <strong>@</strong> Mastodon </a>&nbsp;&nbsp;&nbsp;&nbsp; <a href="https://github.com/UniversalViewer/universalviewer/wiki"> History of the UV </a> </p>

# The Universal Viewer (UV) is a community-developed open source project. Our mission is to help you share your content with the world

The UV software can display images, 3D files and PDFs, play audio and video files, and more. 

<br/>

    npm install universalviewer --save

<br/>
    
> Please note that UV v4 is designed to work on [evergreen browsers](https://www.w3.org/2001/tag/doc/evergreen-web/). If you need IE11 support, please use [UV v3](https://github.com/UniversalViewer/universalviewer/tree/v3).
> Microsoft no longer supports IE11, and it [reached end-of-life on June 15 2022](https://blogs.windows.com/windowsexperience/2021/05/19/the-future-of-internet-explorer-on-windows-10-is-in-microsoft-edge/).

<br/>

- [**Website**](#-website)
- [**Getting Started**](#-getting-started)
- [**Contributing and Giving Feedback**](#-contributing-and-giving-feedback)
- [**Contributors and Sponsors**](#-contributors-and-sponsors)
- [**Accessibility Statement**](#-accessibility-statement)
- [**License**](#-license)

## 🌐 Website

- [Visit Universal Viewer website](https://universalviewer.io/)
- [Visit the stable UV demo page](https://uv-v4.netlify.app) to try out the latest stable version of the Viewer (UV4) with sample items.
- [Visit the dev branch UV demo page](https://universalviewer.dev) to try out the latest 'bleeding edge' dev branch code for UV4.
- [View sample items in version 3 of the Universal Viewer](https://uv-v3.netlify.app)

## 📖 Getting Started

See the [examples](https://github.com/UniversalViewer/universalviewer/wiki/UV-Examples) for how to use the UV in various scenarios.

Read the technical [docs](https://docs.universalviewer.io/modules.html) to learn more about the code and available configuration options.

Read the [manual](https://github.com/UniversalViewer/universalviewer/blob/dev/manual/index.md) for information on using, configuring, and developing for the UV.

<a id="feedback"></a>
<a id="contributing"></a>
## 📣 Contributing and Giving Feedback

An active, collaborative community of testers, developers and institutional users has grown around the Universal Viewer. Read this [blog post about a recent 'community sprint'](https://blogs.bl.uk/digital-scholarship/2024/11/working-together-the-community-sprint-experience-.html) to find out more about how we're working together.

Talking to active contributors and sponsors is a great way to find out what the community is currently focusing on, and where help is needed:

- Join the discussion on [Slack](http://universalviewer.io/#contact)
- There is an [active Slack channel](https://docs.google.com/forms/d/e/1FAIpQLSeHLD0kng5aXvGFsNN_tJGsZMTnp08Hv2F6kdGsJRb6bT0NWw/viewform) and regular community calls.
- You can view discussions and post on our [Google Group](https://groups.google.com/forum/#!forum/universalviewer)
- Ask a question, request a new feature and file a bug with [GitHub issues](https://github.com/universalviewer/universalviewer/issues/new)
- Engage with the [UV Steering Group](https://github.com/UniversalViewer/universalviewer/wiki/Steering-Group) and [community team](https://github.com/UniversalViewer/universalviewer/blob/dev/COMMUNITY_TEAM.md)
- Get familiar with [Code of Conduct](https://github.com/UniversalViewer/universalviewer/blob/dev/CODE_OF_CONDUCT.md)
- Read our [guide to contributing](https://github.com/UniversalViewer/universalviewer/blob/dev/CONTRIBUTING.md)
- Read our [governance document](https://github.com/UniversalViewer/universalviewer/blob/dev/GOVERNANCE.md) to learn more about roles and responsibilities, support, membership, and the decision making process.

If you want to dive into code, you can learn how to take part in improving the UV:

- Fork the repository and [run the examples from source](#-getting-started)
- Find an [issue](https://github.com/UniversalViewer/universalviewer/issues) to work on and submit a pull request
- Help update our [Accessibility Statement](https://github.com/UniversalViewer/universalviewer/wiki/Accessibility-Statement-for-the-Universal-Viewer)
- Star the repository to show your support ⭐
- Could not find an issue? Look for bugs, typos, and missing features.

<a id="sponsors"></a>
## 🏅 Contributors and Sponsors

### Individual contributors
[![Individual contributors](https://opencollective.com/universalviewer/contributors.svg?width=890&button=false "Individual contributors")](https://github.com/UniversalViewer/universalviewer/graphs/contributors)

### Institutional contributors
[Become a sponsor](https://opencollective.com/universalviewer#sponsor) and join our [Steering Group](https://github.com/UniversalViewer/universalviewer/wiki/Steering-Group) to help guide how our sponsorship funds are allocated.

![Institutional contributors](https://raw.githubusercontent.com/UniversalViewer/assets/master/contributors.jpg "Institutional contributors")

## 📖 Accessibility Statement

Read our [Accessibility Statement](https://github.com/UniversalViewer/universalviewer/wiki/Accessibility-Statement-for-the-Universal-Viewer)

## 📖 License

The Universal Viewer is released under the [MIT license](https://github.com/UniversalViewer/universalviewer/blob/master/LICENSE.txt).
