Skip to main content

Unofficial Datpiff Mixtape player - Download and play the newest Hip-Hop and RnB Songs.

Project description

PyPI Build

Introduction

PyDatpiff - 🎶 Unofficial Datpiff Music Application. Play and download the latest Hip-Hop and RnB songs.

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

Dependencies

PyDatpiff requires:

Installation

The default media player uses VLC to play music. For systems that are incompatible with VLC, MPV will be used as the fallback player.

              click link to download

VLC - VideoLan Client media player and framework.

MPV - MPV Framework. ( Supports IOS, Android and Linux Systems )

For linux based systems,   use apt-get to install required repos

VLC

sudo apt-get install vlc 

MPV

sudo apt-get install mpv 

Install Pydatpiff Module

pip3 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 to "hot" by default.

  • 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.
    • limit:

      • maximum amount of mixtapes to return. default=600

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.

HERE ARE SOMETHINGS YOU CAN DO:

  • findSong - Find any song made by an artist.
  • play - Plays songs from current album.
  • download - Download current song.
  • downloadAlbum - Download all songs from an 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 player 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 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
 ]                         

     

PLAY A 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(3)

Play Song - ♬♬♬

Artist: Jay-Z

Song: Jay-Z - Welcome 2 Atlanta V103 Feat. Young Jeezy & DJ Greg Street

Size: 1.91 MB


     

Find A Song

. . . CANT FIND A SONG ??

   #Search for a song
   >>> media.findSong('green lan') # returns mixtape's index and name

   #results
   [(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")
   ]

CONTROLLING MEDIA PLAYER

Media player can rewind , fast-forward , pause , stop and control volume of song.

 # 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 SONGS AND ALBUMS

Download Song

  • media.download
    • 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

  • media.downloadAlbum
    • params: output

      • output : directory to save song. (default: current directory)
#Download a single song
>>> media.download(3,output="directory_to_save_song")
#OR
>>> media.download('Welcome',output="directory_to_save_song")


#Download full album
>>> media.downloadAlbum(output='directory_to_save_album')

LINKS

Download files

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

Files for pydatpiff, version 1.2.2
Filename, size File type Python version Upload date Hashes
Filename, size pydatpiff-1.2.2-py3-none-any.whl (46.4 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pydatpiff-1.2.2.tar.gz (39.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page