PyDatpiff Mixtape player
Project description
Introduction
PyDatpiff - Unofficial Datpiff python program that interact with online Datpiff Mixtapes. PyDatpiff allow users to play and download songs from thier favorite music artist.
- supports windows, mac, and linux
- python 3.3 - above
Dependencies
PyDatpiff requires:
- see requirements: requirements.txt
- python>= 3.3
- VLC- VideoLan Client media player and framework
Installation
Install VLC (if not already install)
pip install pydatpiff
Quick Start
Mixtapes
Import PyDatpiff module and Intialize Mixtapes class
There are two parameters that can be pass to Mixtapes Instance.
Only one parameter should be called at a time. If no parameter is pass, category will be set the "hot".
- params:
category
andsearch
:-
category :
- 'hot' , 'new', 'top',celebrated', 'popular', 'exclusive', 'most download', ' most listen', 'most favorite',' highest rating'
-
search:
- artist name or artist mixtape name.
-
Category | Description |
---|---|
"hot" | Mixtapes that are hot for the week. |
"new" | Mixtapes that are brand-new or just release. |
"top" | Mixtapes that are top-ranking. |
"celebrated" | Top ranking celebrity mixtapes. |
"popular" | Popular mixtapes available. |
"exclusive" | Exclusive mixtapes. |
"most download" | Most downloaded mixtapes. |
"most listen" | Most listen mixtapes. |
"most favorite" | Favorite mixtapes. |
"highest rating" | Mixtapes with the highest rating. |
Let's Get Started...
Create an Instance of the Mixtapes class
import pydatpiff
>>> mix = pydatpiff.Mixtapes(category='hot')
#OR
#Search for an artist's mixtape
>>> mix = pydatpiff.Mixtapes(search='Jay-Z')
# To view all available mixtapes
>>> mix.mixtapes
['Creative Control', 'Carter Collection (15th Anniversary)', 'Viva La Hova', 'The Best Of Jay-z : 25th Anniversary', 'Jay-z - If I Should Die Vol. 1 (the Best Of Jay-z)', 'Jay-Z: The Unheard C lassics', 'Jay-z Underground Mixes And Mashes Disk 2', 'Iceburgz Ent Dj Smokeshop Presents -big Tingz-pt.1 Classic Beefs Nas,jay-z And More', 'The Best Of Jay-z Old Vs New', 'The Best Of Jay-z & Biggie Smalls', 'Jay-z Live From Glastonbury ', 'Jay-z Underground Mixes And Mashes disk 1', 'Jay-z - Remixes',..etc ]
Media
Now Lets create a Media object to play some songs !!
pydatpiff.Media - is a class that controls the PyDatpiff Media Player.
THINGS YOU CAN DO:
findSong
- find any song made by an artistplay
- plays songs from albumdownload
- download songdownloadAlbum
- download all songs from album
Setup media player with an album
Setting media player with an album from above.
Albums
: ['Creative Control', 'Carter Collection (15th Anniversary)', ..etc]
Mixtape's ablum can be reference either by index
or by its album name
.
Index starts at one (1) not zero (0) .
#We pass in the 'mix' object from Mixtapes class
>>> media = pydatpiff.Media(mix)
#Set the media to an ablum.
>>> media.setMedia('Creative Control')
#Or
>>> media.setMedia(1) # set media by index. 1='Creative Control'
#TO VIEW ALL AVAILABLE SONGS
>>> media.songs
[ 'Jay-Z - Intro', 'Jay-Z - Advantage Carter (Prod. By Green Lantern)', 'Jay-Z - Welcome 2 Atla nta V103 Feat. Young Jeezy & DJ Greg Street', "Jay-Z - Jay's Back ASAP", 'Jay-Z - Live In London ', 'Jay-Z - Green Magic', 'Jay-Z - Brooklyn Sound Boy', 'Jay-Z - Child Abuse (Prod. By Green Lan tern)', 'Jay-Z - Jay-Z Speaks On Green Lantern', 'Jay-Z - Flashy Life', 'Jay-Z - Got Me On My Sh it (Prod. By Green Lantern)',..etc ]
Find A Song
. . . CANT FIND A SONG??
#Search for a song
>>> media.findSong('green lan') # returns mixtape's index and name
[(1, 'Creative Control'), (36, 'Headliner & Legends (Jay-Z Freestyles) '), (69, 'Power Us Up( Jay-z, Kanye West, Swizz Beatz)'), (172, 'J3 Rocnation '), (254, "Bakin' Session")]
Lets Play Some Songs !!
PLAYING SONG
Songs can be played either by referencing the song index or name.
Song's name do not have to be an exact match.
>>> media.play('Welcome')
#OR
>>> media.play(2)
CONTROLLING MEDIA PLAYER
Media player can rewind
, fast-forward
, pause
, stop
and control volume
.
# create an object of the player class
>>> player = media.player
# Rewind
>>> player.rewind()
>>> player.rewind(10) # rewind 10 sec ago
# Fast-Forward
>>> player.ffwd()
>>> player.ffwd(10) # fast-forward 10 sec ahead
# Pause
>>> player.pause
# Stop
>>> player.stop # stop song
# Volume
>>> player.volume(50) # set media volume to 50
>>> player.volumeDown(5) # set media volume down 5 steps
>>> player.volumeUp(5) # set media volume up 5 steps
DOWNLOAD SONG AND ALBUM
-
Download Song
-
params:
song
,output
, andrename
-
song : index or name of song.
-
output : directory to save song. *(default: current directory)
-
rename : rename song. (optional)
-
-
-
Download Album
-
params:
output
- output : directory to save song. (default: current directory)
-
#Download a single song
>>> media.download(1,output="directory_to_save_song")
#OR
>>> media.download('Welcome',output="directory_to_save_song")
#Download whole album
>>> media.downloadAlbum(output='directory_to_save_album')
LINKS
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pydatpiff-0.2.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 41c7f8a3309441cc65627836035b0b43f40ce6fafd3012e61e9fddaf2a178ab6 |
|
MD5 | 71e8c1450cb3effecc25841ed2738931 |
|
BLAKE2b-256 | 115559f6c365307b20c079cce63a97321eb22b84acc5b4fa67c55ceadc8d8551 |