YateClient on Mac OS X

From Yate Documentation
Jump to: navigation, search


Supported Platforms

YateClient can be run on Intel platforms running Mac OS X 10.5.7 or later.

Getting YateClient for Mac OS X

There are 2 ways of getting YateClient for Mac OS X:

  • one way is installing it via the Mac App Store. This option depends on whether or not you are running on Snow Leopard (Mac OS X 10.6.6) or on a later version, as the Mac App Store is only available since that version. YateClient can be found here in the Mac App Store.
  • the second option is installing it from the DMG file made available on the Download page. You can use this option if you are running a version which is previous to Mac OS X 10.6.6.

Once installed, you'll find YateClient in the /Applications folder.

Configuration files for YateClient

In case there is a need to configure something specific which cannot be done through the user interface, you can find the configuration files of YateClient inside the YateClient app bundle, in YateClient.app/Contents/MacOS/conf.d. You can see them listed by using one of the following methods:

  • In Finder, go to Applications and find YateClient. Then do a right click on the application and from the menu, click Show package contents. This should open a Finder window listing the Contents folder of YateClient. From there, go to MacOS -> conf.d to see all configuration files.
  • You could list them using Terminal, issuing the following command:
# ls /Applications/YateClient.app/Contents/MacOS/conf.d/

This way you can see all the configuration files that come bundled with YateClient.

Fixing write permissions for the YateClient configuration files when it was installed from the Mac App Store

Installing the YateClient from the AppStore means that you won't have permission to modify the configuration files, so you need to grant write permissions.
This can be solved in the following way:

  • From the Finder window, being located in the MacOS folder (or conf.d folder, if you only want to change permission for specific files), right click on conf.d and click Get Info from the menu.
  • At the bottom of the Info window, there's a Sharing & Permissions section (if it's folded, click on it to expand it). You should see a You can only read message.
  • In the bottom right corner you should see a little lock. Click on it. At this point, the system should be asking you for your administrative password.
  • After introducing the password, click on the + sign and and the person for which you want to grant write permission. After selecting the person, in the Name | Privilege table, select Read&Write privilege for the person you just added. Afterward, click on the Cog button (right of the - sign) and select Apply to enclosed items.

The above operation can also be done on a per file case.
Other information regarding files used by YateClient can be found here.

Checking for audio support

If YateClient cannot detect an input or output audio source, it will display the following message ""Failed to open audio/microphone/speaker. Please check your sound card". This message can be a result of not having selected in System Settings the correct output and input for audio. In order to make sure you have configured the right input and source (especially on iMacs or Mac Minis which do not have an internal microphone), please follow these steps:

  • Quit YateClient if it's running.
  • Open System Preferences and go to Sound.
  • For checking the output for audio, select the Output tab. There, Select a device for output sound that works (meaning that when adjusting the Output volume slider, you'll hear sound on the selected output device).
  • For checking the input for audio, select the Input tab. There, Select a device for input sound that works (meaning that when speaking into the microphone, you'll see activity on the Input level scale).
  • Start YateClient and make a test call again.

Running YateClient in Terminal

There might be cases when the need to run YateClient with debugging information exists and the Debug Window from the user interface is not enough. To do this, you can run YateClient in Terminal following these steps:

  • Start the Terminal application: you can start it from Spotlight by typing Terminal.
  • In the Terminal window, you can run YateClient by typing the following command:

with additional parameters which you wish enabled for debugging (i.e. "-vvvvv", "-Doatm" or any other argument that Yate accepts).

See also

Personal tools