Awesome
<p align="center"><img src="./docs/logo.png" width="150" /></p> <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-"><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://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> <p></p> <p></p>🔍 Table of Contents
📌 Overview
HoloPlay is a Youtube alternative app using Invidious API. 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=300> <img src="docs/screenshots/search.png" width=300> <img src="docs/screenshots/search-light-mode.png" width=300> <img src="docs/screenshots/playlists.png" width=300>
<br><img src="docs/screenshots/mobile.png" width=200> <img src="docs/screenshots/playlists-mobile.png" width=200> <img src="docs/screenshots/favorite-mobile.png" width=200>
✨ Features
- Search on Invidious or Youtube Music
- Search videos, playlists and channels
- Create your playlists
- Save videos, playlists and channels in favorites
- Download source
- Data Syncing between devices (by using Holoplay Serverless)
- Internationalization : 🏴 English, 🇫🇷 French, 🇯🇵 Japanese, 🇷🇺 Russian and 🇩🇪 German
- Respect your privacy
- Sponsor Block
- Responsive
- Dark Theme
- Background mode with PWA installation
🚀 Getting Started
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
Setup
First, use Node.js 18 or higher.
Copy .env.dist
to .env
and change REACT_APP_API_URL
:
REACT_APP_API_URL=http://localhost:3001 # Or https://holoplay-serverless.vercel.app
Then, install dependencies:
npm i
And start project in development mode:
npm start
Docker
If you prefer Docker, HoloPlay can be run in a container from official Docker hub:
docker run -d -p 3000:3000 spout8301/holoplay:latest
Or locally:
docker build -t holoplay .
docker run -d -p 3000:3000 holoplay
💻 Stack
And others libraries, see package.json. Thank you to all contributors of these libraries 🔥 !
📊 Plausible Analytics
HoloPlay use Plausible Analytics, an transparent and fully open source privacy-friendly analytics software.
Analytics page is public : HoloPlay Plausible page
🔥 About Invidious
Invidious is an alternative front-end to YouTube. HoloPlay use all Invidious public instances. All instances are retrieved each time HoloPlay is launched.
🙌 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
This project is licensed under the MIT.
This README was partly generated with easyreadme.