# Amniotic
A multi-output ambient sound mixer for Home Assistant.
Amniotic lets you use a single device to create on-the-fly, custom ambient audio mixes - e.g. mixing Waterfall sounds
with Birdsong on one set of speakers, while playing Fireplace sounds from a second audio device - to suit your tastes
and environment.
The library integrates with Home Assistant via MQTT as a new device, allowing you to create and control ambient mixes
from the Home Assistant interface.
### Why Would I Want Such a Thing?
I won't explain the general reasons for introducing non-musical sounds into one's environment, but if you
find [sound masking](https://en.wikipedia.org/wiki/Sound_masking) helps you concentrate in noisy environments, if
you're (as I am) slightly [misophonic](https://www.webmd.com/mental-health/what-is-misophonia), if you
use [white noise machines](https://en.wikipedia.org/wiki/White_noise_machine) to induce sleep or relaxation, or if you
just think sound is an important factor in setting a pleasant ambience, then you might find Amniotic useful.
### Can't I do This with Spotify, Volumio, HifiBerry etc.?
Since those systems are intended for music, they aren't designed for playing or mixing multiple streams simultaneously
with a single device, even if set up in multi-room configurations. Also, the streaming services often won't allow a
single account to play multiple streams, even _if_ multiple devices are used.
Anyway, those limitations motivated this library.
There are two ways to install and run Amniotic:
- On the Home Assistant machine itself, as an add-on.
- Install manually, on a separate machine.
## Home Assistant Addon
To add as an Addon, click here:
[](https://fmtr.link/amniotic/addon-install)
## Documentation
For non-addon installs, and general documentation, see **[the project wiki](https://fmtr.link/amniotic/doc)**.
Raw data
{
"_id": null,
"home_page": "https://fmtr.link/amniotic",
"name": "amniotic",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "ambient sound audio white noise masking sleep",
"author": "Frontmatter",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/a0/58/91bf027c648ed998f740564f5b9eddb2d27106c6d02cd8860ac09d4a8cdd/amniotic-0.5.24.tar.gz",
"platform": null,
"description": "# Amniotic\n\nA multi-output ambient sound mixer for Home Assistant.\n\nAmniotic lets you use a single device to create on-the-fly, custom ambient audio mixes - e.g. mixing Waterfall sounds\nwith Birdsong on one set of speakers, while playing Fireplace sounds from a second audio device - to suit your tastes\nand environment.\n\nThe library integrates with Home Assistant via MQTT as a new device, allowing you to create and control ambient mixes\nfrom the Home Assistant interface.\n\n### Why Would I Want Such a Thing?\n\nI won't explain the general reasons for introducing non-musical sounds into one's environment, but if you\nfind [sound masking](https://en.wikipedia.org/wiki/Sound_masking) helps you concentrate in noisy environments, if\nyou're (as I am) slightly [misophonic](https://www.webmd.com/mental-health/what-is-misophonia), if you\nuse [white noise machines](https://en.wikipedia.org/wiki/White_noise_machine) to induce sleep or relaxation, or if you\njust think sound is an important factor in setting a pleasant ambience, then you might find Amniotic useful.\n\n### Can't I do This with Spotify, Volumio, HifiBerry etc.?\n\nSince those systems are intended for music, they aren't designed for playing or mixing multiple streams simultaneously\nwith a single device, even if set up in multi-room configurations. Also, the streaming services often won't allow a\nsingle account to play multiple streams, even _if_ multiple devices are used.\n\nAnyway, those limitations motivated this library.\n\nThere are two ways to install and run Amniotic:\n\n- On the Home Assistant machine itself, as an add-on.\n- Install manually, on a separate machine.\n\n## Home Assistant Addon\n\nTo add as an Addon, click here:\n\n[](https://fmtr.link/amniotic/addon-install)\n\n## Documentation\n\nFor non-addon installs, and general documentation, see **[the project wiki](https://fmtr.link/amniotic/doc)**.\n\n",
"bugtrack_url": null,
"license": "Copyright \u00a9 2022 Frontmatter. All rights reserved.",
"summary": "A multi-output ambient sound mixer for Home Assistant",
"version": "0.5.24",
"project_urls": {
"Homepage": "https://fmtr.link/amniotic"
},
"split_keywords": [
"ambient",
"sound",
"audio",
"white",
"noise",
"masking",
"sleep"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7dabf510b99280f41d610f260d4c074a4bdb1ba6d67e007ae6effa7476f3d642",
"md5": "3f28506f24f0a3bb20d28b99fbac70ea",
"sha256": "4f0c05af078ded15d1053cb2231fdbc1c2da4dc840cb36a7b3a8ab9471c32927"
},
"downloads": -1,
"filename": "amniotic-0.5.24-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3f28506f24f0a3bb20d28b99fbac70ea",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 21641,
"upload_time": "2024-03-27T14:15:12",
"upload_time_iso_8601": "2024-03-27T14:15:12.041385Z",
"url": "https://files.pythonhosted.org/packages/7d/ab/f510b99280f41d610f260d4c074a4bdb1ba6d67e007ae6effa7476f3d642/amniotic-0.5.24-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a05891bf027c648ed998f740564f5b9eddb2d27106c6d02cd8860ac09d4a8cdd",
"md5": "e18a8c8d40b8c8364b78abf0f2cdbf07",
"sha256": "78e26d4c6d5d58ac4b7d176b5e2d07aaf92342b6426d0f5f25df4ef4c774f1f6"
},
"downloads": -1,
"filename": "amniotic-0.5.24.tar.gz",
"has_sig": false,
"md5_digest": "e18a8c8d40b8c8364b78abf0f2cdbf07",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 19325,
"upload_time": "2024-03-27T14:15:14",
"upload_time_iso_8601": "2024-03-27T14:15:14.118588Z",
"url": "https://files.pythonhosted.org/packages/a0/58/91bf027c648ed998f740564f5b9eddb2d27106c6d02cd8860ac09d4a8cdd/amniotic-0.5.24.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-27 14:15:14",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "amniotic"
}
JSON