Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/oguzhantasimaz/goitar-hero

Guitar hero game in terminal.
https://github.com/oguzhantasimaz/goitar-hero

go golang guitar-flash guitar-hero tcell terminal terminal-based terminal-game

Last synced: 12 days ago
JSON representation

Guitar hero game in terminal.

Awesome Lists containing this project

README

        

# Goitar Hero

## Introduction

This is a Guitar Hero-inspired game implemented in the terminal using the Go programming language and the TCell library.

![Gif](https://github.com/oguzhantasimaz/goitar-hero/blob/main/gif.gif)

## Features

- **Terminal-Based:** Play the game in your terminal without the need for any external dependencies or libraries.

- **Scoring System:** Compete with yourself or friends to achieve the highest score and accuracy.

- **Audio Playback:** Listen to the song as you play along.

## Installation

1. Clone this repository to your local machine:

```
git clone https://github.com/oguzhantasimaz/goitar-hero
```

2. Navigate to the project directory:

```
cd goitar-hero
```

3. Build and run the game:

```
go run main.go
```

## How to Play

- **Controls:**

- Use the `A`, `S`, `J`, `K` and `L` keys to press the corresponding notes as they reach the bottom of the screen.

- The goal is to hit the correct notes at the right time to score points and achieve a high accuracy rate.

- Enjoy!

- **Scoring:**

- Points are awarded for hitting notes accurately.

- Your accuracy is measured by how many notes you hit correctly out of the total.

## Customization

You can customize the game by adding your own songs and changing the note patterns in the code. See `ScarTissue` in main.go

## Acknowledgements

This game is built using the TCell library and was inspired by the popular Guitar Hero game series.

## Contribution

Feel free to open Pull Requests

## TODO

- [ ] Game over
- [ ] Song library
- [ ] Difficulty
- [x] Sound
- [ ] Mute music if note is not played correctly

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

## Author

- [Oguzhan Tasimaz](https://github.com/oguzhantasimaz)

## Note

This game is for educational and entertainment purposes only. It is not affiliated with or endorsed by the Guitar Hero franchise. Enjoy and rock on!