Skip to content

roblieblang/luthien

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Luthien

Table of Contents

Overview

Luthien is a playlist conversion application designed to facilitate cross-platform listening between Spotify and YouTube. Users can easily transfer their playlists from one platform to another, ensuring seamless music enjoyment across different services.

🌟 Features

  • Convert playlists from Spotify to YouTube, or vice versa
  • Integration with Spotify API and YouTube Data API
  • Redis Caching strategies for optimizing 3rd party API calls
  • Responsive design for various devices
  • Authentication integrated with Auth0

📸 Screenshots

Homepage Spotify Account Spotify Conversion Conversion Success

⚙️ Technologies Used

Backend

  • Go
  • Gin
  • Redis
  • Docker
  • Auth0
  • Google Cloud Platform (Cloud Run)
  • Upstash

Frontend

  • JavaScript
  • React
  • Vite
  • Tailwind
  • Auth0
  • Vercel

💻 Getting Started

Requirements

Installation

  1. Clone the repository: git clone https://github.com/roblieblang/luthien.git
  2. Navigate to the project directory: cd luthien

Backend

  1. Navigate to the backend directory: cd backend
  2. Start Redis and MongoDB with Docker: docker-compose up --build
  3. Start the server with live reloading: air

Frontend

  1. Navigate to the frontend directory: cd frontend
  2. Install dependencies: npm install
  3. Start the development server: npm run dev

Usage

  1. Open your browser and go to http://localhost:5173/
  2. # with your Spotify and YouTube accounts
  3. Follow the on-screen instructions to convert your playlists

Contribution

Contributions are welcome! Please follow these steps:

  1. Fork the repository
  2. Create a new branch: git checkout -b feature-name
  3. Make your changes and commit them: git commit -m 'Add new feature'
  4. Push to the branch: git push origin feature-name
  5. Open a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.