View source for Quickstart

{| align="right"
 | __TOC__
 |}

Welcome to WDLXTV! Be aware that the software offered here is unofficial and '''could''' damage your device (but probably won't :). Proceed at your own risk; you have been warned!


== Download the Firmware ==
Download the [http://forum.wdlxtv.com/viewforum.php?f=10 latest firmware] for your device. Ensure you get firmware appropriate to your device model (G2/Live/Plus). EXT3 versions are for non-permanently testing newer builds, so ensure you download the non-EXT3 version for your model.


== Install the Firmware to USB Stick ==
Format a USB stick to FAT32. This is easily done in Windows via My Computer -> Right Click (Drive Letter) -> Format (I'd recommend '''not''' to use Quick format). Linux users should use mkfs with vfat.

Once your stick is formatted, extract the firmware zip you downloaded and copy these files to the USB drive:
*Live:
 wdtvlive.ver
 wdtvlive.bin
 wdtvlive.fff (if provided)
 wdtvlive.bi2 (if provided)

*Plus:
 wdtvlive2.ver 
 wdtvlive2.bin
 wdtvlive2.fff (if provided)
 wdtvlive2.bi2 (if provided)

''<b style="color:red">Please do not use the often proposed HP Format Utility! It seems to cause more problems than it solves.</b>''

== Flash the Firmware ==
* Turn your WDTV '''off'''.<br/>This means pulling the power plug, not using the remote!

* Disconnect any existing USB devices you may have from your WDTV and insert the stick into the left port. 

* Plug the power cable back in, turn the unit on, and follow the onscreen instructions.

* If the screen stays dark wait at least '''15 minutes''' then remove power completely again, move the USB stick to the rear port, and re-attempt.

* If the new firmware is not found and you don't get a "New firmware found", make sure to edit the '''wdtvlive.ver''' file and change the first version number to something higher than your currently installed firmware version.

''Example:''

You have 1.02.21.WDLXTV_LIVE-0.4.5.3 running and want to up- or downgrade to any other version, change the content of '''wdtvlive.ver''' to
 VERSION='1.02.22.WDLXTV_LIVE-0.4.5.3'

If it is still not showing the upgrade notice, it's most likely due to your USB stick. (95% of the cases)<br />
In this case, start over with formatting the drive and copying the files (make sure you safely remove the device after copying!)<br />
If it's still not working, try a different USB stick.
Also see [[#Troubleshooting]] section.

== First Boot ==
If all went well you should now be running the latest, greatest version of WDLXTV! You should now use telnet to [[Set_SSH_password |set your SSH password]].


== Enabling Web Management (Live/Plus)==
Now that your SSH password has been set, you will probably want a more convenient way to manage your WDTV. Luckily, it comes with a complete and fully featured web GUI. While still connected via SSH/telnet, enter the following commands to ensure the Apache web server is running.

 config_tool -c APACHE='ON'
 config_tool -s
 /etc/init.d/S66apache2 start


== Final Steps ==
With the web GUI enabled, you can manage your WDTV much more easily. Simply point your browser to either the hostname or IP address of your WDTV box; you can find the IP address under the about system menu. The default user/pass for the web GUI is '''wdlxtv/wdlxtv'''. Note that most configuration changes '''require a reboot'''.


== Troubleshooting ==
There are several things that can go wrong and prevent a successfull firmware upgrade. The most common reasons are:


=== WDTV does not pick up the update === 

* .ver file not edited
This seems to be the most common problem and most of the time it's because you did not edit the .ver file according the instructions given. Make sure the base version (the first version number) in the .ver file is higher that the version currently installed on your WDTV.

Example:
 * Version flashed on WDTV Live: 1.05.04 (doesn't matter if official or custom)
 * Version in wdtvlive.ver: VERSION='1.06.04.WDLXTV_LIVE-0.4.7.3'
What matters most is the first version string!


* wrong USB port on WD
If the update is not picked up, try the other USB port on WDTV. Normally you should use the first port which is the one on the side.


* corrupt USB drive
Also a common reason for the update to fail is a corrupt filesystem on the USB drive, which can happen if you did not safely remove the USB drive from your Laptop/Desktop computer after copying the firmware files.
In this case start over with formatting the drive. Don't use Quick Format!


* incorrect firmware
If your WD is connected to the internet, either via ethernet or wireless dongle, and the latest official firmware update is requesting to download instead of the custom firmware on your USB, you have two options.

Fast: Unplug your WD from the internet, power cycle to see if it is now picking up the correct firmware.

Slow: As described above, edit the .ver file to be a higher version number than the official firmware wanting to download.


=== Update progress bar stays at 0% ===

* be patient!
It can take some time until the update progress starts, I've encountered lags up to some minutes at 0% myself.<br>
If it hasn't started after 5-10 min. try this:
 * unplug the USB drive
 * wait a couple of seconds
 * replug the USB drive
If it still doesn't start to update, start over with re-formating the USB drive.



* corrupt USB drive
''see above''


=== General Tips ===

If you can't get the device to update even with trying all the tips above try a different USB drive.



== Support ==
In the event you have broken something or truly get lost along the way, pop in the [http://forum.wdlxtv.com/ support forums] and someone will be happy to assist you.