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:
- Bruce Baron for
alien-contact.ogg - Vann Westfold for
ambienttraut.ogg - Ero Kia for
ambient-wave-17.ogg - Mynoise.net for
b25-bomber.ogg - Mynoise.net for
binaural-low-complex.ogg - Sclolex for
cave.ogg(Water Dripping in a Large Cave) - Daniel Simion for
crackling-fireplace - musicbrain for
didgeridu-monk.ogg - Ero Kia for
elementary-wave-11.ogg - Blair Ferrier for
helicopter-mix.ogg - Chris Zabriskie for
long-hallway.ogg(excerpt from "I Am Running Down the Long Hallway of Viewmont Elementary) Creative Commons 3.0 - György Ligeti for
lux-aeterna-excerpt.ogg - Sclolex for
night-sounds.ogg(Sounds on a quiet night) - Luftrum for
ocean-waves.ogg - chzmn for
perfect-storm.ogg - Hargisss Sound for
spring-birds.ogg - Trekcore.com for
warp-core-hum.ogg - NASA/JPL for
mars-perseverance.ogg - Mynoise.net for
b17-bomber.ogg - juskiddink for
bonfire.ogg - AshFox for
coffee-shop.ogg - unfa for
fan.ogg - inchadney for
forest.ogg - juskiddink for
leaves.ogg - el mar for
library.ogg - juskiddink for
seaside.ogg - SDLx for
train.ogg - Greim for the machine-planet samples
- NASA/JPL for
mars-ingenuity.ogg - AdrienPola for
amazon-rainforest.ogg - dobroide for
rural-spain.ogg - Mynoise.net for
the-pilgrim.ogg - anankalisto for
resonance-of-the-gods.ogg - Emanuele Correani for
train-station.ogg - InspectorJ for
machine-factory.ogg - Gladkiy for
metro-outdoors.ogg - Zabuhailo for
metro.ogg - jjeronen@norssi.oulu.fi for ambient-works-iv.ogg (from Ultimate Mod Collection)
- alphagem-o for
birth-of-a-snowflake.ogg - amfivolia for
biota-alien-soundscape.ogg - moodist.mvze.net for
inside-a-train.ogg - moodist.mvze.net for
underwater.ogg - ambientnoise.online for
womb.ogg
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.