Skip to content

Commit

Permalink
chore(docs): update README
Browse files Browse the repository at this point in the history
  • Loading branch information
Stéphane committed Oct 17, 2023
1 parent d4eb3ef commit 7fc1d16
Showing 1 changed file with 61 additions and 44 deletions.
105 changes: 61 additions & 44 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,121 +1,138 @@
<p align="center"><img src="./docs/logo.png" width="150" /></p>
<h2 align="center">HoloPlay</h2>
<h2 align="center" style="border: 0">HoloPlay</h2>
<p align="center">
<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
<a href="https://github.com/stephane-r/holoplay-pwa/tags"><img src="https://www.repostatus.org/badges/latest/active.svg" alt="Badges"></a>
<a href="https://github.com/stephane-r/holoplay-pwa/pulls"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs welcome"></a>
<a href="https://github.com/stephane-r/holoplay-pwa-"><img src="https://img.shields.io/github/stars/stephane-r/holoplay-pwa?label=%E2%AD%90%20Stars" alt="Stars"></a>
<a href="https://github.com/stephane-r/holoplay-pwa"><img src="https://img.shields.io/github/forks/stephane-r/holoplay-pwa?color=%23ff69b4" alt="Forks"></a>
<a href="https://github.com/stephane-r/holoplay-pwa/tags"><img src="https://img.shields.io/docker/pulls/spout8301/holoplay" alt="Docker pull"></a>
<a href="https://hub.docker.com/r/spout8301/holoplay/tags"><img src="https://img.shields.io/docker/pulls/spout8301/holoplay" alt="Docker pull"></a>
<img src="https://img.shields.io/github/contributors/stephane-r/holoplay-pwa" alt="GitHub contributors" />
<a href="https://github.com/stephane-r/holoplay-pwa/issues"><img src="https://img.shields.io/github/issues/stephane-r/holoplay-pwa" alt="GitHub issues" /></a>
<a href="https://github.com/stephane-r/holoplay-pwa/pulls"><img src="https://img.shields.io/github/issues-pr/stephane-r/holoplay-pwa" alt="GitHub pull request" /></a>
</p>

<hr>
<p></p>
<p></p>

## 🔍 Table of Contents

