Work in Progress: These docs are incomplete and may contain inaccuracies. Norri is not yet available for download.

Configuration

Every Norri audio endpoint has a built-in web configuration interface. You can access it from any browser on the same network by navigating to the device’s address (e.g., http://norri-amp.local).

The interface is divided into four sections: Device, Network, Protocols, and Status.

Device name

The Device section lets you set the name of your audio endpoint. This name is used in several places:

  • Appears as the speaker name in AirPlay
  • Shows as the renderer name in DLNA/UPnP apps
  • Visible as the device name when pairing via Bluetooth
  • Determines the .local hostname used to access the device from a browser

How the hostname works

The device name is automatically converted into a valid hostname:

Device NameHostnameAddress
Norri Ampnorri-amphttp://norri-amp.local
Kitchen Speakerkitchen-speakerhttp://kitchen-speaker.local
Matt’s Roommatts-roomhttp://matts-room.local
Living Room 2living-room-2http://living-room-2.local

The conversion rules are:

  • Spaces and underscores become hyphens
  • Special characters (apostrophes, exclamation marks, etc.) are removed
  • Everything is lowercased

The current hostname is shown below the name field after you save.

Renaming and access

When you change the device name:

  1. The hostname updates immediately
  2. All audio services restart to pick up the new name
  3. The mDNS name updates so other devices can find it at the new .local address
  4. The old .local address stops working

If you rename a device while accessing it via http://old-name.local, you’ll need to navigate to the new address after saving. The confirmation message shows the new address.

Tip

If you’re accessing the device by IP address (e.g., http://192.168.1.177), renaming won’t affect your access.

Network

The Network section shows your current network connection and allows WiFi management.

When connected via ethernet

The section shows your ethernet IP address. If WiFi is also configured, the saved WiFi network name is displayed with options to change or forget it.

If WiFi is not configured, a Set up WiFi button is available. Configuring WiFi while on ethernet is useful if you plan to move the device to a location without ethernet later.

When connected via WiFi

The section shows:

  • The connected WiFi network name (SSID)
  • The device’s IP address
  • Signal strength

Two buttons are available:

  • Change Network scans for available networks and connects to a different one. The device will disconnect from the current network and join the new one. If you’re accessing the device over WiFi, you’ll need to reconnect and navigate to the device’s new IP address.

  • Forget WiFi clears saved credentials. The device will switch to setup mode (Norri-Setup access point) so you or someone else can reconfigure it. Useful when moving the device to a different location or giving it to someone else.

When in setup mode

When the device is in access point mode (Norri-Setup), the network section shows the WiFi setup form with a list of detected networks, a manual SSID field, and a password field. This is the same interface shown during initial setup.

Protocols

The Protocols section has toggle switches for each audio protocol. All protocols are enabled by default.

Sendspin

Multi-room synchronized audio. This is Norri’s native protocol for grouped playback across multiple endpoints. When grouped in the Norri app, audio is synchronized across all endpoints in the group with sub-millisecond accuracy.

Sendspin receives audio from a Norri media server or Music Assistant. It does not appear as a standalone target on your phone. Use the Norri app or Music Assistant to send audio to Sendspin endpoints.

AirPlay

Receives audio from Apple devices (iPhone, iPad, Mac, Apple TV, HomePod). The endpoint appears automatically in the AirPlay output picker on any Apple device on the same network.

Supports AirPlay 1. The audio stream is received and played directly, no transcoding or processing is applied.

DLNA / UPnP

Universal Plug and Play media rendering. The endpoint appears as a media renderer in any DLNA-compatible app or software, including BubbleUPnP, foobar2000, Windows Media Player, and many others.

DLNA supports a wide range of audio formats. The endpoint uses GStreamer for decoding, which handles MP3, FLAC, WAV, AAC, OGG, and most other common formats.

Bluetooth

Bluetooth A2DP (Advanced Audio Distribution Profile) sink. The endpoint is discoverable and can be paired with phones, laptops, tablets, or any other Bluetooth audio source.

Once paired, the device appears as a Bluetooth speaker. Only one Bluetooth source can be connected at a time.

Note

When multiple protocols are active, the device plays audio from whichever source is currently streaming. If multiple sources try to play simultaneously, the most recent one takes priority.

Status

The Status section shows whether each service is currently running or stopped. This is useful for troubleshooting. If a protocol isn’t working, check here first.

The services shown are:

ServiceDescription
SendspinThe Sendspin audio client process
AirPlayshairport-sync, the AirPlay receiver
DLNAgmediarender, the DLNA/UPnP renderer
BluetoothBlueALSA, the Bluetooth audio bridge
NQPTPNetwork time protocol used for AirPlay synchronization
Web UIThe lighttpd web server serving this configuration page

A green dot means the service is running. A grey dot means it is stopped.

Services that are disabled in the Protocols section will show as stopped. This is expected. If a service that should be running shows as stopped, try rebooting the device by unplugging and re-plugging the power supply.

Saving changes

After making changes to the device name or protocol toggles, click Save & Apply. The device will:

  1. Save the new configuration
  2. Update the hostname (if the name changed)
  3. Start or stop services as needed
  4. Restart running services to pick up the new name (if the name changed)

A confirmation message shows the device’s current .local address after saving.