ankushcodes69 / audioscape

AudioScape is a gui/command-line tool that allows users to download a song in MP3 format, retrieve synced lyrics, and play the song along with the synchronized lyrics display. This project is implemented using Python.

AudioScape

AudioScape is a app that allows users to download a song, retrieve synced lyrics, and play the song along with the synchronized lyrics display. This project is implemented using Python.

⚙️ Features

• Download songs.
• Retrieve synced lyrics for the selected song.
• Play the song with synchronized lyrics display.

📜 Prerequisites

• Git installed on your machine.
• Python installed on your machine.

Important

Also Don't Forget To Add To Path All Of These Programs
(Usually There Is A Add To Path Check Box During Installation, Just Check It And If You Forgot To Do So Just Watch A Tutorial On YouTube On How To Add Any Of These Programs To PATH)

🛠️ Getting Started (New Installation)

1. Open Termial On Your Device And Clone the repository:

   git clone https://github.com/ankushcodes69/AudioScape.git

2. Navigate to the project directory:

   cd AudioScape

3. Setup Python Virtual Environment (Optional but recommended. You can skip this and go to next step):

   • Step 1:

     • On Linux / MacOS:

       python3 -m venv env

     • On Windows:

       python -m venv env

   • Step 2:

     • On Linux / MacOS:

       source env/bin/activate

     • On Windows:

       .\env\Scripts\activate

4. Install required packages for python:

   pip install -r requirements.txt

5. Run the main.py file using Python:

   python main.py

6. Follow the on-screen instructions to:

   • Enter the name of the song you want to download.
   • Enjoy the song with synced lyrics!

💡 Usage

1. Activate Python Virtual Environment (If You Have Setup Python Virtual Environment During First Installation)

   • On Linux / MacOS:

     source env/bin/activate

   • On Windows:

     .\env\Scripts\activate

2. Run the main.py file using Python:

   python main.py

To-Do List:

• Implement basic functionality.
• Download songs in webm format.
• Retrieve and display synced lyrics.
• Play the song with synchronized lyrics display.
• Give This Project/App An Actual Name.
• Switch To Complete Python Backend.
• Use Better Api For Lyrics (lrclib.net)
• Add Simple GUI Using Kivy.
• Make GUI Much Better And Colourful.
• Ability To Use YouTube Video Or Playlist Link.
• Ability To Download Songs And Stream Offline With Lyrics.
• Improve error handling.
• Enhance user interface.