{"id":28546192,"url":"https://github.com/yplog/memotty","last_synced_at":"2025-07-07T06:31:28.462Z","repository":{"id":297203204,"uuid":"995287067","full_name":"yplog/memotty","owner":"yplog","description":"Interactive terminal-based quiz application with smart CSV loading and dynamic distractor generation. Built with Go \u0026 Bubbletea.","archived":false,"fork":false,"pushed_at":"2025-06-14T19:43:37.000Z","size":39,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-14T20:35:07.210Z","etag":null,"topics":["bubbletea","csv","go","study-tool"],"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/yplog.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}},"created_at":"2025-06-03T08:52:32.000Z","updated_at":"2025-06-14T19:43:34.000Z","dependencies_parsed_at":"2025-06-14T20:25:51.091Z","dependency_job_id":null,"html_url":"https://github.com/yplog/memotty","commit_stats":null,"previous_names":["yplog/memotty"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/yplog/memotty","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yplog%2Fmemotty","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yplog%2Fmemotty/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yplog%2Fmemotty/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yplog%2Fmemotty/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yplog","download_url":"https://codeload.github.com/yplog/memotty/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yplog%2Fmemotty/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264027564,"owners_count":23546099,"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":["bubbletea","csv","go","study-tool"],"created_at":"2025-06-09T23:09:05.161Z","updated_at":"2025-07-07T06:31:28.455Z","avatar_url":"https://github.com/yplog.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Memotty - Interactive CSV-Based Quiz Application\n\nMemotty is a modern, interactive terminal quiz application built with Go and Bubbletea. It features dynamic CSV loading, intelligent distractor generation, and a beautiful terminal interface.\n\n## Key Features\n\n- **Dynamic CSV Loading**: Load questions from any CSV file in `~/.memotty/`\n- **Adaptive Options**: Question option count adapts to available answers (2-4 options)\n- **Dual Quiz Modes**: Multiple choice and written answer modes\n- **Detailed Results**: Comprehensive analysis with correct/incorrect breakdown\n\n## Quick Start\n\n#### Option 1: One-line Install (Recommended)\n```bash\n# Latest release\ncurl -fsSL https://raw.githubusercontent.com/yplog/memotty/main/scripts/install.sh | bash\n\n# Or download and run manually\ncurl -fsSL -o install.sh https://raw.githubusercontent.com/yplog/memotty/main/scripts/install.sh\nchmod +x install.sh\n./install.sh\n```\n\n#### Option 2: Build from Source\n```bash\ngit clone https://github.com/yplog/memotty\ncd memotty\ngo mod tidy\ngo build -o memotty cmd/memotty/main.go\n\nchmod +x memotty\nmv memotty ~/.local/bin/\n\n# Add to PATH if not already added\necho 'export PATH=\"$HOME/.local/bin:$PATH\"' \u003e\u003e ~/.bashrc\n# or for zsh users\necho 'export PATH=\"$HOME/.local/bin:$PATH\"' \u003e\u003e ~/.zshrc\n```\n\n### Run the Application\n```bash\nmemotty\n```\n\n### Update\nPress `u` on the file selection or mode menu to download and install the latest release automatically.\n\n### Uninstall\n```bash\n# Remove binary only\nrm -f ~/.local/bin/memotty\n\n# Complete removal (including CSV files)\nrm -f ~/.local/bin/memotty \u0026\u0026 rm -rf ~/.memotty\n```\n\n## CSV File Format\n\nPlace your CSV files in `~/.memotty/` directory:\n\n```csv\nWhat is the synonym of happy?,joyful\nWhat is the antonym of cold?,hot\nWhat does the word run mean in the context of exercise?,to jog or sprint\nWhat part of speech is the word quickly?,adverb\nWhat is the plural form of mouse?,mice\nWhich language does the word fiancé originate from?,french\nWhat is the past tense of go?,went\nWhat does the prefix un- mean?,not or opposite\nWhat is the comparative form of good?,better\nWhat is the root word of beautiful?,beauty\n```\n\n### CSV Requirements\n- **Format**: `question,answer` (comma-separated)\n- **Location**: `~/.memotty/*.csv`\n- **No headers**: Start directly with question data\n\n## Technical Features\n\n### Dependencies\n- **[Bubbletea](https://github.com/charmbracelet/bubbletea)**: Terminal UI framework\n- **[Lipgloss](https://github.com/charmbracelet/lipgloss)**: Styling and layout\n- **Go 1.21+**: Modern Go features\n\n## 🛠️ Customization\n\n### Adding New Questions\n1. Create/edit CSV file in `~/.memotty/`\n2. Follow the `question,answer` format\n3. Restart application to load new questions\n\n### Creating Subject-Specific Quizzes\n```csv\n# math_basics.csv\nWhat is 2 + 2?,4\nWhat is the square root of 16?,4\nWhat is 10 * 3?,30\n\n# history_quiz.csv\nWhen did World War II end?,1945\nWho was the first US President?,George Washington\nWhat year did the Berlin Wall fall?,1989\n```\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit changes (`git commit -m 'Add amazing feature'`)\n4. Push to branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyplog%2Fmemotty","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyplog%2Fmemotty","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyplog%2Fmemotty/lists"}