Configuring the Wax Box in your music system

The Wax Box is versatile, so you decide how to integrate it in your music system.

Option 1 - direct control

You can control the system using devices connected directly to the Wax Box. To view the Wax user interface, you can connect a computer monitor using the D-Sub, DVI-D, or HDMI ports on the back panel. The HDMI port also allows you to connect a TV, either directly or through an AV receiver. If you have a projection TV, use the HDMI port to create a 10-foot user interface.

To interact with the user interface, you will need a pointing device. A mouse is probably not a good choice because it requires a flat surface to operate. A trackpad avoids this problem. A handheld finger mouse with trackball might be a good choice for a 10-foot user interface. You can connect these devices using any of the USB ports on the back panel. Another good option is to use one of the Logitech devices with a “Unifying Receiver”. The Unifying Receiver is a small dongle that plugs into a USB port, permitting the device to operate without a cord. The Logitech Wireless Touchpad is a good example of such a device.

If you plan to rip CDs and enter metadata at the Wax Box, you will also need a keyboard. Connect the keyboard using one of the USB ports or the PS/2 keyboard port. A good choice for a keyboard is the Logitech Wireless Touch Keyboard K400 because it has a built-in touchpad and it connects to the Wax Box wirelessly using the Unifying Receiver.

We advise setting up the system using option 1 at least the first time you operate the system. Option 2 requires a network connection, so you will not be able to control the system – or even to see what is happening – if something goes wrong with the network connection. Also, it is easier to configure the network connection using a direct connection. For maximum convenience, you can configure the Wax Box for both direct and remote control.


When you power on your Wax Box, Wax runs automatically. It appears inside a black border which fills the rest of the screen. If you ever need to exit Wax so that you can access the desktop, you cannot do so by clicking the X button in the frame of the window because the frame is not visible. Instead, use keyboard shortcuts: either ctrl-q or alt-F4. It might also be helpful to know that F8 opens a menu for the viewer. You could use the menu to exit fullscreen mode, for example, if you want to access the desktop without terminating Wax.

Option 2 - remote control

You can control the system using a wireless device from the convenience of your listening position. The Wax Box automatically runs a remote desktop server, permitting you to view the desktop from any platform able to run a remote desktop viewer. The next section (Configuring the remote desktop viewer) contains instructions for connecting to the Wax Box using a remote desktop viewer. Using a remote desktop viewer, you can control the Wax Box from any device able to run such software. Install the viewer software on your tablet for greatest convenience. Ripping is often done most easily from a desktop system because then you can use the keyboard and mouse to enter or manipulate metadata. You might even enjoy controlling your system using your smartphone.


It is possible to operate the Wax Box without a network connection, but you will lose several capabilities: viewing Wikipedia pages in Play mode and downloading metadata, including cover art, in Edit mode from sources on the Internet. However, you will still be able to view and play recordings in your collection.

If you use a wired connection, connect the Ethernet cable to the port on the back panel. It is not necessary to change the configuration.

As usual, a Wifi connection is a bit more complicated. For Wax Box 2, you will need to plug a Wifi dongle into a USB 2.0 port on the back panel (Wifi is built in for Wax Box 3 and Wax Box 4). Medialink makes one with 802.11n that projects less far from the back panel than many others. You will also need to configure the system to connect to your network. Click the Network Connections button on the control panel (the one with the waves radiating upward) and then choose the Wireless tab. Enter the SSID for your wireless network on the first page. “Connect automatically” and “Available to all users” should be ticked. You might also want to specify an appropriate name for the connection (e.g., the SSID). Select the Wireless Security tab to configure security according to the settings for your network.

If Ethernet is not available at the location of your audio system, you might want to consider using a HomePlug adapter (a wired connection is the preferred configuration for Wax Box 3 or Wax Box 4). We have had good results using the ZyXEL PLA401v4. In our experience, it provides a data bandwidth in the range 65-75 Mbps – well shy of the 200 Mbps maximum. You might get a higher bandwidth from Wifi, but HomePlug could help avoid problems with interference.

Back panel

_images/appendix-back-panel-1.png _images/appendix-back-panel-2.png _images/appendix-back-panel-3.png _images/appendix-back-panel-4.png

