Zenix: A Lightweight Tool for Procedural Noise Generation
Project description
Overview
Zenix is a lightweight tool for generating procedural noise such as white, pink, and brown noise. It can be used both as a command-line application and as a Python library, making it suitable for quick terminal usage as well as integration into Python projects. Zenix generates noise programmatically using NumPy and plays it through an audio backend, allowing developers to create continuous background sound for focus, concentration, relaxation, or acoustic masking. With support for multiple noise types, configurable parameters, fade-in effects, and looping playback, Zenix provides a simple yet flexible way to work with procedural noise in both interactive and programmatic environments.
| PyPI Counter | |
| Github Stars |
| Branch | main | dev |
| CI |
Installation
Source Code
- Download Version 0.1 or Latest Source
pip install .
PyPI
- Check Python Packaging User Guide
pip install zenix==0.1
Usage
CLI
zenix --type=white --duration=120 --volume=0.25 --fade-in=2 --loop
Arguments
| Argument | Description | Default |
|---|---|---|
--type |
Noise type | white |
--duration |
Duration of generated noise in seconds | 30 |
--volume |
Output volume multiplier | 0.3 |
--fade-in |
Fade-in duration in seconds | 2 |
--loop |
Enable continuous looping playback | False |
Library
from zenix import generate_noise, play_noise, NoiseType
audio = generate_noise(
noise_type=NoiseType.WHITE,
duration=120,
sample_rate=44000,
volume=0.25,
fade_in=2,
)
play_noise(audio=audio, sample_rate=44000, loop=True)
Parameters
| Parameter | Description | Default |
|---|---|---|
noise_type |
Noise type | NoiseType.WHITE |
duration |
Duration of generated noise in seconds | 30 |
sample_rate |
Audio sample rate in Hz | 44100 |
volume |
Output volume multiplier | 0.3 |
fade_in |
Fade-in duration in seconds | 2 |
Issues & Bug Reports
Just fill an issue and describe it. We'll check it ASAP!
- Please complete the issue template
Show Your Support
Star This Repo
Give a ⭐️ if this project helped you!
Donate to Our Project
Bitcoin
1KtNLEEeUbTEK9PdN6Ya3ZAKXaqoKUuxCyEthereum
0xcD4Db18B6664A9662123D4307B074aE968535388Litecoin
Ldnz5gMcEeV8BAdsyf8FstWDC6uyYR6pgZDoge
DDUnKpFQbBqLpFVZ9DfuVysBdr249HxVDhTron
TCZxzPZLcJHr2qR3uPUB1tXB6L3FDSSAx7Ripple
rN7ZuRG7HDGHR5nof8nu5LrsbmSB61V1qqBinance Coin
bnb1zglwcf0ac3d0s2f6ck5kgwvcru4tlctt4p5qefTether
0xcD4Db18B6664A9662123D4307B074aE968535388Dash
Xd3Yn2qZJ7VE8nbKw2fS98aLxR5M6WUU3sStellar
GALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNLZilliqa
zil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5Coffeete
Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning.
Unreleased
0.1 - 2026-04-03
Added
generate_noisefunctionplay_noisefunction- White noise
- Pink noise
- Brown noise
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file zenix-0.1.tar.gz.
File metadata
- Download URL: zenix-0.1.tar.gz
- Upload date:
- Size: 9.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3542ca477e07296b8e1bcfcbf404a6d269a65888d33bb1076f061b53b7407ca4
|
|
| MD5 |
33d561a79a671745a7a18b65ca3929bf
|
|
| BLAKE2b-256 |
70d0973c8a8698aa3a11e934d870a9ecd28c61447ec2883c157091c0c08a6f41
|
File details
Details for the file zenix-0.1-py3-none-any.whl.
File metadata
- Download URL: zenix-0.1-py3-none-any.whl
- Upload date:
- Size: 8.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8ceb0347c4b492185d4a3e14c40260aa80801e3ed73390a1db001138383ff612
|
|
| MD5 |
5da7a66fbd411875ee28351458404621
|
|
| BLAKE2b-256 |
d8b874bb938c4b3e24e0a461160ddcaa4bb5fb98572efa2b0fa521101e17cb76
|