Setup

Table of Contents

• Requirements
• Guide
  • Foobar Setup
  • Beefweb Setup
  • Application Setup

Requirements

• Foobar2000
• Latest APK (Downloaded from project GitHub)
• BeefWeb fb2k-component (Downloaded from hyperblast's GitHub)
• Android Phone
• Install from unknown sources must be enabled

Guide

Foobar Setup

1. Download the latest version of Foobar2000. Version 2.24.5 was used; other versions may not work.
2. Run the installation of Foobar2000, either a full installation or a portable one; both will work. (Portable was used for testing)

Beefweb Setup

1. Download the latest version of the BeefWeb fb2k-component (Version 0.10 was used for testing)
2. Open Foobar2000, choose file, then preferences (or ctrl+p), press the install component button. Once pressed, choose the BeefWeb component and install it. Foobar2000 will require a restart
3. After a restart, go to the preferences, then tools, then Beefweb Remote Control. Set the following settings:
   • Port: 8880 (This can not be changed at the moment)
   • Allow remote connections: ☑
   • Music Directories: Add all directories
   • Require Authentication: ☐ (Authentication is supported in v0.2.0 and newer)
4. Go to Tools → Beefweb Remote Control → Permissions and enable the following:
   • Changing Playlists: ☑
   • Changing Output Device: ☐ (Not supported in v0.1.0, enabling will not break)
   • Changing Default Web Interface: ☐ (Not supported in v0.1.0, enabling will not break)
5. Open you foobar2000 application directory (such as %APPDATA%\foobar2000-v2), then navigate to profile → beefweb
6. Create a new file called config.json
   • Note: Do NOT put the config.json inside clientconfig, as this will not work. (as of Beefweb v0.10)
7. Open config.json in a text editor and add the following:

{
  "responseHeaders": {
    "Access-Control-Allow-Origin": "*"
  }
}

Caution

By doing this it will allow any device from any source to control foobar2000. If you are using one device with a static IP, change the "*" to the IP of the device. For more information, please see the https://github.com/hyperblast/beefweb/blob/master/docs/advanced-config.md

Application Setup

1. Download the latest APK from Releases on this GitHub
2. Open the file (such as with the Files app). The app will need to have permission to install other apps (it is recommended *NOT to give your browser this permission, do it only with a trusted app). You may get a notice that Auto Blocker prevents you from installing the app; this is expected as of v0.1.0. The app is unsigned, so some devices (Such as a Galaxy) will block the installation. Disable Auto Blocker, install it, then enable it again.
3. Once opened, it should prompt you to install/update. If it says the update failed, make sure the older version is uninstalled and try again.
4. Open the application
5. Make sure your phone and computer are on the same network
6. Press the "Find Beefweb Servers" button, and select the IP it provides. If you are using a VPN, a VLAN, or other network setup, this button can likely fail; if so, do step 7, otherwise skip to 8.
7. Get your computer's local IP address. (Such as 192.168.x.x) You can find this by going to Network & Ethernet in Windows settings, running ipconfig in CMD, or looking at your router's dashboard. Enter this IP into the text box.
8. You should now have the IP in the text box, press the "Connect to Beefweb" button, and the status information should say "Connected."