S00custom-options

File placement

This file is executed only when the WDTV starts/boots up, every boot, so operations placed here should not be adversely affected by multiple execution. If you want to apply changes, you have to issue a reboot -f from ssh/telnet or unplug and replug the power cord.

The file is called S00custom-options (no extension). Place it on the root directory of a USB drive attached at boot.

You can also name it S00user-script and place it to the /conf directory on the WDTV. If you choose to create a /conf/S00user-script you must make sure it contains no syntax errors as it will prevent your wdxtv from booting.

WDTV Live

How to use S00custom-options

To enable any setting you see in the file, remove the hash mark (#) from the start of the line. this:

#config_tool -c SOMESETTING=somesetting

becomes:

config_tool -c SOMESETTING=somesetting

config_tool settings 'stick' after being executed once, so you are only required to set them once.

Common settings

Here is a list of currently available config_tool commands for the WDTV Live (running WDLXTV-Live firmware).

Changing the background

Supplying a single image name only works if that image resides in /osd. You may instead use an absolute location to specify any background image you desire, just make sure it exists.

For the original background:

config_tool -c BACKGROUND_IMAGE=original_bg.jpg

For eM82's backdrop background:

config_tool -c BACKGROUND_IMAGE=eM82_bg.jpg

For the wood panel (default) background:

config_tool -c BACKGROUND_IMAGE=villa_bg.jpg

Simplest way to change the background image is adding your image renamed to villa_bg.jpg (maxsize=524288) to root folder of USB drive, and power cycle.

Number of entries in list view

This will change the number of rows in list view.

config_tool -c LISTNUM=4
config_tool -c LISTNUM=6
config_tool -c LISTNUM=8
config_tool -c LISTNUM=10  # (default)
config_tool -c LISTNUM=11
config_tool -c LISTNUM=12

Number of thumbnails in video thumb view

This will change the video thumb view to various amounts of thumbs. It changes the resolution of the displayed image.

config_tool -c THUMBRESO=150x200  #12 thumbs
config_tool -c THUMBRESO=163x245  #8 thumbs
config_tool -c THUMBRESO=180x240  #10 thumbs
config_tool -c THUMBRESO=225x300  #4 thumbs
config_tool -c THUMBRESO=240x360  #4 thumbs

Number of thumbnails in music/photo thumb view

This will change the music and photo thumb views to various amounts of thumbs.

config_tool -c GENTHUMBS=10  #10
config_tool -c GENTHUMBS=15  #15  (default)

Video info overlay position

This requires reboot after change. Used to be able to see subtitles during pause, timing, etc.

Upper ~60% of the screen:

config_tool -c VIDEO_INFO_BAR=2

Top (warning: options bar covers up info overlay with setting 3):

config_tool -c VIDEO_INFO_BAR=3

Subtitle sizes

This will change the subtitle size to one not menu-selectable.

config_tool -c SUBTITLE_FONT_SIZE=44
config_tool -c SUBTITLE_FONT_SIZE=48
config_tool -c SUBTITLE_FONT_SIZE=50
config_tool -c SUBTITLE_FONT_SIZE=52
config_tool -c SUBTITLE_FONT_SIZE=56
config_tool -c SUBTITLE_FONT_SIZE=60
config_tool -c SUBTITLE_FONT_SIZE=64
config_tool -c SUBTITLE_FONT_SIZE=68
config_tool -c SUBTITLE_FONT_SIZE=72
config_tool -c SUBTITLE_FONT_SIZE=76
config_tool -c SUBTITLE_FONT_SIZE=80

Timezone

Change your timezone. Use this as a guide.

config_tool -c TIMEZONE=PST8PDT  #Pacific North America

Hostname

Change the hostname (what other devices over the network see your WDTV as).

config_tool -c DEVICE_NAME=SomeHostName

Custom USB slot icons

config_tool -c USBICONS='OFF'    #  (default: ON)

Disable telnet server

config_tool -c TELNETD=OFF       #  (default: ON)

Custom telnet server port

config_tool -c TELNETPORT=49532  #  (default: 23)

Disable pure-ftpd server

config_tool -c FTPD=OFF          #  (default: ON)

Disable dropbear ssh server

config_tool -c SSHD=OFF          #  (default: ON)

Custom dropbear ssh server port

config_tool -c SSHPORT=62356     #  (default: 22)

Disable keep alive of ethernet during WDTV Live standby

config_tool -c DISABLE_ETHERNET_ON_STANDBY=YES

Delay for net.mounts execution

in case of wireless adapter usage and shares not showing up

config_tool -c NET_MOUNTS_DELAY=30

Automatic IP obtain at boot

NTP requires IPUP=ON

config_tool -c IPUP=OFF          #  (default: OFF)

Enable NTP (network time)

ONLY with wireless: NTP adds ~20s to the initial boot of the device due to the bringing up and acquisition of wireless network address. If NTP fails because of slow address acquire you can increase delay to NTP_DELAY.

config_tool -c NTP=ON

Custom NTP server

config_tool -c NTPSERVER=pool.ntp.org

NTP delay

NTP delay in seconds (in case of slow wireless adapter)

config_tool -c NTP_DELAY=0

Disable mt-daapd digital audio server

Saves approximately 10MB of RAM.

config_tool -c MT-DAAPD=OFF

Disable pandora binary

Saves approximately 2MB of RAM

config_tool -c PANDORA=OFF

Disable UMSP

UMSP requires APACHE=ON

config_tool -c UMSP=OFF          #  (default: ON)

Disable Apache webserver

WARNING: Disabling Apache will make UMSP, youtubeHD, shoutcast, and (of course) the webend stop working!

config_tool -c APACHE=OFF        #  (default: ON)

Enable rtorrent bittorrent client

SSH server must be enabled to start rtorrent
apache webserver must be enabled to use webui
RTORRENT_DIR *MUST* be set for full functionality!
rutorrent & rtorrent DEPEND on it

config_tool -c RTORRENT=ON       #  (default: OFF)

Set rtorrent data location

for incomplete/session/finished/rutorrent
the line below is an EXAMPLE(!) to have your device mounted at /tmp/mnt
create a file on it called: .mnt

config_tool -c RTORRENT_DIR=/tmp/mnt/123ed956-1256-4825-9e79-86fc1e0febaa/

Enable nzbget usenet client

Disabled by default. Apache webserver must be enabled to use web UI.

config_tool -c NZBGET=ON         #  (default: OFF)

Disable online-delayer

Disable online-delayer (in case of stalled network detection) or because nzbget / rtorrent / net.mounts / etc won't execute

config_tool -c ONLINEDELAYER=OFF

Power actions

Power actions are executed when the OSD is suspended/resumed.
Power actions are NOT executed when your wdtv live comes on from cold boot / power cycle.
Power actions are executed when:

the wdtv live goes into standby via remote
the wdtv live wakes up from suspend via remote

Use S00custom-options or S00user-script for actions that happen at boot.
DO NOT EXECUTE usb.power.on OR usb.power.off in power actions (see USB_POWER_OFF setting).

You may have number actions which are executed in order.

config_tool -c POWER_UP_ACTION='logger -t "power_up_action" "I am doing something"
config_tool -c POWER_UP_ACTION20='sleep 5; ether-wake -b xx:xx:xx:xx:xx:xx; sleep 10; /etc/init.d/S90net.mounts start'
config_tool -c POWER_DOWN_ACTION='logger -t "power_down_action" "the OSD has been suspended!"'

==== Enable/Disable Samba Windows share server ==== (default: OFF) Disabled by default

config_tool -c ENABLE_SAMBA_SHARE=1   #  enable Samba Windows share server
config_tool -c ENABLE_SAMBA_SHARE=0   #  disable Samba Windows share server

Change SMB resolve order to 'proper' order

This may or may not work for you. This MUST contain either valid settings or be blank.

Stock/official firmware order:

config_tool -c SMB_RESOLVEORDER='bcast lmhosts wins host'

Proper/corrected order:

config_tool -c SMB_RESOLVEORDER='lmhosts host wins bcast'

Change Samba share export to not allow guest (anonymous) mounting

smbpasswd is stored in /conf This setting requires a reboot if executed manually (telnet/ssh instead of S00 script)

config_tool -c SAMBA_SERVER_PROTECTION_STATE=1
config_tool -c SYSTEM_USERNAME='SambaUser'
config_tool -c SYSTEM_PASSWORD='SambaUser'
config_tool -c SMBSHARE_USERNAME='SambaUser'
config_tool -c SMBSHARE_PASSWORD='SambaUser'

Enable guest read only access, plus user protected write access

This setting makes no sense without the settings above set

config_tool -c SAMBA_PROTECTION_WITH_GUEST=1

Disable/Enable Samba exported shares on standby

Default is ON.

config_tool -c SMB_STANDBY=OFF

Disable/Enable Samba auto export mode