{"id":23893323,"url":"https://github.com/sumpygump/ambient","last_synced_at":"2025-04-15T05:17:40.474Z","repository":{"id":142195916,"uuid":"170530886","full_name":"sumpygump/ambient","owner":"sumpygump","description":"Play ambient sounds from command line","archived":false,"fork":false,"pushed_at":"2025-02-14T15:40:02.000Z","size":227375,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-15T05:17:31.991Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sumpygump.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-02-13T15:27:41.000Z","updated_at":"2025-02-14T15:40:05.000Z","dependencies_parsed_at":"2025-01-13T16:50:23.505Z","dependency_job_id":null,"html_url":"https://github.com/sumpygump/ambient","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sumpygump%2Fambient","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sumpygump%2Fambient/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sumpygump%2Fambient/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sumpygump%2Fambient/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sumpygump","download_url":"https://codeload.github.com/sumpygump/ambient/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249010222,"owners_count":21197796,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-04T14:17:46.776Z","updated_at":"2025-04-15T05:17:40.455Z","avatar_url":"https://github.com/sumpygump.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ambience\n\nAmbient soundscape player\n\nThis is a python cli program that plays audio files, looping them for a specified\nduration and fading between them.\n\nIt reads a directory for `.ogg`, `.wav` or `.flac` files. The program comes\nwith a set of files, but can be used with any files on your computer of the\nsupported types by using the `--path` parameter when invoking.\n\n## Installation with pip\n\n```\npip install ambience\n\nambience --fetch-library\n```\n\n## Manual Installation\n\n - Requires python3\n - Requires pygame\n\nClone this repository.\n\nRun `pip3 install --user -r requirements.txt` to install pygame if not already installed\n\nRecommended: link `ambience` in a directory on your path. E.g. `ln -s ambience.py ~/bin/ambience`\n\n### Alternate install for pygame (compile pygame from source)\n\nTo install pygame from scratch instead of using pip, you can use the following\ncommands (assuming linux):\n\n```\n # Clone source repo\nsudo apt install mercurial\nhg clone https://bitbucket.org/pygame/pygame\ncd pygame\n\nsudo apt install libsdl-dev libsdl-image1.2-dev libsdl-mixer1.2-dev libsdl-ttf2.0-dev libsmpeg-dev libportmidi-dev libavformat-dev libswscale-dev\n\npython3 setup.py build\nsudo python3 setup.py install\n```\n\n## Usage\n\nTo run with the default settings, simply run `ambience`. Use \"ctrl-c\" to stop.\n\n```\nHello from the pygame community. https://www.pygame.org/contribute.html\nusage: ambience [-h] [-d DURATION] [-f] [-i] [-n] [-p PATH] [-q] [-v] [paths ...]\n\npositional arguments:\n  paths                 load given sound file(s) or path(s)\n\noptions:\n  -h, --help            show this help message and exit\n  -d DURATION, --duration DURATION\n                        set the duration in minutes each sound will play: default=5\n  -f, --fetch-library   fetch the sound library from internet\n  -i, --noinit          do not pre-initialize all sounds at start\n  -n, --noinput         disable the stdin input capture\n  -p PATH, --path PATH  set the path where the sound files are\n  -q, --quiet           produce no output\n  -v, --version         show version and exit\n```\n\nIf invoked without the `-n` parameter, press 'n' to skip to next sound and 'q'\nto quit.\n\nThe default sounds used are in the install directory (wherever you\ncloned/downloaded this repo) in the sub-directory `sounds`.\n\n## Sound credits\n\nCredit goes to the following for the sound files included in this package:\n\n- Bruce Baron for [`alien-contact.ogg`](https://freesound.org/people/Sclolex/sounds/149131/)\n- Vann Westfold for [`ambienttraut.ogg`](https://freesound.org/people/Vann%20Westfold/sounds/34308/)\n- Ero Kia for [`ambient-wave-17.ogg`](https://freesound.org/people/deleted_user_2731495/sounds/395837/)\n- Mynoise.net for [`b25-bomber.ogg`](https://mynoise.net/NoiseMachines/propellerNoiseGenerator.php?l=32353333252532141414\u0026m=\u0026d=0)\n- Mynoise.net for [`binaural-low-complex.ogg`](https://mynoise.net/NoiseMachines/binauralBrainwaveGenerator.php?l=61565146413633292522\u0026m=\u0026d=0)\n- Sclolex for [`cave.ogg` (Water Dripping in a Large Cave)](https://freesound.org/people/Sclolex/sounds/177958/)\n- Daniel Simion for [`crackling-fireplace`](http://soundbible.com/2178-Crackling-Fireplace.html)\n- musicbrain for [`didgeridu-monk.ogg`](https://freesound.org/people/musicbrain/sounds/376577/)\n- Ero Kia for [`elementary-wave-11.ogg`](https://freesound.org/people/deleted_user_2731495/sounds/183881/)\n- Blair Ferrier for [`helicopter-mix.ogg`](https://freesound.org/people/nofeedbak/sounds/41171/)\n- Chris Zabriskie for [`long-hallway.ogg` (excerpt from \"I Am Running Down the Long Hallway of Viewmont Elementary)](http://freemusicarchive.org/music/Chris_Zabriskie/I_Am_a_Man_Who_Will_Fight_for_Your_Honor/I_Am_Running_Down_the_Long_Hallway_of_Viewmont_Elementary\") Creative Commons 3.0\n- György Ligeti for `lux-aeterna-excerpt.ogg`\n- Sclolex for [`night-sounds.ogg` (Sounds on a quiet night)](https://freesound.org/people/Sclolex/sounds/342106/)\n- Luftrum for [`ocean-waves.ogg`](https://freesound.org/people/Luftrum/sounds/48412/)\n- chzmn for [`perfect-storm.ogg`](https://weather.ambient-mixer.com/the-perfect-storm)\n- Hargisss Sound for [`spring-birds.ogg`](https://freesound.org/people/hargissssound/sounds/345851/)\n- Trekcore.com for [`warp-core-hum.ogg`](http://www.trekcore.com/audio/)\n- NASA/JPL for [`mars-perseverance.ogg`](https://mars.nasa.gov/resources/25399/in-flight-perseverance-rovers-interplanetary-sound/)\n- Mynoise.net for [`b17-bomber.ogg`](https://mynoise.net/NoiseMachines/propellerNoiseGenerator.php?l=46504747000046202020)\n- juskiddink for [`bonfire.ogg`](https://freesound.org/people/juskiddink/sounds/65795/)\n- AshFox for [`coffee-shop.ogg`](https://freesound.org/people/AshFox/sounds/172968/)\n- unfa for [`fan.ogg`](https://freesound.org/people/unfa/sounds/170869/)\n- inchadney for [`forest.ogg`](https://freesound.org/people/inchadney/sounds/56611/)\n- juskiddink for [`leaves.ogg`](https://freesound.org/people/juskiddink/sounds/78955/)\n- el mar for [`library.ogg`](https://freesound.org/people/el_mar/sounds/171008/)\n- juskiddink for [`seaside.ogg`](https://freesound.org/people/juskiddink/sounds/194868/)\n- SDLx for [`train.ogg`](https://freesound.org/people/SDLx/sounds/259988/)\n- Greim for the [machine-planet samples](https://greim.github.io/machine-planet/)\n- NASA/JPL for [`mars-ingenuity.ogg`](https://mars.nasa.gov/resources/25893/listen-to-nasas-ingenuity-mars-helicopter-in-flight/)\n- AdrienPola for [`amazon-rainforest.ogg`](https://freesound.org/people/AdrienPola/sounds/413976/)\n- dobroide for [`rural-spain.ogg`](https://freesound.org/people/dobroide/sounds/269218/)\n- Mynoise.net for [`the-pilgrim.ogg`](https://mynoise.net/NoiseMachines/tongueDrumSoundscapeGenerator.php)\n- anankalisto for [`resonance-of-the-gods.ogg`](https://freesound.org/people/anankalisto/sounds/139050/)\n- Emanuele Correani for [`train-station.ogg`](https://freesound.org/people/Emanuele_Correani/sounds/332769/)\n- InspectorJ for [`machine-factory.ogg`](https://freesound.org/people/InspectorJ/sounds/385943/)\n- Gladkiy for [`metro-outdoors.ogg`](https://freesound.org/people/gladkiy/sounds/333361/)\n- Zabuhailo for [`metro.ogg`](https://freesound.org/people/Zabuhailo/sounds/193742/)\n- jjeronen@norssi.oulu.fi for ambient-works-iv.ogg (from Ultimate Mod Collection)\n- alphagem-o for `birth-of-a-snowflake.ogg`\n- amfivolia for `biota-alien-soundscape.ogg`\n- moodist.mvze.net for `inside-a-train.ogg`\n- moodist.mvze.net for `underwater.ogg`\n- ambientnoise.online for `womb.ogg`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsumpygump%2Fambient","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsumpygump%2Fambient","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsumpygump%2Fambient/lists"}