TrackTonic is a music streaming website crafted with Django, designed for simplicity and built as a personal project for learning purposes. This endeavor allowed me to delve into the intricacies of web development and gain hands-on experience with Django, HTML, CSS, and JavaScript.
The clean and intuitive interface ensures a seamless experience for users, making music streaming a delight.
Users can create playlists by uploading music from their devices. Simply navigate to the playlist creation section and select the songs you want to add to your playlist.
The app automatically extracts metadata from the uploaded music files to populate song object fields. This ensures that all the necessary information about the songs is available for easy organization and searching ensuring a hassle-free music library management.
Integrated with the Genius API, TrackTonic lets users explore song lyrics effortlessly while enjoying their favorite tunes. Simply click on the lyrics icon next to the song to display the lyrics in a separate section.
Download individual songs or entire playlists (in zip format) shared by other users to broaden your musical horizon. Simply navigate to the playlist you want to download and click on the download button.
To set up the project locally, follow these steps:
- Clone the repository:
git clone https://github.com/Nathaniel81/TrackTonic.git - Install the necessary dependencies:
pip install -r requirements.txt - Set up the database:
python manage.py migrate - Start the development server:
python manage.py runserver
Make sure you have Python and Django installed on your machine before proceeding with the above steps.
To run TrackTonic using Docker, you can use the provided Dockerfile and docker-compose.yml files in the project's root directory. Follow these steps:
- Build the Docker images:
docker-compose build - Run the Docker containers:
docker-compose up
The application will be accessible at http://localhost:8000/ in your web browser.
TrackTonic seamlessly integrates with the Genius API to retrieve song lyrics. To enable this feature, follow these steps:
-
Get Your Genius API Access Token:
- Visit the Genius API Documentation and sign up for an api access token .
- Once registered, you will receive a unique API Access Token that allows TrackTonic to access the Genius API.
-
Create a Configuration File:
- In the project's root directory, create a
.envfile if one doesn't exist.
- In the project's root directory, create a
-
Store Your API Key:
- Open the
.envfile and add the following line, replacing[YOUR_GENIUS_API_ACCESS_TOKEN]with the token you obtained:GENIUS_ACCESS_TOKEN=[YOUR_GENIUS_API_ACCESS_TOKEN]
- Open the
-
Configure the Application:
- The TrackTonic application is designed to read the Genius API Access Token from the
.envfile during runtime. - With the token in place, TrackTonic can dynamically fetch and display lyrics for the songs being played.
- The TrackTonic application is designed to read the Genius API Access Token from the
By following these steps, you ensure that TrackTonic has the necessary authorization to access the Genius API and enrich your music streaming experience with on-the-fly song lyrics.
This project is more than just a music streaming app; it's a product of my journey into web development. Built with a focus on practical learning, TrackTonic showcases the skills and insights gained during the development process. From setting up Django models to handling user authentication and integrating external APIs, every line of code represents a step forward in my coding proficiency.
The name TrackTonic reflects the harmony of tracks and the invigorating essence of learning. It's not just a music streaming website; it's a testament to the power of hands-on experience and continuous improvement.
Feel free to explore TrackTonic, and join me in this musical and coding journey!