Skip to main content

Zenix: A Lightweight Tool for Procedural Noise Generation

Project description

Zenix: A Lightweight Tool for Procedural Noise Generation


built with Python3 GitHub repo size PyPI version

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

PyPI

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

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.1 - 2026-04-03

Added

  • generate_noise function
  • play_noise function
  • 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

zenix-0.1.tar.gz (9.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

zenix-0.1-py3-none-any.whl (8.2 kB view details)

Uploaded Python 3

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

Hashes for zenix-0.1.tar.gz
Algorithm Hash digest
SHA256 3542ca477e07296b8e1bcfcbf404a6d269a65888d33bb1076f061b53b7407ca4
MD5 33d561a79a671745a7a18b65ca3929bf
BLAKE2b-256 70d0973c8a8698aa3a11e934d870a9ecd28c61447ec2883c157091c0c08a6f41

See more details on using hashes here.

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

Hashes for zenix-0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8ceb0347c4b492185d4a3e14c40260aa80801e3ed73390a1db001138383ff612
MD5 5da7a66fbd411875ee28351458404621
BLAKE2b-256 d8b874bb938c4b3e24e0a461160ddcaa4bb5fb98572efa2b0fa521101e17cb76

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page