Advanced topics are FYI only. This chapter describe some additional things to improve subject sound quality, something worth exploring if you are interested. This section is a work in progress and is not finished yet. Please check back after a few weeks.
This is a quick start guide summarising the steps to download, install and configure Snakeoil OS.
Before We Start
Here are some things you need know before hand:
- Snakeoil is designed, tested and run on Atom based Mini-ITX motherboards. Other configurations will work but is not tested thoroughly.
- Only the most popular on-board network cards are supported out of the box. Please refer to this section to install a custom install kernel if your network card is not in this list:
- Broadcom Tigon3
- Intel E1000E/E1000
- Realtek 8169
- Atheros AR815x/AR816x/AR817x
- Your computer needs to be acquire an IP address from your router (or DHCP server) during the first installation. After Snakeoil OS is installed you can assign a static IP address.
Follow these steps to install:
Download the latest ISO:
File Download this if snakeoil-i686-1.0.0.iso You are using a computer that only executes 32 bit code snakeoil-x86_64-1.0.0.iso Everybody else
- Create the LiveCD (Read this if you havn't done this before)
- Connect the machine you want to install on a Network. Turn it on.
- If doing remote install - identify the IP address of the computer (or you can try the computer snakeoil) and remotely connect using VNC (Password is Password1)
- Follow the Ubiquity install wizard to install the OS onto a local storage, remove LiveCD and click the reboot button.
- Start a web browser from your computer and connect to the machine (http://new_machine_name_you_provided_earlier/)
- Go through all the tabs from left to right to configure Snakeoil
- Copy your files to new_machine_name_you_provided_earlier/music and your playlist to new_machine_name_you_provided_earlier/playlists
- Start your player remote control app
- Scan your music library
- Hit play
Here's a video walk-through of the installation process.
This is outdated. Will be revised soon.
Snakeoil is now multi-lingual. The following languages are available:
- English (UK)
- 中文 (简体)
- 中文 (繁體)
And the Snakeoil Squad needs your help to expand the above list! Please follow this simple documentation to translate Snakeoil to your language of choice. (Please note that language translations only applies to the web interface and not the underlying software players)
This article assumes you are using the English language as you edit/create your translations. Please use the equivalent text if your Snakeoil system is set to another language.
Native DSD is another way of playing DSD material on your Snakeoil PC. Traditionally, DSD data is wrapped in PCM and sent to the DAC. This method is commonly known as DSD over PCM (DoP).
A newer method is to send the raw DSD data directly to your DAC. This is called native DSD, and is only supported by some DACs.
How To Enable Native DSD Kernel
Download the native kernel from this thread - Native DSD: linux-4.4.9-rt17, install the kernel and reboot your Snakeoil PC.
For MPD and Squeezelite, set your streaming mode to "PCM (Pulse Mode Modulation", and away you go!
Supported Native DSD DACs
DAC Comments Confirmed Aune X1S 32BIT/384 DSD DAC All Snakeoil kernels with USB audio Denon All Snakeoil kernels with USB audio DIYINHK DSD DXD 384kHz USB to I2S/DSD All Snakeoil kernels with USB audio iFi Audio micro/nano iDSD All Snakeoil kernels with USB audio Gustard DAC-X20U All Snakeoil kernels with USB audio JLsounds I2SoverUSB All Snakeoil kernels with USB audio Makua Molamola Snakeoil DSD kernel > 20180318 Marantz All Snakeoil kernels with USB audio Matrix Audio X-Sabre All Snakeoil kernels with USB audio Matrix Audio Mini-i Pro All Snakeoil kernels with USB audio OPPO HA-1 All Snakeoil kernels with USB audio OPPO Sonica Snakeoil DSD kernel > 20180619 Playback Designs DAC All Snakeoil kernels with USB audio PS Audio NuWave DAC All Snakeoil kernels with USB audio xDuoo XD-05 Snakeoil DSD kernel > 20180318
Add Your Native DAC To Snakeoil OS
If your native DAC is not in the list above, generate a diagnostic file and send it to the Snakeoil Squad for us to evaluate (Email the file to snakeoil.os'@'gmail.com).
This is a step by step walkthough on how to setup the BIOS for a Jetway NF9C motherboard to make sure it'd work with Snakeoil.
So you tried your hand in building your own custom kernel and it fails. Fret not as it is extremely easy to get it back to a working state. You just need to connect your keyboard and monitor back and change the boot sequence manually.
A disk partition in simple terms means a "slice" of your HDD/SSD. Partitioning allow you to split up your SSD into multiple sections. For more information about partitions, refer to this excellent wikipedia article.
This section will describe how to partition your main OS media from within Ubiquity installer.Partitioning is a process that will remove all the files on the areas you're working on. Please make sure all the information data are already copied to a safe location (i.e. backed up) before you continue with partitioning.
To be expanded.
Uploading kernel wouldn't work when you are using persistent USB.
If you're using Squeezelite with LMS, you can configure SnakeoilOS as a 2 PC setup, where one machine runs only the Logitech Media Server, and the other runs only the Squeezelite client.
The are at least two advantages of using this setup:
- Ability to create multiple "zones" (one Squeezelite client being one zone)
- Splitting LMS and Squeezelite into two machines may yield a sound quality improvement
For this configuration please ensure you have activated ALL your SnakeoilOS machines. Enter your activation code for all your machines - you do not need unique activation codes for different machines.
The following picture is the player setting you should set for your Server machine. This is the machine where you run Logitech Media Server. This is also the machine where all your music files are store. This machine will stream music to all your clients.
The following is the player setting for your client machine(s).
This is a good guide to build a RT based kernel: Linky
To be expanded.
The stock kernel included in every ISO only supports a limited range of computer hardware. This is a deliberate choice because the stock kernel will support > 80% of all computers. Supporting everything risk degrading sound quality. All is not lost if the stock ISO image don't work for your computer hardware. You can re-author (modify) the ISO with a kernel tailored to your machine. This chapter describes the process.
How To Modify USB
- Download the ISO, and build it to a USB stick. Follow these instructions.
Go to the forums and download your required custom install kernel. These files have the following naming convention:
install-__.zip (where on the build)
- Extract the downloaded file to get vmlinuz, like so:
- Your USB stick should have the following file structure (note this is for version 1.0.0 and future versions may look slightly different):
- Go into the folder casper (again this is for version 1.0.0 and future versions may look different):
- Rename the file vmlinuz to vmlinuz.backup:
- Copy the file from step 3 into here, like so:
- Safely eject the USB. And you're done.
- Now reboot the computer with this USB stick and you're now using a custom kernel specially tailored to your computer
How To Modify ISO
If you are installing Snakeoil OS using CD/DVD, you need to re-author the ISO and then write the modified ISO image to CD/DVD. You'd need a ISO re-authoring tool for this. You can follow this tutorial.