jRemote 1.

0 User Manual
Document version: 1.0
Author: Anoop Padmanabhan
Email: ee02m043@yahoo.com

Contents
Introduction
Features
Requirements
Phone compatibility
Installing and configuring jRemote
Step 1: Configuring the Bluetooth interface
Step2: Installing and configuring the plugin
Step 3: Installing jRemote Java Midlet.
Starting and stopping jRemote
Main screen
Options and shortcuts
Equalizer
Playlist Editor
Add File
New Playlist
Save Playlist
Open Playlist
Media Library
Tracks
Albums
Artists
Genres
Playlists
Sleep Timer
Video Settings
Known Limitations
 Introduction

jRemote is a remote control plugin for controlling Winamp from a Java and
Bluetooth enabled mobile phone. jRemote allows you to take complete control of
the Winamp functions from your phone over a Bluetooth interface. jRemote as of
now is available only for certain models of Sony Ericsson phones only. Other
maker’s phones may be supported in the future.

Features

Control Winamp’s play, pause, forward, rewind, next track, previous,

volume, shuffle, repeat, equalizer and equalizer preset functions.

View information about the currently playing track. View track length,

elapsed time, remaining time, mono/stereo, and sample rate.

View, edit, create, save and open playlists. Browse through your

computer’s drives for folders, media files and playlists in a Windows

explorer styled interface.

Browse Winamp media library, view artists, albums, genres, and play

lists, play tracks, create and play playlists.

Change Winamp video window size, switch to full screen, 1X and 2X.

Automatically stop Winamp or shutdown your computer after a pre-

determined time or number of songs. Optionally fade the volume

progressively.

Above all from the convenience of your handy mobile phone!

Requirements

Hardware
PC with Bluetooth interface and one free Bluetooth serial port.
Software
Windows 2000, Windows XP
Winamp 5.0 or higher

Phone compatibility

jRemote has been tested successfully on the following phone models from
Sony Ericsson.
220 X 176 screen size: Z550i, K750i
160 X 128 screen size: W300
jRemote is expected to work correctly though not tested on the following
models of Sony Ericsson phones.
160 X 128 screen size: k510, z520, z525, z530
220 X 176 screen size: k600, w600, w700, w800, w810
jRemote may function correctly in phones having a different screen size
but the GUI may not appear correctly.
License
jRemote is free. You can install, use, copy, distribute on any number of
computers or phones as you like. Even commercial use is permitted. jRemote
does NOT contain any ad-ware, spy-ware or any other malicious code.
Disclaimer
jRemote is free and is provided with out any kind of warranty or guaranty
of performance or support. Though jRemote in author’s best faith does not
contain any code that is harmful to your phone or computer the author does not
assume any responsibility for any damages or data loss that may arise by using
jRemote.

Installing and configuring jRemote.

jRemote has two components. One is a plugin running in your PC under

the hood of Winamp. The plugin is a dll file that you need to copy to Winamp’s
plugin directory. Other one is a Java Midlet running in your mobile phone which is
responsible for displaying the GUI, taking inputs from you and sending them to
the plugin over Bluetooth. The plugin silently receives the inputs form the phone,
processes and sends them to Winamp. It also sends information like the current
track, files and folders back to your mobile phone.
The step by step installation procedure is described below.

Step 1: Configuring the Bluetooth interface.

First your phone needs to be paired with the computer. Skip this step if you
have already done so or if you know how to pair! This can be done either form the
Bluetooth manager application installed in your computer or from your mobile
phone. BlueSoleil is a common Bluetooth manager application that is bundled
with most of the USB Bluetooth dongles. The steps for pairing the phone phone
are described below.
A pairing process can be initiated from either the phone or BlueSoleil. For
doing this from your phone go to the Main Menu > Settings > Connectivity and
select Bluetooth. Then select My devices. This will show all already paired
devices. If your Computer’s Bluetooth name is not displayed (Refer to BlueSoleil
documentation for setting this) there then select the Add or New device option.
Your phone will now start searching for Bluetooth devices within range and start
displaying their names. Select your computer from the list. Now the phone will
ask you a passcode. Enter the passcode in phone and select OK. Now BlueSoleil
will pop-up a dialog asking you the passcode.Enter the same passcode in this
dialog box and click OK. The phone and your PC will now be paired. Refer to
BlueSoleil documentation for doing a pairing from BlueSoleil.
 Now you need to enable the serial port service in BlueSoleil. For this go to
