v3.8.0

What's Changed

• Renaming of volume related attributes to match YNCA API naming, see deprecations section below for details.
• min_volume has been removed as it is not provided by the YNCA API

Deprecations

The old attributse will be removed in the next major version, until then backward compatibility code is available.
The following attributes have been renamed to better match the naming in the YNCA protocol.

• max_volume has been renamed to maxvol
• volume has been renamed to vol
• volume_up has been renamed to vol_up
• volume_down has been renamed to vol_down
• min_volume has been removed as it is not provided by the YNCA API

For more deprecation notices see older release notes

Full Changelog: v3.7.0...v3.8.0

v3.7.0

What's Changed

• Added optional communication logging (useful for debugging)
• Improve ynca_server responses (allows for better testing without real receiver)
• Added get_inputinfo_list which replaces get_all_zone_inputs

Deprecations

The following attributes have been renamed to better match the naming in the YNCA protocol.
The old attributse will be removed in the next major version, until then backward compatibility code is available.

• input has been renamed to inp
• get_inputinfo_list replaces get_all_zone_inputs

For more deprecation notices see older release notes

Full Changelog: v3.6.0...v3.7.0

v3.6.0

What's Changed

• More robust protocol handling
• Added get_modelinfo to get supported features for a specific receiver that can not be deduced from the YNCA protocol.
• get_all_zone_inputs now returns a list of all known inputs if a list of specific inputs for the connected receiver could not be determined
• Extended SoundPrg list

Deprecations

The following attributes have been renamed to better match the naming in the YNCA protocol.
The old attributse will be removed in the next major version, until then backward compatibility code is available.

• inputs has been renamed to inp_names
• name has been renamed to zonename
• scenes has been renamed to scenenames

For more deprecation notices see older release notes

Full Changelog: v3.5.0...v3.6.0

v3.5.0

Changes

• Add "9ch Stereo" sound program
• Fix "The Bottom Line" sound program

Full Changelog: v3.4.0...v3.5.0

Deprecation notice

(this is a repeat reminder from the 3.2.2 release)

The ynca.Receiver class has been deprecated and replaced with the ynca.Ynca class.
This is to better represent that this library is about the YNCA API.

The ynca.Ynca class is a direct replacement for the deprecated ynca.Receiver class except for the inputs attribute on the ynca.Receiver class. That attribute is not available as such in YNCA and therefore does not belong into a class representing the API. However since it is useful functionality that most clients will need it has been replaced with the ynca.get_all_zone_inputs helper function with takes a ynca.Ynca class as input and returns a dictionary like the inputs attribute did.

There is a backward compatibility ynca.Receiver class in place which still work as before, but logs a deprecation warning.

The ynca.Receiver backward compatibility class will be removed in the next major version (timeframe unknown).

v3.4.0

Changes

• Make it safe to call connection.close() at any time
• Avoid exception when connection gets closed while connection

Full Changelog: v3.3.0...v3.4.0

Deprecation notice

(this is a repeat reminder from the 3.2.2 release)

The ynca.Receiver class has been deprecated and replaced with the ynca.Ynca class.
This is to better represent that this library is about the YNCA API.

The ynca.Ynca class is a direct replacement for the deprecated ynca.Receiver class except for the inputs attribute on the ynca.Receiver class. That attribute is not available as such in YNCA and therefore does not belong into a class representing the API. However since it is useful functionality that most clients will need it has been replaced with the ynca.get_all_zone_inputs helper function with takes a ynca.Ynca class as input and returns a dictionary like the inputs attribute did.

There is a backward compatibility ynca.Receiver class in place which still work as before, but logs a deprecation warning.

The ynca.Receiver backward compatibility class will be removed in the next major version (timeframe unknown).

v3.3.0

Deprecation notice

(this is a repeat reminder from the 3.2.2 release)

The ynca.Receiver class has been deprecated and replaced with the ynca.Ynca class.
This is to better represent that this library is about the YNCA API.

The ynca.Ynca class is a direct replacement for the deprecated ynca.Receiver class except for the inputs attribute on the ynca.Receiver class. That attribute is not available as such in YNCA and therefore does not belong into a class representing the API. However since it is useful functionality that most clients will need it has been replaced with the ynca.get_all_zone_inputs helper function with takes a ynca.Ynca class as input and returns a dictionary like the inputs attribute did.

There is a backward compatibility ynca.Receiver class in place which still work as before, but logs a deprecation warning.

The ynca.Receiver backward compatibility class will be removed in the next major version (timeframe unknown).

Changes

• Catch error that could sometimes occur during initialization.
• Reorganize some interals
• Improved README
• Updated example.py to better match the README

Full Changelog: v3.2.2...v3.3.0

v3.2.2

Deprecation notice

The ynca.Receiver class has been deprecated and replaced with the ynca.Ynca class.
This is to better represent that this library is about the YNCA API.

The ynca.Ynca class is a direct replacement for the deprecated ynca.Receiver class except for the inputs attribute on the ynca.Receiver class. That attribute is not available as such in YNCA and therefore does not belong into a class representing the API. However since it is useful functionality that most clients will need it has been replaced with the ynca.get_all_zone_inputs helper function with takes a ynca.Ynca class as input and returns a dictionary like the inputs attribute did.

There is a backward compatibility ynca.Receiver class in place which still work as before, but logs a deprecation warning.

The ynca.Receiver backward compatibility class will be removed in the next major version (timeframe unknown).

Changes

• Introduced ynca.Ynca as replacement for ynca.Receiver which is now deprecated
• Added backward compatibility ynca.Receiver class
• Added ynca.get_all_zone_inputs helper function to replace the input attribute on ynca.Receiver
• Misc minor code cleanups
• Fixed issue with YNCA console import
• Renamed YNCA Console to YNCA terminal
• Updated README and example.py for all changes

Note

Version v3.2.0 and v3.2.1 have not been released or retracted as they had errors which have been fixed in v3.2.2

Full Changelog: v3.1.0...v3.2.2

v3.1.0

• Return copies of dictionaries instead of references to internal structures
• Include typing info in package

v3.0.2

This release fixes a few issues with v3.0.0/v3.0.1.

• Extend initialization timeout. Seems to be needed on slower/busier systems
• Don't leave open connection after failed initialize()
• Make it safe to call close() at any time or multiple times

Full Changelog: v3.0.1...v3.0.2

For the rest all notes about 3.0.0 still apply, see below

Breaking change:

The API changed to better represent the YNCA api and to be a little easier to work with.
Check example.py for a basic example.

Changes

A lot of changes, these are the highlights

• Detect connection loss (mainly useful for IP connections)
• Add more subunit functionality e.g.
  • Expose artist, album, song when available
  • Expose playback status and control when available
• Add typehints
• Add tests
• Fix bugs found by tests :P
• Update documentation

v3.0.1

This release fixes 2 minor issues with v3.0.0.

• Fix readme description type so upload to PyPi will work again
• Export Band enum from the library

For the rest all notes about 3.0.0 still apply, see below

Breaking change:

The API changed to better represent the YNCA api and to be a little easier to work with.
Check example.py for a basic example.

Changes

A lot of changes, these are the highlights

• Detect connection loss (mainly useful for IP connections)
• Add more subunit functionality e.g.
  • Expose artist, album, song when available
  • Expose playback status and control when available
• Add typehints
• Add tests
• Fix bugs found by tests :P
• Update documentation