User guide · macOS · Pioneer & Onkyo

Magic AV Remote — User Guide

A friendly, networked remote control for your Pioneer or Onkyo AV receiver, designed for macOS. Setup, day-to-day controls, advanced features, themes, Apple Shortcuts, and troubleshooting — everything you need to get the most out of the app.

1. Introduction

Magic AV Remote is a native macOS app that controls supported Pioneer and Onkyo AV receivers over your local network. Instead of hunting for the physical remote, you keep a small, always-available control window on your Mac — with volume, input switching, listening modes, EQ, tone, zone control, sleep timer, player transport, and more.

Supported receivers

The app handles two families of receivers:

FamilyDefault TCP portTypical receivers
eISCP (Modern)60128Modern Pioneer and Onkyo models (e.g. SC-LX704 family)
Telnet (Legacy)8102Pre-2017 Pioneer Elite models (e.g. the SC-35)

Magic AV Remote hides the differences behind a single UI. A few advanced features only exist on certain models, and the guide says so where it matters.

If your receiver isn't named above but is part of the same Pioneer or Onkyo lineage, it's worth a try — many siblings of these models accept the same commands. Worst case, the app simply won't connect.

Platform requirements

About the project

Magic AV Remote is an independent, third-party app. It is not affiliated with, endorsed by, or sponsored by Pioneer Corporation, Onkyo Corporation, Dolby Laboratories, or any audio-format or receiver manufacturer. Product and brand names are referenced only to indicate compatibility.


2. Finding and connecting to your receiver

Before the app can do anything useful you need to tell it about your receiver. There are two ways: let the app find it for you, or enter the details by hand.

2.1 Open the receivers list

  1. Launch Magic AV Remote.
  2. Click the receiver name in the title bar (it reads "Select Receiver" the first time) to drop the receiver menu down.
  3. Choose Receivers… at the bottom of the menu. The Settings sheet opens.

You can also click the small gear icon in the title bar to jump straight there.

2.2 Automatic network discovery

The app has a built-in scanner that finds compatible receivers on your LAN without you needing to know IP addresses.

  1. In the Settings sheet, scroll to the Network Discovery section.
  2. Click Scan Network.
  3. Wait roughly five seconds. A spinner shows while the scan is in progress.

The first time you click Scan Network, macOS will prompt you to allow Magic AV Remote to find and connect to devices on your local network. Click Allow. After granting permission, you'll likely need to click Scan Network again to actually run the scan.

Each discovered receiver appears with its model name, IP address, port, and family. Press Add to save it. If a receiver is already saved, you'll see a green checkmark instead of an Add button.

Legacy-class receivers can't be found by the broadcast portion of the scan. The app also tries a TCP sweep across your subnet on port 8102, which can pick them up, but it's less reliable than the broadcast — so if your receiver is Legacy-class, the scan may not find it. Manual entry is the sure thing. There are also times when a receiver doesn't respond to a network scan for unknown reasons, so it's always worth attempting a manual connection.

If discovery returns nothing, the most common causes are:

2.3 Manual entry

You can always add a receiver by hand. If the network scan didn't find your receiver (most often the case with Legacy-class receivers), this is how you get it into the app.

  1. In the Settings sheet, click Add Receiver.
  2. Fill in the form:
    FieldWhat to enter
    NameAnything you like ("Living Room", "Theater"). Optional; falls back to the IP if blank.
    Host / IP AddressThe receiver's IPv4 address (preferred) or hostname. Find it in the receiver's Network menu.
    PortFilled in automatically based on family; change only if your receiver uses a non-default port.
    FamilyPick eISCP (Modern) or Telnet (Legacy).
  3. The Port field auto-updates when you change the Family:
    • eISCP (Modern) defaults to 60128.
    • Telnet (Legacy) defaults to 8102.
  4. Click Save.

Tip: if you only know your receiver by hostname and connecting fails with "Hostname lookup failed," enter the IP address instead. Some Bonjour/mDNS setups don't survive across VLANs.

2.4 Editing and deleting saved receivers

To edit a saved receiver, open Receivers… and click its row. You can change its name, host, port, family, or input configuration. There's also a Delete Receiver button at the bottom of the form.

