https://github.com/kalbhor/MusicTools

Python library to download, label and sort music files.
https://github.com/kalbhor/MusicTools

id3 music musicnow musicrepair musictools python

Last synced: about 2 months ago
JSON representation

Python library to download, label and sort music files.

• Host: GitHub
• URL: https://github.com/kalbhor/MusicTools
• Owner: kalbhor
• License: mit
• Created: 2017-01-29T03:41:37.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-01-23T22:21:07.000Z (over 1 year ago)
• Last Synced: 2024-07-26T04:45:39.309Z (about 2 months ago)
• Topics: id3, music, musicnow, musicrepair, musictools, python
• Language: Python
• Homepage:
• Size: 165 KB
• Stars: 89
• Watchers: 6
• Forks: 8
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![banner](http://i63.tinypic.com/2qc2dk2.jpg)]()

[![PyPI version](https://badge.fury.io/py/musictools.svg)](https://badge.fury.io/py/musictools)

[![Build Status](https://travis-ci.org/kalbhor/MusicTools.svg?branch=master)](https://travis-ci.org/kalbhor/MusicTools)

#### Library to download, sort and tag music files

## Social

[![GitHub stars](https://img.shields.io/github/stars/kalbhor/musictools.svg?style=social&label=Star)](https://github.com/kalbhor/musictools)

[![GitHub followers](https://img.shields.io/github/followers/kalbhor.svg?style=social&label=Follow)](https://github.com/kalbhor)  

[![Twitter Follow](https://img.shields.io/twitter/follow/lakshaykalbhor.svg?style=social)](https://twitter.com/lakshaykalbhor)

## Dependencies 

### Mac

```sh

$ brew install libav

```

### Ubuntu

```sh

$ sudo apt-get install libav-tools

```

### Windows

[Install libav](https://github.com/NixOS/nixpkgs/issues/5236)

## Installing

#### From Source:

```sh

$ git clone https://github.com/kalbhor/MusicTools

$ cd MusicTools

$ python setup.py install

```

#### From PyPI:

```sh

$ pip install musictools

```




## Methods

##### Provides a list of youtube videos of the song with urls and titles

```

musictools.get_song_urls(song_name)

```

##### Download song from youtube

```

musictools.download_song(song_url, song_title)

```

##### Provides artist name, song name, album name and album art for a particular song. Requires Client ID and Client Secret for Spotify API

```

musictools.get_metadata(file_name, client_id, client_secret)

```

##### Adds an image as the album art of a mp3 file

```

musictools.add_albumart(file_name, albumart)

```

##### Adds title, artist and album name in a mp3 file

```

musictools.add_metadata(file_name, title, artist, album)

```

##### Removes all metadata and album art from songs

```

musictools.revert_metadata(file_name)

```

##### Returns specified metadata field for a music file

```

musictools.get_current_metadata_tag(file_name, tag)

```

## Example

```sh

>>> from musictools import musictools

>>> songs_list = musictools.get_song_urls("Hey Jude")

>>> print(songs_list[0])

('https://www.youtube.com/watch?v=A_MjCqQoLLA', 'The Beatles - Hey Jude')

>>> url, title = songs_list[0]

>>> print(url)

https://www.youtube.com/watch?v=A_MjCqQoLLA

>>> print(title)

The Beatles - Hey Jude

>>> musictools.download_song(url, title, dl_directory='~/Desktop/Music/')

>>> musictools.get_metadata(title)

('The Beatles', '1 (Remastered)', 'Hey Jude - Remastered 2015', 'https://i.scdn.co/image/9ecfdf528562cae879748b73bd81b64dfa3d5704')

>>> artist, album , song_name, albumart = musictools.get_metadata(title, 'YOUR_CLIENT_ID', 'YOUR_CLIENT_SECRET')

>>> musictools.add_albumart(title, albumart)

>>> musictools.add_metadata(title, song_name, artist, album)

✨✨VOILA✨✨

```

[![image](image.png)]()

## Contributing

To contribute, [post issues](https://github.com/kalbhor/MusicTools/issues) without hesitation and [open pull requests](https://github.com/kalbhor/MusicTools/pulls) to add/improve features.

## License 

#### [MIT](https://github.com/kalbhor/MusicTools/blob/master/LICENSE)