From 367eea523a4c8f292327c28a518b3be03419bff6 Mon Sep 17 00:00:00 2001 From: Sama Ahmed <26samahmed@csu.fullerton.edu> Date: Tue, 10 Dec 2024 21:14:36 -0800 Subject: [PATCH 1/3] Update README.md --- README.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index b0d910d..97bba99 100644 --- a/README.md +++ b/README.md @@ -32,8 +32,14 @@ The app is designed to make the playlist conversion process as straightforward a --- ## 🖼️ Screenshots +Screenshot 2024-12-10 at 7 51 38 PM +Screenshot 2024-12-10 at 7 52 18 PM +Screenshot 2024-12-10 at 7 52 38 PM +Screenshot 2024-12-10 at 7 53 01 PM +Screenshot 2024-12-10 at 7 53 55 PM +Screenshot 2024-12-10 at 7 54 37 PM + -*(TBD)* --- From 1d1ca0663f2e6a43d514d516eb7ae7c8869f0104 Mon Sep 17 00:00:00 2001 From: Sama Ahmed <26samahmed@csu.fullerton.edu> Date: Tue, 10 Dec 2024 21:38:44 -0800 Subject: [PATCH 2/3] Update README.md --- README.md | 87 ++++++++++++++++++++++++++++++++++++++++++++----------- 1 file changed, 70 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index 97bba99..0ebe4ea 100644 --- a/README.md +++ b/README.md @@ -29,6 +29,76 @@ The app is designed to make the playlist conversion process as straightforward a 4. **Limitations** To ensure smooth operation and compliance with API constraints, there is a cap on the number of songs that can be converted in a single session. This ensures that the app remains efficient even for larger playlists. +--- + +## How to Run the Project + +1. **Set Up Environment Variables** + - Obtain Spotify Developer credentials (Client ID and Client Secret) from the [Spotify Developer Portal](https://developer.spotify.com/dashboard/). + - Generate a Google API Key from the [Google Cloud Console](https://console.cloud.google.com/). + - Create a `.env` file in the root directory using the format in `env.example`: + ```env + clientID="🩷" + clientSecret="💜" + GOOGLE_API_KEY="💛" + + SPOTIFY_CLIENT_ID="💚" + SPOTIFY_CLIENT_SECRET="🧡" + ``` + +2. **Install Dependencies** + - Ensure Python v3 is installed on your system. + - Open a terminal, navigate to the `backend/api` folder by running: + ```bash + cd backend/api + ``` + - Install the required Python dependencies by running: + ```bash + pip install -r requirements.txt + ``` + +3. **Run the Application** + Open **two terminals**: + + - **Terminal 1:** + - From the root directory of the project, navigate to the `backend/api` folder: + ```bash + cd backend/api + ``` + - Start the Flask server: + - On Mac: + ```bash + python3 flask-server.py + ``` + - On Windows: + ```bash + python flask-server.py + ``` + + - **Terminal 2:** + - From the root directory of the project, navigate to the `frontend` folder: + ```bash + cd frontend + ``` + - Install the required Node.js dependencies by running: + ```bash + npm install + ``` + - Start the Svelte development server: + ```bash + npm run dev + ``` + +4. **Use the Application** + - Open a browser and navigate to the provided URL (usually `http://localhost:3000`). + - Click **Login to Spotify** to authenticate. + - Select a playlist and click **Submit Playlist**. + - Click **Login to YouTube**, and you'll be redirected to a success page. + - Check your YouTube account for the exported playlist. + +**Note:** Both terminals must remain running simultaneously for the application to work. + + --- ## 🖼️ Screenshots @@ -39,23 +109,6 @@ The app is designed to make the playlist conversion process as straightforward a Screenshot 2024-12-10 at 7 53 55 PM Screenshot 2024-12-10 at 7 54 37 PM - - ---- - -## How to Run the Project - -*(TBD)* - ---- - -## Key Features - -- **Easy Playlist Transfer:** Move your music effortlessly between Spotify and YouTube with minimal input. -- **Accurate Song Matching:** Leverages song titles and artist names to find the closest matches on YouTube. -- **Dynamic Playlist Creation:** Automatically generates and saves a YouTube playlist with the selected songs. -- **Responsive Design:** Enjoy a user-friendly interface on both desktop and mobile devices. - --- Developed by [Sama Ahmed](https://github.com/26samaahmed), [Boushra Bettir](https://github.com/boushrabettir), [James Owen Sterling](https://github.com/JOwen-ster), [Patrick Smith](https://github.com/thisguyblink) ✨ From d8be020b116c16d288304ac910b232ea3debadce Mon Sep 17 00:00:00 2001 From: Sama Ahmed <26samahmed@csu.fullerton.edu> Date: Tue, 10 Dec 2024 21:46:57 -0800 Subject: [PATCH 3/3] Update README.md --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 0ebe4ea..0ca8a2a 100644 --- a/README.md +++ b/README.md @@ -35,7 +35,8 @@ The app is designed to make the playlist conversion process as straightforward a 1. **Set Up Environment Variables** - Obtain Spotify Developer credentials (Client ID and Client Secret) from the [Spotify Developer Portal](https://developer.spotify.com/dashboard/). - - Generate a Google API Key from the [Google Cloud Console](https://console.cloud.google.com/). + - Generate a Google API Key from the [Google Cloud Console](https://console.cloud.google.com/). + - Obtain YouTube credentials (Client ID and Client Secret) from the [Google Cloud Console](https://console.cloud.google.com/). - Create a `.env` file in the root directory using the format in `env.example`: ```env clientID="🩷"