{"id":15023764,"url":"https://github.com/cbedroid/pydatpiff","last_synced_at":"2025-04-12T06:31:14.768Z","repository":{"id":36473608,"uuid":"213083414","full_name":"cbedroid/pydatpiff","owner":"cbedroid","description":"🎶 Unofficial Datpiff  Music Application. Play and download the latest Hip-Hop and RnB songs.","archived":false,"fork":false,"pushed_at":"2023-05-23T02:53:19.000Z","size":2954,"stargazers_count":12,"open_issues_count":4,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-26T01:51:11.738Z","etag":null,"topics":["api","apple","audio","datpiff","deezer","hip-hop","linux","mac","mixer","mixtape","mp3","music","music-player","pandora","radio","slacker","songs","soundcloud","spotify","web"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cbedroid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-10-05T23:13:21.000Z","updated_at":"2023-04-14T05:30:56.000Z","dependencies_parsed_at":"2024-09-24T21:31:40.560Z","dependency_job_id":null,"html_url":"https://github.com/cbedroid/pydatpiff","commit_stats":{"total_commits":197,"total_committers":6,"mean_commits":"32.833333333333336","dds":"0.31472081218274117","last_synced_commit":"6613b71e4b3ab8ffae15539eea0f51e0fd5343ac"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cbedroid%2Fpydatpiff","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cbedroid%2Fpydatpiff/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cbedroid%2Fpydatpiff/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cbedroid%2Fpydatpiff/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cbedroid","download_url":"https://codeload.github.com/cbedroid/pydatpiff/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248529439,"owners_count":21119509,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","apple","audio","datpiff","deezer","hip-hop","linux","mac","mixer","mixtape","mp3","music","music-player","pandora","radio","slacker","songs","soundcloud","spotify","web"],"created_at":"2024-09-24T19:59:25.095Z","updated_at":"2025-04-12T06:31:09.697Z","avatar_url":"https://github.com/cbedroid.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":" [![PyPI](https://img.shields.io/pypi/v/pydatpiff.svg?color=blue)](https://pypi.python.org/pypi/pydatpiff)  ![Build](https://api.travis-ci.org/cbedroid/pydatpiff.svg?branch=master)\n\n\u003cimg src=\"https://user-images.githubusercontent.com/54720725/96840060-f872ab80-1417-11eb-93ac-c964217b98b1.png\" width=\"100%\" height=\"300\"\u003e\n\n# Pydatpiff\n\n**PyDatpiff**   -   🎶 Unofficial [Datpiff](https://www.datpiff.com) Music Application. Play and download the latest Hip-Hop and RnB songs.\n  - supports windows, mac, and linux\n  - python 3.7 - above\n\n[**Documentation**](https://cbedroid.github.io/pydatpiff/) is still undergoing, but you can still visit it here.\n\n**Full documentation** will be available soon!\n\n## Dependencies\n\n**PyDatpiff requires:**\n - see requirements:  [requirements.txt](https://github.com/cbedroid/pydatpiff/blob/master/requirements.txt)\n- *python \u003e= 3.7*\n\n## Installation\n\n The default media player uses VLC to play music.\n For systems that are incompatible with VLC,  MPV will be used as the fallback player.\n\n\n[**VLC**](https://www.videolan.org/vlc/index.html) - VideoLan Client media player and framework.\n\n[**MPV**](https://mpv.io/installation/) -  MPV Framework. ( Supports IOS, Android and Linux Systems )\n--- ---\nFor linux based systems,  \u0026nbsp; use `apt-get` to  install required repos\n\n#### VLC\n```bash\nsudo apt-get install vlc\n```\n#### MPV\n```bash\nsudo apt-get install mpv\n```\n\n#### Install Pydatpiff Module\n```bash\npip3 install pydatpiff\n```\n--- ---\n\n\n\n\n#### Pydatpiff Category \u0026 Description\n\nCategory reference a mixtapes level or ratings. Visit [**Datapiff**](https://datpiff.com) for more info.\n\n---\n | Category                           |      Description                           |\n|-------------------------------------|--------------------------------------------|\n|[__hot__][hot]                       | Mixtape that are hot for the week.\n|[__new__][new]                       | Mixtape that are brand-new or just release.\n|[__top__][top]                       | Mixtape that are top-ranking.\n|[__celebrated__][celebrated]         | Top ranking celebrity mixtapes.\n|[__popular__][popular]               | Popular mixtapes  available.\n|[__exclusive__][exclusive]           | Exclusive mixtapes.\n|[__most download__][most-download]   | Most downloaded mixtapes.\n|[__most listen__][most-listen]       | Most listen mixtapes.\n|[__most favorite__][most-favorite]   | Favorite mixtapes.\n|[__highest rating__][highest-rating] | Mixtape with the highest rating.\n\n--- ---\n\n\n## Mixtape\n\n**pydatpiff.Mixtape** - PyDatpiff Mixtape class is query for the latest music by either referencing a `category` or by searching for a particular `artist` or `mixtape`.\n\n __Import PyDatpiff module and Intialize Mixtape class__\n\nMixtape can accept up to three arguments:  __category__ , __search__ and __limit__.\n\nEither argument __category__ or __search__ should be used at a given time. If no arguments are pass,  **\"category\"** will be set to   __\"hot\"__ by default.\n\n- **params:**  __category__ ,  __search__, __limit__:\n\t - __*category*__ :\n\n        - *'hot' , 'new', 'top',celebrated', 'popular', 'exclusive', 'most download', ' most listen', 'most favorite',' highest rating'*\n\n     - __*search*__:\n\n        - artist name or artist mixtape name.\n\n    - __*limit*__:\n\n        - maximum amount of mixtapes to return. default=600\n\n\n\n*Create an Instance of the Mixtape class*\n```python\nfrom pydatpiff.mixtapes import Mixtape\n\nmix = Mixtape(category='hot')\n# -- OR --\n# Search for an artist's mixtape\nmix = Mixtape(search='Jay-Z')\n\n# To view all available mixtapes\nmix.mixtapes\n\n```\n['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                                                                                                 \u0026 Biggie Smalls', 'Jay-z Live From Glastonbury ', 'Jay-z Underground Mixes And Mashes disk 1', 'Jay-z - Remixes',..etc ]\n\n--- \n\n\n![pydatpiff_mixtapes](https://user-images.githubusercontent.com/54720725/188326131-f2a7f648-0c23-48bd-b7c5-1c950e09ed97.gif)\n\n--- \n\n\n## Media\n\n**pydatpiff.Media** - PyDatpiff class that allow users to play and download songs\n\n\nHere are somethings you can do with **`Pydtapiff Media`**\n - `find_song` - Find any song made by an artist.\n - `play`  - Plays songs from a mixtape.\n - `download` - Download a song from mixtape.\n - `download_album` - Download all songs from an mixtape.\n\n--- ---\n #### Setup and play song from a mixtape\n Setting media player with a mixtape from above.\n\u003e`Mixtape`__:__ *['Creative Control', 'Carter Collection (15th Anniversary)', ..etc]*\n\n Mixtape can be reference either by __index__  or by its __album name__.\n  Index starts at __one (1)__  not __~~zero (0)~~__ .\n\n```python\nfrom pydatpiff.mixtapes import Mixtape\nfrom pydatpiff.media import Media\n\nmix = Mixtape(search=\"Jay-Z\")\n\n# Initialize Media with the Mixtape's object\nmedia = Media(mix)\n\n# Set the media player to a particular mixtapes.\nmedia.setMedia('Creative Control')\n# -- OR --\nmedia.setMedia(1) # set media by index.  1='Creative Control'\n\n# View all songs in current mixtape\nmedia.songs\n\n[ 'Jay-Z - Intro', 'Jay-Z - Advantage Carter (Prod. By Green Lantern)',\n  'Jay-Z - Welcome 2 Atlanta V103 Feat. Young Jeezy \u0026 DJ Greg Street'                                                                                         , \"Jay-Z - Jay's Back ASAP\",\n  'Jay-Z - Live In London',\n  'Jay-Z - Green Magic',\n  'Jay-Z - Brooklyn Sound Boy',\n  'Jay-Z - Child Abuse (Prod. By Green Lantern)',\n  'Jay-Z - Jay-Z Speaks On Green Lantern',\n  'Jay-Z - Flashy Life',\n  'Jay-Z - Got Me On My Shit (Prod. By Green Lantern)',\n  ..etc\n ]\n```\n\n--- ---\n\n\u0026nbsp; \u0026nbsp; \u0026nbsp; \u003ca\u003e\n\u003cimg src=\"https://github.com/cbedroid/pydatpiff/raw/master/github/gif/gif_mixtapes.gif\" alt=\"gif-mixtapes\" border=\"0\" align=\"center\" min-width=\"300px\" width=\"80%\" height=\"100%\"/\u003e\n\u003c/a\u003e\n\n--\n\n\n### PLAYING A SONG\nSongs can be played either by referencing the song  **index** or   **name**.\n\nSong's name __do not__ have to be an exact match.\n\n\n```python\n# Play a song from current mixtape.\nmedia.play('Welcome')\n\n# -- OR --\n\nmedia.play(3)\n\n# Play Song - ♬♬♬\n# Song: Jay-Z - Welcome 2 Atlanta V103 Feat. Young Jeezy \u0026 DJ Greg Street\n# Size:  1.91 MB\n```\n\n![pydatpiff_media](https://user-images.githubusercontent.com/54720725/188327313-b770feba-d0d5-483d-a315-9dd5f39ed8d1.gif)\n\n---\n\n\n## FIND A SONG\n\n\u003cimg src=\"https://user-images.githubusercontent.com/54720725/97070237-dbb7ae80-15a4-11eb-9ab1-c27b0a2a64dc.png\" width=\"100\" height=\"100\"\u003e\n\n**. . . Can't find that song you been looking for??**\n\n  **No worries... We got you covered!**\n\nFind any song made by an artist using the **`find_song`** method in **`media`**.\n\n  - search by `song's name`.\n  - search by `album's name`.\n\n **media.find_song**\n```python\n# Search for a song\nmedia.find_song('green lan') # returns mixtape's index and name\n\n# Search results\n[\n    (1, 'Creative Control'),\n    (36, 'Headliner \u0026 Legends (Jay-Z Freestyles) '),\n    (69, 'Power Us Up( Jay-z, Kanye West, Swizz Beatz)'),\n    (172, 'J3 Rocnation '),(254, \"Bakin' Session\")\n]\n```\n--- ---\n\n ### CONTROLLING MEDIA PLAYER\n Media player *can    `rewind` , `fast-forward` , `pause` ,  `stop` and control `volume`* of song.\n\n\n Using **`media.player`**, you will have complete control over your music player.\n\nSimply create a variable ` player = media.player`\n\n - `info` -  get information about a song\n - `name` -  get name of current song.\n - `duration` - get duration of track.\n - `rewind` - rewind track\n - `ffwd` - fast-forward track\n - `play` - play current *( track must be paused or stop )*.\n - `pause` - pause/unpause track.\n - `stop` - stop track.\n - `volume` - set the volume level (1 - 100).\n - `volume_up` - increase volume ( *default: increase by 5*).\n - `volum_down` - decrease volume ( *default: decrease by 5*).\n\n\n``` python\n# Create an player object to control the media\nplayer = media.player\n\n# Rewind Song ⏪\nplayer.rewind()\nplayer.rewind(10) # rewind 10 sec ago\n\n# Fast-Forward Song ⏩\nplayer.ffwd()\nplayer.ffwd(10) # fast-forward 10 sec ahead\n\n# Pause Song ⏸\nplayer.pause\n\n# Stop Song ⏹\nplayer.stop # stop song\n\n# Control Volume 🔊\nplayer.volume(50) # set media volume to 50\nplayer.volume_up(5) # set media volume up 5 steps\nplayer.volume_down(5) # set media volume down 5 steps\n\n```\n\n ## DOWNLOAD SONGS AND ALBUMS\n\u003e ## Download Song\n\n  - **media.download**\n\t   - __params__: `song` , `output`, and `rename`\n\n            - *__song__* : index or name of song.\n\n\t        - *__output__* : directory to save song. *(default: current directory)\n\n            - *__rename__* : rename song. *(optional)*\n\n\n\n \u003e ## Download Album\n\n  -  **media.download_album**\n        - __params__: `output`\n        - *__output__* : directory to save song. *(default: current directory)*\n\n\n```python\n# Download a single song\nmedia.download(3,output=\"directory_to_save_song\")\n# -- OR --\nmedia.download('Welcome',output=\"directory_to_save_song\")\n\n# Download full album\nmedia.download_album(output='directory_to_save_album')\n```\n\n--- ---\n## LINKS\n- [Code](https://github.com/cbedroid/pydatpiff)\n- [PyPI](https://pypi.org/project/pydatpiff/)\n- [Issues \u0026 Bugs](https://github.com/cbedroid/pydatpiff/issues)\n\n[new]: https://www.datpiff.com/mixtapes\n[hot]: https://www.datpiff.com/mixtapes/hot\n[top]: https://www.datpiff.com/mixtapes-hot.php\n[celebrated]: https://www.datpiff.com/mixtapes/celebrated\n[exclusive]: https://www.datpiff.com/mixtapes-exclusive\n[popular]: https://www.datpiff.com/mixtapes-popular.php\n[highest-rating]: https://www.datpiff.com/mixtapes-popular.php?filter=month\u0026sort=rating\n[most-listen]: https://www.datpiff.com/mixtapes-popular.php?filter=month\u0026sort=listens\n[most-download]: https://www.datpiff.com/mixtapes-popular.php?filter=month\u0026sort=downloads\n[most-favorite]: https://www.datpiff.com/mixtapes-popular.php?filter=month\u0026sort=favorites\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcbedroid%2Fpydatpiff","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcbedroid%2Fpydatpiff","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcbedroid%2Fpydatpiff/lists"}