Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nstechbytes/advanced-voice

**Advanced Voice** is a Chrome extension designed to convert selected text on web pages into spoken audio. It offers a range of features to customize the reading experience, including voice settings, playback controls, and a dark mode for improved usability.
https://github.com/nstechbytes/advanced-voice

chrome chrome-extension css extension html js voice

Last synced: 17 days ago
JSON representation

Host: GitHub
URL: https://github.com/nstechbytes/advanced-voice
Owner: NSTechBytes
License: apache-2.0
Created: 2024-10-13T04:24:36.000Z (about 1 month ago)
Default Branch: main
Last Pushed: 2024-10-13T04:38:12.000Z (about 1 month ago)
Last Synced: 2024-10-29T14:49:26.086Z (18 days ago)
Topics: chrome, chrome-extension, css, extension, html, js, voice
Language: JavaScript
Homepage:
Size: 30.3 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# Advanced Voice Chrome Extension

## Features

- **Read Selected Text**: Converts highlighted text on any web page into spoken audio with a simple right-click.
- **Voice Customization**: Choose from various voices, including different accents and genders. Adjust the speed of speech for optimal listening.
- **Playback Controls**: Pause, resume, and adjust playback speed using intuitive controls.
- **Save Audio**: Save the generated audio file to your local storage for offline access or sharing.
- **Dark Mode**: Switch between light and dark themes for the extension popup to match your preferences.

## 📸 Screenshots

![Extension Preview Light Mode]
*Light mode view with media controls.*![Light](https://github.com/NSTechBytes/Projects-Templates/blob/main/Extensions/Advanced%20Voice/Light.png)

![Extension Preview Dark Mode]
*Dark mode view with media controls.*![Dark](https://github.com/NSTechBytes/Projects-Templates/blob/main/Extensions/Advanced%20Voice/Dark.png)

### Manual Installation

1. **Download the Extension**: Get the latest version from the [GitHub repository](https://github.com/NSTechBytes/Advanced-Voice) (replace with your actual repository link).
2. **Open Chrome** and go to `chrome://extensions/`.
3. **Enable Developer Mode**: Toggle the switch at the top right to enable Developer mode.
4. **Load Unpacked Extension**:
- Click **Load unpacked**.
- Select the directory where you downloaded the extension files.

## Usage

1. **Highlight Text**: Select the text on any web page that you want to be read aloud.
2. **Right-Click**: With the text selected, right-click to open the context menu.
3. **Select "Read Aloud"**: Choose **Read Aloud** from the context menu to start the speech synthesis.

### Using the Extension Popup

- **Open the Popup**: Click on the extension icon in the Chrome toolbar to open the popup.
- **Voice Settings**: Use the dropdown menus and sliders to select the desired voice and adjust the speech speed.
- **Playback Controls**: Use the buttons to pause, resume, and adjust the playback speed.
- **Toggle Dark Mode**: Click the moon icon in the top right to switch between light and dark modes.

## Configuration

### Dark Mode

To enable or disable dark mode:

1. Open the extension popup.
2. Click on the **dark mode toggle** button (moon icon) to switch themes.

### Voice and Speed Settings

1. Open the extension popup.
2. Use the dropdown menus to select your preferred voice.
3. Adjust the speech speed using the slider provided.

## Development

To contribute to the development of Advanced Voice:

1. **Clone the Repository**:
```bash
git clone https://github.com/NSTechBytes/Advanced-Voice.git
```
2. **Navigate to the Project Directory**:
```bash
cd advanced-voice
```
3. **Install Dependencies** (if applicable):
```bash
npm install
```
4. **Make Your Changes**: Implement features or fix bugs as needed.
5. **Test Your Changes**: Ensure that your changes work as expected by loading the extension locally.
6. **Submit a Pull Request**:
- Push your changes to your forked repository.
- Open a pull request on the original repository to merge your changes.

### Running Locally

1. Load the unpacked extension from the `advanced-voice` directory via `chrome://extensions/` in Developer mode.
2. Test your modifications and ensure functionality.

## Contributing

We welcome contributions to Advanced Voice. Please follow these guidelines:

1. **Fork the Repository**: Create your own fork of the repository on GitHub.
2. **Create a Branch**: Develop features or fixes in a new branch based on the main branch.
```bash
git checkout -b feature/your-feature-name
```
3. **Write Tests**: Include tests for your changes if applicable.
4. **Submit a Pull Request**: Provide a clear description of your changes and the problem they solve.

### Code of Conduct

Please adhere to our [Code of Conduct](CODE_OF_CONDUCT.md) when participating in the project.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

## Contact

For any questions, feedback, or issues:

- **GitHub Issues**: [Open an issue](https://github.com/NSTechBytes/Advanced-Voice/issues) on our GitHub repository.
- **Email**: [email protected]

## Acknowledgments

- **Font Awesome**: For providing the icons used in the extension.
- **Chrome Developer Documentation**: For valuable guidance on developing Chrome extensions.
- **Special Thanks**: To contributors and users who help improve the extension.

---

### **Additional Sections You Might Include:**

- **Changelog**: Document updates and changes in a `CHANGELOG.md` file.
- **Screenshots or GIFs**: Add visual examples of the extension’s interface and functionality.
- **FAQ**: Address common questions or issues users might encounter.