{"id":47269027,"url":"https://github.com/SteveMCWin/ttune","last_synced_at":"2026-03-29T14:00:25.662Z","repository":{"id":332180429,"uuid":"1126329878","full_name":"SteveMCWin/ttune","owner":"SteveMCWin","description":"A guitar tuner for your terminal","archived":false,"fork":false,"pushed_at":"2026-03-17T23:09:41.000Z","size":3484,"stargazers_count":43,"open_issues_count":2,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-03-18T13:16:07.250Z","etag":null,"topics":["bubbletea","golang","lipgloss","music","tui"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SteveMCWin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-01T17:13:46.000Z","updated_at":"2026-03-18T10:35:11.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/SteveMCWin/ttune","commit_stats":null,"previous_names":["stevemcwin/ttune"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/SteveMCWin/ttune","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SteveMCWin%2Fttune","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SteveMCWin%2Fttune/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SteveMCWin%2Fttune/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SteveMCWin%2Fttune/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SteveMCWin","download_url":"https://codeload.github.com/SteveMCWin/ttune/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SteveMCWin%2Fttune/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31147144,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-29T13:55:34.612Z","status":"ssl_error","status_checked_at":"2026-03-29T13:54:48.592Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bubbletea","golang","lipgloss","music","tui"],"created_at":"2026-03-15T09:00:27.309Z","updated_at":"2026-03-29T14:00:25.656Z","avatar_url":"https://github.com/SteveMCWin.png","language":"Go","funding_links":[],"categories":["Applications"],"sub_categories":["Media"],"readme":"# tTune\n\n![Cool banner :D](.github/extra/screenshots/banner.png?raw=true)\n\ntTune is a stylized, extendable, keyboard oriented guitar tuning app right in your terminal!\n\n\u003e **Note:** tTune is still actively developed. Future releases may be incompatible with previous ones due to my lack of foresight. If you cannot run the program after updating, please back up your configuration, delete your ~/.config/ttune directory and try running tTune again.\n---\n\n## Showcase\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\".github/extra/screenshots/ttune_demo.gif?raw=true\" /\u003e\u003cbr/\u003e\n  \u003cem\u003eTuning G string demo\u003c/em\u003e\n\u003c/div\u003e\n\n\u003cbr/\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\".github/extra/screenshots/nord_example.png?raw=true\" /\u003e\u003cbr/\u003e\n  \u003cem\u003eTuning view\u003c/em\u003e\n\u003c/div\u003e\n\n\u003cbr/\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\".github/extra/screenshots/gruvbox_example.png?raw=true\" /\u003e\u003cbr/\u003e\n  \u003cem\u003eSettings view\u003c/em\u003e\n\u003c/div\u003e\n\n## Features\n\n- Pitch detection based on the [YIN algorithm](http://audition.ens.fr/adc/pdf/2002_JASA_YIN.pdf)\n- Modern terminal UI\n- Easily customizable settings\n- Batteries included\n\n## Dependencies\n\n- Go `1.24`\n- Portaudio `19.7.0`\n\n### Arch Linux\n\n```bash\nsudo pacman -S pkgconf portaudio go\n```\n\n### Debian\n\n```bash\nsudo apt-get install pkg-config portaudio19-dev golang-go\n```\n\n## Installation\n\n### Arch Linux\n\n```bash\nyay -S ttune\n```\n\n### Build From Source\n\n```bash\n# get dependencies first\ngit clone https://github.com/SteveMCWin/ttune.git\ncd ttune\ngo build\n```\n\n## Customization\n\nYou can add your own options to `custom_options.json` as long as you follow the existing format.\n\n\u003e **Note:** If something breaks, back up and delete the edited files or the entire `~/.config/ttune/` directory - the defaults will be regenerated on the next run.\n\n---\n\n### Ascii Art\n\nPlace your own ASCII art files in `~/.config/ttune/art/`. To display a tuning alongside your art, insert `%%%` where you'd like the notes to appear (see `~/.config/ttune/art/utf_guitar` for reference).\n\n\u003e **Recommended size:** no wider than **24 characters** and no taller than **20 lines**. Oversized art will not render properly.\n\n---\n\n### Border Style\n\nNot extensible at the moment `:^/`\n\nWant this to be moddable? [Open an issue](https://github.com/SteveMCWin/ttune/issues).\n\n---\n\n### Color Theme\n\nTo add a new color theme, open `~/.config/ttune/custom_options.json` and find the list of color themes. Add an entry with:\n\n| Field       | Description              |\n| ----------- | ------------------------ |\n| `name`      | Name of the color theme  |\n| `primary`   | Hex color for borders    |\n| `secondary` | Hex color for text       |\n| `tertiary`  | Hex color for selections |\n\n\u003e **Note:** Your terminal's background color will not be affected.\n\n---\n\n### Displayed Tuning\n\nTo add a new tuning, open `~/.config/ttune/custom_options.json` and find the list of tunings. Add an entry with:\n\n| Field   | Description               |\n| ------- | ------------------------- |\n| `name`  | Name of the tuning        |\n| `notes` | List of notes it contains |\n\n\u003e **Note:** Each note must be **exactly 3 characters long**. Pad shorter note names with spaces (e.g., `\"E4 \"`).\n\n## Planned Features\n\n- [x] Frequency detection\n- [x] Customizable settings\n- [x] Separate user settings\n- [x] Scrollable settings options\n- [ ] Options for frequency detection\n- [ ] Improve pitch detection\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSteveMCWin%2Fttune","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSteveMCWin%2Fttune","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSteveMCWin%2Fttune/lists"}