dsigns

dsigns documentation

Get your player online.

Choose your device, check its connection and return to dsigns for the five-letter code.

Windows, Linux or Android →Use the device’s own network settings.dsigns Pi image →SD-card setup for the dedicated test image.

The player cannot reach dsigns. It checks again automatically and shows its five-letter connection code when the connection works. Open this guide on a phone with mobile data if the local network is unavailable.

1. Check the connection

  1. For Ethernet, connect your player to a working router or switch. Check both ends of the cable and try another cable or port.
  2. Check that the router has internet access and DHCP is enabled. An Ethernet link alone does not mean the internet is available.
  3. Allow a minute for the connection to start. A captive portal, firewall, incorrect DNS or device clock can also prevent a secure connection to dsigns.

If Ethernet works with DHCP, no SD-card changes are needed.

2. Open your device’s network settings

Use the device’s network settings to join Wi-Fi or configure a static IP address. The SD-card text file below applies only to the dsigns Pi image.

  • Windows: open Windows Settings → Network & internet. Choose the Ethernet or Wi-Fi connection. For a static address, edit its IP and DNS settings using the values supplied by your network administrator.
  • Linux PC: use the operating system’s NetworkManager settings. A dedicated dsigns image may need a keyboard and local administrator access; use sudo nmtui to edit or activate a connection. If nmtui is unavailable, your administrator can use nmcli.
  • Android TV / Google TV: press OK or Back in dsigns setup, then choose Network settings. Static-IP options and menu names depend on the device; use its Android network settings or your manufacturer’s instructions.

Return to dsigns after changing the connection. Setup checks again automatically. A player that already has a complete cached playlist can continue playing it while offline.

3. dsigns Pi image

Advanced: configure Wi-Fi or a static address on the SD card

These settings apply to the dsigns Pi test image with the network setup update. They do not configure a standard Raspberry Pi OS card or a Linux .deb installation.

  1. Shut down the Pi, wait for shutdown, then remove the SD card and connect it to your computer.
  2. Open dsigns-setup.txt on the visible bootfs drive. Edit the existing section in a plain-text editor; do not add duplicate section headings.
  3. Save the file with its original name, safely eject the card, return it to the Pi and power on.

Wi-Fi with automatic addressing

Enter your Wi-Fi name and WPA/WPA2 personal password. Use your two-letter country code. Spaces and punctuation are allowed; do not add quotation marks.

[wifi]
enabled = yes
ssid = Your network name
password = Your Wi-Fi password
country = AU
method = dhcp

After a successful import, the player clears the password from this text file and resets enabled to no. The saved connection remains on the player. Keep the card private while it contains a password. Enterprise Wi-Fi and sign-in portals require separate network administration.

Static IPv4 for Ethernet or Wi-Fi

Ask your network administrator for an unused address, prefix length, gateway and DNS servers. The values below are examples; replace them with the values for your network.

[ethernet]
enabled = yes
method = static
address = 192.168.1.50/24
gateway = 192.168.1.1
dns = 1.1.1.1,1.0.0.1

For static Wi-Fi, put those same method, address, gateway and dns fields in the existing [wifi] section, together with the Wi-Fi name, password and country, and set enabled = yes. The Ethernet section controls the Pi's built-in Ethernet port. Use a gateway in the same subnet; this setup supports IPv4 prefixes /1 through /30. IPv6 remains automatic.

To return a connection to DHCP, change its method to dhcp and set enabled = yes. When importing Wi-Fi again, re-enter its password.

Still no code?

Check the values in the file, the router's internet connection and access to https://dsigns.bitprecision.com. The player keeps retrying; no button press is needed. After a safe shutdown, the card's dsigns-diagnostics.txt contains startup and network-configuration errors. Share that report with your administrator, not your Wi-Fi password.

When five letters appear, sign in to dsigns and open Players → Add player.