BlueSoleil’s My Services > Properties . . . menu. In the displayed tabbed dialog
box select the Serial Port A or Serial Port B tab. Make sure that the Auto-start this
service when Bluetooth starts check-box is selected. Also note down the serial
port name displayed here. In the screen shot below COM8 is the serial port
name.

In some cases Serial Port A may be in use by another application. In this case
select Serial Port B.
Step2: Installing and configuring the plugin.

The downloaded zip file will contain a file ml_jRemote.dll Extract this file to
your computer. Now find the directory where Winamp is installed. Open this
directory in Windows explorer and find the folder Plugins. Copy the
ml_jRemote.dll to this folder. Now start Winamp if not already running. If Winamp
is already running restart Winamp.
Go to Winamp’s Options > Preferences menu or press CTRL+P to display
the Winamp preferences dialog box. In Plugins section select Media Library to
display all the installed Media Library plugins. The jRemote plugin should appear
there as shown below. Select jRemote and click on Configure selected plug-in
 Now jRemote will display the configuration dialog as shown below. You
need to select the serial port from the drop down list Serial Port. Select the same
serial port name that you noted from BlueSoleil’s My Services menu in Step1. In
the given example serial port name is COM8. Click OK to save the selected
configuration and close the configuration dialog box. Restart Winamp to take the
changes to effect.

jRemote plugin is now configured and ready for use. You need to do the
configuration only once unless the selected serial port is used by another
application. The settings will be saved in the Winamp’s init file and restored every
time you start Winamp.

Step 3: Installing jRemote Java Midlet

jRemote Java Midlet comes in two flavors for mobile phone screen sizes
160X128 and 220 X 176. The downloaded zip file contains two jar files (Java
executables) jRemote160X128.jar and jRemote220 X176.jar. (Here after both
files will be referred as jRemoteXXXX.jar) Refer to section Phone Compatibility
for finding the right file for your phone.
Extract this file to your computer and transfer this file to your phone using
the Sony Ericsson PC suite file transfer utility or BlueSoleil. Copy
jRemoteXXXX.jar to the Others folder in your phone memory or memory stick.
Now go to your phone’s Main menu > File manager > All Files > Other and locate
jRemoteXXXX.jar. Select Install and phone will ask you the program group where
you want to install. Select Applications and phone will install jRemoteXXXX.jar as
an application. You can choose to start the application right away or find the
jRemote application in Main menu > File Manager > Applications later.

Starting and stopping jRemote

To start jRemote go to Main menu > File Manager > Applications

and select jRemote. jRemote will now start searching for Bluetooth devices within
the range and list the devices found. From the list select your computer and
select Connect. jRemote will now try to connect to the plugin running in Winamp
and will display a continuously running bar. If plugin is configured properly the
phone will ask for a confirmation for allowing a connection for jRemote. Select
Yes and wait for a while. The jRemote main screen as shown below will appear.
To exit from jRemote press the BACK key from the main screen and
select Exit at the bottom of the list of options displayed. jRemote can be
minimized while you are in any screen by pressing the BACK key for few seconds
and then by selecting “Minimize” option from the menu that appears. This is
useful for making calls or for accessing other applications without quitting
jRemote. Also you can exit jRemote by selecting “End Application”.

Note: In phones that do not support minimize application feature, pressing

the BACK key for few seconds will exit jRemote.

Main screen

The main screen of jRemote is shown below. It has a Winamp

