https://github.com/ericwb/slack-status-bar

This project is a status bar application made for Mac OS X to automatically update a Slack user's presence status based on introspecting the calendars, WiFi, and other data.
https://github.com/ericwb/slack-status-bar

mac-osx pyobjc python slack statusbar

Last synced: about 1 month ago
JSON representation

This project is a status bar application made for Mac OS X to automatically update a Slack user's presence status based on introspecting the calendars, WiFi, and other data.

• Host: GitHub
• URL: https://github.com/ericwb/slack-status-bar
• Owner: ericwb
• License: gpl-3.0
• Created: 2017-06-01T23:18:40.000Z (over 7 years ago)
• Default Branch: main
• Last Pushed: 2023-07-10T01:41:18.000Z (over 1 year ago)
• Last Synced: 2024-10-25T05:49:56.662Z (about 2 months ago)
• Topics: mac-osx, pyobjc, python, slack, statusbar
• Language: Python
• Homepage:
• Size: 1.33 MB
• Stars: 42
• Watchers: 4
• Forks: 3
• Open Issues: 6
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• Mac-Menubar-Megalist - Slack Status Bar

README

        
Slack Status Bar

================

.. image:: https://travis-ci.org/ericwb/slack-status-bar.svg?branch=master

    :target: https://travis-ci.org/ericwb/slack-status-bar

================

.. image:: screenshot.png

Overview

--------

The native Slack application has the capability to manually adjust a user's

status, but does nothing automatically. The manual nature of switching your

status based on where or what you're doing is tedious. This app attempts

to ease that pain point by automatically adjusting status based on factors

it can discern.

This status bar automatically (or manually) updates a user's Slack status

based on information from the user's calendars and Wireless SSID in use. It

only works on Mac OS X and is only effective for users that use Mac's default

calendar application and wireless for networking.

Currently the app can detect 4 types of statuses

- Vacationing - scans the vacation calendar for events for the current time

- In a Meeting -  scans the work calendar for events for the current time

- Working Remotely - compares the SSID currently in use with the given work SSID

- Away - detects the lock state of the screen and sets away if locked

Installation

------------

.. code-block:: bash

    pip install -r requirements.txt

Run the following command to build the application into alias mode.

.. code-block:: bash

    python setup.py py2app -A

Configure settings

------------------

- Edit ~/Library/Application Support/Slack Status/config.yaml

- Enter the token for your Slack user

- Enter your work wireless SSID

- Enter names for your work and vacation calendars

- Optionally you may want to edit some of the other settings

To run in application mode

--------------------------

Run the following to start the application

.. code-block:: bash

    open dist/Slack\ Status.app

To run in developer mode

------------------------

Running from the command line

.. code-block:: bash

    python main.py