Skip to main content

Ambience

Ambient soundscape player

This is a python cli program that plays audio files, looping them for a specified duration and fading between them.

It reads a directory for .ogg, .wav or .flac files. The program comes with a set of files, but can be used with any files on your computer of the supported types by using the --path parameter when invoking.

Installation with pip

pip install ambience

ambience --fetch-library

Manual Installation

  • Requires python3
  • Requires pygame

Clone this repository.

Run pip3 install --user -r requirements.txt to install pygame if not already installed

Recommended: link ambience in a directory on your path. E.g. ln -s ambience.py ~/bin/ambience

Alternate install for pygame (compile pygame from source)

To install pygame from scratch instead of using pip, you can use the following commands (assuming linux):

 # Clone source repo
sudo apt install mercurial
hg clone https://bitbucket.org/pygame/pygame
cd pygame

sudo apt install libsdl-dev libsdl-image1.2-dev libsdl-mixer1.2-dev libsdl-ttf2.0-dev libsmpeg-dev libportmidi-dev libavformat-dev libswscale-dev

python3 setup.py build
sudo python3 setup.py install

Usage

To run with the default settings, simply run ambience. Use "ctrl-c" to stop.

Hello from the pygame community. https://www.pygame.org/contribute.html
usage: ambience [-h] [-d DURATION] [-f] [-i] [-n] [-p PATH] [-q] [-v] [paths ...]

positional arguments:
  paths                 load given sound file(s) or path(s)

options:
  -h, --help            show this help message and exit
  -d DURATION, --duration DURATION
                        set the duration in minutes each sound will play: default=5
  -f, --fetch-library   fetch the sound library from internet
  -i, --noinit          do not pre-initialize all sounds at start
  -n, --noinput         disable the stdin input capture
  -p PATH, --path PATH  set the path where the sound files are
  -q, --quiet           produce no output
  -v, --version         show version and exit

If invoked without the -n parameter, press 'n' to skip to next sound and 'q' to quit.

The default sounds used are in the install directory (wherever you cloned/downloaded this repo) in the sub-directory sounds.

Sound credits

Credit goes to the following for the sound files included in this package:

Metadata

Release files for ambience 1.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ambience 1.1.0
File Size Uploaded Provenance Actions
ambience-1.1.0.tar.gz 3.7 MB Without provenance Details for ambience-1.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ambience 1.1.0
File Interpreter ABI Platform Actions
ambience-1.1.0-py3-none-any.whl Python 3 none any Details for ambience-1.1.0-py3-none-any.whl

Total release size: 7.5 MB

Release files / ambience-1.1.0.tar.gz

Download URL ambience-1.1.0.tar.gz
Size 3.7 MB
Tags Source
SHA-256 checksum
How to use checksums
89419715b9b49d404b0d1991d3d8277600ff6bf988ae06f4bd3889675442657e
BLAKE2b-256 checksum
How to use checksums
601ed9df3c2fa3f808ebb862d8bd977871417d0d1d7b70b3f631cc93c332b7a6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.11

Release files / ambience-1.1.0-py3-none-any.whl

Download URL ambience-1.1.0-py3-none-any.whl
Size 3.7 MB
Tags Python 3
SHA-256 checksum
How to use checksums
c7b9a557767e72c988af8f14ca909ea59561dee0224f52b9bf5f22e66a5fe8c5
BLAKE2b-256 checksum
How to use checksums
eb837e19d840c56593d0781912221c731ee9b1e7431bbb237f13631551f62958
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.11.11

Security for ambience 1.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page