{"id":30718259,"url":"https://github.com/cod-e-codes/tea-timer","last_synced_at":"2025-09-03T09:48:35.149Z","repository":{"id":307921849,"uuid":"1031087892","full_name":"Cod-e-Codes/tea-timer","owner":"Cod-e-Codes","description":"tea-timer is a minimalist terminal-based countdown timer built with Bubble Tea. Start, pause, reset, and quit — all with simple key presses. ","archived":false,"fork":false,"pushed_at":"2025-08-03T03:18:17.000Z","size":1377,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-03T03:27:00.968Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/Cod-e-Codes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-03T01:32:15.000Z","updated_at":"2025-08-03T03:23:51.000Z","dependencies_parsed_at":"2025-08-03T03:27:03.785Z","dependency_job_id":"81bc43db-6d94-4f64-9a65-9c8a6e1723e2","html_url":"https://github.com/Cod-e-Codes/tea-timer","commit_stats":null,"previous_names":["cod-e-codes/tea-timer"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Cod-e-Codes/tea-timer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cod-e-Codes%2Ftea-timer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cod-e-Codes%2Ftea-timer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cod-e-Codes%2Ftea-timer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cod-e-Codes%2Ftea-timer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cod-e-Codes","download_url":"https://codeload.github.com/Cod-e-Codes/tea-timer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cod-e-Codes%2Ftea-timer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273423956,"owners_count":25103146,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-03T02:00:09.631Z","response_time":76,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2025-09-03T09:48:32.525Z","updated_at":"2025-09-03T09:48:35.135Z","avatar_url":"https://github.com/Cod-e-Codes.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tea Timer\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/Cod-e-Codes/tea-timer)](https://goreportcard.com/report/github.com/Cod-e-Codes/tea-timer)\n[![CI](https://github.com/Cod-e-Codes/tea-timer/actions/workflows/go.yml/badge.svg)](https://github.com/Cod-e-Codes/tea-timer/actions/workflows/go.yml)\n[![Go Version](https://img.shields.io/badge/Go-1.24+-blue.svg)](https://golang.org)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n![Tea Timer Demo](demo.gif)\n\nA minimalist terminal-based countdown timer built with Go and Bubble Tea. Perfect for timing tea steeping, meditation sessions, or any quick countdown needs.\n\n## Features\n\n- **Clean Interface**: Beautiful terminal UI with colored text and smooth animations\n- **Visual Feedback**: Spinning animation during countdown, flashing alert when time expires\n- **Simple Controls**: Start, pause, reset, and quit with single key presses\n- **Flexible Duration**: Set custom countdown time via command line argument\n- **Cross-Platform**: Works on Windows, macOS, and Linux\n\n## Quick Start\n\n### Download Pre-built Binaries (v1.0.0)\n\nDownload the latest release binaries from [GitHub Releases](https://github.com/Cod-e-Codes/tea-timer/releases/tag/v1.0.0):\n\n- **Linux**: `tea-timer-linux-amd64`\n- **Windows**: `tea-timer-windows-amd64.exe`\n- **macOS**: `tea-timer-darwin-amd64`\n\nMake the binary executable (Linux/macOS):\n```bash\nchmod +x tea-timer-linux-amd64\n```\n\nRun the timer:\n```bash\n# Default 60-second timer\n./tea-timer-linux-amd64\n\n# Custom duration (120 seconds)\n./tea-timer-linux-amd64 120\n```\n\n### Build from Source\n\n```bash\n# Run with default 60-second timer\ngo run main.go\n\n# Run with custom duration (in seconds)\ngo run main.go 120\n\n# Build and run the executable\ngo build\n./tea-timer 300\n```\n\n## Controls\n\n- `s` or `space` - Start/pause timer\n- `r` - Reset timer to initial duration\n- `q`, `ctrl+c`, or `esc` - Quit the application\n\nWhen the timer finishes, the display will flash to alert you. Press `s` or `space` to restart the timer.\n\n## Requirements\n\n- Go 1.24 or later (for building from source)\n- Terminal with color support\n\n## Installation\n\n### From Pre-built Binaries\n1. Download the appropriate binary for your platform from [GitHub Releases](https://github.com/Cod-e-Codes/tea-timer/releases/tag/v1.0.0)\n2. Make executable (Linux/macOS): `chmod +x tea-timer-*`\n3. Run: `./tea-timer-* [duration]`\n\n### From Source\n1. Clone the repository\n2. Run `go mod tidy` to install dependencies\n3. Build with `go build` or run directly with `go run main.go`\n\n## Documentation\n\n- [Contributing Guidelines](CONTRIBUTING.md) - How to contribute to Tea Timer\n- [Security Policy](SECURITY.md) - How to report security vulnerabilities\n- [Issue Templates](.github/ISSUE_TEMPLATE/) - Templates for bug reports and feature requests\n\n## Project Structure\n\n```\ntea-timer/\n├── main.go                    # Main application code\n├── go.mod                     # Go module file\n├── go.sum                     # Dependency checksums\n├── README.md                  # Project documentation\n├── CONTRIBUTING.md            # Contribution guidelines\n├── SECURITY.md                # Security policy\n├── LICENSE                    # MIT License\n├── .github/\n│   ├── workflows/\n│   │   └── go.yml            # CI/CD workflow\n│   ├── ISSUE_TEMPLATE/       # Issue templates\n│   └── pull_request_template.md\n└── tea-timer-*-amd64*        # Release binaries\n```\n\n## Dependencies\n\n- [Bubble Tea](https://github.com/charmbracelet/bubbletea) - Terminal UI framework\n- [Bubbles](https://github.com/charmbracelet/bubbles) - UI components\n- [Lip Gloss](https://github.com/charmbracelet/lipgloss) - Terminal styling \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcod-e-codes%2Ftea-timer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcod-e-codes%2Ftea-timer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcod-e-codes%2Ftea-timer/lists"}