Metadata-Version: 2.1
Name: uberduck
Version: 0.0.2
Summary: A synchronous and asynchronous API wrapper for the UberDuck text-to-speech service (https://uberduck.ai) with 100% coverage and top-notch utilities.
Home-page: https://github.com/ImNimboss/uberduck
Author: ImNimboss
Author-email: nim@nimboss.me
License: MIT
Project-URL: Documentation, https://github.com/ImNimboss/uberduck/tree/main/Documentation
Project-URL: Issue Tracker, https://github.com/ImNimboss/uberduck/issues
Project-URL: Source, https://github.com/ImNimboss/uberduck
Project-URL: Funding, https://patreon.com/nimboss
Project-URL: API Credits, https://uberduck.ai
Project-URL: Creator, https://nimboss.me
Project-URL: Discord, https://discord.gg/FcxqdJ7AQq
Project-URL: Repository, https://github.com/ImNimboss/uberduck
Keywords: uberduck,wrapper,api,text-to-speech,async,famous,tts,texttospeech,AI,api-wrapper,api-key,api-secret
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Artistic Software
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Internet
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Multimedia :: Sound/Audio :: Players
Classifier: Topic :: Multimedia :: Sound/Audio :: Speech
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.6.0
Description-Content-Type: text/markdown
License-File: LICENSE

<p align="center">
    <img src="https://raw.githubusercontent.com/ImNimboss/uberduck/main/.github/assets/uberduck-logo.png" alt="Uberduck Logo">
</p>

# Uberduck

<a href="https://pypi.org/project/uberduck" target="_blank" rel="noopener noreferrer">
    <img src="https://img.shields.io/pypi/v/uberduck.svg?color=9cf&logo=pypi" alt="PyPI Uberduck version number">
    <img src="https://img.shields.io/pypi/dm/uberduck?color=9cf&logo=pypi" alt="PyPI downloads per month">
    <img src="https://img.shields.io/pypi/pyversions/uberduck.svg?color=9cf&logo=pypi" alt="PyPI supported Python versions">
</a>
<a href="https://github.com/ImNimboss/uberduck/issues" target="_blank" rel="noopener noreferrer">
    <img src="https://img.shields.io/github/issues/ImNimboss/uberduck?color=9cf&logo=github" alt="Number of open GitHub issues">
</a>
<a href="https://github.com/ImNimboss/uberduck/contributors" target="_blank" rel="noopener noreferrer">
    <img src="https://img.shields.io/github/contributors/ImNimboss/uberduck?color=9cf&logo=github" alt="Number of contributors">
</a>
<a href="https://discord.gg/FcxqdJ7AQq" target="_blank" rel="noopener noreferrer">
    <img src="https://img.shields.io/discord/930791886522810399?color=9cf&logo=discord&label=discord" alt="Discord server">
</a>

## Description

A synchronous and asynchronous API wrapper for the [UberDuck](https://uberduck.ai) text-to-speech service with 100% coverage and top-notch utilities.

## Main features

- [x] - Synchronous support
- [x] - Asynchronous support
- [x] - Object-oriented
- [x] - Easy to use
- [x] - Utilities like file-saving, audio-playing etc. packed all in one
- [x] - Very adjustable/configurable
- [x] - Regularly maintained
- [x] - Makes the hard tasks of polling and asynchronous operations easy

## Links

* [Documentation](https://github.com/ImNimboss/uberduck/tree/main/Documentation)
* [PyPI](https://pypi.org/project/uberduck)
* [Issue Tracking](https://github.com/ImNimboss/uberduck/issues)
* [Discord server](https://discord.gg/FcxqdJ7AQq)
* [Uberduck main site](https://uberduck.ai)


## Installation and upgrades

```
pip install uberduck
```
for the stable version (recommended).

```
pip install -U uberduck
```
to update your stable version.

```
pip install git+https://github.com/ImNimboss/uberduck
```
to install it straight off of GitHub (you need git installed for this).

```
pip install -U git+https://github.com/ImNimboss/uberduck
```
to upgrade your version that you got from GitHub.

## How to use

Check [Documentation/Basics.md](https://github.com/ImNimboss/uberduck/blob/master/Documentation/Basics.md).

## Examples

Check [Documentation/Examples.md](https://github.com/ImNimboss/uberduck/blob/master/Documentation/Examples.md).

## Some credits

The idea to implement logging in this library came from [discord.py](https://github.com/Rapptz/discord.py).

The idea to use the `polling` library came from [CupOfGeo/UberDuckAPI](https://github.com/CupOfGeo/UberDuckAPI), another uberduck.ai API wrapper.

## Changelog

* `v0.0.1` - Initial release.
* `v0.0.2` - Fixed `get_voices()` and `get_voices_async()` by updating the `Voice` class to be compatible with the new voice data available from the API.

