Metadata-Version: 2.1
Name: apeek
Version: 0.2.0
Summary: apeek is a package for creating audio waveform previews.
Keywords: waveform,metadata,audio,console
Author-email: Jamie Hardt <jamiehardt@me.com>
Requires-Python: ~=3.8
Description-Content-Type: text/markdown
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Multimedia
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: numpy ~= 2.0
Requires-Dist: pydub ~= 0.25.1
Project-URL: Home, https://github.com/iluvcapra/apeek
Project-URL: Issues, https://github.com/iluvcapra/apeek/issues
Project-URL: Source, https://github.com/iluvcapra/apeek.git

# apeek

![](https://img.shields.io/github/license/iluvcapra/apeek.svg) ![](https://img.shields.io/pypi/pyversions/apeek.svg) [![](https://img.shields.io/pypi/v/apeek.svg)](https://pypi.org/project/apeek/) ![](https://img.shields.io/pypi/wheel/apeek.svg)

`apeek` is a package for creating audio waveform previews.

The library installs a command `apeek` for generating waveform overviews with Unicode 
block characters for display in a terminal.

```sh
$ apeek -l12 -i test/media/hi.wav 
                               ▁                                                                     
                              ▃█▅▂▁                                                                  
                            ▅██████▇▇▅▇▃▄▁                                                           
                          ▃▇██████████████▄ ▄                                                        
             ▂      ▁▁▁▂ ▄█████████████████ █                                                        
            ▆██▆▅▇▇█████▇██████████████████ █                                                        
            ███████████████████████████████ █▆                                                       
           ▄███████████████████████████████ ██▆ ▃                                                    
          ▅████████████████████████████████▇███ █▆ ▃▂                                                
          █████████████████████████████████████▄██ ██ ▆▆ ▄                                           
         ▇████████████████████████████████████████ ██ ██ █▄                                          
        ▁█████████████████████████████████████████▇██▅██▅██ ▆▃ ▁                                     
                           max ↑                                                                     
DUR: 0.60 seconds @ 22050Fs // Peak: -2.39 dBFS at 0.31 secs                                         
```
![Screenshot](docs/apeek.png)