To delete quickly: swipe left on a row in the Receivers list (trackpad two-finger swipe).

2.5 Multiple receivers and switching between them

You can save as many receivers as you like. Switching between them takes two clicks:

  1. Click the receiver name in the title bar to drop the menu down.
  2. Pick the receiver you want.

When you switch, the app disconnects from the previous receiver, opens a fresh connection to the new one, and queries its full state. Your previous receiver's saved settings (custom name, hidden inputs, theme) are preserved.

The chosen receiver also persists per window: closing and reopening the window will bring you back to the same one.

2.6 Connection states

The colored dot in the title bar shows the live connection state. It uses four states:

StateColor (default theme)Meaning
ConnectedGreenThe connection is open and command/response is flowing. The dock icon also flips to color.
IdleYellowThe connection has been dropped to save resources after 90 seconds of inactivity. The app will reconnect automatically the moment you press a button or touch the volume control.
UnreachableRedThe app tried to reconnect and the receiver did not answer. Could be off, off-network, or in deep standby.
DisconnectedGreyThe app isn't connected for this receiver. Either you clicked Disconnect manually, no receiver is selected, or the initial connection attempt failed.

A small Connect / Disconnect toggle sits next to the dot if you want to force the state by hand.

2.7 Troubleshooting first-connection issues

When connecting fails you'll see an alert with a short headline and an actionable suggestion. The most common ones:

Telnet (Legacy) receivers only accept one control client at a time. eISCP receivers may accept more than one — it depends on the model. If you have another remote app open (mobile, browser, another Mac) and you're getting "Connection refused," it's likely the other client is holding the only available control slot. Close it, or power-cycle the receiver to drop it.

If you're certain the receiver is on but nothing connects, try the wrong-family check: open the receiver in Settings and verify the family selector matches your receiver. An eISCP command sent to a Telnet (Legacy) receiver (or vice versa) won't produce a useful error — the receiver simply ignores you.


3. Basic use

Once you're connected, the main window gives you everything you need for day-to-day listening.

3.1 Power

The wide Power button in the upper-left of the main panel toggles the current zone on and off. The label updates ("Zone 1 Power", "Zone 2 Power", "Zone 3 Power") to reflect which zone you're controlling.

3.2 Volume

The minus / plus buttons next to the volume display step volume down or up by 0.5 dB. Press and hold for continuous adjustment — the first repeat fires after about 0.4 seconds and then every 0.15 seconds. Both timings are configurable in Settings → Volume Buttons.

The volume readout uses a stylized DIN-Alternate font and shows decibels with a half-step fractional part (e.g., 25.5 dB).

Mac F11 / F12 media keys, and the Mute media key, are intercepted by the app while it's frontmost and routed to the current zone instead of the system output (see §7).

3.3 Mute

The Mute button beneath the volume column toggles mute for the current zone. Its color and label flip when muted.

3.4 Input selection

Below volume, the Input button shows the currently selected source ("HDMI 3", "NETWORK", or a custom name you assigned). Click it to drop a menu of all visible inputs. Pick one and the receiver switches immediately.

The list is filtered two ways:

3.5 Zone tabs (MAIN ZONE / ZONE 2 / ZONE 3)

The three tabs across the top of the main panel select which zone you're controlling. A small filled circle on a tab indicates that zone is powered on, so you can see at a glance what's active without leaving the current tab.

Zone 2 and Zone 3 require corresponding hardware on the receiver. Not every model includes a second or third zone — generally, the more capable (and pricier) models do. If your receiver doesn't have Zone 3 hardware, the Zone 3 tab still appears but the commands have no effect.

Zone 4 is not currently supported. A handful of flagship receivers expose a fourth zone over their network interface. Magic AV Remote does not control Zone 4 today; support is on the roadmap as a future enhancement.

3.6 Kill All

The red KILL ALL button at the bottom of the window powers every zone off with one click — main, zone 2, and zone 3. Useful at bedtime, or when you suddenly need everything quiet.


4. Advanced features

Open the bottom drawer by clicking its chevron. Inside is a stack of advanced controls. We have attempted to limit the controls displayed to those actually supported by your receiver, but there are instances where we cannot detect. So there may be features shown in the Advanced Features that have no effect on your receiver. This will be cleaned up more in a future version.

