Skip to main content

Avaland is a music downloader to download music from many sources.

Project description

Avaland Music Downloader

Avaland Music Downloader

Avaland is a command-line program to download musics directly from most popular Iranian music websites, written in Python. It supports RadioJavan, Bia2Music, Nex1Music, Navahang, WikiSeda and RapFarsi.

It requires the Python interpreter, version 3.5+, and it is not platform specific. It should work on your Unix box, on Windows or on macOS.

Installation and Notes

To install it open your terminal and type:

pip3 install avaland

Usages And Examples

The usages can be found with the -h or --help flag:

Usage: [-h] [--path PATH] [--sources SOURCES] [--dl-first]
               [--dl-album] [--dl-artist]
               query
positional arguments:
  query                 Search query

optional arguments:
  -h, --help            show help message and exit
  --path PATH, -p PATH  path to download music/album
  --sources SOURCES, -s SOURCES
                        list of sources (default: --sources all) Available
                        sources: Bia2, Navahang, Nex1, RadioJavan, RapFarsi,
                        WikiSeda
  --dl-first, -df       download first music in list
  --dl-album, -da       download all musics in an album
  --dl-artist, -dr      download all musics of an artist
# Search tracks
avaland "your search query"

# Search and download first result
avaland "your search query" --dl-first

# Search with custom sources
avaland "your search query" --sources radiojavan,bia2,rapfarsi

# Set custom download path directory
avaland "your search query" --path /foo/bar

Getting Started (For Developers)

from avaland.manager import SourceManager
from avaland.sources import *

manager = SourceManager()

#  register two sources
manager.register(Bia2)
manager.register(RapFarsi)

if __name__ == '__main__':
    #  search for a query
    search = manager.search("hello adele")
    print(search)
    #  download first result from bia2
    download = search['bia2'].musics[0].download()
    print(download)

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork it (https://github.com/dragon-born/avaland)
  2. Create your Feature Branch (git checkout -b feature/newfeature)
  3. Commit your changes (git commit -am 'Add some amazing new feature')
  4. Push to the branch (git push origin feature/newfeature)
  5. Open a new Pull Request

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

avaland-0.0.1.tar.gz (13.0 kB view details)

Uploaded Source

File details

Details for the file avaland-0.0.1.tar.gz.

File metadata

  • Download URL: avaland-0.0.1.tar.gz
  • Upload date:
  • Size: 13.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.2.0 requests-toolbelt/0.8.0 tqdm/4.31.1 CPython/3.8.0

File hashes

Hashes for avaland-0.0.1.tar.gz
Algorithm Hash digest
SHA256 56b396ad0ae6643ab9739c5bedcb57cfd4db0c5618d07b840209c2c9a19aa388
MD5 ba769ca06ac8f659cf9b59aecf36e1d2
BLAKE2b-256 b6efde482774cabbaa590ddc98f43c26d739356e778aa807b8964f3022c8dd49

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page