From 2213f16706210bdf8df6cf51fed49bc58c9402df Mon Sep 17 00:00:00 2001 From: LegendaryMichael <154459803+LegendaryMichael@users.noreply.github.com> Date: Mon, 23 Sep 2024 14:25:56 -0400 Subject: [PATCH] Update README.md to reference AmpliPro hardware - Added a description of the difference between AmpliPi and AmpliPro - Replaced "AmpliPi" with "AmpliPro when in reference to the device - Added a link to micro-nova.com to make it easy to buy an AmpliPro - Changed two pictures: The front+back photo of the device, and the API diagram --- README.md | 30 ++++++++++++----------- docs/imgs/AmpliProOverview2.png | Bin 0 -> 4704587 bytes docs/imgs/OverviewRestAPI2.png | Bin 0 -> 126154 bytes hw/diagrams/NEWsignal_diagram.drawio.svg | 4 +++ 4 files changed, 20 insertions(+), 14 deletions(-) create mode 100644 docs/imgs/AmpliProOverview2.png create mode 100644 docs/imgs/OverviewRestAPI2.png create mode 100644 hw/diagrams/NEWsignal_diagram.drawio.svg diff --git a/README.md b/README.md index 73c1c5ff9..9fcdf080b 100644 --- a/README.md +++ b/README.md @@ -1,21 +1,23 @@ # AmpliPi Home Audio System +AmpliPi is an open-source software solution for multi-room home audio systems, specifically developed for AmpliPro products. The AmpliPro [product line](https://www.amplipro.com/) is designed by the creators of this project, [Micronova](https://www.micro-nova.com/). These systems have been rigorously tested and successfully implemented in various commercial and residential settings. When you purchase AmpliPro hardware from us, you’re not only supporting the project but also gaining access to a professionally designed audio system that delivers exceptional sound quality, backed by worldwide support from our engineering team. + + [![Build Status][workflow-badge]][workflow-link] [![Coverage][coverage-badge]][coverage-link] [![GPL License][license-badge]](COPYING) - + -AmpliPi™ is a multi room/zone home audio controller and amplifier made for whole house audio systems with many zones. It can play up to 4 simultaneous audio sources, each of which can be selected from either its analog RCA input or any supported digital stream (Pandora, Spotify, AirPlay, etc). Each source can be routed to one or more zones, all of which are configurable in real-time using the self-hosted AmpliPi Web App or its underlying REST API. It is expandable up to 36 zones using AmpliPi Zone Expanders. +AmpliPro™ is a multi room/zone audio streamer, controller, and amplifier made for whole house audio systems with many zones. It can play up to 4 simultaneous audio sources, each of which can be selected from either its analog RCA input or any supported digital stream (Pandora, Spotify, AirPlay, etc). Each source can be routed to one or more zones, all of which are configurable in real-time using the AmpliPi App (Android / iOS / web) or its underlying API. It is expandable up to 36 zones using AmpliPro Zone Expanders. -The AmpliPi design is entirely open source, from the software, to the firmware, to the schematics. The REST API and Web App are written in Python and run on a Raspberry Pi 3+ Compute Module. The firmware, which provides the low level volume control and zone configuration, is written in C and configured by the Python API over I2C. All of the internal circuitry comes with full schematics (available in this repo). +The AmpliPro design is entirely open source, from the software, to the firmware, to the schematics. The API and Web App are written in Python and run on a Raspberry Pi 3+ Compute Module. The firmware, which provides the low level volume control and zone configuration, is written in C and configured by the Python API over I2C. All of the internal circuitry comes with full schematics (available in this repo). -The system is self-hosted on the Raspberry Pi and is privacy-centric. By design, AmpliPi doesn’t listen to you or spy on you — it just plays your audio! The way it should be. An internet connection is only needed for some external streaming sources, such as Pandora. The Python application running on the Pi hosts a mobile-friendly website and REST API used to control the system. The website is built on top of the REST API. +The system is self-hosted on the Raspberry Pi and is privacy-centric. By design, AmpliPi doesn’t listen to you or spy on you — it just plays your audio! The way it should be. An internet connection is only needed for some external streaming sources, such as Pandora. The Python application running on the Pi hosts a mobile-friendly website and API used to control the system. The website is built on top of the API. - + -Check us out on [Kickstarter](https://www.kickstarter.com/projects/micro-nova/amplipi-home-audio-system)! ## Features -AmpliPi can play many different types of digital streaming inputs. Most of the streaming services supported can be played as independent digital streams on all four sources at once; check out the **Multiple?** heading. Below is the current status of our digital stream integrations. +AmpliPro can play many different types of digital streaming inputs. Most of the streaming services supported can be played as independent digital streams on all four sources at once; check out the **Multiple?** heading. Below is the current status of our digital stream integrations. Most of these digital streaming services are provided by other open-source projects; check out the **Provided By** heading. @@ -77,18 +79,18 @@ Here's an example of changing group and zone volumes: Check out the full documentation for the web app at [docs/WEB_APP.md](docs/manual/WEB_APP.md). -## The REST API -AmpliPi has a REST API that can be used to control volumes, switch and control audio sources, configure different streaming sources, and much more. It allows full configuration and real-time control of the AmpliPi device. The API conforms to the OpenAPI standard. It is fully documented on our [AmpliPi OpenAPI site](https://micro-nova.github.io/AmpliPi). +## The API +AmpliPi has a flexible API that can be used to control volumes, switch and control audio sources, configure different streaming sources, and much more. It allows full configuration and real-time control of the AmpliPro device. The API conforms to the OpenAPI standard. It is fully documented on our [AmpliPi OpenAPI site](https://micro-nova.github.io/AmpliPi).
+ src="docs/imgs/OverviewRestAPI2.png">
@c$orKbo1ooA15e)OQe8cBG3PUZW&
zc*kB~{}O4D5k>l@3AxDoSHk72v&`d_)wt xQXfzjmT_;g_5Kl%sn#VBkTPE}@RORk
zCVmh430XRy#4MyZU&a?B_U%xnsr~68%H#P0{D`pM<*ui54{8}ErP-bM)5Je*TMx#A
zI6siG_4k6nn3%AAQ&QXRSiTn?2~cnRM{+JDo40*d>T59b>Z8mtL4r%-Wvfn~?t7v8
zcQCq)4GA|sr{29DUNdAg3`aa8Va`kKT}0(CLeW|8;~UcrufQ;4Z-|#Aw;y$M7*-2n
z9LTfIIkv?#zP(=wuaZ^`ZyvLaYEFDudj&N|q`%i|j4D-a-R^*)evDm2Y0-sn0BOu#
zVo5^gjWZX`%G?s^x#5gwj9PFVIsU@dEnk24WC1*)pin_Dfs9fHB8OU; NTFG*}`F%a;rsrOAioCDx j%&$MUwa>Zs*?X-9iFbI0dyu1Y
z&!6C}nfluHYBahMGEH-b@iP1lj67IV_WiY3OB86rMgknNJzn`muS+V^#|ny)VMB8(
z%6@Gp(A8;`s^A?!_VQZB-=iX2m^2bzPxsyPP_Q%!4btiD1N=V;Eqje$_v-Xc$IPxvuAw
zFL{nSe`a^^6^rzi=WB3M%?D>Z;DtI-Zq!jIk;aP1@IH9q(;*{jAQ
P#O;Q@Kr*It7_p%$(QQc^yCG~Mn|ubiqBZU0C|jE!rN({;Nn1TpW+ymGn0vFs&N
zO%M^M-1(xe`7;Bl=162)JWroOB7uNmbi2Idm3K*1h2T8mF5^4m-RXBjRCGyyvfp2-
z8{o3l^w>=_q;z|ZZ+Kkkdy0kMGt+llfb2Et2B0CzJ!own7f2B>6%0}!J0X0ceNnus
z0ga$mV7O2|x0P(;u`J2p`uM48Ma_