Metadata-Version: 2.1
Name: fuzzy-muffler
Version: 0.0.4
Summary: mp3|ogg|wav audio muffler/fuzifier
Home-page: https://github.com/hashirkz/muffle_audio
Author: hashirkz
Author-email: hashir.khan@mail.mcgill.ca
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: POSIX
Description-Content-Type: text/markdown

# about
audio / music muffler/fuzzifier for     
- \*.mp3  
- \*.wav  
- \*.ogg  

## install
```bash
pip install fuzzy-muffler
sudo apt install rubberband-cli

# now you can use the muffle command
usage: muffle [-h] (-f FILE | -r READ_DIR) [-d DEST]

optional arguments:
  -h, --help            show this help message and exit
  -f FILE, --file FILE
  -r READ_DIR, --read-dir READ_DIR
  -d DEST, --dest DEST
```

### ex. usage
```bash
>> muffle -r "audios" -d "muffled2"

2023-12-30 01:59:43,431|INFO           |reading: fuzzywave_A faint signal.mp3
2023-12-30 01:59:43,431|INFO           |writing: fuzzywave_A faint signal.mp3
2023-12-30 01:59:50,859|INFO           |reading: fuzzywave_a l e x - zelda's lullaby (slowed).mp3
2023-12-30 01:59:50,860|INFO           |writing: fuzzywave_a l e x - zelda's lullaby (slowed).mp3
2023-12-30 02:00:03,949|INFO           |reading: fuzzywave_MISOGI - Clairvoyant Slowed Down.mp3
2023-12-30 02:00:03,949|INFO           |writing: fuzzywave_MISOGI - Clairvoyant Slowed Down.mp3
2023-12-30 02:00:22,382|INFO           |reading: fuzzywave_OMORI OST - 004 Spaces In - Between.mp3
2023-12-30 02:00:22,382|INFO           |writing: fuzzywave_OMORI OST - 004 Spaces In - Between.mp3
2023-12-30 02:00:25,925|INFO           |reading: lovefool_miku_looped.mp3
2023-12-30 02:00:25,925|INFO           |writing: lovefool_miku_looped.mp3
2023-12-30 02:00:38,322|INFO           |reading: okay_poorstacy.mp3
2023-12-30 02:00:38,323|INFO           |writing: okay_poorstacy.mp3
```

### options  
| rec | flag             | description                                                         |
| --- | ---------------- | ------------------------------------------------------------------- |
| !   | -f, --file       | filename to muffle                                                  |
| !   | -r, --read_dir   | directory to muffle all audio files                                 |
| ?   | -d, --dest       | destination file/directory name if filename **must end with .mp3**  |


### conf.yml
feel free to play around with these values to see what works best for you  

hz      : butterworth lowpass filter cutoff frequency   
roll    : strength of lowpass filter  
tones   : non time stretching pitching **tones < 0 pitch down**   
rate    : slowing factor rate < 1 slows  
