|
|
||
|---|---|---|
| src | ||
| .editorconfig | ||
| .gitignore | ||
| .npmrc | ||
| LICENSE | ||
| README.md | ||
| README_EN.md | ||
| esbuild.config.mjs | ||
| eslint.config.mts | ||
| manifest.json | ||
| package-lock.json | ||
| package.json | ||
| styles.css | ||
| tsconfig.json | ||
| version-bump.mjs | ||
| versions.json | ||
README_EN.md
Obsidian TTS
中文|English Convert Obsidian note content to speech with MiniMax and Xiaomi MiMo TTS engines.
Features
TTS Engines
| Engine | Models | Voices | Special Features |
|---|---|---|---|
| MiniMax | speech-2.8-hd / 2.8-turbo / 2.6-hd / 2.6-turbo | 10 preset voices + custom cloned voices | Emotion control (9 types), pitch, volume |
| Xiaomi MiMo | mimo-v2-tts | 3 preset voices | Style control (dialects, emotions — 10 styles) |
Playback Controls
- Read selected text / read entire document
- Play, pause, stop, seek
- Draggable floating player with progress bar and time display
- Status bar quick-access button
- Automatic segmentation for long texts
Audio Export
- Export as MP3 files saved to vault
- Insert
![[audio.mp3]]embeds directly into notes - Custom export directory and filename format (supports
noteName,timestampvariables)
Text Processing
- Automatically skips code blocks, LaTeX formulas, HTML tags
- Markdown markup cleanup
- Smart segmentation (by paragraph, sentence, character count)
MiniMax Voice Cloning
- Upload a 10-second to 5-minute audio file to clone a voice
- Cloned voices appear automatically in the voice selector
- Support for deleting cloned voices
Context Menu
Right-click in the editor for quick access to:
- TTS: Read Selected Text
- TTS: Read Entire Document
- TTS: Insert Audio into Note
Installation
- Enable community plugins in Obsidian settings
- Search for Obsidian TTS and install
- Or manually: copy
main.js,manifest.json, andstyles.cssto.obsidian/plugins/obsidian-tts-plugin/
Configuration
MiniMax
- Get an API Key from the MiniMax Platform
- Enter the API Key in plugin settings
- Select model, voice, speed, and other parameters
Xiaomi MiMo
- Get an API key from the Xiaomi MIMO
- Select "Xiaomi TTS" as the engine in plugin settings
- Enter the API Key and Base URL
- Select voice and style
Commands
Available via the command palette (Ctrl/Cmd + P):
| Command | Description |
|---|---|
| Read Selected Text | Read currently selected text |
| Read Entire Document | Read the full note content |
| Play / Pause | Toggle playback |
| Stop | Stop current playback |
| Toggle Floating Player | Show/hide the player panel |
| Export Audio | Generate audio and save to vault |
| Insert Audio into Note | Generate audio and insert embed into note |