Metadata-Version: 2.1
Name: afplay-py
Version: 0.2.1
Summary: A wrapper around macOS afplay
Home-page: https://github.com/unparalleled-js/afplay-py
Author: Juliya Smith <juliya@juliyasmith.com>
Author-email: juliya@juliyasmith.com
License: Apache-2.0
Keywords: afplay,macos
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 :: MacOS
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Requires-Python: >=3.9,<4
Description-Content-Type: text/markdown
Provides-Extra: test
Provides-Extra: lint
Provides-Extra: doc
Provides-Extra: release
Provides-Extra: vlc
Provides-Extra: dev
License-File: LICENSE

# afplay-py

A python wrapper and better CLI for the macOS tool `afplay` (audio-file player).

## Installation

From pip:

```shell
pip install afplay-py
```

From source (from the root project directory):

```shell
pip install .
```

## Quick Usage

### CLI

Play an audio file using the CLI:

```sh
afplay-py ~/path/to/file.mp3
```

**NOTE**: The intent is for this CLI to not have some of the problems the regular tool does.

### Python

Play an audio file using Python:

```python
from afplay import afplay

afplay("path/to/file.mp3", volume=2, time=100, leaks=True)
```

Check if `afplay` is installed:

```python
from afplay import is_installed

print(is_installed())
```


