An open API service indexing awesome lists of open source software.

https://github.com/oviirup/jiosaavn-downloader

An all in one extension for JioSaavn to enable dark mode, download songs, block ads, and more
https://github.com/oviirup/jiosaavn-downloader

chrome-extension dark-theme jiosaavn jiosaavn-downloader jiosaavn-web m4a songs

Last synced: 7 months ago
JSON representation

An all in one extension for JioSaavn to enable dark mode, download songs, block ads, and more

Awesome Lists containing this project

README

          

# JioSaavn Downloader

[![](https://img.shields.io/github/stars/oviirup/jiosaavn-downloader)](#)
[![](https://img.shields.io/github/v/release/oviirup/jiosaavn-downloader?include_prereleases&label=version)](#)
[![](https://img.shields.io/github/downloads/oviirup/jiosaavn-downloader/total)][release]

A simple and effective extension to download songs, albums, or playlists from 🎧 [jiosaavn.com](https://jioSaavn.com) with just one click. It also hides ads 🚫 and promotions from the JioSaavn website and slightly tweaks the UI. Last but not least, it implements a long-awaited **dark mode**.

> [!NOTE]
> 🚧 The project is currently a work in progress, many features are still in the works.
> 🐛 If you found an issue please report it [here](https://github.com/oviirup/jiosaavn-downloader/issues).

If you like the extension, give it a star the repo ⭐
[Follow me][profile] to stay updated on similar projects.

You can download the extension from the following [link][download], or visit the [changelog](./changelog.md).
If you’re having trouble installing it, you can refer to the installation guide below.

Table of Contents

- [How It Works](#how-it-works)
- [Features](#features)
- [How to Use](#how-to-use)
- [Prerequisites](#prerequisites)
- [Download and Install](#download-and-install)
- [Customization](#customization)
- [Acknowledgement](#acknowledgement)

![JioSaavn downloader preview](./assets/preview.png)

## How It Works

The extension fetches data from JioSaavn's API endpoints and organizes it in a user-friendly manner. This process occurs entirely within the browser and does not rely on external servers.

Once the data is fetched, it retrieves the URL for the song, album, or playlist in your preferred quality settings. The extension then sends an HTTP request to the server to fetch the M4A file. This step requires CORS to be enabled in your browser. In previous versions, this required an additional extension, but it is now integrated.

For playlists or albums, the extension fetches the individual songs and downloads them individually, placing them inside a ZIP file for easy download.

## Features

- [x] Dark Mode based on system theme.
- [ ] Download in various qualities: HD **320kbps**, Default **160kbps**.
- [x] Download **Songs**.
- [ ] Download Top Songs from Artists
- [x] Download **Albums** and **Playlists** as ZIP files.
- [ ] Download Podcasts
- [x] **Blocks Ads** and Promotions.
- [x] Modifies certain UI elements.

## How to Use

Due to limitations, this extension cannot be hosted on the Chrome Web Store. You can manually install the extension by following the steps below.

You can access _JioSaavn_ directly by **single-clicking** the extension icon, with no need to add extra bookmarks. **Double-click** the extension icon to open the extension options.

### Prerequisites

- [x] Developer Mode: Enable developer mode in your browser.
Go to and check the **Developer Mode** checkbox.

### Download and Install

1. Download the extension here: [download][download] and extract the contents.
You can also visit the [release page][release] to check for other versions.
2. Go to the Chrome Extensions page: .
3. Click the _Load Unpacked Extension..._ button.
4. Select the extracted folder and click _Open_.

**Note:** If you downloaded the source code, you can install it by running the following commands in your terminal (ensure that Node.js and npm are installed):

```shell
npm install
npm run build
```

This will build the extension in the build folder. You can then manually install the extension.

### Customization

The extension comes with an options page for customization. To access it, right-click the extension icon and select Extension Options. You can also open the options page by double-clicking the extension icon in the toolbar.

- **Quality Settings**: Choose the quality of songs to download.
  > Default: 320kbps
- **Name Format**: Customize the naming format of the downloaded songs.
  > Default: $title - $album_artist,  
  > Params: $title, $album_artist, $artists, $album, $year, $track, $genre, $bitrate

## Acknowledgement

These following projects were instrumental in the development of this extension:

- [sumitkolhe / jiosaavn-api](https://github.com/sumitkolhe/jiosaavn-api)
- [naqushab / saavn-downloader-extension](https://github.com/naqushab/saavn-downloader-extension)
- [tehhs / chrome-localhost-cors-unblocker](https://github.com/Tehhs/chrome-localhost-cors-unblocker)

[⇡ Back to top](#)

[release]: https://github.com/oviirup/jiosaavn-downloader/releases ' '
[download]: https://github.com/oviirup/jiosaavn-downloader/releases/latest 'Download'
[profile]: https://github.com/oviirup