{"id":21922655,"url":"https://github.com/betmig/mettavoice","last_synced_at":"2026-02-20T17:03:09.111Z","repository":{"id":265121757,"uuid":"895196285","full_name":"betmig/mettavoice","owner":"betmig","description":"Metta Voice  - A meditation app that blends ancient Buddhist teachings with modern accessibility features. Experience sutta readings with synchronized TTS, customizable meditation timers, and a focus on user accessibility. Built with React, TypeScript, and Tailwind CSS, designed for offline use and privacy-conscious users.","archived":false,"fork":false,"pushed_at":"2025-04-03T07:00:47.000Z","size":758,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-09T16:31:56.946Z","etag":null,"topics":["accesible-properties","audio","buddhism","digital-wellbeing","frontend","meditation","mindfulness","offline","open-dyslexic","privacy-focused","pwa","react","responsive-design","sutta","tailwindcss","tts","typescript","vite","web-speech-api","zustand"],"latest_commit_sha":null,"homepage":"https://voice.mettabit.io/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/betmig.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":"2024-11-27T18:27:33.000Z","updated_at":"2025-04-03T07:00:52.000Z","dependencies_parsed_at":"2025-01-27T10:42:26.958Z","dependency_job_id":"25f026ac-c7e3-49d6-aec5-a03c3d4d9374","html_url":"https://github.com/betmig/mettavoice","commit_stats":null,"previous_names":["betmig/mettavoice"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/betmig/mettavoice","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/betmig%2Fmettavoice","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/betmig%2Fmettavoice/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/betmig%2Fmettavoice/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/betmig%2Fmettavoice/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/betmig","download_url":"https://codeload.github.com/betmig/mettavoice/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/betmig%2Fmettavoice/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29658167,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-20T16:33:43.953Z","status":"ssl_error","status_checked_at":"2026-02-20T16:33:43.598Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["accesible-properties","audio","buddhism","digital-wellbeing","frontend","meditation","mindfulness","offline","open-dyslexic","privacy-focused","pwa","react","responsive-design","sutta","tailwindcss","tts","typescript","vite","web-speech-api","zustand"],"created_at":"2024-11-28T21:05:51.637Z","updated_at":"2026-02-20T17:03:09.076Z","avatar_url":"https://github.com/betmig.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Metta Voice ☸️\n\nA modern meditation app combining traditional Buddhist suttas with accessibility-focused features. Built and maintained by [Betmig](https://github.com/betmig) from [MettaBit](https://mettabit.io).\n\n## Features\n\n### 📖 Sutta Reader\n- Authentic Buddhist teachings from dhammatalks.org\n- Natural text-to-speech with synchronized highlighting\n- Smart phrase detection for natural reading flow\n- Random sutta selection from curated collection\n- Auto-scrolling text follows the reading\n- Full mobile support with native voice synthesis\n\n### ⏲️ Meditation Timer\n- Customizable duration with hours, minutes, and seconds\n- Multiple bell sound options:\n  - Tibetan Bowl\n  - Zen Bell\n  - Meditation Bell\n  - Temple Bell\n- Configurable start/end meditation bells\n- Auto-start option after sutta reading\n- Volume control for bell sounds\n\n### 🎯 Accessibility First\n- High contrast theme options (Light/Dark)\n- Adjustable text highlighting\n- Customizable display settings:\n  - Brightness (0-100%)\n  - Contrast (0-100%)\n  - Sepia (0-100%)\n  - Grayscale (0-100%)\n- OpenDyslexic font support\n- Screen reader friendly\n- Responsive design for all devices\n\n### 🗣️ Text-to-Speech Options\n- Browser-native TTS with voice selection\n- Mobile-optimized voice synthesis\n- Multiple TTS providers support:\n  - Browser native TTS\n  - Eleven Labs\n  - OpenAI TTS\n  - Microsoft Azure\n  - Amazon Polly\n  - WellSaid Labs\n\n## Quick Start\n\n```bash\n# Clone the repository\ngit clone https://github.com/betmig/metta-voice.git\n\n# Install dependencies\ncd metta-voice\nnpm install\n\n# Build the project\nnpx vite build\n\n# Start development server\nnpm run dev\n\n# Build for production\nnpm run build\n```\n\n## Retrieve API Keys\n\n- **ElevenLabs:**\n  - Sign up or log in at [elevenlabs.io](https://beta.elevenlabs.io/).\n  - Go to Profile \u003e API Keys to generate or view your key.\n\n- **Amazon Polly:**\n  - Sign into AWS, navigate to IAM \u003e Users \u003e Create User with Polly permissions.\n  - View or create Access Keys for API access.\n\n- **Azure Voice:**\n  - Create a Speech resource in Azure.\n  - Go to Keys and Endpoint to retrieve your API keys.\n\n- **OpenAI Voice:**\n  - Check [openai.com](https://www.openai.com/) for voice API availability.\n  - If available, follow their documentation for key retrieval.\n\n- **WellSaid Voices:**\n  - Sign up or log in at [wellsaidlabs.com](https://wellsaidlabs.com/).\n  - Navigate to Account Settings for your API key.\n\n**Warning:** 🚨 **Do not share your API keys with anyone.** 🚨 Keep them secret and secure.\n\n**Note:** Use environment variables or secure storage methods for key management. Always check the latest documentation for changes in API access or usage guidelines.\n\n## Technology Stack\n\n- React 18 with TypeScript\n- Tailwind CSS for styling\n- Zustand for state management\n- Vite as build tool\n- Web Speech API\n- Multiple TTS provider integrations\n\n## Configuration\n\n### Text-to-Speech\n\n1. Navigate to Settings\n2. Select your preferred TTS provider\n3. Enter API credentials if using premium providers\n4. Choose your preferred voice\n5. Test with preview feature\n\n### Display Settings\n\n- Choose between light/dark theme\n- Adjust brightness, contrast, sepia, and grayscale\n- Customize text highlight color and opacity\n- Changes apply in real-time\n\n### Meditation Settings\n\n- Set custom meditation duration\n- Choose preferred bell sounds\n- Configure bell timing (start/end)\n- Enable/disable auto-start after sutta reading\n\n## Privacy\n\nMetta Voice respects your privacy:\n- All data stored locally in browser storage\n- No analytics or tracking\n- No personal information collected\n- TTS API keys stored securely in local storage\n- No server-side data collection\n\n## License\n\nThis project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). This means:\n\n- You can freely use, modify, and distribute this software\n- Modified versions must:\n  - Use the same license\n  - Make source code available\n  - Preserve copyright notices\n\n## Contributing\n\nWe welcome contributions! Please:\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n## Acknowledgments\n\n- Buddhist texts sourced from dhammatalks.org\n- Bell sounds recorded at various temples\n- Icons provided by Lucide React\n- UI components styled with Tailwind CSS\n- TTS capabilities powered by various providers\n\n## Recent Updates\n\n- Added mobile-optimized voice synthesis\n- Improved text chunking for natural reading\n- Enhanced synchronized highlighting\n- Added auto-scrolling during reading\n- Improved accessibility settings\n- Added support for multiple bell sounds\n- Implemented in-memory sutta database\n\n---\n\nMade with ❤️ by [betmig](https://github.com/betmig)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbetmig%2Fmettavoice","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbetmig%2Fmettavoice","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbetmig%2Fmettavoice/lists"}