Music Collection

Welcome to the Music Collection project! This project allows you to manage your music collection and play an interactive musical game. This README provides instructions on how to set up and use the project.

Instructions

Clone the Repository

To get started, clone the repository by executing the following command in your terminal:

git clone https://github.com/henry3260/final-project.git

Navigate to the Project Directory

After cloning the repository, navigate to the project directory using the terminal. Use the following command:

cd final-project

Install Dependencies

Before running the musical game, make sure you have the necessary dependencies installed. The game requires Lua and the Corona SDK. Please follow the installation instructions for your specific operating system:

1. Lua: Visit the Lua website (https://www.lua.org/) and download the appropriate version of Lua for your system. Follow the installation instructions provided.

2. Corona SDK: Visit the Corona SDK website (https://coronalabs.com/) and download the Corona SDK package for your operating system. Install the package by following the provided instructions.

Execute the Program

Once you are in the project directory and have installed the required dependencies, you can execute the program by running the following command:

make
./music_collection

Main Operations of the Playlist

When running the program, you will be presented with several options to interact with the playlist. Here are the main operations you can perform:

1. Import a Music Collection: Import your music collection by providing the necessary file. After importing, you can access other functions.
2. Display the Playlist: View the current songs in your playlist.
3. Sort the Playlist: Sort your playlist by either song length or artist's name.
4. Add Songs: Add a new song to your playlist by providing the required information.
5. Delete Songs: Remove a song from your playlist.
6. Search for a Song: Search for a specific song by providing the keyword of the song's name or the artist's name.
7. Shuffle the Playlist: Randomly shuffle the songs in your playlist.
8. Download the Music Collection: Download your music collection for future use.
9. Exit: Terminate the program.

Main Operation of the Music Game

Apart from managing your music collection, you can also enjoy a musical game. To play the game, follow these steps:

1. Make sure you have Lua and the Corona SDK installed on your system.
2. When prompted to play the game, select the option in the program.
3. The game will start in the Corona Simulator application, where you can select a song and choose a level to enjoy the game.

Additional Notes

• The main program is written in C and interacts with Lua to launch the musical game.
• Make sure you have Lua and the Corona SDK installed and properly set up before running the game.
• Lua is used as a scripting language to control the game logic and interactions.
• The Corona SDK provides the necessary tools and libraries for creating the graphical elements and running the game on different platforms.
• Consult the documentation and resources provided by Lua and the Corona SDK for more information on using and developing games with these tools.

Feel free to explore and enjoy both the music collection and the musical game!

---

Note: Please ensure that you have the necessary dependencies installed as mentioned in the Environment Setup section of the README file to run the program successfully.