- [📌 Overview](#📌-overview)

- [🚀 Getting Started](#🚀-getting-started)

- [Setup](#setup)
- [Docker](#docker)

- [💻 Stack](#💻-stack)

- [📊 Plausible Analytics](#📊-plausible-analytics)

- [🔥 About Invidious](#🔥-about-invidious)

- [🙌 Contributors](#🙌-contributors)

- [📄 License](#📄-license)

## 📌 Overview

HoloPlay is a Youtube alternative app using [Invidious API](https://github.com/omarroth/invidious). You can save music to favoris or create your playlists. This project is fully open source.

If you want add more feature, PM, MR or PR are welcome :)

[<img src="docs/screenshots/dashboard.png" width=350>](./docs/screenshots/dashboard.png)
[<img src="docs/screenshots/search.png" width=350>](./docs/screenshots/search.png)
[<img src="docs/screenshots/search-light-mode.png" width=350>](./docs/screenshots/search-light-mode.png)
[<img src="docs/screenshots/playlists.png" width=350>](./docs/screenshots/playlists.png)
[<img src="docs/screenshots/dashboard.png" width=300>](./docs/screenshots/dashboard.png)
[<img src="docs/screenshots/search.png" width=300>](./docs/screenshots/search.png)
[<img src="docs/screenshots/search-light-mode.png" width=300>](./docs/screenshots/search-light-mode.png)
[<img src="docs/screenshots/playlists.png" width=300>](./docs/screenshots/playlists.png)

<br>

[<img src="docs/screenshots/mobile.png" width=250>](./docs/screenshots/mobile.png)
[<img src="docs/screenshots/playlists-mobile.png" width=250>](./docs/screenshots/playlists-mobile.png)
[<img src="docs/screenshots/favorite-mobile.png" width=250>](./docs/screenshots/favorite-mobile.png)
[<img src="docs/screenshots/mobile.png" width=200>](./docs/screenshots/mobile.png)
[<img src="docs/screenshots/playlists-mobile.png" width=200>](./docs/screenshots/playlists-mobile.png)
[<img src="docs/screenshots/favorite-mobile.png" width=200>](./docs/screenshots/favorite-mobile.png)

## Features
## Features

- **Search on Invidious or Youtube Music**
- **Search by video and playlist**
- **Search videos, playlists and channels**
- **Create your playlists**
- **Save favourites**
- **Downloading video**
- **Background mode (Android, PWA)**
- **Save videos, playlists and channels in favorites**
- **Download source**
- **Data Syncing between devices** (by using [Holoplay Serverless](https://github.com/stephane-r/holoplay-serverless))
- **Internationalization with 🏴󠁧󠁢󠁥󠁮󠁧󠁿 English, 🇫🇷 French, 🇯🇵 Japanese, 🇷🇺 Russian and 🇩🇪 German**
- **Audio and video mode (by using youtube-nocookie.com)**
- **Internationalization : 🏴󠁧󠁢󠁥󠁮󠁧󠁿 English, 🇫🇷 French, 🇯🇵 Japanese, 🇷🇺 Russian and 🇩🇪 German**
- **Respect your privacy**
- **Open Source**
- **Sponsor Block**
- **Responsive**
- **Dark Theme**
- **Background mode with PWA installation**

## Getting Started
## 🚀 Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

### Installing
### Setup

First, use **Node.js 18** or higher.

Copy `.env.dist` to `.env` and change `REACT_APP_API_URL` to your Holoplay Serverless URL :
Copy `.env.dist` to `.env` and change `REACT_APP_API_URL`:

```bash
REACT_APP_API_URL=http://localhost:3001 # Or https://holoplay-serverless.vercel.app for production domain
REACT_APP_API_URL=http://localhost:3001 # Or https://holoplay-serverless.vercel.app
```

Then, install dependencies:

```bash
npm install
npm i
```

And run project in development mode:
And start project in development mode:

```bash
npm start
```

## Docker
### Docker

If you prefer Docker, holoplay can be run in a container from official Docker hub :
If you prefer Docker, HoloPlay can be run in a container from official Docker hub:

```bash
docker run -d -p 3000:3000 spout8301/holoplay:latest
```

Or locally :
Or locally:

```bash
docker build -t holoplay .
docker run -d -p 3000:3000 holoplay
```

## Built With
## 💻 Stack

- [React](https://reactjs.org)
- [React-Router-Dom](https://reactrouter.com/web/guides/quick-start)
- [React-Query](https://react-query.tanstack.com/)
- [Mantine](https://mantine.dev)
- [TypeScript](https://www.typescriptlang.org/)

## Plausible Analytics
And others libraries, see [package.json](./package.json). Thank you to all contributors of these libraries 🔥 !

## 📊 Plausible Analytics

HoloPlay use [Plausible Analytics](https://plausible.io/), an transparent and fully open source [privacy-friendly analytics](https://plausible.io/privacy-focused-web-analytics) software.

Analytics page is public : [HoloPlay Plausible page](https://plausible.holoplay.io/holoplay.io)

## About Invidious
## 🔥 About Invidious

[Invidious](https://github.com/iv-org/invidious) is an alternative front-end to YouTube. HoloPlay use all [Invidious public instances](https://api.invidious.io/). All instances are retrieved each time HoloPlay is launched.

## Contributors
## 🙌 Contributors

<a href="https://github.com/stephane-r/holoplay-pwa/graphs/contributors">
<img src="https://contrib.rocks/image?repo=stephane-r/holoplay-pwa" />
</a>

## License
## 📄 License

This project is licensed under the MIT.

## TODO

- [ ] Play on other device from app (ex. desktop to mobile)
- [ ] Virtualize list for better performance
- [x] Use region on Invidious API ()
- [x] Video mode
- [x] i18n support
- [x] Default Invidious instance
- [x] Add custom Invidious instance
This README was partly generated with [easyreadme](https://easyreadme.vercel.app/builder).

0 comments on commit 7fc1d16

Please sign in to comment.