{"id":23900718,"url":"https://github.com/cod-e-codes/pymon-says","last_synced_at":"2025-06-13T13:08:27.668Z","repository":{"id":268441762,"uuid":"904369684","full_name":"Cod-e-Codes/pymon-says","owner":"Cod-e-Codes","description":"A Python implementation of the classic Simon Says game with a GUI, dynamic sounds, voice prompts, and a scoring system.","archived":false,"fork":false,"pushed_at":"2024-12-19T01:08:55.000Z","size":70460,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-13T13:08:21.758Z","etag":null,"topics":["game-development","gui","pydub","pygame","python","simon-says","tkinter"],"latest_commit_sha":null,"homepage":"https://github.com/Cod-e-Codes/python-simon-says/","language":"Python","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":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}},"created_at":"2024-12-16T18:53:31.000Z","updated_at":"2024-12-24T18:10:35.000Z","dependencies_parsed_at":"2024-12-16T20:22:30.915Z","dependency_job_id":"b2c93b47-d1ee-4ee8-bedd-cd427ec73196","html_url":"https://github.com/Cod-e-Codes/pymon-says","commit_stats":null,"previous_names":["cod-e-codes/python-simon-says","cod-e-codes/pymon-says"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Cod-e-Codes/pymon-says","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cod-e-Codes%2Fpymon-says","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cod-e-Codes%2Fpymon-says/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cod-e-Codes%2Fpymon-says/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cod-e-Codes%2Fpymon-says/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cod-e-Codes","download_url":"https://codeload.github.com/Cod-e-Codes/pymon-says/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cod-e-Codes%2Fpymon-says/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259650956,"owners_count":22890385,"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","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":["game-development","gui","pydub","pygame","python","simon-says","tkinter"],"created_at":"2025-01-04T20:36:57.759Z","updated_at":"2025-06-13T13:08:22.653Z","avatar_url":"https://github.com/Cod-e-Codes.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PymonSays: A Memory Game\n\n## Overview\n\nA modern, interactive implementation of the classic Simon Says memory game, featuring a responsive graphical user interface, dynamic sound effects, and engaging voice guidance.\n\n---\n\n## Key Features\n\n- **Interactive Gameplay**: Responsive GUI with a classic Simon Says game mechanic\n- **Dynamic Audio Experience**:\n  - Unique tones for each game button\n  - Voice-guided color announcements\n- **Advanced Game Mechanics**:\n  - Comprehensive scoring system\n  - Progressive difficulty scaling\n  - High score tracking\n- **Optimized User Experience**:\n  - Clean, automated sound file management\n  - Intuitive user interface\n\n---\n\n## Table of Contents\n- [Releases](#releases)\n- [Prerequisites](#prerequisites)\n- [Installation](#installation)\n- [Usage](#usage)\n- [File Structure](#file-structure)\n- [How It Works](#how-it-works)\n- [Dependencies](#dependencies)\n- [Future Improvements](#future-improvements)\n- [Screenshot](#screenshot)\n- [Contributing](#contributing)\n- [License](#license)\n- [Contact](#contact)\n\n---\n\n## Releases\n\n### Latest Release\n\nThe latest standalone executable is available for download here:\n[**Simon Says v1.0 - Download Standalone Executable**](https://github.com/Cod-e-Codes/pymon-says/releases/tag/v1.0)\n\n**For Users:**\n- Download `main.exe` for Windows from the latest release.\n- Run the executable to start playing the game without installing Python or dependencies.\n\n**For Developers:**\n- Download the source code from the same release page.\n- Follow the installation and usage instructions below to run or modify the project.\n\n---\n\n## Prerequisites\n\n### System Requirements\n\n- **Python Version**: 3.8+ (Tested on 3.12.3)\n- **Platform**: Windows, macOS, Linux\n\n### Development Tools\n\n- Python\n- pip\n- (Recommended) Virtual environment\n\n---\n\n## Installation\n\n### 1. Clone the Repository\n\n```bash\ngit clone https://github.com/Cod-e-Codes/pymon-says.git\ncd pymon-says\n```\n\n### 2. Set Up Virtual Environment\n\n```bash\n# Create virtual environment\npython -m venv venv\n\n# Activate virtual environment\n# macOS/Linux\nsource venv/bin/activate\n\n# Windows\n.\\venv\\Scripts\\activate\n```\n\n### 3. Install Dependencies\n\n```bash\npip install -r requirements.txt\n```\n\n---\n\n## Usage\n\n### Prepare Sound Files\n\n```bash\npython sound_gen.py\n```\n\nThis script creates `.wav` files for the game's tones and cleans up temporary voice files after combining them.\n\n### Launch the Game\n\n```bash\npython main.py\n```\n\n### Standalone Executable\n\nIf you downloaded the `main.exe` file, simply double-click to launch the game.\n\n---\n\n## File Structure\n\n```plaintext\npymon-says/\n│\n├── main.py              # Primary game implementation\n├── sound_gen.py         # Sound generation and management\n│\n├── *.wav                # Generated sound files\n├── requirements.txt     # Project dependencies\n├── screenshot.png       # Game interface preview\n├── icon.ico             # Application icon\n└── README.md            # Project documentation\n```\n\n---\n\n## How It Works\n\n### 1. **Sound Generation** (`sound_gen.py`):\n- Generates tones for the four colors using `pydub`.\n- Leverages `pyttsx3` for voice synthesis.\n- Combines tones and voice prompts into `.wav` files.\n- Cleans up temporary voice files automatically.\n\n### 2. **Pymon Says Game** (`main.py`):\n- Tkinter-based graphical interface.\n- Dynamic difficulty progression.\n- Real-time score tracking.\n- High score preservation.\n\n---\n\n## Dependencies\n\n| Library       | Version       | Purpose                        |\n|---------------|---------------|--------------------------------|\n| comtypes      | \u003e=1.4.8,\u003c2.0  | Windows COM interface          |\n| pydub         | \u003e=0.25.1,\u003c1.0 | Audio manipulation             |\n| pygame        | \u003e=2.6.1,\u003c3.0  | Audio playback                 |\n| pypiwin32     | \u003e=223,\u003c224    | Windows Python extensions      |\n| pyttsx3       | \u003e=2.98,\u003c3.0   | Text-to-speech synthesis       |\n| pywin32       | \u003e=308,\u003c309    | Windows Python extensions      |\n\nInstall them using the provided `requirements.txt` file.\n\n---\n\n## Future Improvements\n\n- [ ] Implement visual button press effects\n- [ ] Develop global leaderboard system\n- [ ] Create custom sound theme support\n- [x] Cross-platform packaging solutions *(Windows supported; planning to expand to macOS and Linux in future releases)*\n\n---\n\n## Screenshot\n\n![Screenshot of the game in action](screenshot.png)\n\n---\n\n## Contributing\n\nContributions are welcome! Please follow these steps:\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n---\n\n## License\n\nDistributed under the MIT License. See `LICENSE` for more information.\n\n---\n\n## Contact\n\nProject Link: [https://github.com/Cod-e-Codes/pymon-says](https://github.com/Cod-e-Codes/pymon-says)\n\n---\n\n**Enjoy challenging your memory with Pymon Says!**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcod-e-codes%2Fpymon-says","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcod-e-codes%2Fpymon-says","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcod-e-codes%2Fpymon-says/lists"}