FooMote

From Banamalon Wiki
Jump to: navigation, search
FooMote
Foomote.png
Genresmusic player remote control, foobar2000
Operating systemAndroid
PermissionsRecord audio
Prevent sleeping
Network access
Change Wi-Fi
Wi-Fi state
Network state
Phone status
Storage
Protected storage
EULAEULA
Privacy policyPrivacy policy
Available inEnglish
German
Finnish
Available atGoogle Play
AndroidPIT
Amazon Appstore for Android
StatePublished
PriceFree or fee-based

FooMote is an app for Android to remote control your foobar2000 player. Or extend it by a music collection with the help of HomeMedia!

Features:

  • Basic controls like play, pause etc.
  • Seek bar
  • Volume bar
  • Playing title
  • Filemanager
  • Media library
  • Widgets
  • Full list of features

Contents

Installation

System Requirements on Android device:

  • At least Android 2.3 (since FooMote version 4.0)
  • WiFi

System Requirements on computer:

Web Interface

Notice: With version 3.0 of FooMote, the template of the web interface changed as well. Please download the new foomote_json template from our web site. This zip file still contains the template for FooMote versions below 3.0 (foomote). This wiki will only deal with the foomote_json template.

Install the foo-httpcontrol (web interface for foobar2000) plugin:

  1. Download the web interface plugin foo-httpcontrol
  2. Go to the installtion directory of foobar2000
  3. Open the components directory
  4. Copy the foo_httpcontrol.dll (of the plugin zip-file) into this directory
  5. Start foobar2000
  6. If your firewall asks you whether to block foobar2000 or not, don’t block it otherwise the App won’t work!
  7. Optional: Adjust the plugin (changes of port require a restart of foobar2000)

For the installation of older foo-httpcontrol plugins, please see → Main article: Installation of deprecated foo-httpcontrol plugin

foomote_json template

Template folder of '#foo-httpcontrol plugin after installation

Install the foomote_json template:

  1. Download the foomote_json template from our web site
  2. Go to the AppData directory of foobar2000 %APPDATA%/foobar2000 (for the portable version of foobar2000: foobar2000 directory)
  3. Create, if not exists the directory foo_httpcontrol_data and open it
  4. Copy the foomote_json folder of the zip file along with its content into this directory (see screenshot on the right)

For the installation of older foo-httpcontrol plugins, please see → Main article: Installation of deprecated foo-httpcontrol plugin

Test web interface

Test web interface and template

Optional tests (foobar2000 must be running):

  1. Test the connection locally: Enter http://localhost:8888 (be sure to replace 8888 with foobar2000's (foo-httpcontrol's) port) in a browser on your computer
    • It is working: foobar2000's web interface is up and running
    • It is not working: Check if foobar2000's web interface is correctly installed
  2. Test the connection remotely: Enter http://[IP-ADDRESS]:8888 (replace 8888 with foobar2000's (foo-httpcontrol's) port and [IP-ADDRESS] with the IP address of the PC where foobar2000 is running) in a browser on a different device
    • It is working: foobar2000's web interface can be accessed remotely
    • It is not working: foobar2000 (foo-httpcontrol) or its port is blocked by a security program or router/modem
  3. Test the web interface template foomote_json: Enter http://localhost:8888/foomote_json?param3=src/status.json (be sure to replace 8888 with foobar2000's (foo-httpcontrol's) port) in a browser on your computer
    • It is working: The current status of foobar2000 is displayed in JSON format, which means the foomote_json template is installed correctly
    • It is not working: The template has not been installed correctly (it's not inside foo_httpcontrol_data folder of foobar2000's AppData directory)

Adjust web interface

Configure web interface and template

