https://github.com/Dragon-Born/avaland

Avaland, Persian Music Downloader
https://github.com/Dragon-Born/avaland

command-line console-application downloader music music-library persian

Last synced: 3 months ago
JSON representation

Avaland, Persian Music Downloader

• Host: GitHub
• URL: https://github.com/Dragon-Born/avaland
• Owner: Dragon-Born
• License: mit
• Created: 2020-05-12T20:58:43.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2022-12-08T09:51:49.000Z (almost 2 years ago)
• Last Synced: 2024-07-10T16:22:11.450Z (4 months ago)
• Topics: command-line, console-application, downloader, music, music-library, persian
• Language: Python
• Homepage:
• Size: 387 KB
• Stars: 27
• Watchers: 1
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
[![PyPI version](https://img.shields.io/pypi/v/avaland.svg)](https://pypi.org/project/avaland/) 

[![Build Status](https://api.travis-ci.com/Dragon-Born/avaland.svg?branch=master)](https://travis-ci.org/dragon-born/avaland)



     
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, MrTehran 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.

![screen shot](.docs/screen_shot.jpg)

## 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

```

```commandline

# 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)

```python

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 ()

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](LICENCE)