{"id":18098660,"url":"https://github.com/krzko/slack-buddy","last_synced_at":"2026-04-29T17:03:51.055Z","repository":{"id":206901221,"uuid":"713633431","full_name":"krzko/slack-buddy","owner":"krzko","description":"🤝 Slack Buddy is a convenient tool designed to help you manage your Slack status effortlessly","archived":false,"fork":false,"pushed_at":"2026-04-27T22:23:48.000Z","size":493,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-28T00:21:52.399Z","etag":null,"topics":["schedule","scheduling","slack","slack-status"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/krzko.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-11-02T23:29:17.000Z","updated_at":"2026-04-27T22:23:45.000Z","dependencies_parsed_at":"2023-11-13T04:23:38.257Z","dependency_job_id":"4a2a9ee0-e348-4d9d-9633-6ebd65e08a4d","html_url":"https://github.com/krzko/slack-buddy","commit_stats":null,"previous_names":["krzko/slack-buddy"],"tags_count":23,"template":false,"template_full_name":null,"purl":"pkg:github/krzko/slack-buddy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krzko%2Fslack-buddy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krzko%2Fslack-buddy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krzko%2Fslack-buddy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krzko%2Fslack-buddy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/krzko","download_url":"https://codeload.github.com/krzko/slack-buddy/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/krzko%2Fslack-buddy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32435122,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T13:34:34.882Z","status":"ssl_error","status_checked_at":"2026-04-29T13:34:29.830Z","response_time":110,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["schedule","scheduling","slack","slack-status"],"created_at":"2024-10-31T20:12:19.610Z","updated_at":"2026-04-29T17:03:51.025Z","avatar_url":"https://github.com/krzko.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# slack-buddy\n\nSlack Buddy is a convenient tool designed to help you manage your Slack status effortlessly. It operates as a system tray application, enabling you to quickly update your Slack status based on various pre-set or custom scenarios.\n\n## Why\n\nIn the dynamic environment of Slack, keeping track of everyone's availability and status can be challenging, especially when mentioned inline in a conversation. Traditional status updates in Slack are often overlooked, particularly in fast-paced discussions. Slack Buddy addresses this gap effectively.\n\nIt updates not just your status emoji and text, but also your display name, embedding your current status directly within it. This enhancement makes your availability or activity instantly visible whenever you are mentioned or involved in a conversation, providing clearer context to your colleagues. This visibility is particularly crucial in remote or hybrid work settings where physical cues are absent, ensuring smoother, more informed interactions and collaborations on Slack.\n\n### No Status\n\n\u003cimg\n  src=\"/assets/images/no-status.png\"\n  alt=\"No status set\"\n  title=\"No status set\"\n  style=\"display: inline-block; margin: 0 auto; max-width: 300px\"\u003e\n\n### With Status\n\n\u003cimg\n  src=\"/assets/images/with-status.png\"\n  alt=\"Slack Buddy status set\"\n  title=\"Slack Buddy status set\"\n  style=\"display: inline-block; margin: 0 auto; max-width: 300px\"\u003e\n\n## Features\n\n* **Pre-defined Status Options**: Set your status to common activities like 'In a meeting', 'Commuting', 'Out sick', etc., with just a click.\n* **Custom Status Support**: Add your personalized statuses with custom text and emojis.\n* **Scheduled Status Updates**: Automate status updates for routine activities with start and end times.\n* **Menu Customisation**: Organise your statuses into categories such as HR, Marketing, SRE, etc., for easy access.\n* **Configuration Management**: Easily configure your Slack API token, User ID, and Display Name.\n\n### navbar\n\n\u003cimg\n  src=\"/assets/images/navbar.png\"\n  alt=\"Slack Buddy Navigation Bar\"\n  title=\"Slack Buddy Navigation Bar\"\n  style=\"display: inline-block; margin: 0 auto; max-width: 300px\"\u003e\n\n## Install and Run\n\nInstall the package via on the of the below methods:\n\n### brew\n\nInstall brew and then run:\n\n```sh\nbrew install krzko/tap/slack-buddy\n```\n\n### Download Binary\n\nDownload the latest version from the [Releases](https://github.com/krzko/slack-buddy/releases) page.\n\n### Run\n\nNow that you have downloaded or installed the package, we need to run the binary. You can start `slack-buddy` via:\n\n```sh\nnohup slack-buddy \u003e /tmp/slack-buddy.log \u0026\n```\n\nA native installer is coming in the future.\n\n## Usage\n\n* **Initial Setup**: Enter your Slack API token, User ID, and Display Name through the settings menu.\n* **Setting a Status**: Click on a predefined or custom status in the system tray menu to update your Slack status.\n* **Adding Custom Statuses**: Use the settings menu to add or modify custom statuses, including their schedule if necessary.\n* **Scheduling Statuses**: Define specific times for automatic status updates, perfect for regular activities like lunches or meetings.\n* **Clearing Your Status**: Use the 'Clear Status' option to revert to your default state.\n\nSlack Buddy is ideal for anyone who need to keep their team updated on their availability and activities without the hassle of manual updates. This tool is a must-have for enhancing your productivity and communication in a remote or hybrid work environment.\n\n## Configuration File\n\nSlack Buddy custom and scheduled statuses can be added via updating the`config.yaml` file in your home directory. An example config.yaml can be seen [here](./config_example.yaml). The file will be located in:\n\n* **linux**: Soon\n* **macOS**: `~/.slack-buddy/config.yaml`\n* **Windows**: Soon\n\n### `api_token`\n\nYou will need to retrieve a Personal Token from a Slack Workspace Administrator. You can get more details from the Slack [Access Tokens](https://api.slack.com/authentication/token-types) page.\n\n### `user_id`\n\nTo retrieve youe `user_id` value, follow these steps:\n\n* Open **Slack**.\n* Open **Profile** window.\n* Select the **three vertical dots** next to **View As**.\n* Select **Copy memeber ID**.\n\n### `disaply_name`\n\n* This is the default disaply name value. All statuses will be set via **`display_name` + \"is ...\"**.\n* This is the value that is set when you select **Clear Status**.\n\n### Example Configuration\n\n* The `title` value has to be unique.\n* Custom statuses do not have `days`, `start_time` or `end_time` values set.\n* Ensure the `status_emoji` value exists in your Slack workspace.\n\n```yaml\napi_token: xoxp-xxx-xxx-xxx-xxx\nuser_id: XXXXXXXXX\ndisplay_name: Kristof\ncustom_items:\n  - title: \"Zwift\"\n    tooltip: \"\"\n    status_text: \"on Zwift\"\n    status_emoji: \":bike:\"\n  - title: \"School Run\"\n    tooltip: \"\"\n    status_text: \"on a school run\"\n    status_emoji: \":school_satchel:\"\n    days: [\"Monday\", \"Tuesday\", \"Wednesday\", \"Thursday\", \"Friday\"]\n    start_time: \"08:45\"\n    end_time: \"09:15\"\n  - title: \"Daily Stand-up\"\n    tooltip: \"\"\n    status_text: \"in a meeting\"\n    status_emoji: \":spiral_calendar_pad:\"\n    days: [\"Monday\", \"Tuesday\", \"Wednesday\", \"Thursday\", \"Friday\"]\n    start_time: \"10:00\"\n    end_time: \"10:15\"\n  - title: \"Lunch\"\n    tooltip: \"\"\n    status_text: \"lunching\"\n    status_emoji: \":pizza:\"\n    days: [\"Monday\", \"Tuesday\", \"Wednesday\", \"Thursday\", \"Friday\"]\n    start_time: \"12:00\"\n    end_time: \"13:00\"\n  - title: \"School Run\"\n    tooltip: \"\"\n    status_text: \"on a school run\"\n    status_emoji: \":school_satchel:\"\n    days: [\"Monday\", \"Tuesday\", \"Wednesday\", \"Thursday\", \"Friday\"]\n    start_time: \"15:15\"\n    end_time: \"15:45\"\n```\n\n## Rate Limits\n\nSlack has some pretty limited rate limits, which can occur regularly.\n\n\u003e Profile update rate limits \nUpdate a user's profile, including custom status, sparingly. Special [rate limit](https://api.slack.com/docs/rate-limits) rules apply when updating profile data with `users.profile.set`. A token may update a single user's profile no more than **10** times per minute. And a single token may only set **30** user profiles per minute. Some burst behavior is allowed.\n\nIf your initial status update isn't set, wait a while and try again.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkrzko%2Fslack-buddy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkrzko%2Fslack-buddy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkrzko%2Fslack-buddy/lists"}