Optionally, you may adjust the web interface plugin foo-httpcontrol and the foomote_json template.

  • Adjust foo-httpcontrol plugin:
    1. Run foobar2000
    2. Open the components settings of foobar2000 (Select from the menu: File » Preferences)
    3. Find Tools on the left and select HTTP Control
    4. Adjust the configuration of foo-httpcontrol to your likes (e.g. the port, authorization credentials, order of the media library browsing)
    5. Click OK to save the changes
  • Adjust foomote_json template:
    1. Go to the AppData directory of foobar2000 %APPDATA%/foobar2000 (for the portable version of foobar2000: foobar2000 directory)
    2. Open the foo_httpcontrol_data/foomote_json directory
    3. Open the config file for edit
    4. Adjust the configuration of foomote_json to your likes (e.g. default album art, items per playlist page) - don't change the json code, otherwise FooMote won't function correctly!
    5. Save the file
  • Restart foobar2000 to make sure that the changed configurations are loaded

FooMote

Download and install the FooMote app. There are two versions available: a free lite version and an ad-free pro version. The free version is available on Google Play, AndroidPIT and Amazon Appstore for Android.

Permissions

Main article: Permissions of FooMote

Connection

foobar2000 (foo-httpcontrol) and the app communicate over the local network. Communications over 3G or 4G should also be possible.

Local network (WiFi)

Make sure no firewall is blocking foobar2000 (foo-httpcontrol) nor the port and no other program is already listening on that port.

If any port changes were made, you have to tell the app. Inside settings choose Media Player settings and you're able to change the port.

For selecting a server are two ways available:

  • Manually: Enter the IP address or pc name of your computer inside the field IP-Address
  • Automatically: Click on Server Management. This triggers a search for running foobar2000s (with enabled web interface) in the network. If your computer could not be found, try again.

After selecting your pc you are ready to interact with foobar2000 from your app.

3G or 4G

Connection over 3G or 4G should also work, but didn't have been tested.

Notice: You have to do port forwarding of the foobar2000 (foo-httpcontrol) port (by default: 8888 (TCP)). Furthermore you need to set your external IP address inside the app, since the automatic scan won't work.

FooMote PRO

The pro version of FooMote includes the same features as the lite version. The only difference is that it is ad-free.

FooMote PRO is available for download on Google Play, AndroidPIT and Amazon Appstore for Android.

Main article: Feature comparison

Usage

Notice: The blue finger tells you that you can swipe that area away to access more features. Just move your finger over this area from left-to-right or the other way round.

Remote control interface

FooMote remote control interface

The remote control interface is the first interface you see, when you enter FooMote. The most used control operations are displayed right away: the play/pause, previous and next buttons and the seek bar to position the playback of foobar2000. The main area shows the album art of the currently playing song and its time information.

On the remote control interface designed for mobile phones, you can access the playlist by swiping away the main remote control interface.

To access more control operations, just slide out the list from the top of the screen (indicated by an arrow slider). By default, the list displays four buttons at most. You can change this appearance in the layout settings. Swipe inside this area to access more buttons.

The following table shows a list of controls which are available for FooMote:

Label Explanation
Play/Pause Play or pause the playback.
Next Open the next file.
Previous Open the previous file.
Position A seek bar is located above the main playback control buttons (play/pause, next and previous) and may be used to select the position of the current playback.
Volume The volume button is located in the action bar. Press it to show the volume bar inside the action bar. Volume can also be changed using the hardware volume buttons of your Android device. To mute the volume, just click the speaker icon while the volume bar is showing.
Refresh The refresh button is located in the action bar for tablet screens. Refresh the currently displayed playlist.
Search The search button is located in the action bar for tablet screens. Search inside the currently displayed playlist.
Filemanager The filemanager button is located in the action bar. Open the filemanager to browse your files.
Jump Back Jump backwards in the current playback.
Jump Jump forwards in the current playback.
Stop Stop the current playback.
Random Randomly select a song from the playlist and play it.
Order Select the playback order:
  • Default
  • Repeat playlist
  • Repeat track
  • Random
  • Shuffle tracks
  • Shuffle albums
  • Shuffle folders