4.1 Listening mode

A drop-down menu near the audio readouts lets you set the active listening mode (Direct, Stereo, Dolby Surround, DTS Neural:X, Pure Audio, Auto Surround, and so on). The available modes are tailored to each receiver family, so only modes your receiver actually accepts appear in the menu.

The audio-format readout next to it shows what's currently playing (e.g. DolbyTrueHD 7.1), which can differ from the setting (e.g. Auto Surround).

4.2 Tone controls (bass & treble)

Inside the drawer you'll find arrow controls for bass and treble, each stepping up and down through the receiver's native range.

Some receivers also expose a "tone controls on/off" master switch. When yours does, a toggle appears in the drawer; switching it off lets you compare flat vs. shaped output without losing your settings.

4.3 Equalizer

When connected to a receiver that exposes a graphic equalizer, a multi-band EQ appears in the drawer. Each band has a small slider; changes are sent live as you drag. Note that these changes are temporary and are only in effect until the receiver is powered off. This is a limitation of the hardware/firmware.

The EQ panel only appears once the app has confirmed your receiver actually accepts equalizer commands. SC-35 / Elite-class Telnet (Legacy) receivers do not appear to expose EQ controls, so the panel never shows up for them — this is a hardware/firmware limitation, not a missing app feature.

4.4 Input renaming

You can rename any input to whatever makes sense to you ("Apple TV" instead of "HDMI 3", "Turntable" instead of "PHONO", etc.).

Some receivers can store the new name on the receiver itself, which means it shows up on the receiver's own front panel and in any other remote app that talks to it. Other receivers don't support saving names back. When that's the case, Magic AV Remote stores your changes locally — the new name appears in this app, but the receiver and any other apps will still see the original input name.

A note at the top of the input-config view tells you which mode applies to your receiver.

To rename:

  1. Open Receivers…, click your receiver.
  2. Click Configure Inputs….
  3. Type a name into any row. Press Return (or click another field) to commit.

The Reset All Input Customizations button (red, destructive) wipes the local overrides — any names you saved to the receiver itself are untouched.

You can also hide an input by unchecking the checkbox on its row. Hidden inputs don't appear in the main input menu but are otherwise unaffected.

4.5 Output channel display

When the drawer is open, a row of labeled boxes shows which speaker channels are active in the current playback (L, R, C, LS, RS, LB, RB, SW, plus heights). Active channels light up; inactive ones stay dim. Click an individual channel's box to adjust its trim level relative to the others — a quick way to nudge balance or surround mix.

The display reflects what the receiver is actually decoding, so it changes when you switch from a 2.0 source to a 5.1 source.

4.6 HDMI output selection

Receivers with multiple HDMI outputs (MAIN, SUB, MAIN+SUB) expose an output-select cycle button in the drawer. Press it to step through the available outputs. If your receiver has only one HDMI output, no button appears.

4.7 Dimmer

If your receiver has a front-panel display dimmer, a small cycle button steps through its levels (Bright / Dim / Darker / Off).

4.8 12V triggers

Receivers with 12V trigger outputs (typically used to wake amplifiers, projectors, or motorized screens) show two toggles labeled 12V A and 12V B. Click to flip each on or off.

4.9 Sleep timer

Found inside the drawer, the sleep timer lets you tell the receiver to power itself off after N minutes. You can pick from preset durations or zero (off).

While a sleep timer is active, the app refreshes the remaining minutes every few seconds so the on-screen countdown stays roughly in sync with what the receiver knows.

4.10 Player controls panel

When the current input is a network / streaming / iPod input that supports player transport (Internet Radio, Spotify, AirPlay, USB-DAC, Media Server, etc.) and the zone is powered on, a Now Playing-style panel appears between the main controls and the drawer.

It shows:

The panel only appears on inputs that actually support it. Switching to HDMI 3 won't show it; switching back to NETWORK will.

This feature is supported on eISCP (Modern) receivers. Telnet (Legacy) receivers do not appear to expose track metadata or transport controls via this protocol.

4.11 Front-panel display mirror

