Skip to content

wsamuelw/mimo-reader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MiMo TTS Reader

A web-based text-to-speech app powered by MiMo TTS. Design custom voices, clone any voice, and generate natural speech — all in your browser.

mimo-tts-reader-video-demo.mov

Live Demo →

I'm using MiMo Open Platform — Xiaomi's most powerful AI (MiMo V2.5 etc). Sign up with my invite code: both get $2 API credits + 10% off your first plan.

Invite code: RRJPZE Sign up → (Auto-filled on sign-up · Credits valid for 40 days)

MiMo Invite Code

Use Cases

  • Podcast Production — Generate voiceovers for intros, outros, and ad reads. Choose from 100 voices or clone your own.
  • Marketing Content — Create voiceovers for social media videos, ads, and presentations. Match your brand voice with custom descriptions.
  • Accessibility — Listen to any text read aloud. Useful for dyslexia, visual impairments, or audio-first learning.
  • E-Learning — Narrate training materials, courses, and tutorials with consistent, professional voices.
  • Content Localization — Generate voiceovers in different accents (Australian, British, French, Japanese) for international audiences.

Features

  • 100 preset voices across 6 categories (Conversational, Professional, Expressive, Youthful, Character, Accent)
  • Voice cloning from audio file or microphone recording
  • Voice design with editable descriptions for fine-tuned control
  • Dark/light theme with system preference detection
  • Download as WAV or MP3 for any project
  • Non-interrupting generation — keep listening while generating new audio
  • Responsive design — works on desktop and mobile
  • Keyboard shortcuts⌘+Enter to generate

Getting Started

  1. Get an API key from MiMo TTS
  2. Open the app at wsamuelw.github.io/mimo-reader
  3. Add your API key in Settings (top-right corner)
  4. Enter text, pick a voice, and hit Generate

Usage

Voice Design

  1. Select Voice Design mode
  2. Choose a voice from the list (or use the search/filter)
  3. Type or paste your text
  4. Click Generate or press ⌘+Enter
  5. Download as WAV or MP3

Voice Clone

  1. Select Voice Clone mode
  2. Upload an audio file or record directly
  3. Type or paste your text
  4. Click Generate
  5. Download the cloned voice output

Voice Preview

  • Click the play icon on any voice to hear a sample
  • Edit the voice description to fine-tune tone, accent, or pace
  • Use the Random button to generate new voice descriptions

API Reference

The app uses the MiMo TTS API with the following models:

Model Use Case
mimo-v2.5-tts-voicedesign Custom voices via description
mimo-v2.5-tts-voiceclone Voice cloning from audio sample
mimo-v2.5-tts Preset voices with dialect tags

Endpoints

Region URL
Singapore https://token-plan-sgp.xiaomimimo.com/v1/chat/completions
China https://token-plan-cn.xiaomimimo.com/v1/chat/completions
Standard https://api.xiaomimimo.com/v1/chat/completions

Tech Stack

  • Frontend: Vanilla HTML, CSS, JavaScript (single-file app)
  • API: MiMo TTS v2.5 (OpenAI-compatible endpoint)
  • Audio: Web Audio API for processing, lamejs for MP3 conversion
  • Fonts: JetBrains Mono

Browser Support

  • Chrome 90+
  • Firefox 88+
  • Safari 14+
  • Edge 90+

Keyboard Shortcuts

Shortcut Action
⌘+Enter Generate speech
Escape Cancel generation
Space Play/pause audio

Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is open source and available under the MIT License.

Acknowledgments

About

Design custom voices, clone any voice from audio, and generate natural speech — all in your browser. 100+ presets across 6 categories. Export WAV/MP3. Great for podcasts, e-learning, and marketing content.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages