Skip to main content

PyDatpiff Mixtape player

Project description

PyPI Build

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

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.

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

    • Only one parameter should be called at a time. If no parameter is pass, category will be set the "hot".__


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 and 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's create a Media object to play some songs !!

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

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 ]


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

Project details


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 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size pydatpiff-0.2.0-py3-none-any.whl (19.2 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size pydatpiff-0.2.0.tar.gz (19.5 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page