Load Load a playlist of foobar2000. You can also load a playlist by clicking on the name of the currently selected playlist.
New Create a new playlist in foobar2000. You may enter a name for the new playlist.
Delete Remove a playlist from the playlist collection in foobar2000.


Main article: Explanation of buttons

Playlist interface

FooMote with playlist

On tablet screens, the playlist interface is displayed on the remote control interface as well. On mobile screens, you can access the playlist interface by swiping away the remote control interface.

The playlist is received via the web interface plugin foo-httpcontrol for foobar2000. You can fill up the playlist using the filemanager or using the external app HomeMedia.

By pressing long on an element inside the playlist, you open up a context menu to perform additional actions:

Label Explanation
Play Play the selected song in foobar2000.
Search Search inside the currently displayed playlist page.
Jump to current Jump to the currently playing song in the playlist (inside FooMote). This works only if the currently playing song is on the current playlist page.
Empty playlist Clear the currently displayed playlist.
Delete element Remove the selected song from the playlist.
Move up Move the selected song up inside the playlist.
Move down Move the selected song down inside the playlist.

You can switch the current playlist, by clicking on the name of the playlist displayed at the top of the playlist. Switch through the playlist pages by clicking the arrows next to the page indicator or select a page by clicking on the page indicator.

The action bar holds buttons to search or to refresh the current playlist page.

Filemanager

FooMote: Filemanager

Use the filemanager to browse your computer's files on your Android device, like using Windows Explorer. To browse a folder or open a file in foobar2000, just click on it.

Tip: Turn on Back button browsing, in the settings, to move up a folder by pressing the back button of Android.

To switch to the filemanager's favorites, select Favorites from the drop down-menu in the action bar. To enable multiple selection of files and folders, hit the edit button (pen symbol) and select your desired files or folders. Choose Done to quit the multiple selection interface without doing anything or select your desired action.

Use the Style button in the action bar to switch between list style or symbolic view. To easily access the root of the filemanager, choose the Root button from the action bar (down-arrow).

When you click on a file, foobar2000 will add the file to the current playlist.

By pressing long on a file or folder, you open up a context menu to perform additional actions:

Label Explanation Folder File
Open Same performance as by clicking on the file/folder itself. yes yes
Add file(s) Add the files of the folder to the current playlist. yes no
Add all files Add all files in the folder and its sub-folders to the current playlist. yes no
New playlist Create a new playlist with this file/folder's files. yes yes
New playlist all files Create a new playlist with all files in the folder and its sub-folders. yes no
Add to Favorites Mark a folder as favorite. The folder will be listed inside the filemanager's list of favorites. yes no

Media library

FooMote: Media library

Use the media library to browse the media library of foobar2000. The interface is similar to a filemanager. The order of browsing is (by default): Music genre » Artists » Album. Just click on a music genre to show its artists or click on an artist to show its albums.

While you browse through the media library, foobar2000 changes its query playlist. That means, once you found the genre, artist or album you want to play, just go back to the remote control interface and you'll see the query playlist.

HomeMedia

You can access your HomeMedia music collection via the external app HomeMedia.


Main article: HomeMedia

Settings

Use the settings to adapt FooMote to your needs and likes.

Click on First Steps to display the first steps to get help setting up the app.

At the bottom of the list of settings, you may find Help & Contact, which will open a list of help and information elements, such as the link to this user guide or the startup information displaying the changelog and version of the app.

Media Player Settings

FooMote: Media player settings

Use the media player settings to change the settings for the current server (= computer running foobar2000) connection. Make sure to set up everything correctly, otherwise the app can't communicate with foo-httpcontrol (which should be installed and running on your computer).

Click on Server Management to open a list of stored and available servers.

It's easier to add a server within server management than to change every field inside this media player settings. Just make sure that the port is correctly set up, otherwise the automatic scan (inside server management) won't work!

The field (IP) address requires the IP address or computer name of the computer running foobar2000. The field port is the port for the foo-httpcontrol web interface.

