goitar-hero

KO | EN

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #open-source #ai #claude-code #codex #deepseek-harness #dsh-plugin #react #windows #developer-tools

★ 29 Open GitHub ↗

Guitar hero game in terminal.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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!

goitar-hero

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README