Desktop Command Execution Widget scripts

82.95.81.43 — Sat, 08 May 2010 12:38:52 GMT

82.95.81.43: Added wol script

Desktop Command Execution widget is one of the most useful widgets on your Maemo desktop. It can be used to show certain information (for example battery level in percentage) or as a button which can be used for example to disconnect active internet connection (you need to tap 3 times and also wait for menus to appear without this widget). Therefore it can replace many other applications/widgets/applets and you can also make something new. Here you'll find a collection of scripts that can be added to the widget. The discussion about the widget is [http://talk.maemo.org/showthread.php?t=39177 on the forum].

Scripts are also compatible with [[Queen BeeCon Widget]] which has extended graphic and cosmetic functionality.

==Making your own scripts==

===Scripts without output===

When there's no output (for example if you're using widget as a button and you use D-Bus call) the widget displays "Invalid Command". This can be most easily avoided if you pipe echo "" at the end of the command. This is alo usable if your script produces unwandet output (D-Bus reply for example).

dbus-send -options -moreoptions | echo ""

Collection of D-Bus calls can be found on [[Phone control]] wiki page. The basic principle for making a script for DCEW is the same as above (D-Bus command and piping an echo).

===Scripts with long output===

Some scripts may create multiple lines which are too long to be displayed on a single line. The widget will not wrap these. In order to wrap them you can use the fold command:

command-that-produces-long-lines | fold -s -w 80

