PHPackages karimgeiger/hkapi - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. karimgeiger/hkapi ActiveLibrary[API Development](/categories/api) karimgeiger/hkapi ================= API wrapper for Harman Kardon AVR with network capabilities and HK Remote support. 36649[4 issues](https://github.com/KarimGeiger/HKAPI/issues)PHP Since Jan 26Pushed 6y ago11 watchersCompare [ Source](https://github.com/KarimGeiger/HKAPI)[ Packagist](https://packagist.org/packages/karimgeiger/hkapi)[ RSS](/packages/karimgeiger-hkapi/feed)WikiDiscussions master Synced 2mo ago READMEChangelogDependenciesVersions (1)Used By (0) HKAPI ===== [](#hkapi) I had a dream. I wanted to integrate my Harman Kardon AVR in my SmartHome environment. Many of the AV-Receivers by Harman Kardon supply network functionality for AirPlay and remote control using the HK Remote for Android or iOS. But you can't script an App like that. So I decided to reverse-engineer the requests sent by the App and write a PHP library having that functionality. And here we are. Feel free to browse the example.php file for a real-life demonstration. Requirements ------------ [](#requirements) Well.. almost nothing is required to get the API running. Of course, you need an compatible AV-Receiver or anything similar created by Harman Kardon. I'm trying to collect a list of all working devices below, but since we'll never know for sure, it might be a good idea to try the API against your own device and let me know if it works. On the client side you just have to be able to connect to sockets using PHP. Minimum required version is 5.6. Of course, to use the autoloader functionality, you have to use composer. Basic Usage ----------- [](#basic-usage) ### As Composer Dependency [](#as-composer-dependency) Add the package to your `require-dev` section in the `composer.json`-file and update your project. ``` "require-dev": { "karimgeiger/hkapi": "1.0.x-dev" } ``` ``` composer update ``` ### As a Base Project [](#as-a-base-project) Generate the autoloader using `composer install`. Everything else should be well-documented in the code itself, so just take a look at the example.php or use an IDE. ### General [](#general) You'll start with the API object. Select your model as third parameter (see: lib/Devices). If your device isn't listed, try picking one that's as similar as possible to yours. ``` $hk = new \HKAPI\API('your_ip', 10025, new \HKAPI\Devices\AVR()); ``` After that you can use any available action on every predefined zone. For example: ``` $zone = $hk->zone('Main Zone'); $zone->on(); $zone->selectSource('Radio'); ``` Before quitting now, please read the following section since it will save you a lot of time investigating. What You Should Know -------------------- [](#what-you-should-know) Since Harman Kardon did not want this API to be public, accessing it is a bit hairy. There is no documentation and most of the actions won't return any state at all. So you'll never know if something succeeded or failed. Also, we don't know how long each request takes to send. Keep that in mind when sending multiple requests at once. Another great "feature" of the devices is, that the server handling all requests running on your device will shut down until next power on (using the button or the remote). This means you cannot control the receiver at all after that period of time. Please note, that this behaviour is different for each device. Some devices shut down immediately after issuing the "off"-command. You can try [using this workaround.](https://github.com/KarimGeiger/HKAPI/commit/6036d4f42b94f23cf62b1186ca95587f42e10e04#commitcomment-16324589) Available Actions ----------------- [](#available-actions) I've gone through all actions available on the official App so this list should be complete. Nevertheless it's possible that there are some hidden actions not supplied by the App. If you know or find some new, just let me know or open a Pull request. I'd be very happy about it. All the actions can be triggered using the Zone object, either using run() or the magic method. You can also run your own requests by using API::generateRequest(), API::sendRequest() and API::readResponse(). - `void on()` - Turn device on. - `void off()` - Turn device off. - `void sleep()` - Toggle sleep or set sleep timer. - `void play()` - Play current track. - `void pause()` - Pause current track. - `void forward()` - Go forward in current track. - `void reverse()` - Go reverse in current track. - `void next()` - Select next track. - `void previous()` - Select previous track. - `void volumeDown()` - Adjust volume by +1. (looking for a better way to do this...) - `void volumeUp()` - Adjust volume by -1. (same here...) - `void muteToggle()` - (Un-)Toggle the volume. - `void up()` - Go up. - `void right()` - Go right. - `void down()` - Go down. - `void left()` - Go left. - `void ok()` - Confirm selection. - `void back()` - Go back. - `void home()` - Go home. - `void info()` - Show info-menu. - `void options()` - Show options-menu. - `string heartAlive()` - Send heart alive request and get back some garbage (yay!). - `void selectSource($source)` - Select the source. A list of (my) sources is shown below. ### Sources [](#sources) The sources are exactly as shown on the on-screen menu, so in my case: - Cable Sat - Disc - DVR - Radio - TV - USB - Game - Media Server - Home Network - AUX - Source A - Source B - Source C - Source D Tested Devices -------------- [](#tested-devices) On this devices the API seems to work, according to some testers. I hope this list will increase over time. - Harman Kardon AVR 370 - Harman Kardon AVR 170 - Works, but [heart-alive won't respond.](https://github.com/KarimGeiger/HKAPI/commit/6036d4f42b94f23cf62b1186ca95587f42e10e04#commitcomment-16567477) - Harman Kardon HK 3700 - Works, but [has problems while waking up.](https://github.com/KarimGeiger/HKAPI/commit/6036d4f42b94f23cf62b1186ca95587f42e10e04#commitcomment-16324589) - Harman Kardon BDS 7773w - Harman Kardon BDS 375 - Harman Kardon BDS 277 - Harman Kardon AVR 1510 - Harman Kardon AVR 161S Known Issues / Incompatible Devices ----------------------------------- [](#known-issues--incompatible-devices) Here you can find a list of devices known to be incompatible to the current version of the API as well as an explanation of the problem. - None known Disclaimer ---------- [](#disclaimer) This project is not affiliated with, or endorsed by Harman Kardon in any way. Harman Kardon is a registered trademark. If you think this project is harming you or your company, please contact me. ### Health Score 24 — LowBetter than 32% of packages Maintenance18 Infrequent updates — may be unmaintained Popularity21 Limited adoption so far Community17 Small or concentrated contributor base Maturity34 Early-stage or recently created project Bus Factor1 Top contributor holds 70.6% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://avatars.githubusercontent.com/u/2329930?v=4)[Karim Geiger](/maintainers/KarimGeiger)[@KarimGeiger](https://github.com/KarimGeiger) --- Top Contributors [![KarimGeiger](https://avatars.githubusercontent.com/u/2329930?v=4)](https://github.com/KarimGeiger "KarimGeiger (12 commits)")[![fdp1nm](https://avatars.githubusercontent.com/u/10390672?v=4)](https://github.com/fdp1nm "fdp1nm (3 commits)")[![kgeiger-godaddy](https://avatars.githubusercontent.com/u/105433340?v=4)](https://github.com/kgeiger-godaddy "kgeiger-godaddy (2 commits)") ### Embed Badge ![Health badge](/badges/karimgeiger-hkapi/health.svg) ``` [![Health](https://phpackages.com/badges/karimgeiger-hkapi/health.svg)](https://phpackages.com/packages/karimgeiger-hkapi) ``` ### Alternatives [stripe/stripe-php Stripe PHP Library 4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk A PHP wrapper for Twilio's API 1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api GitHub API v3 client 2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk PHP SDK for Facebook Business 90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php PHP wrapper for the Meilisearch API 73813.7M114](/packages/meilisearch-meilisearch-php)[google/gax Google API Core for PHP 263103.1M454](/packages/google-gax) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)