Radioplayer metadatas's Now Playng API with Deployment Boilerplate on Digital Ocean 🚀

Easily extract artist and song metadata from MP3 audio streams with this lightweight FastAPI-based application. Simply provide the audio stream URL and receive the information in a convenient JSON format.

The accompanying repository offers a minimalist boilerplate, simplifying the process of deploying your application to Digital Ocean.

Features

• Retrieval of the title from the metadata of an audio stream: Extracts the complete title information embedded within the audio stream.
• Extraction of the artist and song name from the stream title: Intelligently parses the extracted title to identify and separate the artist and song name.
• Album Art Retrieval: Fetches and displays the album artwork associated with the audio stream.
• Stream History Monitoring: Creates a historical log of processed stream links, enabling tracking and analysis of usage patterns.
• Minimal FastAPI Setup: Provides a streamlined and efficient FastAPI implementation for easy API development and deployment.
• Ready-to-deploy on Digital Ocean: Includes a basic configuration and boilerplate code for seamless deployment on Digital Ocean servers.
• Basic configurations for a quick start: Offers essential settings and parameters to get your application up and running quickly.

Requirements

Before running the application, make sure you have the following installed:

• Python 3.x
• FastAPI
• Uvicorn

Quick Start

1. Click the "Deploy to DO" button at the top.
2. Follow the instructions on Digital Ocean to deploy your app.
3. Enjoy your FastAPI app running in the cloud!

Don't have an account? Get a $200 bonus to test it out!

---

Stream Title Fetcher

To retrieve the stream title and cover image, simply replace the URL parameter in the API link provided below:

API Endpoint: https://twj.es/get_stream_title/?url=

Example Usage: Replace https://stream.zeno.fm/yn65fsaurfhvv with your desired stream URL:

https://twj.es/get_stream_title/?url=https://stream.zeno.fm/yn65fsaurfhvv

This will return a link to the stream’s cover image along with the title.

---

Contribution

Contributions are welcome! Feel free to open an issue or submit a pull request for suggestions, bug fixes, or new features.

Happy coding! 🎉