https://github.com/keivan-sf/rjdl

Radio Javan downloader and info scraper for Node.js
https://github.com/keivan-sf/rjdl

downloader nodejs radiojavan radiojavan-downloader scraper

Last synced: 16 days ago
JSON representation

Radio Javan downloader and info scraper for Node.js

• Host: GitHub
• URL: https://github.com/keivan-sf/rjdl
• Owner: Keivan-sf
• Created: 2021-08-09T00:32:34.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2023-08-20T14:12:58.000Z (about 1 year ago)
• Last Synced: 2024-04-24T14:58:02.765Z (7 months ago)
• Topics: downloader, nodejs, radiojavan, radiojavan-downloader, scraper
• Language: HTML
• Homepage: https://keivan-sf.github.io/rjdl
• Size: 937 KB
• Stars: 19
• Watchers: 2
• Forks: 1
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
![node rjdl](https://raw.githubusercontent.com/Keivan-sf/rjdl/gh-pages/images/page.jpg)

>⚠️ This library currently does not work due to Rj latest changes

# Node rjdl

Radio javan scraper / downloader

**Docs [keivan-sf.github.io/rjdl](https://keivan-sf.github.io/rjdl)**

## Install

```bash

npm i node-rjdl

```

## Usage

Here's a quick guide to start

```ts

import * as Rj from "node-rjdl";

const song = await Rj.getMusic("https://rj.app/m/2qKkkB8q");

// {title: ... , artist: ... , ...}

const downloadLinks = await song.getDownloadLinks();

// {midQuality: ... , highQuality: ...}

```

You can use `download()` as well, for example

```ts

const readable = await song.download("hq");

readable.pipe(fs.createWriteStream("song-name.mp3"));

```

### Getting link type

Supported for `Playlists` , `Albums` , `Podcasts` , `Videos` , `Musics` , `TV`

```ts

const rjType = Rj.getLinkType(

    "https://play.radiojavan.com/song/Donya-Bye-Bye-Bye"

);

console.log(rjType === Rj.LinkType.Music); // true

```

### Getting input info

Supported for `Playlists` , `Albums` , `Podcasts` , `Musics` , `Videos`

```ts

const songInfo = await Rj.getMusic(

    "https://play.radiojavan.com/song/Donya-Bye-Bye-Bye"

);

// {title: "Bye Bye Bye" , artist: "Donya" , getDownloadLinks() , ...}

```

### Getting download links

Download links will be provided in **mid** and **high** qualities. It's common to use these functions when you only need the download links alone. Otherwise, `getMusic` and other info getters suite you best with both info and download links in an optimized way.

Supported for `Musics` , `Podcasts` , `Videos`

```ts

const links = await Rj.getMusicDownloadLinksViaURL(

    "https://play.radiojavan.com/song/Donya-Bye-Bye-Bye"

);

console.log(links.midQuality);

// https://host2.rj-mw1.com/media/mp3/mp3-256/Donya-Bye-Bye-Bye.mp3

console.log(links.highQuality);

// https://host2.rj-mw1.com/media/mp3/mp3-320/Donya-Bye-Bye-Bye.mp3

```

You can also use `downloadMusicViaURL` and similar functions if you prefer to get `Readable` object

```ts

const readable = await Rj.downloadMusicViaURL(

    "https://www.play.radiojavan.com/song/Koorosh-Un-Momento-(Ft-Raha)"

);

readable.pipe(fs.createWriteStream("Koorosh-Un-Momento.mp3"));

```

### Validating URL

Only the URLs which their link type is recognizable will be considered valid

```ts

Rj.validateURL("https://play.radiojavan.com/song/Donya-Bye-Bye-Bye"); // true

Rj.validateURL("https://rj.app/ma/D18eAKwY"); // true

Rj.validateURL("https://google.com"); // false

Rj.validateURL("https://radiojavan.com"); // false

```

## Scripts

### Building

To get started install the packages

```bash

npm install

```

Then you'll be able to use the build script

```

npm run build

```

### Testing

For all tests

```

npm test

```

For unit and integration tests only

```bash

npm run unitTest

```

For end to end tests only (ending with `.test.e2e.ts`)

```

npm run e2eTest

```