<!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>
<dl class="help">
<dt>Project needs help!</dt>
<dd>Help us to fix any misprintings, syntax and stylistic errors in documentation. Send Your corrections to <a href="mailto:anyremote@mail.ru">anyremote@mail.ru</a></dd>
</dl>
<!--HOSTINGLOGO-->
</div></div> <!-- sidebar -->
<div id="content"><div class="padding">
<a class="skip" name="content"> </a>
<h1>How to use anyRemote</h1>
<img class="float-right" alt="tray icon and menu" src="data/ganyremote-tray.png" />
<p>To run anyRemote frontend execute command:</p>
<ul>
<li>Gnome: <code>ganyremote</code></li>
<li>KDE: <code>kanyremote</code></li>
</ul>
<p>After startup anyRemote icon will appear in the tray. To open main window choose "Restore" tray menu item. It is possible
to specify <strong>-o</strong> option to open main window at startup. Upon startup frontend will scan all found configuration files
and show list which will look like the picture below.</p>
<p class="center clear"><img alt="main window" src="data/ganyremote1.jpg" /></p>
<p>The status column shows does particular application runs on PC or not. Frontend will rescan application activity each minute (can be changed in preference window).</p>
<p>To run anyRemote it needs just to double-click application name. Alternatively it is possible to use tray menu items Execute/Stop, or File->Execute/Stop menu items in main window.</p>
<p>In preferences window (see below) it is possible to specify locations of configuration files, filters and tune various parameters. </p>
<p class="center"><img alt="main window" src="data/ganyremote3.jpg" /></p>
<p>To use anyRemote GUI it needs to have at least one element in "Directory" list. In normal situation frontend will find location of configurational files automatically.</p>
<p><img class="float-right" alt="main window" src="data/ganyremote-devbr.jpg" />By default frontend will scan for BT devices each minute. Found devices will be marked as <strong>Available</strong> in list. To be detected an BT device must be in <strong>discoverable</strong> mode. If new BT device will be detected, then <strong>Device Detail window</strong> (see below) will be shown automatically.</p>
<p class="clear">In Device Detail window it is possible to</p>
<ul>
<li>ping BT device</li>
<li>verify will it works with anyRemote in AT-mode</li>
<li>upload J2ME client to the phone</li>
<li>configure anyRemote autostart in case of BT device will be found</li>
<li>set configuration file which will be used by anyRemote if BT device will be found</li>
</ul>
<p class="center"><img alt="main window" src="data/ganyremote-devdet.png" /></p>
<p class="info extra">If something goes wrong be double sure that all software <a href="pre.html">prerequisites</a> are installed.</p>
<h1>How to use anyRemote from command line</h1>
<p>By default anyRemote will search the following configuration files:</p>
<ul>
<li>/.anyremote.cfg</li>
<li>$HOME/.anyremote.cfg</li>
</ul>
<p>You can specify another configuration file with <strong>-f</strong> option, for example:</p>
<pre>anyremote -f /...path_to.../xmms.cfg -s peer[,peer ...]</pre>
<p>See <a href="man.html">Man page</a> for details.</p>
<p>You may find some predefined configuration files in these directories:</p>
<ul>
<li>cfg-data/AT-mode</li>
<li>cfg-data/Server-mode</li>
<li>cfg-data/Bemused-emulation</li>
</ul>
<h1>Web interface</h1>
<p>To use anyRemote with any device which contains web browser and which can connect to PC by TCP/IP (GPRS, Wi-Fi, ...)
it is possible to use built-in <a href="web.html">web interface</a>.
<h1>Logging</h1>
<p>By default anyRemote does not prints any logging information.</p>
<p>It is possible to add command <pre>Make(var,Log,by_value,false|true|debug);</pre> to the <code>(Init)= ...</code> command sequence
in the configuration file or use <code>-log</code> command line option to allow
logging.</p>
<p>By default all logging information will be stored in <strong>$HOME/.anyRemote/anyremote.log</strong> file.
This could be altered by setting <strong>AR_TMPDIR</strong> environment variable.
If <strong>AR_TMPDIR</strong> environment variable is set then logging information will be printed to
<strong>${AR_TMPDIR}/anyremote.log.${USER}</strong></p>
<h1>Sound control with amixer</h1>
<p>If configuration file uses <strong><a href="http://alsa.opensrc.org/index.php/Amixer">amixer</a></strong> utility to control sound volume and if
it needed to control a non-default (<strong>0</strong>) sound card it is possible to add the folowing command</p>
<pre>Make(var,MixerCard,by_value,1); <i>% change 1 to the appropriate sound card number</i></pre>
<p>to the <strong>$HOME/.anyRemote/hook_init</strong> file.</p>
<p>If configuration file uses <strong>amixer</strong> utility to control sound volume and if it needed to control a channel different from
<strong>Master</strong> it is possible to add the folowing command</p>
<pre>Make(var,MixerChannel,by_value,PCM); <i>% change PCM to appropriate channel to control</i></pre>
<p>to the <strong>$HOME/.anyRemote/hook_init</strong> file.</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>
