o4x / rjdl

Download Music, Video, Album, Podcast & Playlists from www.RadioJavan.com

rjdl

• This package can be used in two different ways:
  • If you want to use it as a downloader only, then you can simply use its CLI.
  • But if you are a more advanced user and want to use this package in your projects, then you can import it in your project and you're good to go.
• With this package you will be able to save any Music, Video (Music Video & RJ-TV Show), Album, Podcast and Playlist from RadioJavan to your personal computer.
• Podcasts will be saved in 192 kbps quality only, while you can choose between 256 kbps and 320 kbps for Songs (Albums & Playlists as well), and 480p, 720p and 1080p for Videos if available.
• If you are currently living in Iran, you need to turn on your VPN while using this package.

Installation

• Use pip install rjdl to install the latest release of the package. (Of course to be able to use pip, you need python to be installed and added to computer's path first)
• If you want to install the latest version directly from GitHub, then you can use this:
  pip install git+git://github.com/reza00farjam/rjdl

Usage

Command Line

The rjdl as a command, is a well behaved Unix style command line tool that provides you the following optional arguments to use based on the content of your url. You can also list them by running rjdl -h or rjdl --help:

usage: rjdl [-h] [-p PATH] [-t TRACKS [TRACKS ...]]
            [-m {256,320} | -v {480p,720p,1080p}] [-d] [-r]
            url

Download Music, Video, Album, Podcast & Playlists from www.RadioJavan.com

positional arguments:
  url                   URL of desired media

optional arguments:
  -h, --help            show this help message and exit
  -p PATH, --path PATH  download path (default: current working directory)
  -t TRACKS [TRACKS ...], --tracks TRACKS [TRACKS ...]
                        track(s) of Album/Playlist to be downloaded, separated
                        by white space (default: all tracks)
  -m {256,320}, --music-quality {256,320}
                        download quality on Music, Album and Playlist URLs
                        (default: 320)
  -v {480p,720p,1080p}, --video-quality {480p,720p,1080p}
                        download quality on Video URLs (default: 720p)
  -d, --disable-download
                        disable auto downloading (show info only)
  -r, --rjdl-version    show rjdl version and exit

How it works

Simply, just pass rjdl a valid url along with your desired options for it and enjoy your download! Example.

Script

The rjdl as a package, provides enough class and methods to work with RadioJavan for your development purposes. For a good understanding of what it does and how it works, you can take a look at rjdl documentation.

Development Setup

To start developing rjdl, you need to install a recent version of python and pip and then run the following command (for linux):

git clone https://github.com/reza00farjam/rjdl
cd rjdl
python3 -m venv .venv
source .venv/bin/activate
pip install -e .[dev]

Code Style

Keeping to a consistent code style throughout the project makes it easier to contribute and collaborate.

We enforce the following check for all PRs:

tox -e flake8

Contributing

• Contributions of all sizes are welcomed and precious. You can follow the steps below for this purpose:
  • Fork the repository.
  • Make all the changes you want to see in the original repository.
  • Push your changes to a new branch in your fork and create a pull request along with an explanation of your changes.
• Also you can help us by reporting bugs and sharing your ideas.

Copyright & License

• Copyright (C) 2020-2021 Reza Farjam <https://github.com/reza00farjam>
• Licensed under the terms of the MIT License.