This command used to control and customize GUI of Java client. It is possible to change:
|
![]() |
This command also could be used to:
of it execution to set GUI of Java client |
![]() |
Set(...) command is used to set various parameters of GUI of Java client with exact comands specification.
ExecAndSet(..) do the same thing, but it uses the results of executed command as as part of command which will be sent to Java client.
Timer(...) do the same thing as ExecAndSet(...), but it could beexecuted periodically.
For details see examples below.
There are a lot of ways to use this command:
Set(icons, ...)
Format: SetI(icons,caption,1,name1,2,name2...,*,name11,#,name12)
where nameX specifies desired action. This command sets the caption of Java client window and reports to Java client to dynamically change shown icons.
1=Exec(xmmsctrl play);Set(icons,XmmsPlaying,5,stop,1,kill); 1=ExecAndSet(icons,echo "XmmsPlaying,5,stop,1,kill"); 1=Timer(t1,5,0,icons,echo "XmmsPlaying,5,stop,1,kill");
if You do not want to change the caption of Java client window then it is possible to write:
1=Exec(xmmsctrl play);Set(icons,SAME,5,stop,1,kill);
Set(title, ...)
Format: Set(title, new_title)
This command sets the title field of Java client
Set(title,XMMS); ExecAndSet(title,whoami); Timer(t2,5,0,title,whoami);
It is possible to add line break characters to the text. It could be done with "\n".
Set(status, ...)Format: Set(status, new_status) This command sets the status field of Java client
3=Exec(xmmsctrl play);Set(status, Playing) 3=ExecAndSet(status,sh -c "if xmmsctrl playing;then echo Stopped; else echo Playing; fi") 3=Timer(t3,5,0,status,sh -c "if xmmsctrl playing;then echo Stopped; else echo Playing; fi")
Set(bg ...)
Format: Set(bg,R,G,B)
Where R, G, B values should be beetween 0 and 255. This command sets the background color of Java client. For example to set background to blue:
3=Set(bg,0,0,255); 3=ExecAndSet(bg,echo "0,0,255"); 3=Timer(t4,5,0,bg,echo "0,0,255");
The simples way to determine appropriare RGB value is to run KolourPaint program and then open Select Color dialog.
Set(fg ...)
Format: Set(fg,R,G,B)
Where R, G, B values should be beetween 0 and 255. This command sets the foreground color of Java client. For example to set foreground to blue:
3=Set(fg,0,0,255); 3=ExecAndSet(fg,echo "0,0,255"); 3=Timer(t5,100,0,fg,echo "0,0,255");
Set(font ...)
Format: Set(font,small|medium|large)
This command sets the font size for title and status fields of Java client. Java realization in the phone could not support some of font sizes. On SE phones medium font looks the same as large one. For example to set small font size:
3=Set(font,small); 3=ExecAndSet(font,echo small); 3=Timer(t6,120,2,font,echo small);
Set(volume ...)
Format: Set(volume,X)
Whare X should be between 0 and 100. This command sets value of volume bar of Java client (it needs to issue Set(skin,....volume) command before to make volume bar visible):
3=Set(volume,50); 3=ExecAndSet(volume,xmmsctrl getvol); 3=Timer(t7,5,0,volume,xmmsctrl getvol);
Set(vibrate)
Format: Set(vibrate)
This command switches on internal vibrator of the phone (if exists) for 1/2 sec.
3=Set(vibrate);
Set(text, ...)
Format: Set(text,add|replace|show|clear|close|fg|bg|font, _data_)
This command shows help test on the screen of cell phone. See detailed description here.
#=Exec(xmmsctrl quit);Set(text,replace,Help,To run Xmms press 1) #=ExecAndSet(text,replace,Date,date) #=Timer(t8,10,5,text,replace,Date,date)
Set(list ...) and Set(iconlist ...)
Format: Set(list,add|replace|clear|show|close|menu|fg|bg|font, _data_) or
Set(iconlist,add|replace|clear|show|close|menu|fg|bg|font, _data_)
This command used to create and manage lists. It could be useful to manage player playlists or to browse directory structure. See detailed description here. The iconlist can contain icons in front of each list item.
3=Set(list,replace,Shell commands,reboot,shutdown,uptime,dmesg); 3=ExecAndSet(list,replace,Example,more some_file.txt); 3=Timer(t10,6,5,list,replace,Example,more some_file.txt); 3=Set(iconlist,replace,Shell commands,launch:reboot,exit:shutdown,question:uptime,question:dmesg);
Set(menu ...)
Format: Set(menu,add|replace|clear[,_data_])
This command used to manage menues. Custom made menu could be added to each screen of Java Client. See detailed description here.
4=Set(menu,add,Random,Repeat,Shuffle); 4=ExecAndSet(menu,add,echo "Random,Repeat,Shuffle"); 4=Timer(t11,4,10,menu,add,echo "Random,Repeat,Shuffle");
Set(skin ...)
Format: Set(skin,default|bottomline|bottomarc[,keypad_only|joystick_only][,ticker|noticker],[volume],[size16|size32])
4=Set(skin,default,ticker,size32); 4=ExecAndSet(skin,echo "bottomline,joystick_only,volume"); 4=Timer(t12,4,10,echo "bottomarc,ticker,volume);
This command used to choose icon layout ("skin") to show. There are 3 icon layouts defined: default, bottomline and bottomarc. If keypad_only parameter specified, then it will be possible to send commands only by pressing numeric keys. If joystick_only parameter is specified, then it will be possible to send commands only by pressing joystick central button. If ticker parameter is specified then ticker (running text) will be used to show title field instead of static text. |
![]() |
![]() |
If noticker parameter is specified then title field will be shown as static text. If volume parameter is specified then volume bar will be shown. In bottomline and bottomarc icon layouts if there will be not enough space on phone screen to show all icons, then some of them will be omitted. If the screen heigth is less than 250pt. then 16x16 icons will be used by default, overwise 32x32 icons will be used by default. It is possible to force using 16x16 or 32x32 icons by specifying size16 or size32 parameter. |
![]() |
![]() |
Set(filemanager ...)
Format: Set(filemanager, add|replace, left|right, _list_of_files) This command used to show file manager window. It looks like MC and allows to do basic file operations. See detailed description here. |
![]() |
![]() |
3=Set(filemanager,add,left,.,..); 3=ExecAndSet(filemanager,add,left,ls -1); 3=Timer(t13,5,0,filemanager,add,left,ls -1);Set(fullscreen ...)
Format: Set(fullscreen,on|off)
Set fullscreen mode on or off.
3=Set(fullscreen,on); 3=ExecAndSet(fullscreen,echo on); 3=Timer(t15,100,1,fullscreen,echo on);
Set(editfield ...)
Format: Set(editfield,caption_value,label_value,init_value)
Shows edit field on phones screen. When used press OK, then message label_value(0,_entered_value_) will be sent to server.
3=Set(editfield,Enter parameters,Parameters,Enter your data here); 3=ExecAndSet(editfield,echo "Enter parameters,Parameters,Enter your data here"); 3=Timer(t14,6,1,editfield,echo "Enter parameters,Parameters,`more some_file.txt`");For example, if user enters, say - new_line - and press OK, then message Parametes(0,new_line) will be sent.
Set(parameter, ...)
Format: Set(parameter,_parameter_name_,_parameter_value_)
Where _parameter_name_ can be: debug, lazy_repaint, fix_siemens. It is useful to add Set(parameter, ...) command to (Connect) event handler to set parametes automatically upon connection to the phone.
Set(parameter,debug,on|off)
Switch on/off debug information printing in Java Client. Useful for debugging. Default value is "off".
(Connect)=Set(parameter,debug,on);
Set(parameter,lazy_repaint,on|off)
Useful to avoid flickering screen of java client. Default value is "off". If You use long commands like Set(title,a1);Set(status,a2);Set(icons,SAME,...);... then if this parameter is set to "off" then screen of java client will be repainted after each command. If this parameter set to "on" then screen of java client will be repainted only if Set(repaint) command will be issued.
(Connect)=Set(parameter,lazy_repaint,on);
Set(parameter,full_repaint,on|off)
Useful to fix some mismatches in Java realization in phones. Default value is "off". Try to set this option to "on" if something goes wrong with repainting of java client.
(Connect)=Set(parameter,full_repaint,on);
Set(parameter,fix_se,on|off|auto)
Useful to fix mismatches in SE-K750's Java realization. Default value is "auto". If You use other SonyEricsson phone try to set this option to "on" if something goes wrong with repainting of java client.
(Connect)=Set(parameter,fix_se,on);
Set(parameter,fix_siemens,on|off|auto)
Useful to fix mismatches in Siemens-S65's Java realization. Default value is "auto". If You use Siemens/BenqSiemens phone try to set this option to "on" if something goes wrong with java client.
(Connect)=Set(parameter,fix_siemens,on);
Set(parameter,fix_joystick,auto|off)
Useful if using devices with qwerty keypad (like Nokia-E61). Default value is "off". If You use device with qwerty keypad try to set this option if some buttons on keypad detected incorrectly by java client as joystick buttons.
(Connect)=Set(parameter,fix_joystick,auto);
Set(parameter,joystick_up,_keycode_)
Set(parameter,joystick_down,_keycode_)
Set(parameter,joystick_left,_keycode_)
Set(parameter,joystick_right,_keycode_)
Set(parameter,joystick_push,_keycode_)
Useful if using devices with qwerty keypad (like Nokia-E61). No default values. If You use device with qwerty keypad and some buttons on keypad detected incorrectly by java client as joystick buttons and Set(parameter,fix_joystick,auto) does not works then try to set these parameters with real keycodes of joystick keys. To determine real keycodes of joystick keys add Set(parameter,debug,on) command to (Connect) line of cfg. file and then inspect log file.
(Connect)=Set(parameter,joystick_up,-1); (Connect)=Set(parameter,joystick_down,-2); (Connect)=Set(parameter,joystick_left,-3); (Connect)=Set(parameter,joystick_right,-4); (Connect)=Set(parameter,joystick_push,-5);
Set(parameter,fix_nokia_push,on|off|auto)
Useful on some Nokia phones if push joystick do not works. Adds "Push" menu item which should be mapped to push joystick. \ Default value is "auto".
(Connect)=Set(parameter,fix_nokia_push,on);
Set(parameter,fix_nokia_repaint,on|off|auto)
Useful on some Nokia series 40 phones if screen is not redrawed properly and remains white in some cases. Default value is "auto".
(Connect)=Set(parameter,fix_nokia_repaint,on);
Set(parameter,fix_nokia_exit_btn,on|off|auto)
Useful on some Nokia phones if "Exit" menu item is absent in main screen. Adds "Exit" to the menu. Default value is "auto".
(Connect)=Set(parameter,fix_nokia_exit_btn,on);
Set(repaint)
Format: Set(repaint)
This command enforce java client to repaint the screen. Useful if parameter "lazy_repaint" is set to on (see Set(parameter,...).
3=Set(vibrate);
Set(upload ...)
Format: Set(upload,_icon_name_,_ARGB_array_16x16_or_32x_32)
Upload icon to the phone.
3=Set(upload,test,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,255,2,2,2,255,72,72.....(string too long));
You do not need to use this weird command in Your cfg. file. To upload icons just use cfg-example/Server-mode/iconUpload.cfg configuration file.
Only 16x16 or 32x32 PNG icons could be uploaded. There is no direct way to remove uploaded icons nor to show the list of uploaded icons. All uploaded icons will be removed if Java Client will be removed from the phone.