go-kef-w2

CLI, library and apps (planed) for controlling KEFs W2 platform based speakers over the network.

Command line tool

Installation

General

Grap a version for your OS from the releases page.

macOS

Install with Homebrew:

brew install hilli/tap/kefw2

Linux

Install with Homebrew:

brew install hilli/tap/kefw2

Windows

Install with Scoop

In a Windows Powershell window:

# Install Scoop if it's not already on your system
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
scoop install git
# Add repo for kefw2
scoop bucket add hilli https://github.com/hilli/scoop-bucket.git
# Install kefw2
scoop install hilli/kefw2

Note that speaker discovery might not work in Windows.

Usage

Setup the speakers

# Auto discovery
kefw2 config speaker discover --save
# Manually add a speaker
kefw2 config speaker add 10.0.0.149

If you only have one set of speakers, then that will be the default, otherwise configure that with

kefw2 config speaker default <name or IP>

If you want to control a speaker that is not the default use the -s global flag. Eksample:

kefw2 -s 10.0.0.93 status

Get status of the default speaker

kefw2 status

Get volume

kefw2 volume
# or
kefw2 vol

Set volume, 35%

kefw2 vol 35

Skip to next track if in wifi mode

kefw2 next

Select source

kefw2 source wifi
# or just display current source
kefw2 source

Play and pause in wifi mode

kefw2 play
kefw2 pause

Turn the speakers off

kefw2 off

Backup the current EQ Profile

kefw2 config eq_profile > my_profile.json

Set the max volume limit

kefw2 config maxvol 65

All with tab completion available of the options, where applicable.

Plan

• Set volume
• Mute/unmute
• Select source
• Get status
• Turn on/off
• Track next/previous
• Discover speakers automatically
• Display cover art in ASCII (wifi media)
• Backup speaker settings/eq profiles to file
• Restore speaker settings/eq profiles to file
• Play Podcasts/Radio
• Play titles from built-in music streaming services (Amazon Music, Deezer, Qobus, Spotify, Tidal)

Library

Usage

package main

import (
  "fmt"
  "log"

  "github.com/hilli/go-kef-w2/kefw2"
)

func main() {
  speaker, err := kefw2.NewSpeaker("10.0.0.93")
  if err != nil {
    log.Fatal(err)
  }

  fmt.Println(speaker.Name)
  fmt.Println(speaker.Model)
  fmt.Println(speaker.MacAddress)
  fmt.Println(speaker.IPAddress)
  fmt.Println(speaker.Version)
  fmt.Println(speaker.SerialNumber)
  fmt.Println(speaker.MacAddress)
}

Player

UI for controlling the speakers, show whats playing etc.

The idea is to create a Fyne App that will let you select inputs, show whats playing etc. My own needs is to have a Raspberry Pi with a touch screen interact with the speakers and not least control the brigtness of the screen.

Plan

• Cross compilation of Fyne apps
• Input selection buttons
• Volume/mute controll
• Play/pause button for available targets
• Display artwork and track info in wifi mode
• ?? Streaming page, playing Tidal, Qobus, podcasts, radio

Web interface & HomeKit HUB

Not there yet.

Plan

• Turn on/off
• Set volume
• Mute/unmute
• Select source
• Status page, refreshing, display artwork and track info in wifi mode (web)
• Settings page, editing (web)
• Backup/restore settings to file download (web)
• ?? Streaming page, playing Tidal, Qobus, podcasts, radio, etc (web)

License

MIT License