Metadata-Version: 2.1
Name: mw
Version: 0.3.0
Summary: mw is an audio sample editor for the terminal.
Keywords: waveform,metadata,audio,console
Author-email: Jamie Hardt <jamiehardt@me.com>
Requires-Python: ~=3.8
Description-Content-Type: text/markdown
Classifier: Topic :: Multimedia
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: numpy ~= 1.24.3
Requires-Dist: parsimonious ~= 0.10.0
Requires-Dist: pydub ~= 0.25.1
Requires-Dist: apeek ~= 0.1.0
Requires-Dist: gnureadline ~= 8.1.2
Requires-Dist: sphinx >= 5.3.0 ; extra == "doc"
Requires-Dist: sphinx_rtd_theme >= 1.1.1 ; extra == "doc"
Project-URL: Home, https://github.com/iluvcapra/mw
Project-URL: Issues, https://github.com/iluvcapra/mw/issues
Project-URL: Source, https://github.com/iluvcapra/mw.git
Provides-Extra: doc

![](https://img.shields.io/github/license/iluvcapra/mw.svg) ![](https://img.shields.io/pypi/pyversions/mw.svg) [![](https://img.shields.io/pypi/v/mw.svg)](https://pypi.org/project/mw/) ![](https://img.shields.io/pypi/wheel/mw.svg)
[![Lint and Test](https://github.com/iluvcapra/mw/actions/workflows/python-package.yml/badge.svg)](https://github.com/iluvcapra/mw/actions/workflows/python-package.yml)

# mw

`mw` is an interactive, text-mode audio sample editor. Audio files provided as arguments
on the command line can be inspected, edited, mixed and exported.

If you're ever in a terminal/tmux session and just wanted to get a look at and maybe edit 
a sound file without having to open a window, this is a tool for you!

# How to Use

Run `mw` from the command line with audio files as arguments. `mw` uses the pydub package
to read audio and supports any file format ffmpeg does.

```sh 
$ mw my_voice.wav robot_sounds.wav
```

File arguments are added to an internal stack and `mw` will present a command prompt. Some
commands `mw` supports include: _fadein, fadeout, silence, crop, bloop, split, bounce,_ and
_export_.

For a complete list of commands, enter _help_ at the prompt or read `mw`'s manpage.

# Screenshot

![Screenshot of an editing session](https://github.com/iluvcapra/mw/raw/master/docs/mw.png)


