Skip to content

Latest commit

 

History

History
137 lines (104 loc) · 3.67 KB

README.md

File metadata and controls

137 lines (104 loc) · 3.67 KB

THE ULTIMATE SONGS DOWNLOAD SERVER PYTHON

A Flask-based server application that allows users to download songs with embedded metadata and album art. All input fields are mandatory to ensure proper metadata embedding and album cover functionality.

Features

  • Download audio files (.m4a) with metadata and album art.
  • Metadata support: Title, Artist, Album, Year, and Cover Art.
  • Supports WEBP album covers (auto-conversion to JPEG).
  • Error handling for invalid or missing fields.
  • Lightweight and fast, designed for seamless user experience.
  • Temporary files are automatically cleaned up after download.

Technologies Used

  • Flask: Web server framework.
  • Flask-CORS: Enable Cross-Origin Resource Sharing (CORS).
  • Requests: Handle HTTP requests for downloading audio and image files.
  • Mutagen: Add metadata to audio files.
  • Pillow: Validate and process image files.
  • Python: Backend logic implementation.

API Endpoint

GET /generate-audio

Query Parameters (All Required):

Parameter Type Description
audioUrl String URL of the audio file to download.
imageUrl String URL of the album cover image.
songName String Name of the song.
artist String Artist of the song.
album String Album name of the song.
year String Release year of the song.

Response:

  • Success: Returns the .m4a audio file with embedded metadata.
  • Failure: Returns a JSON error message with appropriate HTTP status codes.

Example Request:

curl -X GET "http://127.0.0.1:5000/generate-audio?audioUrl=https://example.com/audio.m4a&imageUrl=https://example.com/image.webp&songName=Farzi&artist=Sachin-Jigar&album=Farzi&year=2023"

Installation

Clone the Repository:

git clone https://github.com/patelharsh80874/THE-ULTIMATE-SONGS-DOWNLOAD-SERVER-PYTHON
cd your-repo-name

Create a Virtual Environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Install Dependencies:

pip install -r requirements.txt

Run the Server:

python app.py

Access the API:

The server runs on http://127.0.0.1:5000 by default.

File Structure

.
├── app.py                # Main Flask application
├── requirements.txt      # Project dependencies
├── README.md             # Project documentation
└── /tmp                  # Temporary directory for downloaded files

Error Handling

  1. Missing or Invalid Parameters:

    • Returns: {"error": "All fields are required"} with HTTP 400.

  2. Invalid Audio URL:

    • Returns: {"error": "Invalid or inaccessible audio URL"} with HTTP 400.

  3. Invalid Image URL:

    • Returns: {"error": "Invalid or inaccessible image URL"} with HTTP 400.

  4. Server Error:

    • Returns: {"error": "Unexpected error occurred"} with HTTP 500.

Requirements

Below is the content of requirements.txt:

blinker==1.9.0
certifi==2024.8.30
charset-normalizer==3.4.0
click==8.1.7
colorama==0.4.6
Flask==3.1.0
idna==3.10
itsdangerous==2.2.0
Jinja2==3.1.4
MarkupSafe==3.0.2
mutagen==1.47.0
requests==2.32.3
urllib3==2.2.3
Werkzeug==3.1.3
flask_cors==3.0.10
Pillow==11.0.0

To install all dependencies:

pip install -r requirements.txt