update README.md

CONTRIBUTING.md

@@ -0,0 +1,15 @@
+# Contribution Guidelines
+
+Please ensure your pull request adheres to the following guidelines:
+
+- Search previous suggestions before making a new one, as yours may be a duplicate.
+- Suggested packages should be tested and documented.
+- Make an individual pull request for each suggestion.
+- Use the following format: `[ITEM](LINK) - DESCRIPTION.`
+- New categories, or improvements to the existing categorization are welcome.
+- Keep descriptions short and simple, but descriptive.
+- End all descriptions with a full stop/period.
+- Check your spelling and grammar.
+- Make sure your text editor is set to remove trailing whitespace.
+
+Thank you for your suggestions!

README.md

@@ -1,2 +1,97 @@
-# awesome-odroid-go
-A collection of awesome ODROID-GO emulators, games and resources
+<p align="center">
+  <br>
+  <img width="400" src="./logo.svg" alt="logo of awesome-odroid-go repository">
+  <br>
+  <br>
+</p>
+
+## Awesome ODROID-GO [![Awesome](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/sindresorhus/awesome)
+
+> A collection of awesome [ODROID-GO](https://wiki.odroid.com/odroid_go/odroid_go) emulators, games and resources
+
+- [Emulators](#emulators)
+- [Games](#games)
+- [Apps](#apps)
+- [Extras](#extras)
+- [Resources](#resources)
+	- [Official Resources](#official-resources)
+	- [Guides](#guides)
+	- [Projects](#projects)
+		- [Arduino](#arduino)
+		- [MicroPython](#micropython)
+	- [Videos](#videos)
+
+---
+
+# Emulators
+- [Go-Play](https://github.com/OtherCrashOverride/go-play) - Emulator Launcher that includes GameBoy, GameBoy Color, NES and SMS emulation.
+- [Frodo-Go](https://github.com/OtherCrashOverride/frodo-go) - Commodore 64 emulator.
+- [c64-go](https://github.com/Schuemi/c64-go) - Commodore 64 emulator
+- [Stella](https://github.com/OtherCrashOverride/stella-odroid-go) - Atari 2600 emulator.
+- [ProSystem](https://github.com/OtherCrashOverride/prosystem-odroid-go) - Atari 7800 emulator.
+- [Spectrum](https://bitbucket.org/DavidKnight247/odroid-go-spectrum-emulator) - Spectrum emulator.
+- [fMSX-go](https://github.com/Schuemi/fMSX-go) - fMSX emulator.
+- [Open Source Emulator Launcher](https://github.com/IlyaMZP/emulator-launcher-odroid-go) - Open Source Emulator Launcher for Odroid Go to replace Springboard.
+
+# Games
+- [Doom](https://github.com/mad-ady/doom-odroid-go)
+- [Duke Nukem 3D](https://github.com/jkirsons/Duke3D)
+- [Tyrian](https://github.com/jkirsons/OpenTyrian)
+- [Pong](https://github.com/khuenqdev/goduino/tree/master/pong)
+
+# Apps
+- [MicroPython](https://github.com/OtherCrashOverride/MicroPython_ESP32_psRAM_LoBo-odroid-go)
+- [M5Stack Library](https://yadi.sk/d/0wo7ympO3Zc6RT)
+
+# Extras
+- [ROM artwork](https://dn.odroid.com/ODROID_GO/romart-20180810.tgz)
+- [Bluetooth Keyboard](https://github.com/OtherCrashOverride/bt-keyboard-go)
+
+# Resources
+
+### Official Resources
+- [Official Wiki](https://wiki.odroid.com/odroid_go/odroid_go)
+- [ODROID-GO by Hardkernal Forum](https://forum.odroid.com/viewforum.php?f=157)
+- [Github](https://github.com/hardkernel/ODROID-GO)
+- [Official Hardkernal Website](https://www.hardkernel.com)
+
+### Guides
+- [Assembly](https://wiki.odroid.com/odroid_go/go_assembling)
+- [Make a SD card for importing roms](https://wiki.odroid.com/odroid_go/make_sd_card)
+- [Firmware Update](https://wiki.odroid.com/odroid_go/firmware_update)
+- [Extracting esp32 image with esp32img tool](https://wiki.odroid.com/odroid_go/extract_esp32_img)
+- [Hardware tunning for silent the sound volume](https://wiki.odroid.com/odroid_go/silent_volume)
+- [Writing Applications](https://wiki.odroid.com/odroid_go/write_app)
+
+### Projects
+
+#### Arduino
+- [Getting Started with Arduino](https://wiki.odroid.com/odroid_go/arduino/01_arduino_setup)
+- [Hello World](https://wiki.odroid.com/odroid_go/arduino/02_hello_world)
+- [Control Blue LED and PWM](https://wiki.odroid.com/odroid_go/arduino/03_blue_led_and_pwm)
+- [Using Buttons](https://wiki.odroid.com/odroid_go/arduino/04_buttons)
+- [Get the status of the battery](https://wiki.odroid.com/odroid_go/arduino/05_battery)
+- [Using the Speaker](https://wiki.odroid.com/odroid_go/arduino/06_speaker)
+- [Using Bluetooth Serial](https://wiki.odroid.com/odroid_go/arduino/07_bluetooth_serial)
+- [Using WiFi](https://wiki.odroid.com/odroid_go/arduino/08_wifi_ap)
+- [Control LCD via I2C interface](https://wiki.odroid.com/odroid_go/arduino/09_16x2lcd_i2c)
+- [Build a Weather Station](https://wiki.odroid.com/odroid_go/arduino/30_weather_station)
+- [Build an Ultrasonic Distance Meter](https://wiki.odroid.com/odroid_go/arduino/31_ultrasonic_distance_meter)
+- [Flappybird](https://wiki.odroid.com/odroid_go/arduino/32_game_flappybird)
+- [Tetris](https://wiki.odroid.com/odroid_go/arduino/33_game_tetris)
+- [Control a Servo Motor](https://wiki.odroid.com/odroid_go/arduino/34_servo_motor)
+- [Build a Motion Detector](https://wiki.odroid.com/odroid_go/arduino/35_pir_motion_detector)
+- [Build a Colorviewer](https://wiki.odroid.com/odroid_go/arduino/36_colorview)
+- [Build an IR Receiver](https://wiki.odroid.com/odroid_go/arduino/37_ir_receiver)
+- [Make Arduino Applications](https://wiki.odroid.com/odroid_go/arduino_app)
+
+#### MicroPython
+- [Getting started with MicroPython](https://wiki.odroid.com/odroid_go/micropython/01_micropython_setup)
+- [Hello World](https://wiki.odroid.com/odroid_go/micropython/02_hello_world)
+- [Control Blue LED and PWM](https://wiki.odroid.com/odroid_go/micropython/03_blue_led_and_pwm)
+- [Using Buttons](https://wiki.odroid.com/odroid_go/micropython/04_buttons)
+- [Get the status of the battery](https://wiki.odroid.com/odroid_go/micropython/05_battery)
+- [Using the speaker](https://wiki.odroid.com/odroid_go/micropython/06_speaker)
+
+#### Videos
+- [Headphones on ODROID-GO](https://www.youtube.com/watch?v=pp_DPHiUhcc)