saavn_play

A comprehensive Dart package for interacting with the JioSaavn API. This unofficial client provides easy access to search for songs, albums, playlists, artists, podcasts, radio stations, and more.

⚠️ IMPORTANT: EDUCATIONAL PURPOSE ONLY

This project is intended for educational and research purposes only.

This is an unofficial project and is NOT affiliated with, funded by, authorized, endorsed, or in any way associated with JioSaavn, Reliance Industries, Saavn Media Pvt Ltd, or any other company, organization, or individual.

The maintainers are NOT liable for any legal issues, misuse, damages, or consequences resulting from the use of this software.

Users are solely responsible for ensuring their use complies with all applicable laws, regulations, and terms of service.

This software is provided "AS IS" without warranty of any kind. See LICENSE for full disclaimer.

📚 Documentation

For complete documentation with interactive examples, API reference, and guides, visit our documentation website:

👉 https://krishna-9099.github.io/saavn_play

The documentation website includes:

🚀 Getting Started - Installation and quick start guide
📖 API Reference - Complete endpoint documentation
💡 Examples - Code examples for all features
📦 Models - Data model documentation

Installation

Add the following to your pubspec.yaml:

dependencies:
  saavn_play: ^1.0.0

Then run:

dart pub get

Quick Start

import 'package:saavn_play/saavn_play.dart';

void main() async {
  final client = SaavnPlayClient();

  // Search for songs
  final songs = await client.search.songs('Imagine Dragons');
  
  for (var song in songs.results) {
    print('${song.name} by ${song.primaryArtists}');
  }
}

Features

🔍 Search: Search for songs, albums, playlists, and artists
🎵 Songs: Fetch song details and download URLs by ID
💿 Albums: Retrieve album information and track listings
🎤 Artists: Get artist details, top songs, and albums
📋 Playlists: Access playlist details and songs
📜 Lyrics: Fetch song lyrics with copyright info
📻 Radio: Browse featured stations and get station songs
🎙️ Podcasts: Discover top podcast shows
🏠 Home: Get personalized home/launch data
⭐ Featured Playlists: Browse featured playlists with filters
🌐 Web API: Access footer details, browse menus, and show details

Repository

Source code and issue tracker live on GitHub:

github.com/krishna-9099/saavn_play

License

This project is licensed under the MIT License. See LICENSE for details.

Disclaimer

THIS PROJECT IS PROVIDED FOR EDUCATIONAL AND RESEARCH PURPOSES ONLY.

This project and its content are unofficial and are NOT affiliated with, funded by, authorized by, or endorsed by JioSaavn, Reliance Industries Limited, Saavn Media Pvt Ltd, or any of their subsidiaries, affiliates, or partners.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND. By using this software, you acknowledge that you are solely responsible for ensuring your use complies with all applicable laws, regulations, and terms of service.