You may enter a user name and password, inside the media player settings or inside the advanced settings of the currently selected server. Make sure to enter the same user name and password as you have set-up in the settings of foo-httpcontrol.

FooMote also comes with a WOL - Wake On LAN - feature, since your computer might not be awake all the time. All you need to do is to make sure the MAC address displayed in the MAC address field is the correct MAC address of your computer. Otherwise FooMote tries to wake up the wrong device. During an automatic scan, FooMote acquires the MAC address, but you may also enter the MAC address manually. This should of course be done, before you try to wake up the pc (unless you know the MAC-address).

WOL, as its name indicates, tries to wake your computer over the network, which means you must enable this feature in BIOS to get it work. There are a lots of tutorials on how to enable WOL.


Main article: Instructions for getting the MAC address on Windows


If you check the WOL automatically checkbox, FooMote will try to wake up the server every time you open up the main remote control interface of FooMote. But you may also try to wake up your computer by clicking the Wake Up! button while it is sleeping.

Advanced Settings

FooMote: Advanced settings

Inside the advanced settings you can set the update frequency, which means, how often the playback status of foobar2000 is being updated. For example, by default, FooMote requests the status (which file is playing, time/volume etc.) of foobar2000 every five seconds.

You can change this delay inside the update status setting:

  • Realtime: Update every second
  • Every 5 seconds
  • Every 10 seconds
  • Every 30 seconds
  • Every minute
  • Only if needed (e.g. when the next song is playing or the playback is being paused)

Notice: The more often the status is updated, the more your battery will decrease.

With the display setting drop-down you may define what FooMote should do, when the Android device enters an idle state (due to inactivity): perform the default behavior, just dim the screen, brighten the screen or leave the device and screen on.

The back button browsing will change the behavior of the filemanager: While pressing the back key of your Android device, FooMote will browse the parent instead of going back to the remote control interface.

To start foobar2000 remotely, the external app HomeMedia is required to be installed and set-up correctly on your Android device.

If you check the start player automatically checkbox, FooMote will try to start foobar2000 every time you open up the main remote control interface of FooMote. But you may also try to start foobar2000 on your computer by clicking the Start Player button while it is not yet open.

Alternative Input Method

FooMote: Alternative input method

FooMote provides, in addition to the default control buttons, alternative input methods.

The Phone Call Control comes into effect when your Android phone is behaving like a normal phone: By default, FooMote pauses the playback when your phone is ringing and resumes the playback once your phone call ended. These settings can be changed, by selecting the state of the phone call (Ringing - Phone call accepted - Phone call ended) and choosing an action from the drop-down menu (change volume or change playback state).

Use the Touch Control to activate a gesture control feature of FooMote. These touch gestures work only on the main area (which is holding the album art) of the remote control interface. Otherwise you won't be able to scroll through the playlist!

Depending on your finger movement, you trigger different actions (assuming they are turned on in the settings):

  • Move your finger up or down on the main area to increase or decrease the volume.
  • Tap the main area to play or pause the playback of foobar2000.
  • Swipe inside the main area to open the next or previous song in the playlist.

Notice: The next/previous gesture is only working on tablets! Mobile screens need this gesture to access the playlist.

The Shake Control is triggered, as the name intends, when you shake your Android device. You may choose between playing a random song or the next song in the playlist or to just toggle between playing and pausing.

A cool feature is the Voice Control, which is also adaptive. Leave single command enabled to improve your battery life. If single command is enabled, you'll have to press the voice command button (inside the action bar) before saying a voice command. Is single command disabled, you just have to press voice command button only one time to activate the voice control. The recording and parsing of the audio for voice commands will be done in the background, but only as long as FooMote is open.

