7. Configure Ampwifi

The first time you run Ampwifi it will prompt you to configure it. This is because Ampwifi needs to know how to connect to Winamp® and the AjaxAMP Remote Control Plugin. This section will describe how to do that.

Here is a list of all the settings:

  1. System Settings
    • Wiresless & networks - Click this to setup your wireless network. If your WiFi is already connected and working, you probably don't need to click this.
  2. Communications
    • Server profile - Click this to activate, add, remove or edit server profiles. A server profile describes how Ampwifi will communicate with Winamp® and AjaxAMP. You can maintain an unlimited list of server profiles. Ampwifi only connects to one server at a time, and that's called the active server profile.
    • Refresh interval - This determines how frequently Ampwifi will refresh from Winamp®. The shorter the interval the more accurately Ampwifi can display the Now Playing and Playlist information, however it may use more battery and bandwidth. A longer refresh interval will trade accuracy for improved battery performance. You may also set the refresh interval to Manual, which means Ampwifi will refresh only when you explicitly ask for a refresh or when you issue a command to Winamp®. Note that when the refresh interval is set to Manual, the Pause and Play buttons are not highlighted as Ampwifi can not safely determine the exact state without regularly refreshing.
    • Allow mobile data - Enable this to allow the use of mobile/cellular data networks. This is considered an adnvanced feature for those who understand how to setup their routers and firewalls to forward the required port to their Windows machine running Winamp®. Of course you'll need to determine the WAN IP address of your router/gateway and manually set that in your server profile.
  3. Playlist
    • Show file name - Enable this to have the full path of each song listed below the title in the Playlist tab.
    • Confirm removal - Enable this to request confirmation before removing an item from the Playlist.
  4. Music library
    • Group folders - When enabled, folders will be listed at the top of the list, followed by any music files. When disabled, folders and files will be viewed in alphabetical order.
  5. Search results
    • Group folders - When enabled, folders will be listed at the top of the search results, followed by any music files. When disabled, folders and files will be viewed in alphabetical order.
    • Show folders only - Enable this to search only folders names, otherwise files and folders will be searched. Note that enabling this automatically disabled Group folders for Search results.
    • Show full path - Enable this to have the full path of each song listed below the title in the search results.
    • Match whole words only - Use this feature to reduce search results to match your exact search query. When enabled all words entered into the search edit box must match only whole words. For example, with the feature enabled "Love" will not match "Loverboy" because it's not a full word match. With the feature disabled a partial word such as "Lov" will match with both "Love" and "Loverboy".
    • Clear search history - On Android 3.0+ devices, a history of all search queries (but not results) is kept on the device so that they can be displayed as suggestions when entering a new search query. Select this item to permanently clear out your search history.
  6. Nexus
    • Always show at startup - When enabled, the Nexus activity will always be shown when first run. This is to allow you to see what network you're currently connected to and which Server Profile will be used. However, there's no reason to always view the Nexus activity when you launch Ampwifi. Disabling this feature will still show the Nexus activity if Ampwifi notices that you're on a different network since the last time it was run (example: connected to different Wi-Fi network). Since a change in networks may affect your connection to Winamp®, the Nexus activity will be shown so that you can make changes if needed. The Nexus activity can not be completely disabled.
    • Remove from back stack - When you tap the Launch button to connect to Winamp®, the Nexus activity will be removed from the back stack when this option is enabled. This means that once connected, pressing the back button you will not go back to the Nexus activity but instead to the Android home screen. When this option is disabled, pressing the back button from within the main part of the app takes you back to the Nexus activity.

Managing server profiles

The "server" is the machine running Winamp® with the AjaxAMP Remote Control Plugin. The "Server Profile" defines how Ampwifi will communicate with it. Each profile has a name, the host IP address of the server, the port number where AjaxAMP is listening on and optionally a user name and password for security reasons. If you're not sure what an IP address or a port number is, not to worry, Ampwifi can in most cases figure that out for you.

To view or edit a server profile you'll need to select the Settings menu option. Then press the Server profile setting which will bring up the Server profiles activity. There are two ways to add new server profiles:

  1. Scan for servers - Pressing this will start another activity where Ampwifi will scan the network to find any machines running Winamp®. It takes about 4 seconds to scan the network. Make sure that the server is on, that Winamp® is running, that AjaxAMP is properly configured and working and that your Android device is connected via WiFi to your network. Any found servers will be presented in a list. Simply check the ones you wish to use and then press the Add button.
  2. Add server profile - Pressing this will bring up a dialog where you can manually enter the details for the new server profile. This includes a name for your server profile, the host address and port number. Optionally, you can also enter a user name and password if the server requires it.

Below you will see two categories of server profiles:

  1. Active server profile - The active server profile is the server that Ampwifi will connect to. To edit this profile, simply press it.
  2. Inactive server profiles - All other server profiles are listed here. To make any one of these active, simply press it and it will be moved to the Active server profile category. If you long press an inactiver server profile you'll have the option to:
    1. Make profile active
    2. Edit profile
    3. remove profile

Server profile

When manually adding or editing a server profile, there are three mandatory fields that must be entered and two optional fields. If the mandatory fields have not been entered, the OK button will be disabled and you will NOT be able to store that server profile. You can instead press Cancel to discard any changes and return to the server profiles activity. The server profile fields are:

  1. Name - This is the name of the server profile. It does not need to be unique, but it probably would make sense to give it a unique name.
  2. Host - This would typically be the machine name of the machine running Winamp® with the AjaxAMP Remote Control Plugin. You may also enter an IP address in this field. To learn more about how to determine the machine name, click here. To learn more about determining the machine IP address, click here. This field does not accept spaces.
  3. Port - This is the port number that AjaxAMP will be listening on. Make sure this matches the value in AjaxAMP Configuration, under Server → Server Port. This number is 5151 by default. This field accepts only numerical digits and a value between 0 and 65535.
  4. User - This is the username if required. Make sure this matches the value in AjaxAMP Configuration, under Security → Username. This field does not accept spaces.
  5. Password - This is the password if required. Make sure this matches the value in AjaxAMP Configuration, under Security → Password. This field does not accept spaces.