# MusicDNA

**Repository Path**: umdol/MusicDNA

## Basic Information

- **Project Name**: MusicDNA
- **Description**: https://github.com/harjot-oberai/MusicDNA
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-05-20
- **Last Updated**: 2024-10-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MusicDNA - A Music Player like no other
<img src = "https://github.com/harjot-oberai/MusicStreamer/blob/master/screenshots/splash.png" width = "800"><br><br>
<a href='https://play.google.com/store/apps/details?id=com.sdsmdg.harjot.MusicDNA&pcampaignid=MKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1'><img alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/images/generic/en_badge_web_generic.png' width="200"/></a>
[<img src="https://f-droid.org/badge/get-it-on.png"
      alt="Get it on F-Droid"
      width="200">](https://android.izzysoft.de/repo/apk/com.sdsmdg.harjot.MusicDNA)<br>
A Music Player for android that makes use of the Visualizer Class for rendering a beautiful **DNA** (***Visualization***) of the currently playing music.

## Background
The Music Player draws inspiration from [paullewis's music-dna](https://github.com/paullewis/music-dna/).
The Player uses the FFT Data supplied by the **Visualizer** class of Android , calculates the Amplitude at that particular moment and plots the **DNA**.

## The Player
MusicDNA combines the usefullness of a traditional Music Player app with the beautiful visualizations.
The Player allows users to play both **local music** as well as Stream Music directly from **SoundCloud**.
The Player also packs a **Powerful Equalizer with** ***BassBoost and Reverb*** effects

## Build Instructions

After cloning the repo, create a file `Config.java` under `\app\src\main\java\com\sdsmdg\harjot\MusicDNA`
Put the following code in it
```
package com.sdsmdg.harjot.MusicDNA;

public class Config {
    public static final String CLIENT_ID = "YOUR_SOUNDCLOUD_CLIENT_ID";
    public static final String API_URL = "https://api.soundcloud.com";
    public static final String GENIUS = "YOUR_GENIUS_API_KEY";
}
```
Replace `YOUR_SOUNDCLOUD_CLIENT_ID` with a client id received from SoundCloud or leave it blank if you don't want to use SoundCloud streaming.Get SoundCloud Client ID from here : [https://developers.soundcloud.com/](https://developers.soundcloud.com/)<br>
Replace `YOUR_GENIUS_API_KEY` with an API key received from Genius or leave it blank if you don't want to use lyrics from genius.com.
Get Genius API key from here : [https://genius.com/api-clients/new](https://genius.com/api-clients/new)<br>
After that just import the project into Android Studio.

## The Player - *In Action*

Video Demo : [http://sendvid.com/b2hhc1pi](http://sendvid.com/b2hhc1pi)<br>
The video's length was cut short due to ADB screenrecord's limit of 3:00 min. <br>
Credits for combining audio and video [Piyush Mehrotra](https://github.com/hm98)

<p align="center">
<img src = "https://github.com/harjot-oberai/MusicStreamer/blob/master/screenshots/dna1.png" width = "300"><img src = "https://github.com/harjot-oberai/MusicStreamer/blob/master/screenshots/home.png" width = "300">
</p>
<p align="center">
<img src = "https://github.com/harjot-oberai/MusicStreamer/blob/master/screenshots/equalizer.png" width = "300"><img src = "https://github.com/harjot-oberai/MusicStreamer/blob/master/screenshots/savedDNA.png" width = "300">
</p>
<p align="center">
<img src = "https://github.com/harjot-oberai/MusicStreamer/blob/master/screenshots/albums_artists.png" width = "600">
</p>
<p align="center">
<img src = "https://github.com/harjot-oberai/MusicStreamer/blob/master/screenshots/fav_recents.png" width = "600">
</p>

## License
MusicDNA is under `CC BY-NC-SA` license.