pydatpiff 0.1.8

PyDatpiff Mixtape player

Introduction

PyDatpiff is a python program that interact with online Datpiff Mixtapes. PyDatpiff allow users play and download songs from PyDatpiff 's Mixtapes.

• supports windows,mac,and linux
• python 3.0 - above

Dependencies

PyDatpiff requires:

• see requirements: requirements.txt
• python>= 3.4.5
• VLC- VideoLan Client media player and framework

---

Installation

pip install pydatpiff

Quick Start

• Mixtapes

  • Import PyDatpiff module and Intialize Mixtapes class

    • params: category and search:

      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.

---

import pydatpiff
mix = pydatpiff.Mixtapes(category='hot')
#OR
#search for an artist's mixtape
mix = pydatpiff.Mixtapes(search='Jay-Z')

---

Media

pydatpiff.Media - is a class that controls the PyDatpiff Media Player.

THINGS YOU CAN DO:

• play - plays songs from album
• download - download song
• downloadAlbum - download all songs from album

Now Initailize Media class

import pydatpiff

mix = pydatpiff.Mixtapes(search='Jay-Z')

# we pass in Mixtapes' instance to the Media class
media = pydatpiff.Media(mix)

# 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 Classics', '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 ]

---

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)

media.setMedia('Creative Control')
#OR
media.setMedia(1) # set media to 'Creative Control'

#TO VIEW ALL AVAILABLE SONGS
>>> media.songs

[ 'Jay-Z - Intro', 'Jay-Z - Advantage Carter (Prod. By Green Lantern)', 'Jay-Z - Welcome 2 Atlanta 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 Lantern)', 'Jay-Z - Jay-Z Speaks On Green Lantern', 'Jay-Z - Flashy Life', 'Jay-Z - Got Me On My Shit (Prod. By Green Lantern)',..etc ]

---

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(2)
#OR
>>> media.play('Welcome')

MEDIA PLAYER CONTROLS

Media player can be 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 or Album

Download Song

• params: song , output, and rename

  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

• Code
• PyPI
• Issues & Bugs