Whale

Whale is a "Music Streaming" website developed with Django and Ajax. Users can share music with others.

Overview

The main features that have currently been implemented are:

• Listen songs (no need to login)
• Music player functions(play, pause, next, previous, timestamp)
• Comment the song.
• Add to favourite list.
• Upload songs.
• Edit and Delete own songs.
• Authentication and authorization
• User Profile
• Follow / Unfollow
• Search songs
• Responsive design

Tech Stack

Frontend - Vanilla Javascript, Ajax
Styling - Bootstrap CSS
Backend - Django
Database - Postgres
Hosting - AWS EC2
Containerization: Docker

Demo

Due to server costs, I am sorry that I could not release this site public. I am only sharing with my close friends.
Here is the demo GIF.

Coming Features

• UI Resign
• Shuffle/ Loop songs
• Timer
• Notification
• User Created Playlist
• Song Recommendation
• Live Radio

Entity–relationship Diagram

Note: Click and download the image to see details.

Quick Start

To get this project up and running locally on your computer:

1. Clone the project.

   git clone https://github.com/pyaephyokyaw15/Whale.git

2. Set up the Python development environment.

   Note: I want to recommend using a Python virtual environment.

3. Create .env file in the project root directory and create variables used in settings.py.

4. Assuming you have Python setup, run the following commands (if you're on Windows you may use py or py -3 instead of python to start Python):

   pip3 install -r requirements.txt
   python3 manage.py makemigrations
   python3 manage.py migrate
   python3 manage.py collectstatic
   python3 manage.py test # Run the standard tests. These should all pass.
   python3 manage.py createsuperuser # Create a superuser
   python3 manage.py runserver
   

5. Open a browser to http://127.0.0.1:8000.

6. Admin Site: http://127.0.0.1:8000/admin

References

• Django Documentation
• mdn web docs

Author

• @pyaephyokyaw15