Natural Readers audio uploader

About

# Natural Readers Narration Uploader – Chrome Extension

This Chrome extension automatically uploads narration text into NaturalReaders.com and assigns voices to each narration entry. It is designed to speed up workflow for users who work with many narrations and want to automate repetitive tasks.

## ⭐ Features

- Upload a `.txt` file containing narration blocks (“Narration 4A”, “Optional Narration 4b”, etc.)
- Parses narrations into a structured format:
  - Supports lettered variations (A, B, C…)
  - Supports optional narrations
  - Handles narrations without letters
- Automatically inserts narration text into NaturalReaders text fields
- Assigns a voice to all narrations belonging to the same number (e.g., all “4a”, “4b” use the same voice)
- Optional **auto-download** of generated audio files
- Works only on **NaturalReaders.com**, preventing mis-clicks on other sites

## 📂 How It Works

1. Click the upload area or drag-and-drop a `.txt` file.
2. The extension reads the file but does not send it until you click **Start**.
3. After clicking **Start**, the extension sends the parsed narrations to the background script.
4. The content script:
   - Creates text blocks in NaturalReaders
   - Fills in narration text
   - Applies the correct voice pattern
5. (Optional) Automatically triggers audio file downloads.

## 📄 File Format Requirements

Your `.txt` file must contain narration sections in this format:
Narration 4a
Your text here...

Optional Narration 4a
Optional text...

Narration 10
Another narration without a letter

- “Optional Narration” is supported.
- Letters (`a`, `b`, `c`…) are grouped under the same narration number.
- Narrations without a letter are treated as `text` under that number.

## 🛠 Installation (Developer Mode)

1. Download or clone the extension folder.
2. Go to **chrome://extensions/**
3. Enable **Developer Mode** (top right).
4. Click **Load unpacked**.
5. Select your extension folder.

## ⚠ Notes

- Only works on **NaturalReaders.com**
- You must upload a `.txt` before clicking **Start**
- Your file is processed **locally**, never uploaded