Project-Player

🧱 Project Structure Overview — Java Swing Applications

This repository contains multiple Java Swing applications and GUI components.
Each file plays a specific role in the functionality and user interface of the overall project.
Below is a complete breakdown of the project structure with short explanations for each file.

---

🧩 File Descriptions

🎇 LeapYearCheckerFinal.java

• A standalone GUI that checks if a year is a leap year.
• Includes animated glowing buttons, floating particle effects, and sound feedback.
• Updated for Hacktoberfest 2025 to include comments, styling, and a “Clear” button feature.

---

🎵 Player.java

• Core backend class for a simple media player application.
• Handles music playback, control, and resource management.
• Designed to work with PlayerGUI.java and PlayerMain.java.

---

🪟 PlayerGUI.java

• Front-end GUI for the audio player.
• Provides buttons, labels, and controls to play, pause, and stop tracks.
• Connects to Player.java for playback logic.
• Has a corresponding .form file that defines its visual layout.

---

🧭 PlayerMain.java

• Entry point for the music player program.
• Initializes the GUI and launches the main player window.
• Keeps the project modular and easy to test separately.

---

📋 ListFrame.java

• Supplementary frame used for displaying or managing lists (like track lists).
• Works as a component within the player GUI.
• The .form file defines its layout visually using an IDE like NetBeans.

---

🧱 .form Files

• Example: ListFrame.form, PlayerGUI.form
• These files store layout metadata generated by GUI builders (like NetBeans Form Designer).
• They describe positions, colors, fonts, and design properties for GUI components.

---

⚙️ requirements.txt

• Contains dependencies or setup notes (if any).
• Since this is a Java Swing project, it may list version requirements or optional libraries.

---

📝 README.md

• Documentation file (this one).
• Provides an overview of the folder layout and explains the purpose of each file.

---

To open a PR (pull request) for this repo:

1. Fork the repository
2. Make a separate folder on your local computer
3. Right click > Git bash here.
4. git clone "repolink.git" (your forked repo link)
5. Now head over to your file > make required changes > save the file.
6. (return to the git bash terminal)
7. git add .
8. git commit "any message"
9. git push origin master/main/your-banch
10. (switch to Github)
11. Go to Pull requests tab > new Pull request > create pull request
12. You're done !

Note: Have patience till your PR gets reviewed and accepted/merged.

Hacktoberfest Contribution

• Added by Misbah Qureshi for Hacktoberfest 2025 🎉

🧑‍💻 Contribution Note

This documentation was added and updated as part of Hacktoberfest 2025 to make the repository more beginner-friendly and readable.

If you are new to open source, understanding the file structure helps you navigate and contribute effectively.

---

📜 License

This repository is open source and can be used for learning, modification, or improvement under the MIT License.