<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>anyRemote · Control your computer with your phone</title>
<meta http-equiv="Content-type" content="text/html; charset=utf-8" />
<meta name="description" content="anyRemote project page - Bluetooth remote control tool" />
<link rel="stylesheet" href="data/master.css" type="text/css" media="all" title="Default Style" charset="utf-8" />
<script src="data/effects.js" type="text/javascript" charset="utf-8"></script>
<link rel="alternate" title="Feed" href="data/feed.xml" type="application/rss+xml" />
<link rel="icon" href="data/logo-favicon.png" type="image/png" />
<link rel="shortcut icon" href="data/logo-favicon.png" type="image/png" />
</head>
<body id="docs">
<a class="skip" name="top"> </a>
<a class="skip" href="#content">Skip to content</a>
<div id="head">
<div id="logo">
<h1><a href="index.html"><img src="data/logo-head.png" alt="logo" /> anyRemote</a></h1>
</div>
<div id="navigation"><div class="padding">
<a href="index.html"><span>About</span></a>
<a href="frontend.html"><span>Screenshots</span></a>
<a href="dload.html"><span>Download</span></a>
<a href="docs.html" class="active"><span>Documentation</span></a>
<a href="faq.html"><span>FAQ</span></a>
<a href="contacts.html"><span>Contact</span></a>
<a href="thanks.html"><span>Special Thanks</span></a>
</div></div>
</div>
<div id="sidebar"><div class="padding">
<dl class="info">
<dt>Information</dt>
<dd>
<p>Please use the two sidebar boxes below to browse through the anyRemote Documentation!</p>
</dd>
</dl>
<dl class="docs">
<dt>Documentation</dt>
<dd>
<ul>
<li><a href="pre-setup.html">Before install</a></li>
<li><a href="pre.html">Software prerequisites</a></li>
<li><a href="install.html">Compilation and installation</a></li>
<li><a href="mode.html">Which mode to choose ?</a></li>
<li><strong>Setup</strong>
<ul>
<li><a href="setup-at.html">Setup: AT mode</a>
<ul>
<li><a href="event.html">Event reporting</a></li>
<li><a href="ckpd-emulation.html">Keypad emulation events</a></li>
</ul>
</li>
<li><a href="setup-server.html">Setup: Server mode</a></li>
</ul>
</li>
<li><a href="use.html">How to use anyRemote</a>
<ul>
<li><a href="android-client.html">Android Client</a></li>
<li><a href="use-jc.html">J2ME Client</a></li>
<li><a href="web.html">Web Interface</a></li>
<li><a href="cm-xml.html">XML Services Interface</a></li>
<li><a href="cfg-howto.html">How to create simple configuration file</a></li>
<li><a href="bemused.html">Bemused Support</a></li>
<li><a href="iviewer.html">Command Fusion iViewer support</a></li>
</ul>
</li>
<li><a href="devices.html">Tested devices</a></li>
<li><a href="phones.html">Phone specific details</a></li>
<li><a href="tips-tricks.html">Tips & tricks</a></li>
<li><a href="man.html">Man page</a></li>
</ul>
</dd>
</dl>
<dl class="docs-advanced">
<dt>Advanced</dt>
<dd>
<ul>
<li><a href="http://elpraga.bshellz.net/HOWTOstartanyRemoteatboottime.html">miniHOWTO: start anyRemote at boot time and create a multimedia computer</a> (externally maintained)</li>
<li><strong>Format of configuration files</strong>
<ul>
<li><strong>Server mode</strong>
<ul>
<li><a href="conf-server.html">Configuration file format</a></li>
<li><a href="conf-server-ex.html">Configuration file examples</a></li>
<li><a href="set.html">Set(...) / ExecAndSet(...) commands</a></li>
<li><a href="set-fm.html">Set(filemanager ... ) command</a></li>
<li><a href="set-icons.html">Set(icons ...) command and available icon set</a></li>
<li><a href="set-list.html">Set(list ... ) and Set(iconlist ... ) commands</a></li>
<li><a href="set-menu.html">Set(menu ... ) command</a></li>
<li><a href="set-parameter.html">Set(parameter, ... ) commands</a></li>
<li><a href="set-text.html">Set(text ... ) command</a></li>
<li><a href="set-window.html">Set(image ... ) command</a></li>
</ul>
</li>
<li><strong>AT mode</strong>
<ul>
<li><a href="conf-at.html">Configurational file format</a></li>
<li><a href="conf-at-ex.html">Configurational file examples</a></li>
</ul>
</li>
<li><strong>Common</strong>
<ul>
<li><a href="make.html">Make(...) command</a></li>
<li><a href="emulate.html">Emulate(...) command</a></li>
<li><a href="dbus.html">Dbus(...) command</a></li>
<li><a href="vars.html">Variable substitution</a></li>
<li><a href="ev-handlers.html">Event handlers</a></li>
<li><a href="icon-themes.html">Icon themes for J2ME client</a></li>
</ul>
</li>
</ul>
</li>
<li><a href="ir.html">anyRemote and InfraRed</a></li>
</ul>
</dd>
</dl>
<dl class="contact">
<dt>Contact</dt>
<dd>
<p>We will be pleased for any questions, suggestions, patches and examples of configuration files!</p>
<ul>
<li>Post in the <a href="http://sourceforge.net/forum/?group_id=162923">Forum</a></li>
<li>Please, send e-mails to <a href="mailto:anyremote@mail.ru">anyremote@mail.ru</a></li>
</ul>
</dd>
</dl>
<!--HOSTINGLOGO-->
</div></div> <!-- sidebar -->
<div id="content"><div class="padding">
<a class="skip" name="content"> </a>
<h1>Tips & tricks</h1>
<h2>Enhance security with password</h2>
<p>In <a href="setup-server.html">Server-mode</a> it is possible to set password which will be requested from J2ME/Android clients.</p>
<p>To make this it needs to run anyRemote with <strong>-password</strong> commandline option.</p>
<p>The password phrase should be stored in <strong>$HOME/.anyRemote/password</strong> file in a plain text.</p>
<h2>Keepalive messages</h2>
<p>If J2ME/Android client on the phone disconnects from PC after some inactivity period it is possible to send keepalive messages to
handle this. It just needs to add command like</p>
<pre>Timer(_PING_,300,0);</pre>
<p>to the <strong>$HOME/.anyRemote/hook_connect</strong> file and add command</p>
<pre>Timer(_PING_,cancel);</pre>
<p>to the <strong>$HOME/.anyRemote/hook_disconnect</strong> file.</p>
<p>In the line above <strong>300</strong> is a number of seconds between <a href="conf-server.html#sec-get">Get(ping)</a> requests.</p>
<h2>Customization of client initialization/exiting and connect/disconnect commands.</h2>
<p>It is possible to add custom commands to <a href="ev-handlers.html">(Init)</a>, <a href="ev-handlers.html">(Connect)</a>,
<a href="ev-handlers.html">(Disconnect)</a> and <a href="ev-handlers.html">(Exit)</a> event handlers.</p>
<p>To do this it needs to create file</p>
<ul>
<li><strong>$HOME/.anyRemote/hook_int</strong> (for (Init) event handler)</li>
<li><strong>$HOME/.anyRemote/hook_connect</strong> (for (Connect) event handler)</li>
<li><strong>$HOME/.anyRemote/hook_disconnect</strong> (for (Disconnect) event handler)</li>
<li><strong>$HOME/.anyRemote/hook_exit</strong> (for (Exit) event handler)</li>
</ul>
<p>and put all needed commands there. That commands will be executed after commands defined in appropriate
<a href="ev-handlers.html">event handler</a> command sequence.</p>
<h2>Support for non-UTF8 encodings</h2>
<p>Anyremote J2ME client supports only <a href="http://en.wikipedia.org/wiki/UTF-8">UTF8</a> encoding.
If You system configured to use other encoding (e.g <a href="http://en.wikipedia.org/wiki/ISO_8859-15">ISO-8859-15</a>
used in Western Europe) then it is possible to handle this.</p>
<p>It needs to define variable <strong>$(FromEncoding)</strong> and add command like </p>
<pre>Make(var,FromEncoding,by_value,ISO-8859-15);</pre>
<p>to the <strong>$HOME/.anyRemote/hook_init</strong> file.</p>
<p>Conversion from specified encoding to <a href="http://en.wikipedia.org/wiki/UTF-8">UTF8</a> will be automatically applied
to the following commands:</p>
<pre>ExecAndSet(list,add|replace,...);
ExecAndSet(iconlist,add|replace,...);
ExecAndSet(filemanager,add|replace,left|right...);
</pre>
<p>Reverse conversion to specified encoding from <a href="http://en.wikipedia.org/wiki/UTF-8">UTF8</a> will be automatically applied
to the <a href="vars.html#params_index">$(Param)</a> environment variable.</p>
<p><strong>Note:</strong> Be sure <a href="http://www.gnu.org/software/libiconv">iconv</a> library is installed in You system.</p>
<p><strong>Note:</strong> anyRemote should be compiled with <a href="http://www.gnu.org/software/libiconv">iconv</a> support.</p>
<h2>Volume control with <a href="http://alsa.opensrc.org/index.php/Amixer">amixer</a> or
<a href="http://linux.die.net/man/1/pacmd">pacmd</a> utilities.</h2>
<p>If managed application does not allow to control volume, then anyRemote will use <a href="http://alsa.opensrc.org/">ALSA</a> or
<a href="http://www.pulseaudio.org/">PulseAudio</a> directly. And using of the
<a href="http://www.pulseaudio.org/">PulseAudio</a> will be a preferred.</p>
<p> In this case it needs to have <strong><a href="http://alsa.opensrc.org/index.php/Amixer">amixer</a></strong> or
<strong><a href="http://linux.die.net/man/1/pacmd">pacmd</a></strong> utilities installed on Your system.</p>
<p>By default anyRemote will control</p>
<ul>
<li><strong>Master</strong> channel of soundcard <strong>#0</strong> in case of <a href="http://alsa.opensrc.org/">ALSA</a></li>
<li><strong>Default Sink</strong> in case of <a href="http://www.pulseaudio.org/">PulseAudio</a></li>
</ul>
<p>If it needs to control sound volume with non-default parameters, it is possible to add definitions of the following
<a href="vars.html">variables</a></p>
<ul>
<li><strong>$(default_mixer_up)</strong></li>
<li><strong>$(default_mixer_down)</strong></li>
<li><strong>$(default_mixer_mute)</strong></li>
<li><strong>$(default_mixer_get)</strong></li>
<li><strong>$(default_mixer_set)</strong></li>
</ul>
<p> to the <strong>$HOME/.anyRemote/hook_init</strong> file.</p>
<p>For example, default setup for <a href="http://alsa.opensrc.org/">ALSA</a>:</p>
<pre>Make(var,default_mixer_up,by_value,amixer sset Master,0 5%+ -q);
Make(var,default_mixer_down,by_value,amixer sset Master,0 5%- -q);
Make(var,default_mixer_mute,by_value,amixer sset Master,0 toggle -q);
Make(var,default_mixer_get,by_value,amixer sget Master,0|\
grep '\['|head -1|cut -f 2 -d "["|cut -f 1 -d "]"|sed "s/%//");
Make(var,default_mixer_set,by_value,amixer -q sset Master,0 );</pre>
<p>or default setup for <a href="http://www.pulseaudio.org/">PulseAudio</a>:</p>
<pre>Make(var,default_sink,LANG=C;pactl stat|grep "Default Sink"|cut -f 2 -d ":"|tr -d ' ');
Make(var,default_mixer_down,by_value,$(CfgDir)/Utils/pulse-audio-ctl.sh down $(default_sink));
Make(var,default_mixer_up,by_value,$(CfgDir)/Utils/pulse-audio-ctl.sh up $(default_sink));
Make(var,default_mixer_mute,by_value,$(CfgDir)/Utils/pulse-audio-ctl.sh mute $(default_sink));
Make(var,default_mixer_get,by_value,$(CfgDir)/Utils/pulse-audio-ctl.sh get $(default_sink));
Make(var,default_mixer_set,by_value,$(CfgDir)/Utils/pulse-audio-ctl.sh set $(default_sink) );</pre>
<h2>Power Management</h2>
<p>By default anyRemote will use</p>
<ul>
<li><strong>poweroff</strong> command to switch off computer</li>
<li><strong>dbus-send --system --print-reply --dest="org.freedesktop.UPower" /org/freedesktop/UPower org.freedesktop.UPower.Suspend</strong> command to suspend computer</li>
</ul>
<p>In Ubuntu <strong>pmi</strong> utility is available in <strong>powermanagement-interface</strong> package and
it is possible to use <strong>pmi action suspend</strong> command to suspend computer.</p>
<p>If it needs to change default power management parameters, it is possible to add definitions of the following
<a href="vars.html">variables</a></p>
<ul>
<li><strong>$(default_switch_off)</strong></li>
<li><strong>$(default_suspend)</strong></li>
</ul>
<p> to the <strong>$HOME/.anyRemote/hook_init</strong> file.</p>
<p>For example:</p>
<pre>Make(var,default_switch_off,by_value,poweroff);
Make(var,default_suspend,by_value,pmi action suspend);</pre>
<h2>Cover Art support by audio player configuration files.</h2>
<p>If anyRemote can not retrieve cover art from application, it try to search it inside directory with file currently played.
(search done with depth equal to 2).
It is user responsibility to store cover art in appropriate directory.</p>
</div></div> <!-- content -->
<div id="foot">
<p>Maintained by <a href="mailto:anyremote@mail.ru">anyRemote</a>. Website by <a href="http://www.martinlettner.info">m.lettner</a>.</p>
</div>
</body>
</html>
