Remote control for Yamaha receiver

My Yamaha RX-V577 receiver came with quite a nice Android app for remote control, but no desktop program. Looking around, I could find no existing desktop program, so I decided to write my own.

The receiver implements something called the “Yamaha Network Control Alias” protocol, YNCA. There exists a 1500+ pages reference document, but that is hard to find, so I have made a copy available.

The reveiver listens for text commands on TCP port 50000. Here is the initial conversation between the program and the receiver. Replies from the receiver are indented relative to commands:

         @SYS:INPNAMEAV1=    TV
         @SYS:INPNAMEAV2=   AV2
         @SYS:INPNAMEAV3=   AV3
         @SYS:INPNAMEAV5=   AV5
         @SYS:INPNAMEAV6=   AV6

There are five commands in that conversation:

  • @MAIN:VOL=? asks for the current sound volume.
  • @SYS:INPNAME=? asks for the name of the inputs. These names are configurable.
  • @MAIN:SCENENAME=? asks for the names of the “scenes”. These are also configurable.
  • @MAIN:VOL=-22.0 sets the volume. There is no reply.
  • @MAIN:BASIC=? asks for a number of basic parameters. The program sends this command every few seconds.

All commands and replies take the form of assignments: @group:identifier=value

There is no additional protocol. A client can connect, send a single text command like “@MAIN:VOL=-22.0” and immediately disconnect. A command must end in a carriage-return followed by a line-feed (“\r\n“).

To test communication, use nc. These command lines switch power on and off:

$ echo -e '@MAIN:PWR=On\r' | nc yamaha 50000
$ echo -e '@MAIN:PWR=Standby\r' | nc yamaha 50000

The receiver only accepts a single connection.


To compile it you need gcc 4.8.0 or later, and either Qt4 or Qt5. Build instructions:

  • Downloaded the archive. Unpack.
  • Modify compiler-related variables in
  • $ qmake
  • $ make
  • The executable is ./i386/gcc/bin/yamaha.elf.

Beware of a subtle detail here. qmake generates Makefile, but the makefile that gets used by make is makefile. The lowercase makefile includes the capitalized Makefile, and adds a few targets and settings. If that is confusing, you can change the filename of the generated makefile:

$ qmake -o Makefile.generated

Remember to change the include statementin makefile.

There is no install target. To install, copy these files:

  • ./i386/gcc/bin/yamaha.elf
  • yamaha.qtss

The .qtss (Qt Style Sheet) file must be in the same directory as the executable, or any parent or (great) grandparent directory. The application will search for it all the way up to the root directory.

Running the remote control

Program options:

  • -a address : The hostname or IP address of the receiver. Defaults to
  • -p port : The port number that the receiver listens on. Defaults to 50000.
  • -v : Verbose. Show YNCA commands and replies.
  • -d : Debug. Lots of output.

To overcome the receivers limitation of a single connection, the program listens on port 50000 and forwards everything to the receiver. Replies are NOT returned; this is pure one-way communication.

The labels on the mute and power buttons show what will be done if they are pushed. If the receiver is on, then the button will say “Off”.

You can reach me by email at “lars dash 7 dot sdu dot se” or by telephone +46 705 189090

View source for the content of this page.