The 80 in that instance is the maximum length of the line, which you can change. The -s option makes fold word wrap with spaces. More information is available from the [http://unixhelp.ed.ac.uk/CGI/man-cgi?fold fold man page].

==Scripts to display information==

===Battery===

All battery scripts are collected here. Pick the one which suits your needs. Examples of the output values are under each one.

There are 2 values for full battery capacity available. First one is design charge in mAh, which is always the same (1273 mAh). The second one is the one used in these scripts and it is the full charge from last charging. With displaying this one you can also monitor battery wear level.

Battery percentage level is calculated using first value and is therefore less accurate, that's why you cannot achieve 100% full battery, but only about 95%. After some time the full percentage will be even lower.

But last full charge value has one disadvantage. This is that after a reboot the phone forgets this value and the value returned is 0. It shows the proper value after next charging.

====Percentage, current and last full charge====

hal-device bme | awk '/l.p/ {perc = $3}; /g.c/ {curr = $3}; /g.la/ {last = $3}; /s_c/ {isch = $3} END if (isch == "false") {print perc" % ("curr"/"last" mAh)"} else {print "Charging"}'

Output example: '''83 % (1000/1200 mAh)''', when charging '''Charging'''

====Percentage and current charge====

hal-device bme | awk '/l.p/ {perc = $3}; /g.c/ {curr = $3}; /s_c/ {isch = $3} END if (isch == "false") {print perc" % ("curr" mAh)"} else {print "Charging"}'

Output example: '''83 % (1000 mAh)''', when charging '''Charging'''

====Percentage====

hal-device bme | awk '/l.p/ {perc = $3}; /s_c/ {isch = $3} END if (isch == "false") {print perc" %"} else {print "Chrg"}'

Output example: '''83 %''', when charging '''Chrg'''

====Current and last full charge====

hal-device bme | awk '/g.c/ {curr = $3}; /g.la/ {last = $3} END {print curr"/"last" mAh"}'

Output example: '''1000/1200 mAh'''

====Current charge====

hal-device bme | awk '/g.c/ {print $3" mAh"}'

Output example: '''1000 mAh'''

====Last full charge====

hal-device bme | awk '/g.la/ {print $3" mAh"}'

Output example: '''1200 mAh'''

===IP===

Internal IPs are obtained from the ifconfig and external IPs are obtained from the internet, because gprs0 IP which you can get with ifconfig is often from private address range, because mobile operators like to use NAT.

====External (WAN) and internal (LAN)====

echo WAN IP: `wget -q -O - api.myiptest.com | awk -F"\"" '{print $4}'`; echo LAN IP: `/sbin/ifconfig wlan0 | awk -F "[: ]" '/Bc/ {print $13}'`

Output example:

'''WAN IP: 1.2.3.4'''

'''LAN IP: 192.168.1.2'''

echo WAN IP: `wget -q -O - api.myiptest.com | awk -F"\"" '{print $4 " ("$12" "toupper($28)")"}'`; echo LAN IP: `/sbin/ifconfig wlan0 | awk -F "[: ]" '/Bc/ {print $13}'`

Output example:

'''WAN IP: 1.2.3.4 (ISP CountryCode)'''

'''LAN IP: 192.168.1.2'''

echo WAN IP: `wget -q -O - api.myiptest.com | awk -F"\"" '{print $4" ("$12" @ "$20", "toupper($28)")"}'`; echo LAN IP: `/sbin/ifconfig wlan0 | awk -F "[: ]" '/Bc/ {print $13}'`

Output example:

'''WAN IP: 1.2.3.4 (ISP @ City, CountryCode)'''

'''LAN IP: 192.168.1.2'''

====External (WAN)====

wget -q -O - api.myiptest.com | awk -F"\"" '{print $4}'

Output example: '''1.2.3.4'''

wget -q -O - api.myiptest.com | awk -F"\"" '{print $4 " ("$12" "toupper($28)")"}'

Output example: '''1.2.3.4 (ISP CountryCode)'''

wget -q -O - api.myiptest.com | awk -F"\"" '{print $4" ("$12" @ "$20", "toupper($28)")"}'

Output example: '''1.2.3.4 (ISP @ City, CountryCode)'''

====Internal (LAN)====

/sbin/ifconfig wlan0 | awk -F "[: ]" '/Bc/ {print $13}'

This one displays only wlan0 IP (used for SSH, WinSCP, VNC... in LAN).

===Disk usage===

====rootfs (256MB /) percentage used====

df | awk '$1 == "rootfs" {print $5}'

====rootfs (256MB /) free space====

df -h | awk '$1 == "rootfs" {print $4}'

====Internal memory for user data (27GB /home/user/MyDocs) percentage used====

df /home/user/MyDocs | awk '/My/ {print $5}'

====Internal memory for user data (27GB /home/user/MyDocs) free space====

df -h /home/user/MyDocs | awk '/My/ {print $4}'

====Internal memory for application data (2GB /home) percentage used====

df /home | awk '/ho/ {print $5}'

====Internal memory for application data (2GB /home) free space====

df -h /home | awk '/ho/ {print $4}'

====Memory card (/media/mmc1) percentage used====

df /media/mmc1 | awk '/mm/ {print $5}'

====Memory card (/media/mmc1) free space====

df -h /media/mmc1 | awk '/mm/ {print $4}'

===Wi-Fi signal===

====Link quality====

awk -F "[. ]" '/0/ {print $6" %"}' /proc/net/wireless

====RSSI====

awk '/0/ {print $4" dBm"}' /proc/net/wireless

====Noise====

awk -F "[. ]" '/0/ {print $12" dBm"}' /proc/net/wireless

===CPU frequency===

awk '{print $1/1000" MHz"}' /sys/devices/system/cpu/cpu0/cpufreq/scaling_cur_freq

===Memory usage===

====RAM used====

awk '/mT/ {memttl = $2}; /mF/ {memfre = $2}; /Bu/ {membff = $2}; $1 == "Cached:" {memcch = $2} END {printf ("%.1f MB\n",(memttl-memfre-membff-memcch)/1024)}' /proc/meminfo

====RAM free====

awk '/mF/ {memfre = $2}; /Bu/ {membff = $2}; $1 == "Cached:" {memcch = $2} END {printf ("%.1f MB\n",(memfre+membff+memcch)/1024)}' /proc/meminfo

====Swap used====

awk '/pT/ {swpttl = $2}; /pF/ {swpfre = $2} END {printf ("%.1f MB\n",(swpttl-swpfre)/1024)}' /proc/meminfo

====Swap free====

awk '/pF/ {printf ("%.1f MB\n",$2/1024)}' /proc/meminfo

====Total memory used====

awk '/mT/ {memttl = $2}; /mF/ {memfre = $2}; /Bu/ {membff = $2}; $1 == "Cached:" {memcch = $2}; /pT/ {swpttl = $2}; /pF/ {swpfre = $2} END {printf ("%.1f MB\n",(memttl+swpttl-memfre-membff-memcch-swpfre)/1024)}' /proc/meminfo

====Total memory free====

awk '/mF/ {memfre = $2}; /Bu/ {membff = $2}; $1 == "Cached:" {memcch = $2}; /pF/ {swpfre = $2} END {printf ("%.1f MB\n",(memfre+membff+memcch+swpfre)/1024)}' /proc/meminfo

===GPRS data usage===

You can use this with scheduled reset of the GPRS data counter to display data usage for current month. Additional info can be found on [[fcron]] wiki page.

====Download and upload combined====

rx=`gconftool-2 -g /system/osso/connectivity/network_type/GPRS/gprs_rx_bytes`; tx=`gconftool-2 -g /system/osso/connectivity/network_type/GPRS/gprs_tx_bytes`; echo $(($tx + $rx)) | awk '{printf ("%.1f MB\n",$1/1048576)}'

====Download and upload separated====

echo `gconftool-2 -g /system/osso/connectivity/network_type/GPRS/gprs_rx_bytes | awk '{printf ("Download: %.1f MB\n",$1/1048576)}'`; echo `gconftool-2 -g /system/osso/connectivity/network_type/GPRS/gprs_tx_bytes | awk '{printf ("Upload: %.1f MB\n",$1/1048576)}'`

===Time and date===

====Date====

date +"%a, %-d.%-m.%Y"

This command will show the date in format (for example) '''Tue, 4.5.2010'''. You can define your own format (between the quotation marks). Possible options are described on [http://unixhelp.ed.ac.uk/CGI/man-cgi?date manpage].

====Time in different timezones====

export TZ="Europe/London"; date +%R

This one shows two timezones in format ''London: 13:04 | Denver: 06:04''

echo "London:" `export TZ="Europe/London"; date +%R` "| Denver:" `export TZ="America/Denver"; date +%R`

London and Denver are taken as an example. TZ values can be found on [[:wikipedia:List_of_tz_database_time_zones|Wikipedia]].

===Uptime and load===

These scripts are formatproof meaning that they display what they're supposed to no matter what format is command "uptime" outputting. Not all scripts found are like that, because "uptime" command is a little bit complicated for scripted text processing. For example when the system is running under one hour only "x min" is shown, when it is running under one day "hour:min:sec" is shown and after that it is shown in format "x days, hour:min:sec".

====Both====

uptime | sed -e 's/.*up */uptime: /' -e 's/ average//' -e 's/ / /'

====Uptime====

uptime | sed -e 's/.*p *//' -e 's/, l.*//' -e 's/ / /'

====Load====

uptime | sed 's/.*e: //'

===Boot reason===

cat /proc/bootreason

===Boot count===

cat /var/lib/dsme/boot_count

===Temperature===

CPU's thermal sensors are not accessible, but there is one near the battery. This commands displays output of its readings, but IT IS NOT RELIABLE, because it doesn't always work. Sometimes the value returned is wrong or constant. It needs to be tested further.

echo `cat /sys/devices/platform/omap34xx_temp/temp1_input` °C

There is a working way now to read the correct temperature, but it is working only on a newer titan's kernels (normal, overclock, undervoltage). The bq27x00_battery module has to be loaded first.

echo `cat /sys/class/power_supply/bq27200-0/temp` °C

===Top processes===

This script displays top ''N'' CPU consuming processes. It excludes top itself, which is quite processor intensive so you probably don't want this updating too often. Modify ''N=3'' at the start to display different number of processes.

N=3; top -bn 1 | grep -v top | head -n $(($N+4)) | tail -n $(($N+1)) | awk '{OFS = "\t"} {print $7,$8}'

==Scripts for buttons==

Make sure that update policy for button widgets is set only to "update when clicked". "Update when switched to desktop", "update interval" and "network presence" should be disabled to avoid automatic actions. Also keep in mind that widgets are executed at every boot so they can for example automatically disable Wi-Fi when phone boots.

There is a bug in version 0.9 or lower which prevents you from using DCEW widgets as buttons, because they get activated (pressed) automatically all the time. You have to update DCEW to at least version 1.0, which is currently in Extras-devel.

===Networking===

====Connect/disconnect====

sh /path/conn-disconn.sh | echo ""

'''conn-disconn.sh'''

#!/bin/sh
if [ `/sbin/route | awk '/au/ {print $1}'` = default ]; then
dbus-send --system --dest=com.nokia.icd /com/nokia/icd_ui com.nokia.icd_ui.disconnect boolean:true
else
dbus-send --system --type=method_call --dest=com.nokia.icd /com/nokia/icd com.nokia.icd.connect string:"[ANY]" uint32:0
fi

====Connect internet (show connections)====

dbus-send --system --type=method_call --dest=com.nokia.icd_ui /com/nokia/icd_ui com.nokia.icd_ui.show_conn_dlg boolean:false | echo ""

====Connect to any saved connection====

dbus-send --system --type=method_call --dest=com.nokia.icd /com/nokia/icd com.nokia.icd.connect string:"[ANY]" uint32:0 | echo ""

====Disconnect internet====

dbus-send --system --dest=com.nokia.icd /com/nokia/icd_ui com.nokia.icd_ui.disconnect boolean:true | echo ""

====Enable/disable Wi-Fi====

rootsh /path/to/script/wifi.sh | echo ""

'''wifi.sh script:'''

#!/bin/sh
out=`ifconfig wlan0`
if [ $? -eq "0" ] ; then
if [ `echo "$out" | grep -c RUNNING` -gt "0" ] ; then
run-standalone.sh dbus-send --system --dest=com.nokia.icd /com/nokia/icd_ui com.nokia.icd_ui.disconnect boolean:true
fi
ifconfig wlan0 down
rmmod wl12xx
run-standalone.sh dbus-send --type=method_call --dest=org.freedesktop.Notifications /org/freedesktop/Notifications org.freedesktop.Notifications.SystemNoteInfoprint string:'Wi-Fi disabled'
exit 2
else
modprobe wl12xx
wl1251-cal
stop wlancond
start wlancond
ifconfig wlan0 up
run-standalone.sh dbus-send --system --type=method_call --dest=com.nokia.icd_ui /com/nokia/icd_ui com.nokia.icd_ui.show_conn_dlg boolean:false
exit 0
fi

Don't forget to make it executable.

====Wake On Lan====

/path/to/script/wol.py | echo ""
wol.py script;

#! /usr/bin/python
# Wake-On-LAN
# Change ip range in the "s.sendto(msg" line
# and the MAC of the pc to wakeup in the bottom line
import struct, socket
def WakeOnLan(ethernet_address):
# Construct a six-byte hardware address
addr_byte = ethernet_address.split(':')
hw_addr = struct.pack('BBBBBB', int(addr_byte[0], 16),
int(addr_byte[1], 16),
int(addr_byte[2], 16),
int(addr_byte[3], 16),
int(addr_byte[4], 16),
int(addr_byte[5], 16))
# Build the Wake-On-LAN "Magic Packet"...
msg = '\xff' * 6 + hw_addr * 16
# ...and send it to the broadcast address using UDP
s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
s.setsockopt(socket.SOL_SOCKET, socket.SO_BROADCAST, 1)
s.sendto(msg, ('192.168.1.255', 9))
s.close()
# Example use
WakeOnLan('00:13:21:00:62:AE')
Don't forget to Chmod 755 wol.py

====Disconnect mobile network====

dbus-send --system --type=method_call --dest=com.nokia.phone.SSC /com/nokia/phone/SSC com.nokia.phone.SSC.set_radio boolean:false | echo ""

====Connect mobile network====

dbus-send --system --type=method_call --dest=com.nokia.phone.SSC /com/nokia/phone/SSC com.nokia.phone.SSC.set_radio boolean:true | echo ""

===Lock screen and keys===

dbus-send --system --type=method_call --dest=com.nokia.mce /com/nokia/mce/request com.nokia.mce.request.req_tklock_mode_change string:"locked" | echo ""

===Radio mode===

====2G/3G====

sh /path/to/script/2g3g.sh | echo ""

'''2g3g.sh script:'''

#!/bin/sh
if [ `dbus-send --system --type=method_call --print-reply --dest=com.nokia.phone.net /com/nokia/phone/net Phone.Net.get_selected_radio_access_technology | awk '/b/ {print $2}'` -eq 1 ]; then
dbus-send --system --type=method_call --dest=com.nokia.phone.net /com/nokia/phone/net Phone.Net.set_selected_radio_access_technology byte:2
else
dbus-send --system --type=method_call --dest=com.nokia.phone.net /com/nokia/phone/net Phone.Net.set_selected_radio_access_technology byte:1
fi

When 3G or Dual mode is active, the script will switch to 2G. And when 2G is active, it will switch to 3G.

Don't forget to make the script executable.

====2G====

dbus-send --system --type=method_call --dest=com.nokia.phone.net /com/nokia/phone/net Phone.Net.set_selected_radio_access_technology byte:1 | echo ""

====3G====

dbus-send --system --type=method_call --dest=com.nokia.phone.net /com/nokia/phone/net Phone.Net.set_selected_radio_access_technology byte:2 | echo ""

====Dual====

dbus-send --system --type=method_call --dest=com.nokia.phone.net /com/nokia/phone/net Phone.Net.set_selected_radio_access_technology byte:0 | echo ""

===Bluetooth===

====Enable====

dbus-send --system --type=method_call --dest=org.bluez $(dbus-send --system --print-reply --dest=org.bluez / org.bluez.Manager.ListAdapters | awk -F'"' '/at/ {print $2}') org.bluez.Adapter.SetProperty string:Powered variant:boolean:true | echo ""

====Disable====

dbus-send --system --type=method_call --dest=org.bluez $(dbus-send --system --print-reply --dest=org.bluez / org.bluez.Manager.ListAdapters | awk -F'"' '/at/ {print $2}') org.bluez.Adapter.SetProperty string:Powered variant:boolean:false | echo ""

===Profiles===

====General====

dbus-send --type=method_call --dest=com.nokia.profiled /com/nokia/profiled com.nokia.profiled.set_profile string:"general" | echo ""

====Silent====

dbus-send --type=method_call --dest=com.nokia.profiled /com/nokia/profiled com.nokia.profiled.set_profile string:"silent" | echo""

===Lock (secure) the device===

dbus-send --system --type=method_call --dest=com.nokia.system_ui /com/nokia/system_ui/request com.nokia.system_ui.request.devlock_open string:"com.nokia.mce" string:"/com/nokia/mce/request" string:"com.nokia.mce.request" string:"devlock_callback" uint32:'3' | echo ""

===Update e-mail===

sh /path/to/script/email.sh | echo ""

'''email.sh script:'''

The script connects to the internet and refreshes e-mail. Keep in mind that Modest e-mail client which N900 uses is very slow in this aspect and send and recive can take up to minute and a half. Make it executable.

#!/bin/sh
run-standalone.sh dbus-send --type=method_call --dest=org.freedesktop.Notifications /org/freedesktop/Notifications org.freedesktop.Notifications.SystemNoteInfoprint string:"Updating e-mail..."
run-standalone.sh dbus-send --system --type=method_call --dest=com.nokia.icd /com/nokia/icd com.nokia.icd.connect string:"[ANY]" uint32:0
sleep 10
run-standalone.sh dbus-send --type=method_call --dest=com.nokia.modest /com/nokia/modest com.nokia.modest.SendReceive

===Set maximum CPU frequency===

rootsh echo 600000 > /sys/devices/system/cpu/cpu0/cpufreq/scaling_max_freq | echo ""

Replace 600000 with desired maximum frequency. This is usable with the new overclocking kernels if you wish to manually change the maximum frequency to which processor can scale. Pay attention to the two exceptions in titan's kernels (124999 and 599000). The list of available frequencies on your device/kernel can be obtained with command:

awk '{print $1/1000" MHz"}' /sys/devices/system/cpu/cpu0/cpufreq/stats/time_in_state

===Reboot===

rootsh reboot | echo ""

Warning: Consult forums before you try this, because currently DCEW executes some (all?) commands at startup. This will be optional in next version. Making a reboot button on current DCEW version could result in endless reboot loop.

===FM transmitter===

====Enable/disable====

/usr/bin/fmtx_client -p$(if [ $(cut -d. -f1 /proc/uptime ) -lt 100 ]; then echo 0; else /usr/bin/fmtx_client | /bin/grep -q '^state=enabled' ; echo $? ; fi) | /usr/bin/awk -F '=' '($1=="state") {print $2}'

Note: when you reboot the device, this script waits 100 seconds before you can turn the transmitter on/off again.

====Increase power====

echo "echo 118 > /sys/class/i2c-adapter/i2c-2/2-0063/power_level" | sudo gainroot | echo ""

[[Category:Software]]
[[Category:Power users]]

maemo.org wiki - User contributions [en]

Desktop Command Execution Widget scripts