• Intro
• Downloads
• Community
• Development
• News
• TALK

Desktop Command Execution Widget scripts

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 on the forum.

Contents 1 Making your own scripts 2 Scripts to display information 2.1 Battery 2.1.1 Percentage, current and last full charge 2.1.2 Percentage and current charge 2.1.3 Percentage 2.1.4 Current and last full charge 2.1.5 Current charge 2.1.6 Last full charge 2.2 IP 2.2.1 External (WAN) and internal (LAN) 2.2.2 External (WAN) 2.2.3 Internal (LAN) 2.3 Disk usage 2.3.1 rootfs (256MB /) percentage used 2.3.2 rootfs (256MB /) free space 2.3.3 Internal memory for user data (27GB /home/user/MyDocs) percentage used 2.3.4 Internal memory for user data (27GB /home/user/MyDocs) free space 2.3.5 Internal memory for application data (2GB /home) percentage used 2.3.6 Internal memory for application data (2GB /home) free space 2.3.7 Memory card (/media/mmc1) percentage used 2.3.8 Memory card (/media/mmc1) free space 2.4 Wi-Fi signal 2.4.1 Link quality 2.4.2 RSSI 2.4.3 Noise 2.5 CPU frequency 2.6 Memory usage 2.6.1 RAM used 2.6.2 RAM free 2.6.3 Swap used 2.6.4 Swap free 2.6.5 Total memory used 2.6.6 Total memory free 2.7 GPRS data usage 2.7.1 Download and upload combined 2.7.2 Download and upload separated 2.8 Time and date 2.8.1 Date 2.8.2 Time in different timezones 2.9 Uptime and load 2.9.1 Both 2.9.2 Uptime 2.9.3 Load 2.10 Boot reason 2.11 Boot count 2.12 Temperature 2.13 Top processes 3 Scripts for buttons 3.1 Networking 3.1.1 Connect/disconnect 3.1.2 Connect internet (show connections) 3.1.3 Connect to any saved connection 3.1.4 Disconnect internet 3.1.5 Enable/disable Wi-Fi 3.1.6 Disconnect mobile network 3.1.7 Connect mobile network 3.2 Lock screen and keys 3.3 Radio mode 3.3.1 2G/3G 3.3.2 2G 3.3.3 3G 3.3.4 Dual 3.4 Bluetooth 3.4.1 Enable 3.4.2 Disable 3.5 Profiles 3.5.1 General 3.5.2 Silent 3.6 Lock (secure) the device 3.7 Update e-mail 3.8 Set maximum CPU frequency 3.9 Reboot 3.10 FM transmitter 3.10.1 Enable/disable 3.10.2 Increase power

Making your own scripts

When there's no output (for example if you're using widget as a button and you use dbus call), the widget displays "Invalid Command". This can be most easily avoided if you pipe echo "" at the end of the command. Example:

dbus-send -options -moreoptions | echo ""

This also works:

dbus-send -options -moreoptions; echo ""

...but the piping is preferred for buttons as it doesn't display ANY output (some dbus calls work only with reply). All of the dbus commands should be working in the same way. Collection of these can be found on Phone control wiki page. The basic principle is the same as above (dbus command and piping an echo).

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 +"%d.%m.%Y"

This command will show the date in format (for example) 01.10.2010. You can define your own format (between the quotation marks). Possible options are described on 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.

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.

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.

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

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