CYBER TOMATO

A minimalist terminal-based pomodoro application built with Rust, featuring ASCII art timer display, Mario-style animations, and immersive audio feedback.

Features

Core Timer Functions

• Work Sessions: Default 25-minute focused work periods
• Break Sessions: 5-minute rest periods with relaxing completion music
• Custom Timers: Flexible timing with format like "30,10" (30min work + 10min break) or "20" (20min work + 5min default break)
• Auto/Manual Modes: Auto mode cycles between work and break sessions automatically

Visual Experience

• Large ASCII Art Timer: Eye-catching countdown display with custom digit patterns
• Cyberpunk Green Theme: Consistent neon green aesthetic throughout the interface
• Real-time Progress Bar: Visual progress tracking with percentage display
• Clean TUI Layout: 4-panel interface optimized for terminal use

Audio & Animation

• Mario Animation: Delightful Super Mario-style brick-breaking animation for work completion
• Synchronized Music: Mario Bros theme music with sound effects during animations
• Break Completion Music: 6-second melodic sequence to signal end of break time
• Work Completion Sounds: Quick notification tones for work session completion

Keyboard-Driven Interface

• Lightning-fast Controls: All functions accessible via single keypresses
• Interactive Help: Press x for comprehensive controls popup
• Custom Timer Input: Intuitive dialog with format validation and examples

Quick Start

Prerequisites

• Rust 1.70+ - Install Rust
• Audio System - Ensure your system has working audio output

Installation

# Clone the repository
git clone git@github.com:coolcode/cyber-tomato-cli.git
cd cyber-tomato-cli
# Build and run
cargo run
# Or build optimized release version
cargo build --release
./target/release/cyber-tomato

Controls

Tip: Press x anytime to view the interactive controls popup!

Essential Keys

Key	Action	Description
w	Start Work Session	Begin 25-minute work period
b	Start Break Session	Begin 5-minute break period
c	Custom Timer	Open custom timer input dialog
Space/Enter	Pause/Resume	Toggle timer pause state
t	Toggle Mode	Switch between Manual/Auto modes
m	Mario Animation	Trigger Mario animation (for testing)
x	Help	Show/hide controls popup
q/Esc	Exit	Quit application

Custom Timer Format

• "30,10" → 30 minutes work + 10 minutes break
• "20" → 20 minutes work + 5 minutes default break
• Numbers only → Work time with 5-minute default break

Interface Layout

CYBER TOMATO features a clean, bordered interface:

┌─────────────────────────────────┐
│ CYBER TOMATO │ ← Title Bar
├─────────────────────────────────┤
│ │
│ ██████ ██████ ██████ │ ← ASCII Art Timer
│ ██ ██ ██ ██ ██ ██ │ (Large Digital Display)
│ ██████ ██████ ██████ │
│ │
├─────────────────────────────────┤
│ ███████████████████████░░░ 85% │ ← Progress Bar
├─────────────────────────────────┤
│ Mode: Auto | Status: Working │ ← Status & Help
│ Done: 5 | x: Help │
└─────────────────────────────────┘

Special Features

Mario Animation

• Triggered automatically when work sessions complete
• Features Mario jumping, hitting bricks, and collecting mushrooms
• Synchronized with classic Mario Bros theme music
• Interactive brick-breaking physics simulation

Audio System

• Work Completion: Quick notification beeps
• Break Completion: Musical melody (notification tones + 6-second relaxing tune)
• Mario Animation: Full theme song with jump, brick-break, and power-up sound effects
• High-Quality Audio: Square wave synthesis with decay envelopes

Auto Mode

• Automatically cycles between work and break sessions
• Perfect for uninterrupted pomodoro technique practice
• Visual and audio feedback for session transitions

Technical Details

Core Dependencies

• rodio 0.20 - High-quality audio playback and synthesis
• ratatui 0.29 - Modern terminal user interface framework
• crossterm 0.29 - Cross-platform terminal control

Project Structure

cyber-tomato-cli/
├── src/
│ ├── main.rs # Core application logic
│ ├── audio.rs # Audio management and synthesis
│ ├── mario_animation.rs # Mario animation system
│ └── ascii_digits.rs # ASCII art digit rendering
├── Cargo.toml # Dependencies and metadata
├── rustfmt.toml # Code formatting rules
└── README.md # This documentation

Audio Implementation

• Fresh Stream Architecture: Creates new audio streams for each playback
• Custom Synthesis: Square wave generation with exponential decay
• Synchronized Playback: Coordinated music and sound effects
• Cross-Platform: Works on Linux, macOS, and Windows

Development

Building & Testing

# Development build
cargo build
# Optimized release build
cargo build --release
# Run all tests
cargo test# Code quality checks
cargo clippy --all-targets --all-features -- -D warnings
cargo fmt --all -- --check

Audio Testing

The application gracefully handles systems without audio:

• Displays warning messages for audio initialization failures
• Continues normal timer operation without sound
• All visual features remain fully functional

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Add tests if applicable
5. Commit your changes (git commit -m 'Add amazing feature')
6. Push to the branch (git push origin feature/amazing-feature)
7. Submit a pull request

Acknowledgments

• ASCII Art Numbers from yuanqing
• Rodio Team for excellent Rust audio library
• Ratatui Team for powerful TUI framework
• Rust Community for amazing ecosystem and tools
• Super Mario Bros for inspiration on the animation system

---

Built with Claude Code

ASCII Cat Design:

 ^~^ ← Ears (triangular ears with wavy middle)
_ ('Y') ← Face outline with apostrophe eyes and Y-shaped nose/mouth
\ / \  ← Body outline (shoulders tapering down)
(\|||/) ← Legs in parentheses with 4 vertical legs (\|||/)