zenix 0.7

Zenix: A Lightweight Tool for Procedural Noise Generation

Zenix: A Lightweight Tool for Procedural Noise Generation

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

Code Quality

Installation

Source Code

• Download Version 0.7 or Latest Source
• pip install .

PyPI

• Check Python Packaging User Guide
• pip install zenix==0.7

Usage

CLI

zenix --type=white --duration=120 --volume=0.25 --fade-in=2 --fade-out=3 --sample-rate=44000 --loop --output=noise.wav

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
--fade-out	Fade-out duration in seconds	2
--sample-rate	Audio sample rate in Hz	44100
--loop	Enable continuous looping playback	False
--output	Save generated noise to WAV file	None

Library

Generate Noise

Generate procedural noise as a PCM int16 NumPy array.

from zenix import generate_noise, play_noise, save_noise, NoiseType
audio = generate_noise(
        noise_type=NoiseType.WHITE,
        duration=120,
        sample_rate=44000,
        volume=0.25,
        fade_in=2,
		fade_out=2
    )

Parameter	Type	Description	Default
noise_type	NoiseType	Noise type	NoiseType.WHITE
duration	float	Duration of generated noise in seconds	30
sample_rate	int	Audio sample rate in Hz	44100
volume	float	Output volume multiplier	0.3
fade_in	float	Fade-in duration in seconds	2
fade_out	float	Fade-out duration in seconds	2

Play Noise

Play generated noise directly from memory.

from zenix import generate_noise, play_noise

audio = generate_noise(duration=30)

play_noise(
    audio=audio,
    sample_rate=44100,
    loop=False
)

Parameter	Type	Description	Default
audio	numpy.ndarray	PCM mono audio buffer (int16)	Required
sample_rate	int	Audio sample rate in Hz	44100
loop	bool	Enable continuous looping playback	False

Save Noise

Save generated noise to a WAV file.

from zenix import generate_noise, save_noise

audio = generate_noise(duration=60)

save_noise(
    filepath="noise.wav",
    audio=audio,
    sample_rate=44100
)

Parameter	Type	Description	Default
filepath	str	Output WAV file path	Required
audio	numpy.ndarray	PCM mono audio buffer (int16)	Required
sample_rate	int	Audio sample rate in Hz	44100

Noise Object

The Noise class provides an object-oriented interface for generating, playing, and saving procedural noise.

from zenix import Noise, NoiseType

noise = Noise(
    noise_type=NoiseType.PINK,
    duration=120,
    sample_rate=44100,
    volume=0.25,
    fade_in=2,
    fade_out=2
)

noise.play()
noise.save("noise.wav")

Parameter	Type	Description	Default
noise_type	NoiseType	Noise type	NoiseType.WHITE
duration	float	Duration of generated noise in seconds	30
sample_rate	int	Audio sample rate in Hz	44100
volume	float	Output volume multiplier	0.3
fade_in	float	Fade-in duration in seconds	2
fade_out	float	Fade-out duration in seconds	2

The generated audio can be accessed through the audio property, which automatically generates the noise on first access and returns a PCM int16 NumPy array.

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

1KtNLEEeUbTEK9PdN6Ya3ZAKXaqoKUuxCy

Ethereum

0xcD4Db18B6664A9662123D4307B074aE968535388

Litecoin

Ldnz5gMcEeV8BAdsyf8FstWDC6uyYR6pgZ

Doge

DDUnKpFQbBqLpFVZ9DfuVysBdr249HxVDh

Tron

TCZxzPZLcJHr2qR3uPUB1tXB6L3FDSSAx7

Ripple

rN7ZuRG7HDGHR5nof8nu5LrsbmSB61V1qq

Binance Coin

bnb1zglwcf0ac3d0s2f6ck5kgwvcru4tlctt4p5qef

Tether

0xcD4Db18B6664A9662123D4307B074aE968535388

Dash

Xd3Yn2qZJ7VE8nbKw2fS98aLxR5M6WUU3s

Stellar

GALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNL

Zilliqa

zil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5

Coffeete

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.7 - 2026-06-13

Added

• Noise class

Changed

• Test system modified
• Dependencies structure modified
• README.md updated

0.6 - 2026-05-25

Added

• Blue noise
• ZenixError class
• ZenixValidationError class

Changed

• Error messages updated
• Test system modified
• README.md updated

0.5 - 2026-05-05

Added

• save_noise function
• --output argument

Changed

• Validation system modified
• Test system modified
• README.md updated

0.4 - 2026-04-26

Added

• fade_out parameter
• --fade-out argument

Changed

• README.md updated
• Test system modified

0.3 - 2026-04-21

Added

• Input validation
• Logo

Changed

• Test system modified

0.2 - 2026-04-13

Added

• --sample-rate argument

Changed

• README.md updated
• Test system modified

0.1 - 2026-04-03

Added

• generate_noise function
• play_noise function
• White noise
• Pink noise
• Brown noise