Skip to content

Latest commit

 

History

History
80 lines (48 loc) · 3.17 KB

README.md

File metadata and controls

80 lines (48 loc) · 3.17 KB
Raw

sleepwatcher-lync-status

Version: 0.0.4

Automatically changes the Microsoft Lync status when the screen is locked or unlocked on Mac OS X. Lync does not automatically do this, which causes issues when your screen is locked, but your contacts still see you as available.

Tested on Mac OS X 10.10.1 and Microsoft Lync 2011 (14.0.10).

The provided default configuration does the following:

  • When your screen is locked (and/or goes to sleep), it stores your current Lync status and then sets it to Appear Away.
  • When your screen is unlocked (or wakes up from sleep), it restores your Lync status to your previous status.

Please note that this only works if you set your system to put your screen to sleep when the system is locked. I use the Ctrl+Shift+Eject keyboard combo to lock the screen. Please open an issue here on Github if you are running into any problems with this.

The default actions can be changed by editing the com.nilswinkler.sleepwatcher-lync-status-20compatibility-localuser.plist file. Take a look at this file (and the install.sh script for more details).

Installation

This tool uses SleepWatcher to be notified when the screen goes to sleep. Since SleepWatcher is licensed under the GPL, it can't be bundled with this tool, you have to install it separately. The easiest way to do this is through Homebrew:

brew install sleepwatcher

If you don't use Homebrew, you can install SleepWatcher from its homepage.

Once SleepWatcher is installed locally (ignore the steps printed by Homebrew), you need to clone this repository to a local directory on your Mac:

git clone https://github.com/nwinkler/sleepwatcher-lync-status.git

This will create a new directory with the contents of this repo. Change into this directory and install the provided default scripts:

cd sleepwatcher-lync-status

./install.sh

If you lock your screen now (for the first time after installing this tool), it will not work. After unlocking your screen, you will see a notification indicating that the sleepwatcher application wants to change your assistive settings. Open your Mac's System Preferences and check the box in the Security & Privacy > Accessability screen next to sleepwatcher. This is required to allow SleepWatcher to use the system's menu to change the Lync status:

Settings

You may have to provide an admin user or your password to change this setting.

Uninstalling

To remove the sleepwatcher integration, simply call the provided uninstall script:

cd sleepwatcher-lync-status

./uninstall.sh

To Do

  • N/A

Known Issues

  • The menu integration can fail on installations of OS X that don't use English language. There are some hardcoded values in the code referencing the menu entries.

Contributing

This project uses Git-Flow, any changes or pull requests need to be made against the develop branch.

References

License

Copyright (c) 2014 Nils Winkler. Licensed under the MIT license.