styled display where the information about the currently playing track is
displayed. The display shows total track length, elapsed time, and remaining time
- all in minutes, stereo/mono, and sample rate. Player status such as stopped,
playing, paused, shuffle, repeat and muted will be displayed using icons. The title
of the track continuously scrolls in the bottom of the display. If Winamp is not
running the message “Winamp is not running! Please start Winamp” scrolls in the
display.
The volume bar reflects the current volume setting of Winamp and tracks
the Winamp volume. The seek-bar shows the progress of the current track
graphically.

The four switches at the bottom of the screen provide the basic Winamp
functions Previous Track, Play, Pause and Next Track.
Previous Track is activated by pressing the top-left key on your phone’s
key pad. Next Track is activated by pressing the top– right switch key.
LEFT and RIGHT navigation keys activate the Rewind and Forward
actions respectively of the current song. The slider on seek-bar will move left or
right to reflect this.
The UP and DOWN navigation keys activate the volume up and down
actions and the slider on the volume bar reflects this.
The OK/SELECT button toggles between playing or paused state of the
current track. The state will be reflected in the switches and also displayed in the
display area as icons.
Pressing C key will mute Winamp and press C again to un-mute.
 Pressing * key will toggle repeat and # will toggle shuffle.
While you are in the jRemote’s main screen pressing the BACK key once
will display a list of options as listed below. Selecting an option will display the
related screen as described in following sections. Alternately you can invoke the
options from the main screen by pressing the numerical shortcut keys as listed
below.

jRemote Options and shortcuts

Main Window : displays the main window.

Equalizer : displays a Winamp styled equalizer. Refer to
section jRemote Equalizer for details. Shortcut: Numerical Key 1
Playlist Editor : displays a playlist editor that displays current
playlist playing in Winamp. Also you can create, edit, save, and open playlists.
Refer to section Playlist editor for details. Shortcut: Numerical Key 2
Media Library : Displays a list of Tracks, Albums, Artists, and
Genres in Winamp’s media library. You can select an artist, genre, album, or a
track from any hierarchy for playback in Winamp. Shortcut: Numerical Key 3
Play File : Displays a Windows explorer styled browser.
You can browse your computers drives for media files and play/enqueue them in
Winamp. Shortcut: Numerical Key 4
Open Playlist : Displays a list of playlists from your computer’s
My Music folder. Shortcut: Numerical Key 5
Sleep Timer : Displays a screen for setting the shutdown
timer and volume fader. Shortcut: Numerical Key 6
Video Settings : Displays a screen for setting the Winamp video
screen. Shortcut: Numerical Key 7
About : Displays the about screen.
Exit : Exit jRemote
 Equalizer

jRemote’s Equalizer screen is as shown below. The 10 equalizer

bands can be controlled by the UP and DOWN navigation keys. The band to
control can be selected by repeatedly pressing the LEFT and RIGHT navigation
keys and the corresponding slider gets highlighted. jRemote provides a number
of preset equalizer settings that can be displayed by pressing the top-left key.
You can select a preset from this list. While you are in equalizer screen pressing
the BACK key will take you back to the main screen.

Playlist Editor

jRemote’s Playlist editor displays the track names in the current

playlist playing in Winamp. You can select any track from here for playback. Also
the more menu to the right of the screen has options for adding a track to the
playlist, creating a new playlist, save a playlist, and open a playlist. Select Cancel
or Back from Playlist editor to go back to jRemote’s main screen.
Add File
Selecting Add file from the more menu will display the file browser. It lists
the drives in your computer and you can browse through them. The browser will
display all folders and media files. The media file name extensions are taken from
Winamp’s configuration. You can look inside the folders by pressing the
OK/SELECT key and use Add option from the more menu to add folders to
playlists. Media files can be added to the playlists by either pressing OK/SELECT
key or by using Add option from the more menu. Press BACK button to go back
to the previous directory or select Cancel to go back to Playlist editor.

New Playlist
Selecting this option will clear the playlist in Winamp and jRemote.
Now you can select the Add File option to add files to the playlist.