The dark strip at the top of the main panel mirrors the receiver's front-panel readout, in real time, in a DIN-Alternate font. When the receiver powers off, the strip clears automatically (the receiver stops sending front-panel updates while off).

4.12 Additional controls for SC-35 / Elite receivers

When connected to a Telnet (Legacy) receiver, additional cycle buttons may appear in the drawer for features common to SC-35-class hardware:

Effectiveness varies by model; the exact set of working controls depends on what your receiver's firmware actually accepts.

4.13 Additional controls for modern receivers

On eISCP (Modern) receivers, the drawer reveals a different (larger) set of cycle buttons:

Each is a single-button cycle: tap to advance one step through that feature's valid states. The current state is queried and displayed as a label. Buttons for features your receiver doesn't have are hidden automatically.

4.14 Speaker A/B

If the receiver supports speaker-A/B switching, a small two-button group lets you toggle output to speaker set A, set B, or both.


5. Themes

Magic AV Remote ships with six built-in themes and a per-slot color editor for everything else.

5.1 Built-in presets

PresetVibe
OnyxDeep black surfaces with electric cyan/blue accents (the default).
PearlPale blue-tinted whites; light counterpart to Onyx with the same cyan family.
EmberPure-black surfaces, smoky slate mid-tones, vivid ember-red accents.
RubyWarm light surfaces with burgundy and red accents.
AmberWarm dark surfaces with golden amber accents.
CitrineBright warm light with yellow/gold accents.

To pick a preset:

  1. Click the receiver-name title bar → Theme….
  2. In the editor, the preset chips appear at the top. Click one to load it.

5.2 Per-receiver themes

Themes are stored per receiver, not globally. This means Zone 2 in your bedroom can wear Pearl while the main living-room receiver wears Onyx, and switching between them in the window selector flips themes automatically.

This is a deliberate design choice; if you previously had a single global theme from an older build, it's migrated forward to every saved receiver the first time you launch.

5.3 Custom theme editor

The theme editor exposes every individually-themable color slot, grouped into logical categories:

Each row is a color well — click to open the system color picker. Hit Reset to Default on any slot to revert just that one.

5.4 Reset

To start over, load a preset (e.g. Onyx) — it clears all overrides and replaces them with that preset's complete set.


6. Multi-window: controlling multiple receivers at once

Magic AV Remote is a multi-window app. From the File → New Window menu (or ⌘N), open as many windows as you have receivers — each is fully independent.

Tip: arrange your windows side-by-side and you've got a synchronized whole-house remote. Combined with the On Top option (right-click in the title bar to toggle "Always on Top"), a small floating window can live in the corner of your screen permanently.


7. Keyboard shortcuts

When the Magic AV Remote window is focused:

KeyAction
F11System-level Volume Down media key — intercepted and routed to the receiver.
F12System-level Volume Up media key — intercepted and routed to the receiver.
Mute media keyMute toggle for the active zone.
⌘NOpen a new window.
⌘WClose the focused window.
⌘QQuit Magic AV Remote.

The media keys target whichever zone tab is currently selected. That's the simplest way to control a different zone without leaving the main window: pick the tab, then press the volume keys.