Inside the command management, you may test the commands or set-up new commands: For example, you want to say Google to pause the playback. Use the test button to test voice commands. The tab commands lists all voice commands which are available and your alternative commands are added as well (e.g. the Google command will be listed below pause). You can even add alternative commands as numbers! Numbers are required to jump to a specific position in the playback (position [number] [number] [number] by default), jump a specific value forward/backwards in the playback (jump [number] [number] [number] by default) or to change the volume (volume [number] by default).

Since the voice commands are deleted on an update of FooMote, you can export the list of commands to an external XML file. Later, you may import the previously stored XML file to FooMote.

Just activate it in the settings and try it out!

Wave Control requires the external app Wave Control for parsing the input commands. This app uses the photosensor/light sensor of your Android device to detect movements without touching the phone. Basically, there are two different commands:

  • Waving your hand one time over the sensor to play the next song
  • Waving your hand two times (back and forth) over the sensor to play the previous song

You can find further information about this app by reading its description in Google play.

Layout Settings

Use the layout settings to change the layout of FooMote.

Enable the fullscreen checkbox to force the application into fullscreen mode and thus, hide the notification bar of Android.

The swipe notification is the blue finger, which appears above swipable areas. You can turn this notification off.

You may also force the orientation of FooMote to display the app always in portrait, landscape or to auto-rotate when you tilt your Android device.

By default, the expandable button list shows only four buttons at most. However, you can change this appearance by changing the value of the max buttons setting.

The image scale type defines how the album art is displayed:

  • Center: Center without scaling the image
  • Center Crop (default): Center by scaling the image
  • Center Inside: Center by scaling the image to fit completely inside the area
  • Fit Center: Scale the image centered to fit in the area
  • Fit End: Scale the image to fit in the area without centering
  • Fit XY: Fill the image to fit in the area without aspect ratio

Change the appearance of the playlist in FooMote by displaying or hiding the time, artist and album of a song.

Server Management

FooMote: Server Management

Use the server management to easily switch between stored and available servers and to add new ones. A server is a computer which is running foobar2000.

When you enter server management, FooMote searches the local network for running foobar2000s by trying to access the web interface of foo-httpcontrol on the computer. Hit the refresh button to re-start the search for foobar2000 in the local network. If you are using FooMote via 3g/4g, you won't find any servers by an automatic scan - you'll have to add your server manually.

Notice: The Port (which you can find inside media player settings) is also the port used to find running foobar2000s by an automatic scan (done by FooMote). You need to make sure that FooMote has set up the same port as foo-httpcontrol to find your computer during the automatic scan.

To add a server, click on the Add server button and the add server-dialog will pop up. Enter the IP address or pc name of your computer inside the address field and change the port, if applicable (click on Advanced Settings to show the field for the port). Click OK to save the server. You may also enter a user name and password, inside the server's advanced settings. Make sure to enter the same user name and password as you have set-up in the settings of foo-httpcontrol.

Tip: To store an automatically added server press long on the server, choose Edit from the context menu and then click the OK button.

When you click on a server, FooMote will switch the server to your selected one.

By pressing long on a server, you open up a context menu to perform additional actions:

Label Explanation
Select Same performance as by clicking on the server itself.
Edit Open the edit server-dialog to change the server's details (e.g. port or address). The edit server-dialog is similar to the add server-dialog, mentioned above.
Wake up! Wake up the selected computer. Make sure that FooMote stored the MAC-address of the computer to get waking up to work.
Wake all! Wake up all displayed servers. Make sure that FooMote stored the MAC-address of the computers to get waking up to work.
Delete Remove the selected server from the list of servers.
Delete all Remove all servers from the list of servers.

Notice: In the tablet design of FooMote, you may test the connection to your server: Just click the test button on the right. If the line is green and goes all the way from the smart phone icon to the server icon, a connection was successful. Otherwise the line will be red and stop half way between the smart phone icon and the server icon.

Widgets

FooMote provides four widgets, which differ in size and display. Each widget displays either the current album art or the title being played and a play-pause button to change the playback state.

Widgets of FooMote

External links

Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox
Translate