Computer Configuration

Overview and Quick-Start

Setting up Klink on your computer requires the installation of a small helper program. These instructions assume that your computer does not already have Internet access. They will walk you through the process of downloading the PC companion program to your phone and copying it to your computer so that you can use Klink.

Advanced users and those with Internet access on their PC: You may wish to download Klink PC software directly from this page. It should be a matter of downloading the appropriate installer file and running it on your PC to complete Klink installation.

All other users should follow the guide below.

Step-by-Step Guide

What type of computer do you want to connect?

Windows

Download Klink PC software:
- Klink for Windows - This is for all Windows users and provides drivers for almost every Android device. (4.5MB)
Connect your phone to your computer via the USB cable.
When downloading is complete, pull down the notification bar, and you should see an item resembling "USB connected" or "USB connection type". Press it so that your computer can access the files on your phone. Choose "Mount" if you are asked. On some phones you must further select a mode called "USB Mass Storage". [images]
Pull down the notification bar.
Choose to "Mount" your phone.
HTC users might see something like this instead:
[hide]

NOTE: Some phones (notably Samsung Galaxy devices) require that you disable "USB debugging" in order to mount the device as a removable drive. Do this by swiping from top to bottom on your phone to pull down the notification pane. Then, tap on the "USB debugging" box if you see it, and disable the "USB debugging" option.
A new disk should appear on your desktop. Open it and choose the "download" folder. NOTE: You might also see a "downloads" folder. Be sure to open "download". [images]

[hide]
You should find the installer file named something like "Faveset_Klink_Installer_1.07f.exe" within the "download" folder. Copy it to your computer.
Then, unmount the phone by choosing to "Safely Remove" it in Windows. Afterward, pull down the notification bar on your phone and "Turn off USB storage". [images]
Click the following icon in your status tray:

Safely remove the drive that is your phone.

On your phone, pull down the notification menu, and "Turn off USB storage".
[hide]

Now, run Klink's installer from the place where you copied it to install Klink on your PC. [image]
[hide]