To use the analog output of the Wax Box, connect an audio cable to the green jack on the back panel. If you prefer to use an external USB DAC, connect it to one of the USB 3.0 jacks (the blue ones). For multichannel, use the black jack for left and right rear and the orange one for center and sub. You can use the USB 2.0 jacks for keyboard and mouse or for the Unifying Receiver of a Logitech Wireless Touch Keyboard K400 or for a Wifi dongle (Wax Box 3 has Wifi built in). If you want to connect a monitor or TV, you have a choice of D-Sub (VGA) port, DVI-D port, or HDMI on Wax Box 1 and Wax Box 2, DVI-D, HDMI, and DisplayPort on Wax Box 3, or HDMI and DVI-D on Wax Box 4.

Wax Box 4 SE

The Wax Box 4 SE system is powered by an external linear power supply. Connect the +19V output of the power supply to the main power input of the Wax Box and the +5V output to the power input of the BitScrubber board. Connect the digital input of your audio system to the appropriate digital output of the BitScrubber board – either BNC or RCA.

Activating a Wax Box 4 SE involves two steps. First, turn on the external power supply using the rocker switch. Be sure that the red slide switch is set for the appropriate line voltage. Second, push the power button on the front panel of the Wax Box. Reverse the sequence to turn off the Wax Box: Push the power button on the Wax Box and then turn off the power supply after the blue power LEDs go off.


Wax Box 4 users should also be aware that there is a headphone output on the left side of the case just behind the front panel between the two USB 2.0 ports and the two USB 3.0 ports. (There is also a push button which has no function.)

Configuring the remote desktop viewer

You can interact with Wax from almost any device, whether it runs iOS, Mac OS X, Android, Windows, or Linux. Although the Wax Box is designed to function without a monitor, it still generates a desktop on which the Wax interface appears. You can view this desktop using an application known as a “remote desktop viewer”. Wax supports two prevalent protocols for conveying a desktop to a remote viewer, RDP and VNC. You can use whatever viewer you prefer. Each has its own style of interaction with the remote display. If you are dissatisfied with the style of one viewer, try another. Be aware that RDP is a more efficient protocol, so favor it if your network is slow. You can also find viewers for your desktop systems, if you would like to control Wax from them as well.

Our favorite viewers

You are free to use any remote desktop viewer that suits you. Browse Google Play for your Android device, iTunes Store for your iOS device, or Mac App Store for your OS X device. Try “remote desktop browser”, “rdp”, or “vnc” as keywords for your search. Also, consider a Web search using your favorite search engine as you may find free, open source applications that are not in any of the application stores.

