YateClient on Mac OS X
From Yate Documentation
(Difference between revisions)
(→Checking for audio support) |
(→Running YateClient in Terminal) |
||
| (13 intermediate revisions by one user not shown) | |||
| Line 7: | Line 7: | ||
There are 2 ways of getting YateClient for Mac OS X: | There are 2 ways of getting YateClient for Mac OS X: | ||
| − | * one way is installing it | + | * 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 [https://itunes.apple.com/us/app/yateclient/id510684169?mt=12 here] in the Mac App Store. |
* the second option is installing it from the DMG file made available on the [[Download#MacOS_X | Download page]]. You can use this option if you are running a version which is previous to Mac OS X 10.6.6. | * the second option is installing it from the DMG file made available on the [[Download#MacOS_X | 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. | + | Once installed, you'll find YateClient in the ''/Applications'' folder. |
===Configuration files for YateClient=== | ===Configuration files for YateClient=== | ||
| Line 16: | Line 16: | ||
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 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. | + | * 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/ | + | * 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. | This way you can see all the configuration files that come bundled with YateClient. | ||
| Line 26: | Line 27: | ||
This can be solved in the following way: | 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. | + | * 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. | + | * 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. | * 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. | + | * 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. | The above operation can also be done on a per file case. | ||
| Line 40: | Line 41: | ||
* Quit YateClient if it's running. | * Quit YateClient if it's running. | ||
| − | * Open System Preferences and go to Sound. | + | * Open ''System Preferences'' and go to ''Sound''. |
| − | * For checking the output for audio, select the Output tab. There, | + | * 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, | + | * 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. | * Start YateClient and make a test call again. | ||
===Running YateClient in Terminal=== | ===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: | ||
| + | |||
| + | /Applications/YateClient.app/Contents/MacOS/YateClient | ||
| + | |||
| + | with additional parameters which you wish enabled for debugging (i.e. "-vvvvv", "-Doatm" or any other argument that Yate accepts). | ||
| + | |||
| + | |||
| + | '''See also''' | ||
| + | * [[Paths_and_Directories#Mac_OS_X_notes|Paths and Directories]] | ||
| + | * [[Administrate Yate]] | ||
| + | |||
| + | [[Category:Client]] [[Category:YateClient]] [[Category:Mac]] | ||
Latest revision as of 11:34, 4 November 2013
Contents |
[edit] Supported Platforms
YateClient can be run on Intel platforms running Mac OS X 10.5.7 or later.
[edit] 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.
[edit] 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.
[edit] 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.
[edit] 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.
[edit] 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:
/Applications/YateClient.app/Contents/MacOS/YateClient
with additional parameters which you wish enabled for debugging (i.e. "-vvvvv", "-Doatm" or any other argument that Yate accepts).
See also
