KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

obsidian-edge-tts

★ 314 Open GitHub ↗

Free, high quality text-to-speech for your Obsidian notes, leveraging Microsoft Edge's Read Aloud API.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

> [!IMPORTANT]
> Microsoft has been inconsistent in their servers allowing for the work-around we use to get free text-to-speech starting around December 17th, 2025
>
> If you're reading this, it's possible the servers are down again. Please know that it's very likely I'm already aware.
>
> I will update here should we end up in a situation where we know whether or not these periods of downtime are the shape of things to come or just a blip.
>
> https://github.com/travisvn/obsidian-edge-tts/issues/92#issuecomment-3673821661

# Obsidian Edge TTS Plugin 🗣️

<h1 align="center">Free high-quality text-to-speech (narration) in Obsidian</h1>

## Overview

The **Obsidian Edge TTS Plugin** is a community plugin for [Obsidian](https://obsidian.md/) that allows you to read your notes aloud using Microsoft's Edge TTS API. It supports a variety of voices and locales, making it an excellent tool for users who want to listen to their notes while multitasking or to improve accessibility.

## Features

-   **🔥 NEW: Native Mobile Support** - Now works on both Obsidian Desktop and Obsidian Mobile (iOS/Android)
-   Read selected text or entire notes aloud
-   Choose from a list of top voices or specify a custom voice
-   Adjust playback speed of voice over
-   Toggle optional notices for playback status
-   Option to generate mp3 file and embed it directly in note
-   **Playback queue**: Add multiple notes to a queue for continuous playback with loop and auto-scroll options
-   Listen to voice samples before selecting a voice (via [tts.travisvn.com](https://tts.travisvn.com))

## Installation

[Install Obsidian plugin](https://tts.travisvn.com/obsidian)

1. Open Obsidian
2. Go to **Settings** → **Community Plugins**
3. Search for **Edge TTS**
4. Click **Install** and then **Enable**

Alternatively, you can manually download the latest release from [GitHub Releases](https://github.com/travisvn/obsidian-edge-tts/releases)

## Usage

-   Open the note you want to read aloud (or select the text)
-   Use the **Read note aloud** command from the command palette
    -   _or_ Click the ribbon icon (if enabled)
    -   _or_ Playback button in the status bar — this both starts a narration and then allows you to pause or resume once it's started
    -   _or_ Right-click on a file and select `Read note aloud`
-   Right-click on a file and select `Add to playback queue` to queue multiple notes for continuous playback
-   Right-click on a file and select `Generate MP3` to save the narration to an mp3 and embed it in the note (if enabled).
-   Use the **Show floating playback controls** command from the command palette to open the player if it has been closed. This command is idempotent, meaning if the player is already open, it won't do anything.
-   Use the **Reset floating player position** command to move the player back to its default bottom-right screen position.

## Settings

To access the plugin settings:

1. Go to **Settings** → **Community Plugins** → **Edge TTS**.
2. Configure the following options:

- **Select voice**: Choose from a list of top voices.
    - **Custom voice**: Manually enter a custom voice.
    - **Playback speed**: Adjust playback speed multiplier.
    - **Show notices**: Toggle notices for playback status and errors.
    - **Show status bar button**: Toggle playback button in status bar.
    - **Disable floating playback controls**: Hides the floating player during audio playback. If you close the player using the 'X' button, you can reopen it using the "Show floating playback controls" command.
    - **Enable replay option**: Keeps the playback controls open after audio finishes to allow replaying.
    - **Enable queue feature**: Toggle the playback queue functionality for continuous playback of multiple notes.
    - **Generate MP3**: Toggle settings related to the `Generate MP3` menu option.
    - **Voice Samples**: Visit [tts.travisvn.com](https://tts.travisvn.com) to sample available voices.

![Obsidian Edge TTS Plugin Settings Screenshot](https://xx95vnikv6.ufs.sh/f/MMMHiQ1TQaBocgGqdi5Yrp8QZkBUquOFL65GVCWh4za1Ij2l)

<h1 align="center">If you like this project, please <a href="https://github.com/travisvn/obsidian-edge-tts" target="_blank">give it a star on GitHub</a> ⭐️</h1>

## ✨ _New_ Mobile Option 📱

Create audio narration for your Obsidian notes through our free mobile app

-   Available on **iOS** and **Android**
-   Usage:
    -   Use the "share" functionality on any given note
    -   Select `Read Aloud AI` from the native mobile share menu
    -   Your markdown will be imported from the shared file and formatted like in the Obsidian desktop plugin
    -   Narration will playback instantly, and you can export the `.mp3` generated back into Obsidian

obsidian-edge-tts

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README