Skip to content

Web app using Invidious API for listening Youtube audio source.

Notifications You must be signed in to change notification settings

stephane-r/holoplay-pwa

Folders and files

NameName
Last commit message
Last commit date

Latest commit

38020e8 ยท Jul 22, 2024
Jul 22, 2024
Oct 12, 2023
Oct 31, 2023
Oct 11, 2023
Nov 2, 2023
Jul 22, 2024
Nov 2, 2023
Aug 29, 2023
Jul 22, 2024
Oct 11, 2023
Nov 2, 2023
Dec 8, 2023
Dec 8, 2023
Dec 8, 2023
Oct 24, 2023
Jun 6, 2023
Oct 13, 2023
Jul 22, 2024
Oct 11, 2023
Oct 31, 2023
Oct 12, 2023
Feb 20, 2024
Jul 22, 2024
Jul 22, 2024
Dec 8, 2023
Oct 19, 2023
Oct 24, 2023
Jul 13, 2023

Repository files navigation

HoloPlay

License: MIT Stars Forks Docker pull GitHub contributors GitHub issues GitHub pull request

๐Ÿ” 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 :)


โœจ 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

๐Ÿ“„ License

This project is licensed under the MIT.

This README was partly generated with easyreadme.