diff --git a/.DS_Store b/.DS_Store
new file mode 100644
index 0000000..d936cf1
Binary files /dev/null and b/.DS_Store differ
diff --git a/README.md b/README.md
index acae3d6..d7ddbfe 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,81 @@
-# abletonlivetemplate
-A default project for Ableton Live 11.x that has all scales and scale degrees ready in midi.
+[![Contributors][contributors-shield]][contributors-url]
+[![Forks][forks-shield]][forks-url]
+[![Stargazers][stars-shield]][stars-url]
+[![Issues][issues-shield]][issues-url]
+[![MIT License][license-shield]][license-url]
+
+# Guy's Default Ableton Live Template
+A default project for Ableton Live 11.x that has all chord scales and chord scale degrees ready in midi. This includes:
+* Chord scales as indiviudal midi files; and
+* Each chord scale degree as a chord midi file.
+
+Mix and match as you please!
+
+![product-screenshot]
+
+### Built With
+* [Ableton Live](https://www.ableton.com)
+* [generateMidi](https://github.com/guyewhite/generateMidi)
+
+### Installation
+
+1. Download this repo to your local drive.
+2. Open it in Ableton Live.
+
+## Usage
+
+1. In the session view, drag a chord scale or a chord to the appropriate session slot. Then, hit play for the session.
+2. Consider how you can use follow actions to introduce randomness or sequencing.
+
+## Contributing
+
+Your contributions to this project are very much appreciated. If you would like to help make this project better, fork to repo and create a pull request. Alternatively, you can open an issue with the tag "request." Please star this project!
+
+1. Fork the Project and make a branch with your feature (`git checkout -b feature/myFeature`).
+3. Commit your Changes (`git commit -m 'Added myFeature'`).
+4. Push to the Branch (`git push origin feature/myFeature`).
+5. Open a Pull Request.
+
+## License
+
+Distributed under the MIT License. See `LICENSE.txt` for more information.
+
+## Contact
+
+Pending...
+
+<!-- MARKDOWN LINKS & IMAGES -->
+<!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
+[contributors-shield]: https://img.shields.io/github/contributors/guyewhite/CSVto3Dstrings.svg?style=for-the-badge
+[contributors-url]: https://github.com/guyewhite/CSVto3Dstrings/graphs/contributors
+[forks-shield]: https://img.shields.io/github/forks/guyewhite/CSVto3Dstrings.svg?style=for-the-badge
+[forks-url]: https://github.com/guyewhite/CSVto3Dstrings/network/members
+[stars-shield]: https://img.shields.io/github/stars/guyewhite/CSVto3Dstrings.svg?style=for-the-badge
+[stars-url]: https://github.com/guyewhite/CSVto3Dstrings/stargazers
+[issues-shield]: https://img.shields.io/github/issues/guyewhite/CSVto3Dstrings.svg?style=for-the-badge
+[issues-url]: https://github.com/guyewhite/CSVto3Dstrings/issues
+[license-shield]: https://img.shields.io/github/license/guyewhite/CSVto3Dstrings.svg?style=for-the-badge
+[license-url]: https://github.com/guyewhite/CSVto3Dstrings/blob/master/LICENSE.txt
+[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=555
+[linkedin-url]: https://linkedin.com/in/linkedin_username
+[product-screenshot]: images/screenshot.png
+[Next.js]: https://img.shields.io/badge/next.js-000000?style=for-the-badge&logo=nextdotjs&logoColor=white
+[Next-url]: https://nextjs.org/
+[React.js]: https://img.shields.io/badge/React-20232A?style=for-the-badge&logo=react&logoColor=61DAFB
+[React-url]: https://reactjs.org/
+[Vue.js]: https://img.shields.io/badge/Vue.js-35495E?style=for-the-badge&logo=vuedotjs&logoColor=4FC08D
+[Vue-url]: https://vuejs.org/
+[Angular.io]: https://img.shields.io/badge/Angular-DD0031?style=for-the-badge&logo=angular&logoColor=white
+[Angular-url]: https://angular.io/
+[Svelte.dev]: https://img.shields.io/badge/Svelte-4A4A55?style=for-the-badge&logo=svelte&logoColor=FF3E00
+[Svelte-url]: https://svelte.dev/
+[Laravel.com]: https://img.shields.io/badge/Laravel-FF2D20?style=for-the-badge&logo=laravel&logoColor=white
+[Laravel-url]: https://laravel.com
+[Bootstrap.com]: https://img.shields.io/badge/Bootstrap-563D7C?style=for-the-badge&logo=bootstrap&logoColor=white
+[Bootstrap-url]: https://getbootstrap.com
+[JQuery.com]: https://img.shields.io/badge/jQuery-0769AD?style=for-the-badge&logo=jquery&logoColor=white
+[JQuery-url]: https://jquery.com
+[Python.org]: https://img.shields.io/badge/python-version?style=for-the-badge&logo=python&logoColor=FFFFFF
+[Python-url]: https://python.org
+[Clang]: https://img.shields.io/badge/Clang-version?style=for-the-badge&logo=C&logoColor=FFFFFF
+[Clang-url]: https://clang.llvm.org/
diff --git a/images/screenshot.png b/images/screenshot.png
new file mode 100644
index 0000000..c5c5e75
Binary files /dev/null and b/images/screenshot.png differ