Custom Firmware Package Notes

From hummy.tv Wiki
Revision as of 11:52, 9 June 2012 by Ezra pound (talk | contribs) (Extract To MPG)
Jump to: navigation, search

BREIF NOTES FOR CUSTOM FIRMWARE PACKAGES

Note Note: Some Functions of the Web Interface are 'Built-In' and do not require an additional package to be installed, These Features are covered in the Web If section of this page

Some packages require a reboot (Hard disk spin down) before they take effect


7Zip

Command line utility that can pack and un-pack zip type files

  • Supported Packing / unpacking Formats = 7z, XZ, BZIP2, GZIP, TAR, ZIP and WIM
  • Supported Unpacking only = ARJ, CAB, CHM, CPIO, CramFS, DEB, DMG, FAT, HFS, ISO, LZH, LZMA, MBR, MSI, NSIS, NTFS, RAR, RPM, SquashFS, UDF, VHD, WIM, XAR and Z.


Auto-Unprotect

The Auto Unprotect package runs in the background and automatically removes the Encryption Protected flag on High Definition recordings. This is the flag which prevents the file from being decrypted in the same way a Standard Definition file. On first installation, the hard disk will be scanned for any high definition recordings and they will be unprotected. Thereafter new recordings will have the flag removed as they are completed

Auto Unprotect also makes a change to the DLNA index so that High Definition files can be streamed without DTCP

NOTE:- The removal of the ENC flag does not decrypt the file, However it does make decyption possible by the same means as a Standard Definition file, see flow chart HERE


Auto-Update

This package automatically keeps the installed packages up to date by checking for any new releases daily and automatically downloading and installing them, It will check once per day at the earliest power on, for most people probably the 04:30 boot


Bash

Bourne Again SHell is an enhanced Sh (Shell) Command line / scripting language See Reference Guide


Betaftpd

For HDR-Fox T2

The HDR-FOX T2 has a built-in FTP server, This default server will still be in available after the Custom Firmware is installed, However only files under ‘Media’ are visible, Betaftpd has two possible Logins, If login = humaxftp and password = 0000 is used then only ‘Media’ is visible. If login = root and password = 0000 is used then the entire file system is accessable. If the remote password has been changed from 0000 then the new password must be used

NOTE:- The Built-in FTP server must be turned off if Betaftpd is used with Menu >> Settings >> System >> Internet Settings >> FTP Server = OFF

For HD-Fox T2

Betaftpd will add an FTP server to the Humax after installation, Betaftpd has two possible Logins, If login = humaxftp and password = 0000 is used then only ‘Media’ is visible. If login = root and password = 0000 is used then the entire file system is accessable. If the remote password has been changed from 0000 then the new password must be used


BootHDR

This Function for the HD-FOX T2 only, Allows the HD-FOX T2 to run the software for the HDR-FOX T2, to allow decryption of recordings by copying to a volume, BootHDR can be installed from the Web-If packages screen (of the HD-Fox T2 only). Here is the equivalent command line (Telnet) :-

opkg install wget

opkg install boothdr --force-reinstall


Bsed

Binary-safe search/replace utility.


BusyBox

Your Humax box has a ‘Unix’ operating system, Busybox is a package that provides 158 common Unix Sh (Shell) commands that can be used in a Telnet sessions, The List below shows the available commands, There is no 'man' command that would explain what they do, but most commands can have a -? or -h extention to get some help e.g. ls -?, A command look up table can be found HERE