Save Playlist
Selecting this option will display a text entry screen where you can
enter the name of the playlist. By default this will display My Playlist1 and you can
edit this. Selecting the Save option will save the current playlist in My Music
folder of your computer as an m3u file. If the entered file already exists this will
display an error and the entry will change to My Playlist2 and so on. If the playlist
is saved successfully you will get a message indicating the same. Press the
BACK key to go back to the Playlist editor screen.

Open Playlist
Selecting this option will display the file browser with all the playlists
saved in your computer’s My Music folder. You can select a play list to play it in
Winamp. Press BACK button to go back to Playlist editor.

Media Library

Media library allows you to browse through Winamp’s media library

database and play or queue tracks from there. jRemote’s Media Library provides
flexible options like playing all tracks in an album, a genre, or by an artist. Media
libray main screen displays the following options.
 Tracks
Displays all tracks in the library. Press select or eEnqueue from more
menu to play in Winamp. Pressing BACK once will take you back to the Media
library main screen.

Albums
Displays all albums in the library. You can play an album by
selecting Enqueue from more menu. Press BACK once to go back to Media
library main screen. Press OK/SELECT to view the tracks in an album. The name
of the album will be displayed in the title. You can play any track by pressing
OK/SELECT or Enqueue from more menu. You can go back to Media library
main screen by pressing BACK twice.

Artists
Displays all artists in the library. You can play all tracks by an
artist by selecting Enqueue from more menu. Press BACK once to go back to
Media library main screen. Press OK/SELECT to view all albums by an artist.
You can select an album to view and play the tracks or play an album by
selecting enqueue from more menu. Select the All Tracks entry in the list of
albums to view all tracks by an artist. Note that this will have tracks by an artist
including those tracks that does not belong to any album.

Genres
Displays all genres in the library. You can play all tracks in a
genre by selecting Enqueue from more menu. Press BACK once to go back to
Media library main screen. Press OK/SELECT to view all albums in a genre. You
can select an album to view and play the tracks or play an album by selecting
Enqueue from more menu. Select the All Tracks entry in the list of albums to view
all tracks in a genre. Note that this will have tracks in a genre including those
tracks that does not belong to any album.
Playlists
Select this option to display all playlists media library. You can play a
playlist by selecting it or enqueue by selecting Enqueue from the more menu.

Sleep Timer

jRemote allows you to shutdown your computer or stop playback and fade
volume after a predetermined time interval or number of songs. Any combination
of these options can also be selected. For example you can program jRemote to
shutdown the computer say after 30 minutes and fade volume by 10% after every
2 minutes.
The first choice elements in sleep timer screen allow selecting the sleep
timer action between shutting down the computer and stopping playback. You
can use the LETT and RIGHT navigation keys to select between choices and
OK/SELECT key to make a choice. You can enter the time in minutes or the
number of songs in the text entry box after that. You can use the UP and DOWN
navigation keys to select the text field and then enter the time in minutes or
number of songs using the numerical keys. You can select the timer to be
activated after the entered number of minutes or the number of songs by the next
choice elements.
You can set the volume fading in percentage in the next text entry box.
You can set the number of minutes to elapse before fading volume in the next
text entry field.
After entering the values and choices select Set to activate the sleep timer.
If the sleep timer is successfully activated the timer status displayed at the bottom
of the screen will change from “Unknown!” to “Enabled!” To disable a previously
scheduled timer action select “Disable” from the more menu.
You can return to jRemote main screen by pressing BACK key or by
selecting “Cancel” command from more menu.

Video Settings
jRemote allows you to change Winamp’s video window size remotely. Use
the choice group elements and the select set to switch the video settings. You
can return to jRemote main screen by pressing BACK key or by selecting
“Cancel” command from more menu.

Known limitations
1. ‘:’ characters in titles and filenames will be replaced by ‘;’ character in
jRemote’s display ,file browser and play list editor.
2. Does not track the Winamp volume changes made using mouse track
ball and keyboard.
3. Display does not reflect mute operation done from Winamp.
4. Does not display the drive name while doing a back operation in file
browser.

Any trademarks referred in this manual are the property of their owners

