DatStreamer

a DatPiff streaming client written in Java

Table of Contents

• Table of Contents
• Changelog
• Features
• Keyboard Shortcuts
• Get DatStreamer!
• Updating DatStreamer!
• Screenshots
• Troubleshooting
• Project BTS
  • .dat folder
  • src tree
• Acknowledgements

Changelog

Release	Changes	Date
v1.1	browse tab download cover art new dock icon for macOS! new button tooltips add keyboard shortcuts ui improvements performance optimizations macOS bug fixes under the hood refactoring	7/11/20
v1.0	First Release!	3/18/20

Features

• Browse featured mixtapes on DatPiff
• Stream any mixtape on DatPiff
• Download full mixtapes and cover art
• Queue up mixtapes and tracks to jam out to
• Search for mixtapes
• Organize your favorite tracks into playlists
• Favorite the best mixtapes for later

Keyboard Shortcuts

Key	Action
SPACE	play/pause
B	previous track
N	next track
M	shuffle queue

Get DatStreamer!

1. go to the releases tab
2. download the latest DatStreamer .jar file to any location on your computer
3. make sure you have Java 8 installed
4. launch and enjoy!

On first startup, DatStreamer creates a .dat folder where all your playlists and downloaded mixtapes are stored. don't delete this folder!

Updating DatStreamer!

1. go to the releases tab
2. download the latest DatStreamer .jar file and replace with the previous version's .jar file
3. launch and enjoy your new DatStreamer!
   • if DatStreamer doesn't launch:
     1. make a copy of your .dat folder and place it somewhere safe
     2. then delete the orignal .dat folder
     3. restart datstreamer and copy over your previously downloaded mixtapes
     4. you'll have to start over with your playlists and your liked mixtapes :( srry

Screenshots

Browse

Library

Mixtapes

Search

Troubleshooting

DatStreamer doesn't launch after updating!

1. make a copy of your .dat folder and place it somewhere safe
2. then delete the orignal .dat folder
3. restart datstreamer and copy over your previously downloaded mixtapes
4. you'll have to start over with your playlists and your liked mixtapes :( srry

Project BTS

.dat folder

├───mixtapes
│   │   liked.dat           [your liked mixtapes]
│   │
│   └─── all your downloaded mixtapes
│
└───playlists
    |   Liked Songs.play    [your liked songs playlist]
    │
    └─── your other playlists

src tree

│   style.css                   [styling for the app]
│
├───DatStreamer
│       Browse.java             [browse view]
│       DatFiles.java           [retrieve and store datstreamer files]
│       DatStreamer.java        [main class]
│       Library.java            [library view]
│       Menu.java               [tabs/nav view]
│       Player.java             [player/controls view]
│       QueueView.java          [tracks queue view]
│       Search.java             [search view]
│
├───imgs                        [icon resources]
│       add.png
│       add_to_playlist.png
│       add_to_queue.png
│       back.png
│       clear.png
│       download.png
│       explore.png
│       icon.png
│       library.png
│       liked.png
│       next.png
│       not_liked.png
│       pause.png
│       play_arrow.png
│       previous.png
│       search.png
│       shuffle.png
│       track.png
│       trash.png
│
├───META-INF
│       MANIFEST.MF
│
├───Mixtapes
│       Mixtape.java            [Mixtape class]
│       MixtapePreview.java     [mixtape preview view]
│       Mixtapes.java           [just an ArrayList for Mixtape]
│       MixtapeView.java        [full mixtape view]
│
├───Playlists
│       Playlist.java           [Playlist class]
│       PlaylistPreview.java    [playlist preview view]
│       PlaylistView.java       [full playlist view]
│
└───Tracks
        Track.java              [Track class]
        TrackPreview.java       [track preview view]
        Tracks.java             [just an ArrayList for Track]
        TrackView.java          [full track view]
        TrackViewSpacer.java    [spacer for track view buttons]

Acknowledgements

• DatPiff🔥
• Google Material Design Icons
• jsoup