Update README.md

Author: joao003

README.md

@@ -1,7 +1,50 @@
 # breakout-python
-This is Breakout game made fully in Python with Pygame library. This was created for online programming course project. The objective of the game is to break all the bricks available in the level in order to pass to next level.
+
+![logo](https://github.com/joao003/breakout-python/assets/90219319/a6cd67d1-e913-4c07-9d9c-b724fba3b989)
+
+![breakout](https://github.com/joao003/breakout-python/assets/90219319/14620652-a816-450c-b0e8-ede935625bff)
+
+This is Breakout game made fully in Python with Pygame library. This was created for online programming course project, it is to show my skills that I learned from CS50. The objective of this game is to break all the bricks available in the level in order to pass to next level.
 
 # Controls
-Arrow keys - Move paddle
-Spacebar - Launch sphere
-P - Pause/Resume game
+* Arrow keys - Move paddle
+* Spacebar - Launch sphere
+* P - Pause/Resume game
+
+# Known bugs
+* Sphere can be stuck on right side of screen sometimes. The solution is let it fall off.
+
+# Requirements
+* Python must be installed or up-to-date.
+* Pygame must be installed
+* Windows 10 or later (Never tested on Windows 7 and 8.1. Recent version of Python doesn't support Windows 7, but Windows 8.1 may work)
+* Also works on modern Linux distros with WineHQ.
+
+# Credits
+* Skyline by Pianochocolate (Free Music Archive)
+* The End is Near by Scott Gratton (Free Music Archive)
+* Jungle Relaxing Music - Forest Music with Birds Sounds (YouTube)
+* Arabic Battle Music by The Great Fortress (YouTube)
+* Medieval and Celtic Music | LANDS by Alex-Productions | https://onsound.eu/
+  Music promoted by https://www.free-stock-music.com
+  Creative Commons / Attribution 3.0 Unported License (CC BY 3.0)
+  https://creativecommons.org/licenses/by/3.0/deed.en_US
+* Upside Crown by LAZY SALON (Free Music Archive)
+* Palm Beach by Peyruis | https://soundcloud.com/peyruis
+  Music promoted by https://www.free-stock-music.com
+  Creative Commons / Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0)
+  https://creativecommons.org/licenses/by-sa/3.0/deed.en_US
+* Beach by MusicbyAden & Jurgance | https://soundcloud.com/musicbyaden
+  https://soundcloud.com/jurgance
+  Music promoted by https://www.free-stock-music.com
+  Creative Commons / Attribution-NoDerivatives 4.0 International (CC BY-ND 4.0)
+  https://creativecommons.org/licenses/by-nd/4.0/
+* Cases to Rest by Blue Dot Sessions (Free Music Archive)
+* Vetur Frosti by Alexander Nakarada | https://www.serpentsoundstudios.com
+  Music promoted by https://www.free-stock-music.com
+  Creative Commons / Attribution 4.0 International (CC BY 4.0)
+  https://creativecommons.org/licenses/by/4.0/
+* Space Ambience by Alexander Nakarada | https://www.serpentsoundstudios.com
+  Music promoted by https://www.free-stock-music.com
+  Creative Commons / Attribution 4.0 International (CC BY 4.0)
+  https://creativecommons.org/licenses/by/4.0/