When the app is not frontmost, the media keys revert to the system default behavior (changing your Mac's output volume).


8. Apple Shortcuts integration

Magic AV Remote exposes a set of actions to the macOS Shortcuts app so you can build automations (and trigger them by voice, by hotkey, on a schedule, or as part of larger automations).

8.1 Available actions

ActionParametersWhat it does
Set PowerReceiver · Action (On / Off / Toggle) · Zone (Main / Zone 2 / Zone 3)Power the chosen zone on, off, or toggle it.
Set VolumeReceiver · Volume (dB, default −25) · ZoneSet the absolute volume in decibels.
Adjust VolumeReceiver · Direction (Up / Down) · Steps (1–40) · ZoneStep volume up or down by N half-dB steps.
Set MuteReceiver · Action (On / Off / Toggle) · ZoneMute, unmute, or toggle the chosen zone.
Select InputReceiver · Input · ZoneSwitch to a specific input. The picker shows your renamed inputs.
Player TransportReceiver · Action (Play / Pause / Play-Pause / Next / Previous)Send a transport command to the current network/iPod source.

8.2 Example automations

8.3 Using Shortcuts

Just keep Magic AV Remote running (it's fine in the background) and your Shortcuts will work. The actions appear in the Shortcuts app's action library under "Magic AV Remote." If a Shortcut needs to pick from your renamed inputs, open the receiver once in the main app first — that gives the input picker something to show.


9. FAQ

Why won't it connect?

Open Settings → Receivers, double-check the IP and family. The number-one cause of failures is "Connection refused" because another app, browser tab, or stale session is holding the receiver's single allowed control slot — close other clients or power-cycle the receiver. See §2.7.

Can I control two receivers at once?

Yes — open multiple windows (⌘N) and select a different receiver in each. Each window holds its own connection.

Does it work without internet?

Yes. The app is LAN-only. It talks directly to your receiver over your local network. There is no cloud service. You can disable internet on your Mac entirely and the app still works.

Why doesn't the equalizer show on my SC-35?

SC-35 / Elite-class receivers don't appear to support graphic-EQ control via their network interface. The EQ panel only appears when the connected receiver responds to an EQ query, which these receivers do not. This is a hardware/firmware limitation, not a missing app feature.

Can I use it with another receiver model?

Probably, if it's a Pioneer or Onkyo with eISCP (Modern) or Telnet (Legacy) support. Add it manually with the appropriate port (60128 or 8102) and see whether commands flow. Some commands may produce errors (the receiver simply ignores them) but core features — power, volume, mute, input — are widely shared across the families.

How do I reset the theme?

Open the theme editor (title bar menu → Theme…) and click the Onyx preset to restore the design's baseline. Individual color slots can be reset one at a time inside the editor.

Is my data sent anywhere?

No. All traffic is between your Mac and your receiver over your local network. The app makes no outbound internet connections and has no analytics. Album-art images for the Now Playing panel are fetched from the receiver itself, not from a third party.

Can I run a macro / sequence of commands?

Yes, via Apple Shortcuts. Chain Set Power, Select Input, Set Volume, etc., into a single Shortcut and bind it to a hotkey or schedule. See §8.

Does it support HomeKit?

Not directly. The receivers themselves don't speak HomeKit either. However, you can wrap Magic AV Remote's Shortcuts into a Personal Automation in the Home app on your Mac/iPhone, or trigger them via Siri, which is effectively the same outcome.

My receiver is on but the dot is grey ("Disconnected"). What gives?

Click Connect in the title bar to manually open a session, or open the receiver menu and re-select the receiver to force a fresh connect. If the dot quickly flips to red ("Unreachable"), the receiver isn't answering — check power, network, and that no other client is holding the slot.

The volume keys move my Mac's volume instead of the receiver's. Why?

Magic AV Remote only intercepts the media keys while it's the frontmost app. Click the window to bring it forward and the keys will route to the receiver.

Why does the connection drop after a minute or two of doing nothing?

That's the deliberate idle state. After 90 seconds of inactivity the app closes the connection so the receiver's single control slot is free for other apps. As soon as you press any button, it reconnects automatically. The dot turns yellow during this state.

Why are renamed inputs not showing in my Apple Shortcuts picker?

Open the receiver once in the main app and let it finish querying state (about 2–3 seconds after the green dot appears). Once the app has seen your inputs, the names appear in the Shortcuts picker even when the main app is closed.

Will this run on my Intel Mac?

No — Magic AV Remote is Apple Silicon only. The app is built arm64-only and requires an M1, M2, M3, M4, or later Mac running macOS 14 (Sonoma) or newer.

Why is Zone 3 grayed out / not doing anything?

Zone 3 is a hardware feature — not every receiver model includes a third zone. Generally, the more capable (and pricier) models do. If your receiver doesn't have Zone 3 hardware, the Zone 3 tab still appears in the app but the commands have no effect on the receiver.

What does "Pure Audio" mode do, and does it work here?

Pure Audio is the receiver's pristine-signal mode (display off, video circuits off where possible). It's exposed in the listening-mode menu when the connected receiver advertises it. Pick it from the menu and the receiver will switch.


Appendix A — Glossary