NOTE:- It is not a good idea to 'Play' with these commands if you don't know what you are doing

  • [
  • [[
  • ar
  • arp
  • arping
  • ash
  • awk
  • base64
  • basename
  • bunzip2
  • bzcat
  • bzip2
  • cal
  • cat
  • catv
  • chgrp
  • chmod
  • chown
  • chroot
  • cksum
  • clear
  • cmp
  • comm
  • cp
  • cpio
  • cut
  • date
  • dc
  • dd
  • df
  • diff
  • dirname
  • dos2unix
  • du
  • echo
  • ed
  • egrep
  • env
  • ether-wake
  • expr
  • false
  • fgrep
  • find
  • fold
  • free
  • ftpget
  • ftpput
  • fuser
  • grep
  • gunzip
  • gzip
  • hd
  • head
  • hexdump
  • ifconfig
  • insmod
  • install
  • iostat
  • kill
  • killall
  • killall5
  • last
  • less
  • ln
  • logname
  • ls
  • lsmod
  • lsusb
  • lzcat
  • lzma
  • md5sum
  • mkdir
  • mkfifo
  • mknod
  • mktemp
  • modinfo
  • modprobe
  • more
  • mpstat
  • mv
  • nc
  • netstat
  • nice
  • nmeter
  • nohup
  • nslookup
  • od
  • patch
  • pgrep
  • ping
  • pkill
  • pmap
  • printenv
  • printf
  • ps
  • pstree
  • pwd
  • pwdx
  • readlink
  • realpath
  • renice
  • rm
  • rmdir
  • rmmod
  • route
  • rpm
  • sed
  • sendmail
  • seq
  • sh
  • sha1sum
  • sha256sum
  • sha512sum
  • sleep
  • sort
  • split
  • stat
  • strings
  • stty
  • sum
  • sync
  • sysctl
  • tail
  • tar
  • tee
  • telnet
  • test
  • tftp
  • time
  • top
  • touch
  • tr
  • traceroute
  • true
  • tty
  • uname
  • uniq
  • unix2dos
  • unlzma
  • unxz
  • unzip
  • uptime
  • usleep
  • uudecode
  • uuencode
  • vi
  • watch
  • wc
  • wget
  • which
  • who
  • whoami
  • xargs
  • xz
  • xzcat
  • yes
  • zcat


CIFS

The Common Internet File System. The cifs package provides the Humax with the ability to remotely access files shared from PCs using Windows file sharing. This package adds the support to the running system but mounting remote filesystems must currently be performed from the command line, Example :-


mkdir /media/NAS

mkdir "/media/My Video/NAS"

mount -t cifs //server/share /media/NAS -o user=abc,password=def

mount -t cifs "//server/share /media/My Video/NAS" -o user=abc,password=def


Cron

Cron is a time-based job scheduler that will auto-run tasks for you, It is built into Busybox which is a standard utility on your Humax, so cron does not need to be installed, the tasks are held in a cron table or crontab, here is an example crontab :-

humax# cd /mod/var/spool/cron/crontabs/
humax# cat root
0 2 * * * /mod/sbin/anacron -s -d
1,31 * * * * /mod/sbin/unencrypt "/mnt/hd2/My Video/archive" > /mod/tmp/unencrypt.log 2>&1
*/10 * * * * /mod/sbin/rs_process >> /mod/tmp/rs.log 2>&1
humax#

Each line of crontab has the following structure:

<Minute> <Hour> <Day> <Month> <Day of Week> <Command line> Note :- * = All or Every

The three examples above will run

  1. at 2AM every day
  2. at 1 Minute and 31 Minutes of every Hour every day
  3. every 10 Minutes continuously

It is possible to display all cron jobs with the following command line:-

crontab -l

To add a new cron job edit file /mod/var/spool/cron/crontabs/root and add a new line

Curl Command

curl command line utility


Custom TV Portal

An extension to the Humax TV Portal thats add some more apps

Full Guide HERE


Dedup (Command Line)

The dedup package adds a command line utility which can consolidate recordings within a single folder so that duplicates are removed and the remaining episodes are renamed so that the episode name and number (if available) are displayed in the Media Browser

Note:- There is a 'built-in' version of Dedup in the Web-If that effectivly replaces the command line package, However if the dedup package is installed it is possible to perform the following Telnet commands from the folder you have navigated to:-

dedup HIDE lists the recordings there and shows what they would be renamed to

dedup -yes HIDE perform the changes as detailed below :-

  • Renames the files on disk to match the episode name
  • Changes the title shown in the media list to match the episode name
  • Identifies duplicate episodes and moves them to a sub-folder called dup/


Disable DSO

Disable automatic retuning in response to Digital-Switch-Over events


Disable OTA

This feature inhibits any Over The Air Software updates that may be transmitted by Humax


Dropbear SSH

A secure shell (ssh) server for the Humax. This package provides remote command line access over an encrypted session and is a secure alternative to using telnet to gain command line access - although it causes the box to do more work. Also allows the use of scp (secure copy) as a secure alternative to FTP.

Login with username=root, password=humax


E2fs_Progs

Ext2/3/4 Filesystem Utilities. The Linux File Disk system used on the Humax


Edit On Box (Nicesplice)

Full Guide for Nicesplice HERE


EPG (Command Line)

EPG information can be obtained from a Telnet Command line e.g.

epg


humax# epg
Humax EPG Tool v1.0.8, by af123, 2011.

Syntax: epg [options] [filters] <command>...

  Options:
    -b                     Brief output.
    -d[level]              Set debug level.
    -f<file>               Specify alternate EPG data file.
    -h                     Show help text.
    -p                     Parsable output.

  Filters: (can be specified multiple times, all must be true)
    -C<CRID>               Show only events with this CRID.
    -D<descriptor type>    Show only selected descriptor type.
    -E<event id>           Show only selected event.
    -R<SCRID>              Show only events with this Series ID.
    -S<service id>         Show only selected service.
    -T<content type>       Show only selected content types.
    -@<unix timestamp>     Show only programmes at time.
    -/<unix timestamp>     Show only programmes on day.
    -/<days>               Show only programmes on day.
    -=<start>:<end>        Show only programmes in time period.

  Commands:
    dump                   Show a parsed summary of the EPG.
    dumpraw                Show raw data from the EPG.
    sqldump                Produce SQL statements from EPG data.
    sqlitedump <file>      Create SQLite database from EPG data.
    now                    Show what is currently on.
    first                  Show the time of the earliest record.
    last                   Show the time of the latest record.
    parse                  Parse the EPG, no output.
    search <text>          Search programme names for text.
    searchall <text>       Search programme names/descriptions for text.


Epg Keywords (Web-If)

This package was a web interface plugin which allowed a list of keywords to be configured and when found an email was sent Weekly to a specified email address detailing any programmes in the EPG which matched the keywords

NOTE:- The EPG Keywords functionallity has now been moved to Remote Scheduling Auto


Initial Setup :-

  • Web-If MAIN >> SETTINGS >> Email address >> myname@talktalk.co.uk
  • Web-If MAIN >> SETTINGS >> SMTP >> smtp.talktalk.co.uk
  • Web-If MAIN >> SETTINGS >> SEND TEST EMAIL


Ffmpeg

FFmpeg will record, convert and stream audio and video, It includes libavcodec - the leading audio/video codec library, It also displays information about video and audio files. See Link HERE


Flatten

This feature changes how recorded programs are displayed on screen in the 'Media - My Video' menu, Series of programs are normally grouped into a sub-folder, Flatten will move the contents of sub-folders to the main 'Top' folder and remove empty sub-folders, After installing flatten the Web-If will have an option under OPT+ which lets you toggle directories between flatten and no-flatten

NOTE :- All directories will default to have flatten turned on unless they are changed

Exceptions

  • Folders marked as no flatten using the OPT+ option will not be flattened
  • Folders who's names are bounded by square brackets e.g. [NOT THIS ONE] will not be flattened
  • Folders containing a file called .noflatten will not be flattened (Note:- Create this file Via Telnet)


Flexget

FlexGet is a multipurpose automation tool for content like torrents, nzbs, podcasts, comics, series, movies, etc.It can use different kinds of sources like RSS-feeds, html pages, csv files,search engines and there are even plugins for sites that do not provide any kind of useful feeds.

A Typical Cron entry for Flexget would be :-

*/1 * * * * /mod/bin/flexget -c /mod/.flexget/config.yml --cron

  • Flexget Documentation HERE


Forcedate

This utility forces the date on your Humax to 16 November 2011 12:34:56. It is require if the Humax can't get Time / Date info Over The Air. After using Forcedate it is possible to set time / date to internet time automatically on boot-up using NTP Client


Foscam

See Guide HERE


FTP

File Transfer Protocol is a method of transferring files to and from your Humax, The Humax HDR-Fox T2 has a built-in FTP for access to the media folders only. See the Betaftpd package for access to the full Humax file structure or to add an FTP server to the HD-Fox T2. To use FTP on a P.C. a program that handles FTP is required, Internet Explorer and Windows (file) Explorer will allow FTP access by entering ftp://10.0.0.200 into the address bar, Although access may be restricted to media folders only, even when using the Betaftpd package, If access to the whole file structure is required programs like Filezilla or WS_FTP_Pro can be used.

Notes :-

  • To use the Built-In Humax FTP server MENU >> Settings >> System >> Internet Settings >> FTP Server = ON
  • When using Betaftpd MENU >> Settings >> System >> Internet Settings >> FTP Server = OFF
  • 10.0.0.200 needs to be replaced with your own Humax IP address
  • login = humaxftp
  • password = 0000 (your Remote Pin default). If the remote password has been changed from 0000 then the new password must be used


Grep

Grep is built into Busybox and is used to search through a file or files looking for specified blocks of text, The output can be displayed on-screen or sent to a new file. Syntax Here

Associated utilities = Egrep, Fgrep

humax# cat original-file.txt

-H      Add 'filename:' prefix
-h      Do not add 'filename:' prefix
-n      Add 'line_no:' prefix
-l      Show only names of files that match
-L      Show only names of files that don't match
-c      Show only count of matching lines
-o      Show only the matching part of line
-q      Quiet. Return 0 if PATTERN is found, 1 otherwise
-v      Select non-matching lines
-s      Suppress open and read errors
-r      Recurse
-i      Ignore case
-w      Match whole words only
-F      PATTERN is a literal (not regexp)
-E      PATTERN is an extended regexp
-m N    Match up to N times per file
-A N    Print N lines of trailing context
-B N    Print N lines of leading context
-C N    Same as '-A N -B N'
-e PTRN Pattern to match
-f FILE Read pattern from file

humax# grep match original-file.txt
-l      Show only names of files that match
-L      Show only names of files that don't match
-c      Show only count of matching lines
-o      Show only the matching part of line
-v      Select non-matching lines
-e PTRN Pattern to match
humax#


HMT

This package displays information on the humax *.hmt file, A small 'sidecar' file created alogside the main *.ts video file

From a Telnet Session, Navigate to a directory containing an *.hmt file, Then enter hmt {filename}

hmt KAISER_CHIEFS_DD5_1_20110410_0147.hmt

humax# hmt KAISER_CHIEFS_DD5_1_20110410_0147.hmt
Format:HD
Title:KAISER CHIEFS DD5.1
Channel:4096 (BBC HD)
Folder:/mnt/hd2/My Video/MY-ARCHIVE/
Filename:KAISER CHIEFS DD5_1_20110410_0147
Genre:Entertainment
EPG:Performance from the Kaiser Chiefs from the Later... with Jools Holland archives.
 They play I Predict a Riot, the party and festival anthem of 2005.

Flags: HD,Unlimited Copies,
Copy count:0

Scheduled start:1302396300 (Sun Apr 10 00:45:00 2011)
Scheduled duration:300
Recording start:1302396449 (Sun Apr 10 00:47:29 2011)
Recording end:1302396706 (Sun Apr 10 00:51:46 2011)
Play resumes at: 15 seconds in.

Service ID (SID):17472
Transport Stream ID (TSID):16516
Originating Network ID (ONID):9018
Programme Map Table PID (PMTPID):100
Video PID:101
Audio PID:102
Bookmarks:0 =


Humidify

A utility for manipulating Humax Download Format (HDF) files


Inadyn

A Dynamic DNS client with web configuration plugin (see webif settings page), The log file is blanked whenever the box set to standby and a new one created when switched from standby

I-Phone Interface

An iphone optimised web interface for the Humax

Screen Shots HERE


lsof

This unix command stands for LiSt of Open Files,With no extentions it will default to 'All' open files, But it is probably more useful when used with a filter as shown in the examples :-

lsof | grep humaxtv HIDE All files opened by the main Humax TV process

lsof | cut -f 1 -d' ' | sort | uniq HIDE List all processes that have opened files

lsof | grep epg HIDE All files opened by the EPG process

humax# lsof | grep epg
epg 596 root  cwd  0000  31,0 1307722938  21474853357 /dev
epg 596 root  rtd  0000  31,0 1321652395  77309428205 /
epg 596 root  txt  0000  8,18 1322689164   4295000557 /mnt/hd2/mod/bin/epg
epg 596 root  mem   REG  8,18                 9226050 /mnt/hd2/mod/bin/epg (path inode=4295000557)
epg 596 root  mem   REG  31,0                     174 /lib/ld-uClibc-0.9.29.so (path inode=4295000557)
epg 596 root  mem   REG  8,18                 9225846 /mnt/hd2/mod/lib/libsqlite3.so.0.8.6 (path inode=4295000557)
epg 596 root  mem   REG  31,0                     169 /lib/libuClibc-0.9.29.so (path inode=4295000448)
epg 596 root  mem   REG  31,0                     216 /lib/libpthread-0.9.29.so (path inode=4295000448)
epg 596 root  mem   REG  31,0                     186 /lib/libdl-0.9.29.so (path inode=4295000448)
epg 596 root    0  0000  31,0 1307722935   4294975926 /dev/null
epg 596 root    1  0000  0,13 1322848876   4295000502 /tmp/epgd.log
epg 596 root    2  0000  0,13 1322848858   4295000502 /tmp/modinit.log


Jim

Jim is a form of the programming language TCL (Tool Command Language), That runs on the Humax unix platform


Jpnevulator

Serial Port Sniffer


Joe

Text Editor, See Text Editors


Mediatomb

A UPnP MediaServer, This package allows the HD T2 to stream content to other devices on your network, as the HD T2 does not have this facility built-in


Mongoose

Mongoose is the Webserver that the Custom Firmware Package uses to present the Web pages you see when you log into the Web Interface, SEE EXAMPLES


Multienv

Helper utility for modifying the settop environment, Used by other packages.


Mvdisks

Mounts external drives (connected via USB) under "My Video" to allow export by the DLNA server (HDR only)


Network Shares Automount

Automatic mounting of remote nfs or smb directories, with configuration on the box, using special "settings" directorys to add and configure shares. Remote host(s) are "pinged" regularly, and shares are mounting / unmounting automatically with host availability


Folders on a computer or NAS box can be shared with other devices on the same network. On the humax box with custom firmware we can add support for two protocols - smb (used by Windows, pre-Lion OsX, linux running Samba), and nfs (Linux, OsX, common with NAS boxes). smb support is provided by the cifs package. We can "mount" the remote shared folder(s) so they appear as if they were part of the local file system on the Humax

This packages uses directory names in the "*Modsettings/smb" and/or "*Modsettings/nfs" folders to configure as many shares as you like. For example to set up a new smb share, use the opt+ button to create a new directory within the smb folder. Name it what you want the mount to be called (eg "MyPc") Wait about 10 seconds, and navigate into the new folder. The script should have created a load of template "configuration directories" for you to rename (host IP address, foldername, user, password etc). Note that the "_" symbol is used instead of "." in IP names and "/" in folder names as these can't be input (or if they can I think the box changes them to a "_")

Once configured, the script will regularly ping the host computer to see if it is available. If it is then the shared folder will be mounted and should be browsable. If the host goes offline, the folder will be unmounted, preventing the box from locking up.

Wake up On LAN (WOL) is also available to automatically power up compatible (newer) NAS boxes, The user must supply the MAC address of the NAS box and set WakeUp=on


Nano

Text Editor, See Text Editors


NTFS 3g

Read/write NTFS disk access. Out of the box the Humax can read NTFS formatted drives but this package upgrades that support to full read/write access


Ntp Client

Network Time Protocol sets the Humax clock from an Internet time server on each boot. Useful if you do not have an aerial connection. Note :- This utility may also need Forcedate to be loaded, In order to get the date near the current as NTP won't change a time / Date that is too far out


OPKG

Open PacKaGe Management is the tool used to handle Custom Firmware packages, Here Are some examples :-

opkgHID= list all opkg commands

opkg install http://hummypkg.org.uk/hdrfoxt2/base/auto-unprotect_1.0.6_mipsel.opk HID= Install a remote package

opkg listHID= list of available packages

opkg list-installedHID= list of installed packages

opkg remove auto-unprotectHID= uninstall a package Note: No version numbers


Portal Foscam

See GUIDE


Portal Xtra1

See Guide HERE


Poweron-Channel

This Utility forces the Humax to always power up on a selected TV channel regardless of the last channel viewed on power down, It is also possible to select a power on volume that overrides the power down volume


Procps

procps is the package that has a bunch of small useful utilities that give information about processes using the /proc filesystem. The package includes the programs ps, top, vmstat, w, kill, free, slabtop, and skill.Version 3 includes NPTL thread support, a rewritten top, many bug fixes, performance improvements, and new features. Link HERE


Prog Backup

Utility for backing up recordings and sidecar files to locally attached drives, A search of attatched drives will be made so that the user can choose. Both Hi-Def and Standard definition recordings will be de-crypted so they can be played on a P.C. or copied back to a different Humax. Command line examples Below :-


progbackup HIDE Backup everthing under My Video

progbackup "/mnt/hd2/My Video/BOB's Films/" HIDE Backup files in a specified folder

NOTE:- Make sure to use the quotation marks around the directory name.


Redring

Ver 2.0 Under Construction

Causes the Humax to display a Red LED ring when recording in standby, plus various other front panel options detailed in the table below. The new settings are configurable using the Web-If >> Settings >> Redring Settings

GENERAL SETTINGS
Humax Status Humax Default With Redring Redring Setting
Show Purple When dual Recording 11% Amber Purple On / Off
Enable Debugging Log N/A Debug On / Off


WHEN FULLY AWAKE
Humax Status Humax Default With Redring Redring Setting
Disable Screen Scrolling Scrolling On Scrolling Off On / Off
Enable Clock Clock Off Clock On On / Off
Show Elapsed Time During Playback N/A Elapsed Time On / Off
Show Play HH:MM Instead of Clock N/A HH:MM On / Off
Constant LED Brightness Fixed Switchable On / Off
Blue Brightness 100% > 50% after 3 Mins. Variable 0% to 100%
Red Brightness 100% > 50% after 3 Mins. Variable 0% to 100%
Constant VFD Display Brightness Fixed Switchable On / Off
VFD Display Brightness Fixed Variable 0% to 100%


WHEN HALF AWAKE
Humax Status Humax Default With Redring Redring Setting
Show Blue LED Ring 11% Amber Switchable Blue On / Off
Blue LED Ring Brightness 11% Amber Variable 10% to 100%
Show Red LED Ring (Recording) 11% Amber Switchable Red On / Off
Red LED Brightness 11% Amber Variable 10% to 100%


WHEN IN STANDBY
Humax Status Humax Default With Redring Redring Setting
Constant LED Ring Brightness Fixed Switchable Amber On / Off
LED Ring Brightness 11% Amber Amber Brightness 0% to 100%
Constant VFD Display Brightness Fixed Switchable On / Off
VFD Display Brightness 11% Variable 0% to 100%


Redring Ver 1.09


Humax Status Humax Default With Redring Redring Setting
Standby LED Not Recording 11% Amber 11% Amber N/A
Standby LED Waiting to Record (Half-Awake) 11% Amber Blue & Set Brightness(1) Blue On / Off & 10% to 99% Brightness(1)
Standby LED Recording X1 11% Amber Red & Set Brightness(2) 10% to 99% Brightness(2)
Standby LED Recording X2 11% Amber Purple Purple On / Off & Brightness(2)
Awake LED Not Recording 99% Blue Blue Brightness(3)
Awake LED Waiting to Record 99% Blue Blue Brightness(3)
Awake LED Recording X1 99% Red Red Brightness(3)
Awake LED Recording X2 99% Red Purple Purple On / Off & Brightness(3)
Disable Display Scrolling Scrolling On Scrolling Off On / Off
Show Clock When Running N/A Clock On / Off
Show Elapsed Time On Playback At end of scrolling display. Elapsed Time On / Off
Turn off LED in standby 11% Amber <1% Amber On / Off
Set Awake LED brightness 100% brightness Set Brightness(3) On / Off & 0% to 99% Brightness(3)
Set Awake Display brightness 100% > 50% after 3 Mins. Set Brightness(4) On / Off & 0% to 99% Brightness(4)
Set Standby Display brightness 11% Set Brightness(5) On / Off & 0% to 99% Brightness(5)
Redring Debug N/A Debug On / Off

HIDE ** = Change from Humax default

Remote Scheduling (RS)

Remote Scheduling Service. Links your device to the remote scheduling portal so you can manage your scheduled recordings list from anywhere with an Internet connection and web browser

Full Guide HERE


Remote Scheduling Auto

Full Guide HERE


Rsvsync

Boot-time reservation sync service


Rsync

A fast, versatile, remote (and local) file-copying tool, example :-

rsync -avr --progress --delete --exclude 'Tsr/' mnt/hd2/ root@synology ip::NetBackup


Samba

Windows compatible file sharing. Allows access to the Humax filesystem from a computer on the same network. The file system is shared using Windows compatible sharing so can be access from Windows, MacOSX and most other operating systems


Sed

GNU Stream Editor, A stream editor is used to perform basic text transformations on an input stream, application notes HERE or HERE

Series Filer

This utility will re-locate series folders created at the top level of My Video to Selected Sub-Directories so that they can be grouped together. After a New series folder has been created by the Humax at the top level, Simply move this series folder to a Sub-directory that you have created e.g. move the Doctor Who series folder to a sub-folder called ‘His Video’. When the next instalment of Doctor Who is transmitted the Humax will create another Doctor Who folder at the top level again, However, If Series Files is running the new instalment will be moved to the ‘His Video / Doctor Who’ automatically. Program names will also be re-named (if possible) to give more detail of each episode


Service Control

A command line utility allowing easy control of installed services. Run the 'service' command from the command line for help.


From a Telnet command line prompt send the following :-

service

humax# service

Name                 Installed  Autostart  Running
----                 ---------  ---------  -------
mediatomb            No         No         No
dropbear             No         No         No
transmission         No         No         No
samba                No         No         No
cifs                 No         No         No
mongoose             Yes        Yes        Yes

Syntax:
        service start <service>
        service stop <service>
        service auto <service>          (toggles autostart) 


Sh (SHell)

Sh or Shell is a command line / scripting language built into Busybox that is roughly equivalent to the Windows DOS (Disk Operating System) utility. It is however a lot more powerful than DOS and is a true language

Smartmontools

This utility will report on the condition of the S.M.A.R.T. hard disk drive, After installing the package enter the following command line using Telnet :-

mod/bin/smartctl /dev/sdb -A

or

mod/bin/smartctl /dev/sdb -a HIDE for more details

Documentation HERE


humax# /mod/bin/smartctl /dev/sdb -A
smartctl 5.41 2011-06-09 r3365 [7405b0-smp-linux-2.6.18-7.1] (local build)
Copyright (C) 2002-11 by Bruce Allen, http://smartmontools.sourceforge.net

=== START OF READ SMART DATA SECTION ===
SMART Attributes Data Structure revision number: 10
Vendor Specific SMART Attributes with Thresholds:
ID# ATTRIBUTE_NAME          FLAG     VALUE WORST THRESH TYPE      UPDATED  WHEN_FAILED RAW_VALUE
  1 Raw_Read_Error_Rate     0x000f   114   099   006    Pre-fail  Always       -       66811863
  3 Spin_Up_Time            0x0003   097   097   000    Pre-fail  Always       -       0
  4 Start_Stop_Count        0x0032   098   098   020    Old_age   Always       -       2878
  5 Reallocated_Sector_Ct   0x0033   100   100   036    Pre-fail  Always       -       0
  7 Seek_Error_Rate         0x000f   078   060   030    Pre-fail  Always       -       70502101
  9 Power_On_Hours          0x0032   097   097   000    Old_age   Always       -       3294
 10 Spin_Retry_Count        0x0013   100   100   097    Pre-fail  Always       -       0
 12 Power_Cycle_Count       0x0032   099   099   020    Old_age   Always       -       1439
184 End-to-End_Error        0x0032   100   100   099    Old_age   Always       -       0
187 Reported_Uncorrect      0x0032   097   097   000    Old_age   Always       -       3
188 Command_Timeout         0x0032   100   100   000    Old_age   Always       -       0
189 High_Fly_Writes         0x003a   093   093   000    Old_age   Always       -       7
190 Airflow_Temperature_Cel 0x0022   055   044   045    Old_age   Always   In_the_past 45 (0 109 45 32)
194 Temperature_Celsius     0x0022   045   056   000    Old_age   Always       -       45 (0 13 0 0)
195 Hardware_ECC_Recovered  0x001a   048   039   000    Old_age   Always       -       66811863
197 Current_Pending_Sector  0x0012   100   100   000    Old_age   Always       -       0
198 Offline_Uncorrectable   0x0010   100   100   000    Old_age   Offline      -       0
199 UDMA_CRC_Error_Count    0x003e   200   200   000    Old_age   Always       -       0

NOTE:- If an external Hard disk Drive is found on boot up the Internal Hard disk will be /dev/sdb, If no External Hard Disk drive is found at boot up the the internal Hard disk will be /dev/sda


SQLite

SQlite is a database file handler, e.g. files that typically end in *.db can be opened, edited etc.


SSMTP

SSMTP is a program to deliver an E-mail from your Humax to a mailhost or mailhub, It will not handle incomming E-Mail


Sysmon

A System Monitoring Utility, the Web-If main page has a System Monitoring icon, selecting this icon displays the following options :-

  • Hard Disk Temperature

Displays a graph showing the hard disk temperature, This feature uses the Smartmontools package, options are to display last 2 hours, 1, 5, 10, 30 Days


  • CPU Utilisation

Displays a graph showing CPU Utilisation for Idle, Wait, User and System, options are to display last 2 hours, 1, 5, 10, 30 Days


Telnet

Telnet is built into the default Custom Firmware package, To communicate Via Telnet from a P.C. you will need a program such as PuTTY, Select connection type Telnet and enter the IP address of your Humax into the Host Name box, Then select OPEN, You will be presented with a new Telnet Window and if connection is successful you will see the humax# prompt.


It is also possible to use Telnet supplied in some versions Microsoft Windows e.g. Start >> Run >> CMD >> Telnet

Telnet is available in Windows XP, However Vista and Windows 7 will require Telnet to be enabled with Control Panel >> Programs and Features >> Turn Windows Features On / Off >> 'Tick' Telnet

Follow THIS LINK for more details on the various ways of obtaining a Telnet connection

Here is an example of Windows XP Telnet for ls -al

C:\> telnet

Welcome to Microsoft Telnet Client
Escape Character is 'CTRL + ]'

 open 10.0.0.200

humax# ls -al
total 17
drwxr-xr-x 18 root root  192 Jan 10 09:10 .
drwxr-xr-x 18 root root  192 Jan 10 09:10 ..
drwxr-xr-x  2 root root  474 Jan 10 09:10 bin
drwxr-xr-x  5 root root 2140 Jun 10  2011 dev
drwxr-xr-x  9 root root  378 Jan 10 09:10 etc
drwxr-xr-x  3 root root   23 Jun 10  2011 home
drwxr-xr-x  4 root root  668 Jun 10  2011 lib
drwxr-xr-x  3 root root  120 Jan  1  2000 media
drwxr-xr-x  7 root root   84 May 13  2011 mnt
lrwxrwxrwx  1 root root   11 Jan 10 09:10 mod -> mnt/hd2/mod
drwxr-xr-x  3 root root   22 Jun 10  2011 opt
dr-xr-xr-x 57 root root    0 Jan  1  2000 proc
drwxr-xr-x  2 root root    3 Jun 10  2011 root
drwxr-xr-x  2 root root  396 Jan 10 09:10 sbin
drwxr-xr-x  3 root root   23 Jun 10  2011 share
drwxr-xr-x 10 root root    0 Jan  1  2000 sys
drwxrwxrwt  2 root root  280 Apr 13 16:31 tmp
drwxr-xr-x  9 root root   87 Aug 31  2011 usr
drwxr-xr-x  4 root root   88 Jan 10 09:10 var
humax#


to exit from humax# enter Ctrl + d

Microsoft Telnet >

to exit from Telnet enter q

C:\>

To exit windows command line enter exit

NOTES

  • Telnet command lines on this WiKi are identified by a Yellow Background
  • [Putty] Telnet >> Connection >> Telnet >> return Key sends Telnet New Line instead of ^M should be 'un-Ticked'
  • [Windows] Telnet >> unset crlf


Text Editors

There is a built-in GUI Text editor in the Web-If (details HERE). In addition to this editor, There is a basic version of Vi built into the custom Busybox package (not in the Busybox version included in the vendor's firmware). There are also several packages that can be installed to suit your editing preferences e.g. Vim Basic, Vim Standard, Joe and Nano.

If you've only installed the basic custom firmware (using the upgrade path with USB), then there's sed


Transmission (Bit Torrent)

The Transmission program will download files from the internet using the a torrent protocol, Downloads using this system are usually fed from multiple sites at the same time in parallel, Because of this many URL’s may be used in the download process, These URLs are packaged together into a single *.torrent file, Transmission re-constructs fragments of the file/s from these various URLs into their original format.

Transmission needs to be supplied with the *.Torrent file, it does not have a Torrent file search facility, one possible torrent source is torrentz.eu, download your selected *.Torrent file to the P.C. you run the Web-iF from

For command line access enter :-

transmission-remote

Blocklist Notes

The block list utility does not currently work as it should e.g. Settings (Bottom Left) >> preferences >> Peers should allow an IP to be entered and then 'Updated', This should read a txt, gz, zip file to opened from a remote site that holds details of URLs that transmission is not allowed to contact during the download process. This can increase security by avoiding know virus sites etc.

Because the ‘Update’ does not work it is necessary to obtain the block file (e.g. from http://www.iblocklist.com/lists.php) and place them in the /mod/etc/transmission/blocklists folder, these files must be smaller than 5Mbs, They will be processed by the Transmission program when first run and *.bin files will be created in the same folder, if the files are successfully processed an indication of the number of ‘Blocked’ URL will be displayed e.g. Block List Has 598940 Rules

  • Go into service control and start Transmission
  • Set it to auto start if you want it to come on whenever the box is on
  • Go to the Web-If main menu and click the transmission icon at the bottom left
  • Select 'Open' (the folder at the top left)
  • Select browse in the window and highlight the prviously downloaded *.torrent file
  • When highlighted select 'Open'
  • Select 'Upload'
  • If the 'Start when added' box is checked the download will start immediately
  • A new directory will be created at /media/ My Video/torrent/ containing successful downloads


trm

trm is a version of the Unix rm command (ReMove), This version removes files in blocks using Truncate (hence Truncate ReMove) rather than all at once, In order to reduce demand on system resources


TTYSnoop

TTYSnoop allows you to snoop on login tty's through another tty-device or pseudo-tty. The snoop-tty becomes a 'clone' of the original tty, redirecting both input and output from/to it.


Uinput

User-space input kernel module


Unencrypt

This function will unencrypt all files in a designated directory (or all files in My Video) automatically, Files are de-crypted at the same location e.g. 'decrypt in place' and are processed at the rate of one file every 30 Mins. max. so don't expect instant results

To setup Unencrypt install the package and then via Telnet enter one of the lines below :-

unencryptsetup "Bob's Videos" HIDE process a single directory

unencryptsetup HIDE process all files in 'My Video'

unencryptsetup disable HIDE Turn off unencrypt

This will update the cron table and schedule the program to run every 30 minutes (at Mins 01 and 31) indefinitely. Every time it runs, it will check that there isn't already another job running and then decrypt the first encrypted file that it finds in the directory you specified, therefore gradually working its way through your files, If you don't specify a directory, it will default to decrypting all of your recordings.

NOTES:-

  • Due to CPU overloading this feature only works between 1AM and 6AM the Humax must be out of standby during this time using an Auto On / Auto off timer
  • Auto-Unprotect must be running
  • Content sharing must = on e.g. Menu >> Settings >> System >> Internet Settings

See Decryption flow chart HERE


Undelete

Redirects deleted recordings to a dustbin folder called [Deleted Items] and then automatically removes them from this new folder 7 days later, The Folder Name and delay before deletion is carried out (1 to 30 days) is configurable in the Web-If Setting area. It's a batch process which runs once per day. It runs 6 minutes after the first boot of the day or, if you keep your box on all the time, at 2am. It scans the bin and removes anything that was put there over x * 24 hours ago, Where x = no. of days (strictly, anything that was last modified over x * 24 hours ago)


Vi

Text Editor, See Text Editors. A basic version of Vi is built into the custom Busybox package (it's not included in the version of Busybox in the vendor's firmware).


Vim Basic

Text Editor, See Text Editors


Vim Standard

Text Editor, See Text Editors


Virtual-Disk

One way to decrypt content which has been recorded by the Humax is to copy to an external disk, This is usually a slow process as the external disk must be connected via one of the USB ports. This package creates a virtual disk on the system to which content can be copied. It is much faster since it is based on the internal hard disk. The virtual disk is shared by the MediaTomb package by default, giving a fairly straightforward method of sharing recorded content on the network. In conjunction with the 'auto-unprotect' package, high definition content can also be shared

Note:- The copy to Virtual Disk MUST be by Remote Control OPT+ copy for decryption to take place


Web IF

Screen Shots HIDE Release Notes

An evolving web interface for the Humax. This package provides a means of accessing the Humax using a web browser on any device connected to the network (including mobile 'phones and iPads). The interface allows easy viewing of recorded programme details as well as allowing basic manipulation to be performed. Additionally the EPG can be viewed and searched from within the web browser

Within the Web-IF are the following Built-In Functions :-

Clipboard

Used in conjunction with Copy, Cut and Paste, The clipboard is an area that files can be temporarily held in while a new folder is selected. It emulates a Windows Clipboard

Copy

See Clipboard

Crop

Web-If MAIN >> BROWSE MEDIA FILES >> (Select Single File) >> OPT+ >> Crop

See Edit on Box link HERE

Cut

See Clipboard

Decrypt

Web-If MAIN >> BROWSE MEDIA FILES >> (Select Single File) >> OPT+ >> Decrypt

This Function will move the file to an _original folder and then stream a new copy to the present location, The new copy will be Decrypted and can be played on a P.C.. NOTE both High Definition AND Standard definition need to be Decrypted

De-duplicate / Tidy this folder

Webif-media-ded.png
Webif-media-ded2.png

Web-If MAIN >> BROWSE MEDIA FILES >> De-duplicate / Tidy this folder

This Function will search a folder and re-name files with more meaningful titles, It will also seperate duplicates into a new folder

See Tidy (Re-name) Example >>

This Function will search a folder and re-name files with more meaningful titles

It will Also seperate duplicates into a new folder

See De Duplicate (to new folder) Example >>

Download

Web-If MAIN >> BROWSE MEDIA FILES >> (Select Single File) >> OPT+ >> Download

This function will download with decrytion an SD file (or Hi-Def File if the 'ENC' flag is removed) and place it into the default download folder on your P.C., The following items may inhibit it functioning correctly :-

  1. The File type *.TS must not be assosiated with a program such as a media player on your P.C., If it is, Remove the association
  2. Your brouser must allow re-direction of addresses

Extract Audio

Web-If MAIN >> BROWSE MEDIA FILES >> (Select Single File) >> OPT+ >> Extract Audio

This function will produce an MP3 file containing the stereo audio track contained in a standard Def. Video file (or radio recording), The following conditions must be met :-

  • The file must be de-crypted (Dispays a DEC against it)
  • ffmpeg package must be installed
  • Standard Def. recording only (Hi-Def 2 Ch or 6 Ch sound won't be decoded)

Extract To MPG

Web-If MAIN >> BROWSE MEDIA FILES >> (Select Single File) >> OPT+ >> Extract To MPG

This function will produce an MPG copy of the *.TS file in the same folder, the MPG version strips out control frames relating to things which were on the same Mux as the recorded program, resulting in a smaller file. The following conditions must be met :-

  • The file must be de-crypted (Dispays a DEC against it)
  • ffmpeg package must be installed
  • Standard Def. recording only

File Editor

Web-If MAIN >> Diagnostics >> File Editor >> Open >> [Navigate to deisired file]

Paste

See Clipboard


Webif-media-detail.png

Play

This function provides an in-browser playback function for the Humax, It requires that you have the VLC plugin installed for your browser

Web-If MAIN >> BROWSE MEDIA FILES >> (Click on Single File) >> Play

Save Last Streamed Content

Web-If MAIN >> BROWSE MEDIA FILES >> Save Last Streamed Content

This Function will make a permanent MP4 copy of any content that has been viewed using the Humax TV portal e.g. I-Player / You Tube and place it into the 'My Video' folder. The Telnet equivalent Syntax is as follows :-

cp /mnt/hd3/Streamer_down_file "/media/My Video/theclip.mp4"

NOTE:- The Portal screen must remain open until the entire file has been downloaded (It is not performed in the background), The amount of time the download takes will vary with broadband speed

Split

Web-If MAIN >> BROWSE MEDIA FILES >> (Select Single File) >> OPT+ >> Split (45m parts)

This Function (only available on files over 4GB) will split the file into 45 Minute parts with a 2 Minute overlap, It can be used to stream large files without hitting the 4GB stream bug present on the Humax.

The New files will have segment numbering e.g. 1/3. E.T. The Extra-Terrestrial


Web-IF Channel Icons

A set of PNG picture files used to display the T.V. channel icons in the Web-Interface, they reside in /mod/var/mongoose/html/img/channels


Webif-Charts

Chart modules for the web interface


Webif-iphone

A cut-down web interface, optimised for display on the iPhone and other mobile devices

See Screenshots HERE


wget

Retrieve files via HTTP or FTP

Note:- There is already a version of wget in Busybox which is loaded automatically, However it may be necessary to install the stand alone package as it will be a newer version

Xtra1 Portal

See Guide HERE


Zeroconf

mDNS Responder, Will create a humax.local name which can be seen by anything running mDNS