Difference between revisions of "S00custom-options"

From WikiDLXTV
Jump to: navigation, search
Line 168: Line 168:
  
 
==== Power actions ====
 
==== Power actions ====
Power actions are executed when the OSD is suspended/resumed.
+
Power actions are executed when the OSD is suspended/resumed.<br/>
Power actions are NOT executed when your wdtv live comes on from cold boot / power cycle.
+
Power actions are NOT executed when your wdtv live comes on from cold boot / power cycle.<br/>
Power actions are executed when:
+
Power actions are executed when:<br/>
 
* the wdtv live goes into standby via remote
 
* the wdtv live goes into standby via remote
 
* the wdtv live wakes up from suspend via remote
 
* the wdtv live wakes up from suspend via remote
Use S00custom-options or S00user-script for actions that happen at boot.
+
Use S00custom-options or S00user-script for actions that happen at boot.<br/>
 
DO NOT EXECUTE usb.power.on OR usb.power.off in power actions (see USB_POWER_OFF setting).
 
DO NOT EXECUTE usb.power.on OR usb.power.off in power actions (see USB_POWER_OFF setting).
  
Line 180: Line 180:
 
  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_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!"'
 
  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 ====
 
==== Change SMB resolve order to 'proper' order ====
Line 189: Line 194:
  
 
==== Change Samba share export to not allow guest (anonymous) mounting ====
 
==== Change Samba share export to not allow guest (anonymous) mounting ====
If you do this you'll have to supply your own smb.conf with all the proper settings configured in order to mount exported shares remotely.
+
smbpasswd is stored in /conf
  config_tool -c SMB_NOGUEST=ON
+
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'
  
==== Disable/enable Samba exported shares on standby ====
+
==== 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.
 
Default is ON.
 
  config_tool -c SMB_STANDBY=OFF
 
  config_tool -c SMB_STANDBY=OFF
 +
 +
==== Disable/Enable Samba auto export mode ====
 +
Default is ON.
 +
config_tool -c SMBD_AUTO=OFF
 +
 +
==== Set Samba Workgroup ====
 +
config_tool -c SAMBA_WORKGROUP=SomeWorkgroup
 +
 +
==== Enable NFSD kernel NFS server ====
 +
Default is OFF.
 +
config_tool -c NFSD=ON
 +
 +
==== Enable NFSD auto export mode ====
 +
Default is OFF.
 +
Requires NFSD_AUTO_DEFAULT
 +
Overrides /conf/exports
 +
config_tool -c NFSD_AUTO=ON
 +
 +
==== NFSD auto export mode default setting ====
 +
config_tool -c NFSD_AUTO_DEFAULT='192.168.0.234(rw,async,no_subtree_check) 192.168.0.199(rw,async,no_subtree_check)'
  
 
==== Enable Eiri ====
 
==== Enable Eiri ====

Revision as of 11:56, 7 September 2010

Contents

The S00custom-options is a file that contains settings that you can configure that aren't accessible by the regular Settings option on the WDTV. WARNING: Any syntax errors in this file will cause the OSD to not boot at all.

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

Default is ON.

config_tool -c SMBD_AUTO=OFF

Set Samba Workgroup

config_tool -c SAMBA_WORKGROUP=SomeWorkgroup

Enable NFSD kernel NFS server

Default is OFF.

config_tool -c NFSD=ON

Enable NFSD auto export mode

Default is OFF. Requires NFSD_AUTO_DEFAULT Overrides /conf/exports

config_tool -c NFSD_AUTO=ON

NFSD auto export mode default setting

config_tool -c NFSD_AUTO_DEFAULT='192.168.0.234(rw,async,no_subtree_check) 192.168.0.199(rw,async,no_subtree_check)'

Enable Eiri

Default is OFF. What is eiri and howto here.

config_tool -c Eiri=ON 

Enable Deluge bittorrent client

Deluge is disabled by default.

config_tool -c DELUGE=ON

Deprecated since version 0.4.2.1 (Deluge has been replaced by rtorrent)

Disable Deluge bittorrent web UI

The web UI (user interface) are the controls of the torrent client that you can view in your browser.

config_tool -c DELUGEWEBUI=OFF

Deprecated since version 0.4.2.1 (Deluge has been replaced by rtorrent)

Disable lighttpd webserver

This is enabled by default.

config_tool -c LIGHTTPD=OFF

Deprecated since version 0.4.2.1 (lighttpd has been replaced by the apache webserver)

All of the above settings can also be set by manual execution via telnet/ssh.