Package: anthemav
This is a Python package to interface withAnthemAVM and MRX receivers and
processors. It uses the asyncio library to maintain an object-based
connection to the network port of the receiver with supporting methods
and properties to poll and adjust the receiver settings.This package was created primarily to support an anthemav media_player
platform for theHome Assistantautomation platform but it is structured to be general-purpose and
should be usable for other applications as well.ImportantThis package will maintain a persistant connection to the network
control port which will prevent any other application from communicating
with the receiver. This includes the Anthem iOS and Android remote
control app as well as the ARC-2 room calibration software. You will
need to disable any application that is using the library in order to
run those other applications.RequirementsPython 3.6 or newer with asyncioAn Anthem MRX or AVM receiver or processorKnown IssuesThis has only been tested with an MRXx20 series receiver, although
the Anthem protocol was largely unchanged from the MRXx10 series. It
should work with the older units, but I’d appreciate feedback or pull
requests if you encounter problems. It will definitely not work with
the original MRXx00 units or the D2v models.Only Zone 1 is currently supported. If you have other zones
configured, this library will not allow you to inspect or control
them. This is not an intractable problem, I just chose not to address
that nuance in this initial release. It’s certainly feasible to add
support but I am not settled on how that should be exposed in the
internal API of the package.I skipped over a lot of the more esoteric settings that are available
(like toggling Dolby Volume on each input). If I passed over a
setting that’s really important to you, please let me know and I’ll
be happy to add support for it. Eventually I intend to cover the full
scope of the Anthem API, but you know how it goes.InstallationYou can, of course, just install the most recent release of this package
usingpip. This will download the more rececnt version fromPyPIand install it to your
host.pip install anthemavIf you want to grab the the development code, you can also clone this
git repository and install from local sources:cd python-anthemav
pip install .And, as you probably expect, you can live the developer’s life by
working with the live repo and edit to your heart’s content:cd python-anthemav
pip install . -eTestingThe package installs a command-line tool which will connect to your
receiver, power it up, and then monitor all activity and changes that
take place. The code for this console monitor is inanthemav/tools.pyand you can invoke it by simply running this at
the command line with the appropriate IP and port number that matches
your receiver and its configured port:anthemav_monitor --host 10.0.0.100 --port 14999Helpful Commandssudo tcpflow -c port 14999Interesting LinksProject HomeAPI Documentation for Anthem Network Protocol (Excel Spreadsheet):MRX-x20 and AVM-60MRX-x40, AVM-70 and AVM-90MDX-16 and MDX-8Pictures of catsCreditsThis package was written by David McNett.https://github.com/nuggethttps://keybase.io/nuggetThis package is maintained by Alex Henryhttps://github.com/hyralexHow can you help?First and foremost, you can help by forking this project and coding.
Features, bug fixes, documentation, and sample code will all add
tremendously to the quality of this project.If you have a feature you’d love to see added to the project but you
don’t think that you’re able to do the work, I’m someone is probably
happy to perform the directed development in the form of a bug or
feature bounty.If you’re anxious for a feature but it’s not actually worth money to
you, please open an issue here on Github describing the problem or
limitation. If you never ask, it’ll never happenIf you just want to thank me for the work I’ve already done, I’m
happy to accept your thanks, gratitude, pizza, or bitcoin. My bitcoin
wallet address can be onKeybaseor
you can send me a donation viaPayPal.Or, if you’re not comfortable sending me money directly, I’ll be
nearly as thrilled (really) if you donate tothe
ACLU,EFF, orEPICand let me know that you did.