We have not done an exhaustive survey of available applications, but here are some of our favorites:

  • Android: Jump Desktop, RealVNC
  • iOS: Jump Desktop ($15)
  • OSX: CoRD (free at; Jump Desktop ($30)
  • Windows 7: RealVNC Viewer (free)

To connect the viewer to the Wax Box, you must configure the viewer to locate the Wax Box on your LAN. Normally, you will specify the Wax Box using its symbolic name, which is either waxbox-3.local or waxbox-4.local, depending on which system you have. If you must configure the viewer with the IP address of the Wax Box, then you will have to determine the IP address first. If you have a keyboard and monitor connected to your Wax Box, use the command ifconfig in a terminal window to view a listing that includes the IP numbers for all the network interfaces or click on the network status monitor on the right of the control panel. You want the IP number associated with eth0 if you are connected by Ethernet or wlan0 if you are connected by Wifi. If you do not have a monitor connected. An easy way to get the IP number is to run an application known as a “zeroconf browser” on any device on your LAN. On the Android platform, a suitable program is called “ZeroConf Browser” (free). On iOS, there is one called “NetExplorer” ($0.99). On Ubuntu, there is one called avahi-browse. With any such browser, look for a service with “wax” in the name associated with the protocol (RDP or VNC) that you intend to use. For example, if you use an RDP viewer, you will need to find the IP address for “wax-client-RDP”. Make a note of the IP address and enter it in your remote desktop viewer. Some viewers have service discovery built in. In those cases, it might be possible to select the Wax Box from a list of names. A third way to get the IP number is to connect to your router and view the list of attached devices.


If you are configuring the viewer using the IP address of the Wax Box, be aware that the router might assign a different address each time you turn on the Wax Box. You will need to update the viewer configuration every time the IP address changes. If you are familiar with router configuration, you can reserve the IP address so that it will not change. Normally, routers change IP address assignments rarely, but it will be annoying – or even perplexing – if it happens. Look in the DHCP configuration of your router for address reservation.

If you are using RDP, your viewer controls the resolution of the remote desktop. You can set the resolution to whatever value suits you, but be aware that Wax was designed to run on a desktop with resolution 800x480. With either RDP or VNC, be sure to select color depth of at least 16 bits per pixel or the cover art will be distorted.

Wax provides three ports for VNC connections, 5901, 5902, and 5903. Connect to port 5901 to view the Wax client normally (the client occupies the entire screen of your remote viewer). Connect to port 5902 for desktop mode. In desktop mode, you will see the entire desktop with the Wax client on it. Use this mode if you need to view the manual or a cover art file, if you need to open a browser to access a streaming service, or if you need to open a terminal to do system maintenance. Connect to port 5903 to view documents or images.

VNC connections

Port View
5901 Normal (Wax fills the display)
5902 Desktop (Wax is visible on the desktop)
5903 Documents or images

With some remote desktop clients, you specify the port number for the connection by entering it in a suitably labeled entry. With others, you append the port number to the IP address after a colon (e.g., waxbox-4.local:5902 or Since 5900 is the default port for VNC, it is even possible that you would specify only the last digit (e.g.,

For convenience, configure three connections in your remote desktop viewer, one for normal mode (name it “Wax (normal)”, perhaps), one for desktop mode (name it “Wax (desktop)”), and one for documents/images (name it “Wax (viewer)”). If you need to specify a username and password to connect, use “wax” as the user name and “3beezwax” as the password.

It is worth mentioning that you are allowed to connect more than one viewer at a time. A change in one viewer appears instantly in the other viewers. Use whichever device is most convenient without worrying about synchronizing them.

Preferred network configuration for Wax Box 3 or Wax Box 4

It is so much easier to connect a Wax Box to your LAN using a wired connection that we are now urging users to use Homeplug when Ethernet is not available. Connecting the Wax Box to the LAN using a wired connection frees the Wifi interface so that it can be configured as an AP (Access Point). Now you can connect your tablet to the Wax Box directly using this AP rather than the one in your router (although it will still work to use the one in your router). The SSID for this AP is “waxnet”. Select it in the Wifi configuration for your tablet. In your remote desktop viewer, specify as address “waxbox-3.local” or “waxbox-4.local” with port number either 5901 or 5902, as discussed above. In the unlikely case that the remote desktop viewer cannot connect using the symbolic name of the Wax Box, you can easily get the appropriate IP address. Go back to Wifi settings and view the configuration for the current connection (to waxnet). (On an iPad, tap the i with a circle around it.) Use the IP number that appears as the IP address for the router or DNS (they should be the same). When you configure your system this way, you will not have to find the IP address of your Wax Box using a zeroconf browser, as discussed above. Also, your tablet is almost guaranteed a strong Wifi signal because you will most likely be near the Wax Box when you are using your tablet to control it.

You can still connect to the Wax Box through the IP address assigned to its Ethernet connection (which is how you will connect a remote desktop viewer on your desktop system). Follow the procedure discussed above. Also, it is still possible to use the Wifi interface in the Wax Box instead of a wired connection to connect to your network, but you will then not be able to connect your tablet directly to the Wax Box.

Updating the software

Normally, Wax updates itself automatically when a newer version becomes available. The system checks for a newer version and installs it if one is available. It then restarts the servers and the client. The update is scheduled to take place late at night to minimize the risk that an update disrupts a listening session.

It is possible to initiate an update manually. Open a terminal (or log in remotely using ssh) and run the command

sudo wax-update

You can check the date of the last update and the numbers of the current versions in Config mode on the Disk tab (disk-update). The command above will perform the update only if the version in the update server is newer than the one in your Wax Box. To force an update regardless of version, use the command

sudo wax-update -f

Reading status messages

When something is wrong, it often helps to read the status messages. If the client is not running, you can run it from a terminal using the command

wax-client start

The status messages will appear in the terminal. If the client is already running, it is possible to view the status messages in a log file. The log files reside in ~/.wax/log (the most recent log file is called wax.log). To monitor new messages as they arrive in this file, use the command “tail -f wax.log”. Any message following “Uncaught exception” indicates a serious problem. These messages are forwarded automatically to 3beez technical support (critical errors).

There may also be relevant log messages in /var/log/syslog. Search for the string “wax-update” to get information about the update process. Search for “nameserver”, “dataserver”, “playserver”, “ripserver” to see the respective servers starting or stopping. Search for “wax-client” to see the client starting or stopping. Search for wax-backup to see the backup of the sound drive happen.

Configuring the Wax Box to use a different audio output

The sound system in the Wax Box must be configured appropriately to direct its audio output to the desired interface – analog, BitScrubber board, or USB. Every Wax Box is configured initially to use the interface specified at the time of purchase. If you ever need to change the configuration, you can run a command in a terminal window. The command takes an argument which specifies the desired output. The most useful arguments are “analog” and “usb”:

sudo wax-output <analog | usb>

You will need to enter a password to run this command (3beezwax). Specifying analog enables not only the analog output, but also the two BitScrubber board outputs and TOSLINK. Selecting usb will disable these outputs.

Adjusting geometry of the main window

You can stretch the Wax window by dragging a corner or an edge. You can also maximize it using a button at the top right of the window. Such changes will not be permanent. You cannot make the window smaller than its default size (800x480) by this means (though you can using the procedure below).

To make permanent changes to the geometry of the window, create a file in the directory /home/wax/.wax called “mainwindowgeometry”. Specify the desired geometry by including any or all of the following lines:

variable default purpose
MAIN_WINDOW_SIZE (800, 480) overall dimensions of the main window (parentheses are required)
RIGHT_PANEL_VBOX_WIDTH 341 width of the right panel (the one that contains the play queue, among other things)
IMAGE_WIDTH 74 width of the cover art thumbnails in icon view
ITEM_PADDING 5 space between the thumbnails in icon view
DIVIDER 254 position of the divider between the recording and track lists (larger numbers position divider farther down)
PLAY_KEY_COL_WIDTH 100 width of the column for the metadata key in Play mode
PROPS_KEY_COL_WIDTH 125 width of the column for the property key in Play mode

Modify the given default values (with a line like PLAY_KEY_COL_WIDTH = 150) to change the layout as desired.

Another option is to use F10 to toggle “fullscreen mode”. In fullscreen mode, Wax will fill the desktop on which it is displayed. You will have to use F10 to get out of fullscreen mode if you need to access the desktop. Wax remembers the setting of fullscreen mode from one session to another.

Running on localhost

You can force the Wax servers to bind to localhost (rather than the router) by setting the parameter “use_local_host” in the servers configuration file ~/.wax/serversrc to True (False otherwise). Use the editor Leafpad (on the main menu under Accessories) to edit the file. If the network is slow, this technique might improve responsivity of the client.

Accessing the Wax Box over the LAN

It is possible to access the Waxbox over your LAN. Five folders are directly related to the operation of Wax:


The sound folder has three subdirectories. The data subdirectory contains all the sound data that you ripped from your CDs and imported from files. This folder resides on a hard disk drive dedicated to the sound archive. The other two subdirectories are related to the inner workings of Wax.


The metadata folder contains the metadata for your collection. You will not normally access the files in this folder yourself, but it is possible to export their content to a spreadsheet (see export metadata).


The documents folder has documents (both PDFs and images) for each recording.


The transfer folder is used to transfer files to (Import) and from (Export) the Waxbox. This folder may contain subfolders if you choose to create them. Note that when the file chooser in either the import or export operations tells you that you are in the root folder, this is the folder you are actually in. Use this folder to import or export sound files, or to import images or documents documents.

The transfer folder is also the location in which your spreadsheet will appear if you export your metadata. You can view the spreadsheet using a spreadsheet program (e.g., Excel) running on some other platform on your LAN or by running Gnumeric on the Wax Box itself (accessed from the main menu on the desktop).


Wax automatically copies the contents of the sound and metadata folders once a day to folders with the same names in the backup directory. Read about the backup and restore operations in the documentation for Config mode.

The backup folder resides on a hard disk drive different from the one for the sound folder, so if the primary hard disk fails, you can restore your collection from this folder. If both hard disk drives fail, you will lose your collection, so to be extra cautious you should back up sound/data, metadata, documents, and .wax over your LAN to an external device as well. If you choose to implement a redundant backup in this manner, consider configuring a backup program to run automatically on a regular basis (e.g., every day).



To enter Unicode characters in your metadata manually (rather than with the Unicode keyboard), you need to use a special sequence of keystrokes. There are two options. Choose the one that is more comfortable for you.

Method 1:

Type (and release) ctrl-shift-u, code, {enter,space}

{enter,space} means that you can type either enter or space. You do not need to type leading zeros in the code. If the code is 00e9, you can type just e9. The characters that you type for the code turn into the desired Unicode character when you type enter or space.

Method 2:

Press (and hold) ctrl-shift, u, code, release ctrl-shift

Again, you do not need to type leading zeros. The characters that you type for the code turn into the desired Unicode character when you release ctrl-shift.

To find the code for the Unicode character that you want, use a table such as this one: Unicode-table. The code that you need is the numeric portion of the Unicode code point (the portion after “U+”).

Here are some characters that you might need:

code character code character code character
00e0 à 00e1 á 00e2 â
00e4 ä 00e8 è 00e9 é
00ea ê 00eb ë 00f1 ñ
00f2 ò 00f3 ó 00f4 ô
00f5 õ 00f6 ö 00f9 ù
00fa ú 00fb û 00fc ü

Completion files

Wax provides automatic completion of values you type into work metadata fields. Predefined completion values are stored in files in the directory ~/.wax/completions. The name of a file corresponds to the key to which the values should be applied. Initially, Wax provides several completion files, including composer, conductor, and orchestra. To create your own completion files, use a text editor (e.g., Leafpad) to specify values (one on each line). Wax ignores blank lines and lines that start with # (to signify a comment). Restart Wax after creating a new completion file.

Default property configuration files

Wax allows you to specify sets of default values for properties (except for the first four automatic properties). You specify the values in files that reside in the directory ~/.wax/propsdefaults. The name of the file is the name that Wax presents on the context menu that appears when you right click in the panel for properties in Edit mode. The format is simple, but unforgiving. If you create a new configuration, model the contents on one of the existing files. For example, the file that ships with the Wax Box with the configuration for CDs contains this:

{“Source”: “CD”, “Sample rate”: 44.1, “Resolution”: 16, “Codec”: “FLAC”}

You must surround the entire specification with {}. Each specification follows the pattern “<key>”: <value>. <key> is the name of the property. The value should be in quotes if it is a string; do not use quotes if the value is numeric. If you do not want to specify a default value for a particular property, omit the entire “<key>”: <value> specification.

Wax reads the files in the propsdefaults directory once when it is starting. If you make any changes to the files, you must restart Wax before those changes will take effect.

Bulk transfer

Many new Wax users already have a sound archive which they created using some other system (e.g., iTunes or Windows Media Player). Wax provides a way to transfer this legacy archive into Wax. As you would expect, there are limitations to this process. Wax uses different metadata tags to describe a recording depending on the genre of the recording whereas your legacy system uses a single set of metadata tags (basically, “album title” and “artist”). Moreover, the metadata that you will want to use to catalog a recording in Wax may not even exist in your legacy archive. For example, you might want to include the name of the lyricist in your description of a recording destined for the Show genre, but that information is most likely not in your legacy archive. Inevitably, full integration of your legacy archive into Wax involves some effort on your part.

Accepting these limitations, you can transfer your legacy collection in one simple operation. The transfer preserves the metadata that you have currently and it obviates ripping your entire collection again. Thus, you can immediately enjoy your existing collection from within Wax. There is no need to do anything else, but those who care may choose to edit the existing metadata to take advantage of the superior capabilities of Wax and to move recordings to the appropriate Wax genre.

To transfer your legacy archive you will run a program called “wax-transfer” in the directory at the top of the file system hierarchy containing your music collection. Although the program navigates the file system in your legacy system, it actually runs on the Wax Box. Here is how to make this magic happen: On the Wax Box, activate the file manager (PCManFM) by clicking the icon in the task bar with the folders (you need to be using a monitor and keyboard connected directly to the Wax Box or you need to be connected using a remote desktop client in desktop mode). Under Go, select Connect to Server and then specify how to connect to your legacy system (using ssh, most likely). Navigate to the folder at the top of the hierarchy containing your sound archive. [See Warning below] When you get there, click Tools | Open Current Folder in Terminal (or type F4). A terminal window will open in that folder. Type the command “wax-transfer”. The program will automatically transfer all of the sound files that it finds in the file system hierarchy to your Wax Box. It will create a new genre on the Wax Box for the recordings that it transfers. By default, the new genre will be called “Bulk import”. Use the -n option to specify a different name. The wax-transfer program examines the tags of each recording it finds. If there is a genre tag, then wax-transfer will store the recording in a subgenre of “Bulk import” with that name. If there is no genre tag, then it will assign the recording to subgenre “No genre”.


There is a bug in the file manager (PCManFM). When you get to this point, you might find that the option Tools | Open Current Folder in Terminal is grayed out, so you will not be able to select it. If this happens, go to the left panel of PCManFM. At the top of the panel is a button which probably says “Places”. Click the button and select “Directory Tree”. Select root (“/”) and navigate into run/user/<nnn>/gvfs/<sftp:...>. Navigate to the top folder of the hierarchy containing your sound archive. This time you will be able to open a terminal. Continue as above.


wax-transfer has several command-line options. Use -h or -‑help to have the program itself list them.

short long function
-h ‑-help print help message and exit
-e END ‑-end END stop after transferring recordings up to index END
-i INDICES ‑-indices INDICES comma-separated list of indices of recordings to transfer
-l ‑-list just list the recordings found without transferring them
-n NAME ‑-name NAME the name of the super genre in Wax
-s SKIP ‑-skip SKIP skip the first SKIP recordings

To use the -i option to transfer specific recordings, use the -l option first to get a list of recordings with their index numbers, then use the index numbers of the desired recordings in the -i option. If a transfer fails to complete, use the index number of the last successful transfer in the -s option to skip the recordings that were successfully transferred.

To play a recording from your legacy collection, select it in the usual manner. The dropdown list that appears when you click the genre button in Select mode will now contain the genre “Bulk import” (or whatever name you assigned in the transfer process using the -n option). It will have a pull-right menu for subgenres – most likely a large number of them (there are 148 genres defined in the ID3 specification). The main difference between the recordings imported from your legacy collection and the recordings that you create using Wax is that all the recordings from your legacy collection will be described using only the metadata keys “album” and “artist”, just as they were described on your legacy platform. Of course, the imported metadata will also suffer from the same defects that they had on your legacy platform. Correct these defects and augment the metadata using Edit mode to revise the metadata for a particular recording. Use Move to move an individual recording to the appropriate Wax genre. Use Move all to move all the recordings in a legacy subgenre to their new home in Wax and then delete the subgenre. Complete the transfer at your own pace – or not at all. Your legacy collection is immediately accessible, so the choice to integrate the recordings into Wax is yours.

Silent operation

The sound files for all of your recordings reside on the sound drive (a hard disk drive). However, when you play a recording, Wax actually plays copies of the sound files in a cache which resides on a solid-state drive. When you put a recording in the play queue, Wax checks to see whether the sound files for the recording are already in the cache. If they are, it plays the copy in the cache without ever activating the sound drive. If they are not, it activates the sound drive, copies the sound files to the cache, and then deactivates the sound drive. Likewise, Wax activates the sound drive to perform any operation that requires access to the actual sound files (e.g., deleting them) and then immediately deactivates it. You can override this default behavior by changing the value of active_standby in ~/.wax/serversrc to False. Wax also has two fail-safe mechanisms: It deactivates the HDD when it starts playing, and it deactivates the HDD after 30 minutes of inactivity. A disk icon appears in the global control panel when the disk is active. If you ever see the icon at a time when you think that the data drive should be idle, click on the icon to tell Wax that it should try to idle the HDD. Keeping the HDD idle as much as possible renders operation absolutely silent while you are listening to music, and it also extends the life of the HDD.

Streaming services

You can listen to streaming services such as Tidal and Spotify with the Wax Box using their web interface. Connect to the Wax Box in desktop mode and open the browser (the fifth button on the control panel). Access the desired streaming service just as you would from your desktop system. Be aware that it is not possible to play simultaneously from Wax and from the streaming service. As long as Wax has a recording in its play queue, the operating system thinks that Wax is playing even if you clicked the stop button, so the browser will be mute. Clear the play queue to release the sound system. When you finish listening to the streaming service, the browser might hold onto the sound system for a short time. Exit the browser to release the sound system.

Recovering from a disk crash

Wax idles both the sound and backup HDDs when they are not needed. Idling the HDDs not only silences a source of acoustic noise (see silent operation), it extends their life by reducing wear. Nevertheless, a HDD might fail. The backup that Wax creates automatically protects you from this eventuality.

In the event of a HDD failure, someone will need to replace the HDD. Most likely, you will return your Wax Box to 3beez for this service. Here are a few hints in case you decide to perform the service yourself.

The first task will be to identify the HDD that failed. Use the df command to get a list of HDDs. The HDD that failed most likely will not appear on the list. Disconnect the SATA cable from each HDD in turn and then run the df command. When disconnecting the SATA cable does not affect the output of the df command, you have found the defective HDD.

The replacement HDD will ideally be formatted ext4. You can use the gparted command to format the HDD using the Wax Box. Specify a gpt partition table.

For the replacement HDD to mount properly, you will have to update /etc/fstab with the correct UUID. Use the blkid command to get the UUID.

If it was the backup drive that failed, the final step is to perform a backup using the command wax-backup. To restore the sound drive, run the command wax-restore.