jellyfin-web/README.md

83 lines
2.9 KiB
Markdown
Raw Normal View History

2019-09-24 07:43:15 -07:00
<h1 align="center">Jellyfin Web</h1>
2019-11-25 08:26:00 -07:00
<h3 align="center">Part of the <a href="https://jellyfin.org">Jellyfin Project</a></h3>
2019-09-24 07:43:15 -07:00
---
<p align="center">
2019-09-24 07:43:15 -07:00
<img alt="Logo Banner" src="https://raw.githubusercontent.com/jellyfin/jellyfin-ux/master/branding/SVG/banner-logo-solid.svg?sanitize=true"/>
2019-11-24 07:59:42 -07:00
<br/>
<br/>
<a href="https://github.com/jellyfin/jellyfin-web">
<img alt="GPL 2.0 License" src="https://img.shields.io/github/license/jellyfin/jellyfin-web.svg"/>
</a>
<a href="https://github.com/jellyfin/jellyfin-web/releases">
<img alt="Current Release" src="https://img.shields.io/github/release/jellyfin/jellyfin-web.svg"/>
</a>
<a href="https://translate.jellyfin.org/projects/jellyfin/jellyfin-web/?utm_source=widget">
<img src="https://translate.jellyfin.org/widgets/jellyfin/-/jellyfin-web/svg-badge.svg" alt="Translation Status"/>
</a>
2019-12-14 22:09:30 -07:00
<br/>
2019-11-24 07:59:42 -07:00
<a href="https://opencollective.com/jellyfin">
<img alt="Donate" src="https://img.shields.io/opencollective/all/jellyfin.svg?label=backers"/>
</a>
<a href="https://features.jellyfin.org">
<img alt="Feature Requests" src="https://img.shields.io/badge/fider-vote%20on%20features-success.svg"/>
</a>
<a href="https://forum.jellyfin.org">
<img alt="Discuss on our Forum" src="https://img.shields.io/discourse/https/forum.jellyfin.org/users.svg"/>
</a>
<a href="https://matrix.to/#/+jellyfin:matrix.org">
<img alt="Chat on Matrix" src="https://img.shields.io/matrix/jellyfin:matrix.org.svg?logo=matrix"/>
</a>
2019-11-25 08:26:00 -07:00
<a href="https://www.reddit.com/r/jellyfin">
2019-11-24 07:59:42 -07:00
<img alt="Join our Subreddit" src="https://img.shields.io/badge/reddit-r%2Fjellyfin-%23FF5700.svg"/>
</a>
</p>
2019-11-25 08:26:00 -07:00
Jellyfin Web is the frontend used for most of the clients available for end users, such as desktop browsers, Android, and iOS. We welcome all contributions and pull requests! If you have a larger feature in mind please open an issue so we can discuss the implementation before you start. Translations can be improved very easily from our <a href="https://translate.jellyfin.org/projects/jellyfin/jellyfin-web">Weblate</a> instance. Look through the following graphic to see if your native language could use some work!
2019-11-24 07:59:42 -07:00
<a href="https://translate.jellyfin.org/engage/jellyfin/?utm_source=widget">
<img src="https://translate.jellyfin.org/widgets/jellyfin/-/jellyfin-web/multi-auto.svg" alt="Detailed Translation Status"/>
</a>
## Build Process
### Dependencies
- [Node.js](https://nodejs.org/en/download/)
- [Yarn 1.22.4](https://classic.yarnpkg.com/en/docs/install)
- Gulp-cli
2019-11-24 07:59:42 -07:00
### Getting Started
2019-09-24 07:43:15 -07:00
2019-11-24 07:59:42 -07:00
1. Clone or download this repository.
2020-03-16 08:32:46 -07:00
2019-11-24 07:59:42 -07:00
```sh
git clone https://github.com/jellyfin/jellyfin-web.git
cd jellyfin-web
```
2020-03-16 08:32:46 -07:00
2019-12-14 22:09:30 -07:00
2. Install build dependencies in the project directory.
2020-03-16 08:32:46 -07:00
2019-11-24 07:59:42 -07:00
```sh
2019-11-30 10:52:46 -07:00
yarn install
2019-11-24 07:59:42 -07:00
```
2019-11-30 10:52:46 -07:00
2019-12-03 07:17:01 -07:00
3. Run the web client with webpack for local development.
2020-03-16 08:32:46 -07:00
2019-11-30 10:52:46 -07:00
```sh
2020-02-28 07:24:18 -07:00
yarn serve
2019-11-30 10:52:46 -07:00
```
4. Build the client with sourcemaps.
2020-03-16 08:32:46 -07:00
2020-03-16 08:37:21 -07:00
```sh
2020-03-16 09:27:14 -07:00
yarn build:development
2020-03-16 08:37:21 -07:00
```
2020-03-16 08:32:46 -07:00
You can build a nginx compatible version as well.
2020-03-16 08:37:21 -07:00
```sh
2020-03-16 09:27:14 -07:00
yarn build:standalone
```