re·chan

re·chan is a desktop and mobile web application that provides an alternative interface for browsing your YouTube subscriptions and their latest videos. Sign in with your Google account to rediscover all your subscribed channels, organize them with custom tags, mark favorites, and filter or sort content to find what you want to watch.

This repository is hosted here but you can also configure, modify, and deploy it on your own server.

Prerequisites

• Node.js
• npm
• Python
• A Firebase and Google Cloud project with:
  • YouTube Data API v3 enabled
  • Google Sign-in provider
  • Realtime Database

Installation

1. Clone the repository:

   git clone https://github.com/tbrebant/rechan.git
   cd rechan

2. Install dependencies:

   npm install

3. Configure environment variables:

   Create a copy of .env.example named .env and add your credentials:

   Replace the placeholder values with your actual credentials and information:

   • YouTube API Key and Google OAuth Client ID: Get these from Google Cloud Console.
   • Firebase Configuration: Get these from Firebase Console.
   • E-mail address and website url for the privacy policy and terms of service pages.

Development

To run the application locally for development:

npm start

This will watch the files, rebuild on change, and serve the website on http://localhost:8081.

Release

npm run build

And deploy the content of dist/ folder wherever you want.

License

MIT License