Please ⭐ this repo if you find it useful

LinkPlay devices integration for Home Assistant

Collaborators wanted! This component was transferred to this repository to save from death as a result of moral obsolescence of the code. But now I don’t have the opportunity to fully support it and develop the code.

If you can help with developing this component, I will be very grateful to you. Please, message to me.

This component allows you to integrate control of audio devices based on LinkPlay platform into your Home Assistant smart home system.

LinkPlay platform makes it easy to create a variety of modern audio systems. There are already quite a few manufacturers and devices that operate on the basis of LinkPlay. Here are just some of the firms and devices: August (WS300G), Audio Pro (A10, A40, Addon C3/C5/C5A/C10/C-SUB, D-1, Drumfire, Link 1), Auna (Intelligence Tube), Bauhn (SoundMax 5), Bem (Speaker Big Mo), Centaurus (Flyears), Champion (AWF320), COWIN (DiDa, Thunder), Crystal Acoustics (Crystal Audio), CVTE (FD2140), Dayton Audio (AERO), DOSS (Deshi, Soundbox Mini, DOSS Assistant, Cloud Fox A1), DYON (DYON Area Player), Edifier (MA1), Energy Sistem (Multiroom Tower Wi-Fi, Multiroom Portable Wi-Fi), FABRIQ (Chorus, Riff), First Alert (Onelink Safe & Sound), GE Sol (C), GGMM (E2 Wireless, E3 Wireless, E5 Wireless), GIEC (Hi-Fi Smart Sound S1), Harman Kardon (Allure), Hyundai (Modern Oxygen Bar), iDeaUSA (iDEaHome, Home Speaker, Mini Home Soundbar), iHome (iAVS16), iLive (Concierge, Platinum), iLuv (Aud Air, Aud Click Shower, Aud Click), JAM Audio (Voice, Symphony, Rhythm), JD (CrazyBoa 2Face), Lowes (Showbox), Magnavox (MSH315V), Medion (MD43631, MedionX MD43259), Meidong (Meidong 3119), MK (MK Alexa Speaker), MÜZO (Cobblestone), Naxa (NAS-5003, NHS-5002, NAS-5001, NAS-5000), Nexum (Memo), Omaker (WoW), Omars (Dogo), Polaroid (PWF1001), Roxcore (Roxcore), Sharper Image (SWF1002), Shenzhen Renqing Technology Ltd (ROCKLAVA), Sonoé (iEast SoundStream, iEast Stream Pro, iEast StreamAmp AM160, iEast StreamAmp i50B), SoundBot (SB600), SoundLogic (Buddy), Stereoboommm (MR200, MR300), Tibo (Choros Tap), Tinman (Smart JOJO), Venz (A501), Uyesee (AM160), Youzhuan (Intelligent Music Ceiling), Zolo Audio (Holo), etc.

Component setup instructions

1. Create a directory custom_components in your Home Assistant configuration directory.

2. Create a directory linkplay in custom_components directory.

3. Copy linkplay directory from this project including all files and sub-directories into the directory custom_components.

   It should look similar to this after installation:

   <config_dir>/
   |-- custom_components/
   |   |-- linkplay/
   |       |-- __init__.py
   |       |-- manifest.json
   |       |-- etc...
   

4. To add LinkPlay device to your installation, add the following to your configuration.yaml file:

   # Example configuration.yaml entry
   media_player:
     - platform: linkplay
       host: YOUR_IP_ADDRESS
       device_name: NAME_OF_DEVICE_AS_IN_OFFICIAL_APPLICATION

Configuration Variables

host:
(string) (Required) The host name or IP address of the device that is running Emby.

device_name:
(string) (Required) The name of the device, as it setted up in the official application.

name:
(string) (Optional) Name to use in the frontend.
Default value: Identical to devicename value

lastfm_api_key:
(string) (Optional) API key to LastFM service to get album covers.

Track updates

You can automatically track new versions of this component and update it by custom-updater (deprecated) or HACS.

For custom-updater to initiate tracking add this lines to you configuration.yaml file:

# Example configuration.yaml entry
custom_updater:
  track:
    - components
  component_urls:
    - https://raw.githubusercontent.com/Limych/media_player.linkplay/master/custom_components.json

Contributing

This is an active open-source project. We are always open to people who want to use the code or contribute to it.

We have set up a separate document containing our contribution guidelines.

Thank you for being involved! 😍

Authors & contributors

The original setup of this repository is by [Andrey "Limych" Khrolenok][limych].

For a full list of all authors and contributors, check [the contributor's page][contributors].

License

MIT License

Copyright (c) 2019 Niclas Berglind @nicjo814 Copyright (c) 2019—2020 Andrey "Limych" Khrolenok

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.