NOTE: With some phones, Windows may warn about not finding drivers for the "ACM" or "CDC" device. This is normal, as Klink only requires the "ADB" feature. In an effort to conserve space, the installer only provides ADB drivers.
Your computer and phone should now be ready. To begin communicating:
- Make sure that your phone is connected to your computer via USB.
- Tap "Start" from within Klink's Android application. Be sure to follow any prompts that might appear regarding USB debugging, as debugging must be enabled.
- Windows should find your phone and configure things after a few seconds. Klink's PC program should then detect your phone by displaying a serial number in the "Detected device" box.
- Finally, click on "Start" from within Klink's PC application.
If the PC software cannot see your phone: it may be necessary to unplug the phone and plug it back the first time that Windows configures drivers for it. (This especially applies to Windows XP users.) It may also help to exit Klink's PC software and start it again after your phone is connected. If this does not help, contact us. If you would like to solve the problem yourself, please search the Internet for "ADB drivers" and your phone model. More information is in the details link. [details]
If you are unsure of whether or not Windows can recognize your phone, open Windows' Device Manager, and see whether an entry with a name resembling "ADB", "Android", or your phone's manufacturer has been detected:
- Run the Device Manager by going to "Start" and choosing "Run." When prompted, type in "devmgmt.msc".
- Device Manager will appear. Look for something containing the word "ADB", possibly under the heading "Android Phone".
  For example, the following screenshot is for a Samsung device after driver installation, when Windows can detect the device. You do not need to install drivers in this situation.
  If Windows cannot detect your phone, you should see something like the following, in which "ADB" is identified with a question mark/exclamation point under "Other devices." You will have to install drivers in this case.
  If you fail to see an "ADB" device, ensure that "USB debugging" is enabled by following any prompts when starting Klink on your phone (or by pressing the Menu Key at the phone's home screen and choosing Settings, Applications, and Development).
If you need to install drivers, note the dialog box at the end of Klink PC installation, because the installer will provide you with a directory containing the driver files that were installed. (This is normally a sub-directory of "Faveset Klink" named "Drivers".) You may wish to point Windows to that directory in the following.
Otherwise, download the driver that is appropriate for your device from this page. Please contact the support email via Klink's page in the Market/Play Store app if you cannot see a driver file for your phone model, and we'll get things in order. So far, all phone compatibility issues have been resolved under Windows.
After downloading the driver file to your phone, copy it to your computer and install it:
- If the downloaded driver is an installer (ends in .exe or .msi), run it to install the drivers. Windows should detect your device the next time you unplug it and plug it back into your computer.
- If the downloaded driver is a zip file, decompress it into a folder. The next time you connect the device, Windows will say that the phone cannot be detected. It should then prompt you for more information. Direct it to search for drivers in the folder containing the decompressed files.
  You can also instruct Windows manually if it fails to prompt you about your device when reconnecting. After unzipping the file, open up the device manager as described earlier (run "devmgmt.msc" from Windows start). Then, right-click on the unknown "ADB" device identified with a question mark/exclamation point, and select "Properties". Click on the "Driver" tab at the top, and choose to "Update" or "Install" driver. A help wizard will then pop up:
  On XP:
  - You should see a hardware update wizard.
  - Tell it not to connect to Windows Update.
  - Choose "Install from a list or specific location".
  - The first item "Search for the best driver in these locations" should be marked. Check the second box and click the "Browse" button.
  - Find the directory where you extracted the driver files (probably off of the Windows desktop).
  - Click OK and then Next to continue.
  - Windows should then detect your phone. It might ask you to repeat this step once more for other phone features.
  On Vista/7:
  - You should see a "Found New Hardware" window.
  - Choose the first item "Locate and install driver software (recommended)."
  - Choose "Don't search online" when asked if you want Windows to look online.
  - Tell Windows that "I don't have the disc. Show me other options."
  - Choose "Browse my computer for driver software (advanced)."
  - Press the "Browse" button.
  - Find the directory where you extracted the driver files.
  - Click "Next".
  - Windows should then detect your phone. As with XP, Windows might ask you to repeat this once more for other phone features.
[hide]
Having DNS problems? If your computer's browser is reporting a "DNS" error, please go into the Settings page from the main screen of the Klink Android app. Tap on "Use alternative DNS", and select one of the non-carrier alternatives. This is necessary for the handful of phones that do not correctly report carrier settings.
Internet Connection Sharing users: Please turn off "Emulate Internet Check" in the Windows Compatibility setting page of the Klink phone app.
TIP: Most users will want to tap and run the "Mimic Mobile Device" option listed on the main screen of the Android app. This configures Klink so that the connected computer will appear more like a mobile device during use.

Mac OS X

Download Klink Mac software to your phone by tapping on one of the following:
- Klink for Intel Macs - This is most common.
- Klink for PowerPC Macs - This is less common and is only for PowerPC G3/G4/G5 Macs running OS X 10.5.
Connect your phone to your computer via the USB cable.
When downloading is complete, pull down the notification bar, and you should see an item resembling "USB connected" or "USB connection type". Press it so that your computer can access the files on your phone. Choose "Mount" if you are asked. On some phones you must further select a mode called "USB Mass Storage". [images]
Pull down the notification bar.
Choose to "Mount" your phone.
HTC users might see something like this instead:
[hide]

NOTE: Some phones (notably Samsung Galaxy devices) require that you disable "USB debugging" in order to mount the device as a removable drive. Do this by swiping from top to bottom on your phone to pull down the notification pane. Then, tap on the "USB debugging" box if you see it, and disable the "USB debugging" option.
A new disk should appear on your desktop. Open it up and choose the "download" folder. NOTE: You might also see a "downloads" folder. Be sure to open "download". [images]

[hide]
You should find the file named similarly to "Faveset_Klink_Installer_1.04.dmg" within the "download" folder. Move it to your desktop. [image]
[hide]
Unmount your phone by dragging the disk drive icon to the trashcan. Then, turn off USB storage by pulling down the notifications menu on your phone. NOTE: On HTC phones, you should change the "USB connection type" to "Charge only." [images]

[hide]
Open the installer file by double-clicking it. This will mount a new drive named after the install file. [image]
[hide]
Double-click on the new drive to open it and run the installer. Follow the on-screen instructions to install Klink. [details]
1. Read and accept the LICENSE text file.
2. (PowerPC users only) Double-click on the file named tuntap_20090913.pkg to install the drivers.
3. Drag "Klink" out of "Faveset Klink Installer" to your Applications folder. For your convenience, there is a shortcut to "Applications" located to the right of Klink.
4. To clean up, eject "Faveset Klink Installer" by dragging the drive image located on your desktop to the Trash.
[hide]
NOTE: Users of OS X 10.5 Leopard should expand the details link to see the installation instructions, since they fail to appear in the Finder on older versions of OS X.
Your computer and phone should now be ready. To begin communicating:
- Make sure that your phone is connected to your computer via USB.
- Tap "Start" from within Klink's Android application. Be sure to follow any prompts that might appear regarding USB debugging, as debugging must be enabled.
- Klink's PC program should then detect your phone by displaying a serial number in the "Detected device" box.
- Finally, click on "Start" from within Klink's PC application.
If the PC software cannot see your phone: it may be necessary to unplug the phone and plug it back in. It may also help to exit Klink's PC software and start it again after your phone is connected. If you've previously installed a similar app like EasyTether or Pdanet, please see the following paragraph.
EasyTether users (former and current): EasyTether installs a driver that takes exclusive access of your phone and prevents Klink from working. This driver loads on system startup and needs to be removed if you wish to run Klink. To remove EasyTether's driver:
- Open up the Finder.
- Click on your Mac's hard drive in the left pane.
- You should see a short list of folders. Open the one titled "System".
- Open "Library".
- Open "Extensions".
- Look for the file named "EasyTetherUSBEthernet.kext", and drag it to the trash. Your computer might ask for your authorization, so confirm the action.
- Restart your computer to clear all traces of EasyTether's driver from memory.
- NOTE: You may reverse these changes at any time by re-running EasyTether's installation process. Klink does not install a driver that will take exclusive access of your device.
PdaNet users: You should follow EasyTether instructions above, but look for a file called "PdaNetDrv.kext" instead.
Samsung Kies users: You should follow EasyTether instructions above, but look for a file called "ssuddrv.kext" instead.

Ubuntu/Linux

Download Klink PC software to your phone by tapping here (32-bit Ubuntu) or here (64-bit Ubuntu).
Connect your phone to your computer via the USB cable.
When downloading is complete, pull down the notification bar, and you should see an item resembling "USB connected" or "USB connection type". Press it so that your computer can access the files on your phone. Choose "Mount" if you are asked. On some phones you must further select a mode called "USB Mass Storage". [images]
Pull down the notification bar.
Choose to "Mount" your phone.
HTC users might see something like this instead:
[hide]

NOTE: Some phones (notably Samsung Galaxy devices) require that you disable "USB debugging" in order to mount the device as a removable drive. Do this by swiping from top to bottom on your phone to pull down the notification pane. Then, tap on the "USB debugging" box if you see it, and disable the "USB debugging" option.
Ubuntu should detect a new removable drive. Open it up and choose the "download" folder. Navigate to the downloaded.deb file and open it to install it.
NOTE to 64-bit users: If, for some reason, you wish to use the 32-bit .deb file, you may do so, as it has minimal dependencies and should be compatible with your system as long as you have the ia32-libs compatibility package installed. [details]
To install the 32-bit version of Klink on a 64-bit Ubuntu system, open a terminal and change to the directory containing the .deb file. In the following, we assume that the .deb file has been copied to the Desktop.
```
$ cd Desktop
$ sudo apt-get install ia32-libs
$ sudo dpkg --force-architecture -i klink*.deb
```
[hide]
Unmount your phone. Then, turn off USB storage by pulling down the notifications menu on your phone. NOTE: On HTC phones, you should change the "USB connection type" to "Charge only." [images]
[hide]
Your computer and phone should now be ready. To begin communicating:
- Make sure that your phone is connected to your computer via USB.
- Tap "Start" from within Klink's Android application. Be sure to follow any prompts that might appear regarding USB debugging, as debugging must be enabled.
- Finally, run klink from a terminal.
More documentation is available in /usr/share/doc/klink/README.gz or by running klink -h from the commandline to see a list of available flags.