{"id":49745372,"url":"https://github.com/gammons/slk","last_synced_at":"2026-05-25T01:05:25.130Z","repository":{"id":354064641,"uuid":"1220766244","full_name":"gammons/slk","owner":"gammons","description":"A blazingly fast Slack TUI","archived":false,"fork":false,"pushed_at":"2026-05-09T14:55:51.000Z","size":27570,"stargazers_count":39,"open_issues_count":2,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-05-09T16:51:25.732Z","etag":null,"topics":["golang","slack"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gammons.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"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":"2026-04-25T09:55:59.000Z","updated_at":"2026-05-09T14:55:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gammons/slk","commit_stats":null,"previous_names":["gammons/slk"],"tags_count":30,"template":false,"template_full_name":null,"purl":"pkg:github/gammons/slk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gammons%2Fslk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gammons%2Fslk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gammons%2Fslk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gammons%2Fslk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gammons","download_url":"https://codeload.github.com/gammons/slk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gammons%2Fslk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33067533,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T11:35:32.926Z","status":"ssl_error","status_checked_at":"2026-05-15T11:35:31.362Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["golang","slack"],"created_at":"2026-05-10T03:29:16.243Z","updated_at":"2026-05-25T01:05:25.122Z","avatar_url":"https://github.com/gammons.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# slk\n\n\u003e **A blazingly fast Slack TUI.**\n\u003e Keyboard-driven, beautifully themed, and under 20MB. One static binary. No Electron required.\n\u003e\n\u003e Marketing site: [getslk.sh](https://getslk.sh) · Docs: [Wiki](https://github.com/gammons/slk/wiki)\n\n![slk screenshot](docs/assets/screenshot.png)\n\n`slk` is a daily-driver replacement for the official Slack desktop client, built in Go with [bubbletea](https://github.com/charmbracelet/bubbletea) and [lipgloss](https://github.com/charmbracelet/lipgloss).\n\n## Why slk?\n\n- **Fast.** Cold start in milliseconds. Render-cached messages. SQLite-backed scrollback. Real-time over WebSocket.\n- **Tiny.** ~19 MB on disk. ~60 MB RSS for a live multi-workspace session vs. 500 MB–1.5 GB for the official client. No node_modules, no Chromium, no 1Gb RAM tax.\n- **Keyboard-first.** Vim-style modal editing. `j/k`, `h/l`, `i`, `Esc`.\n- **Pretty.** 35+ built-in themes, lipgloss-styled panels, true-pixel avatars on kitty (half-block fallback elsewhere), emoji shortcodes, day separators, and pill-style reactions.\n- **Multi-workspace.** All your workspaces stay connected in parallel. `1`–`9` to instantly jump between them, with live unread badges in the rail.\n- **Yours.** TOML config, custom themes, custom channel sections via glob, XDG-compliant paths.\n\n## Highlights\n\n- Real-time messages, edits, deletes, reactions, typing indicators\n- Inline images (kitty graphics / sixel / half-block fallback) with full-screen preview\n- Threads side panel + a workspace-wide threads view\n- Smart paste: clipboard images, file paths, or text — multiple attachments + caption in one send\n- Slack-native sidebar sections, kept live; or glob-based config sections\n- Browser-cookie auth (`xoxc` + `d`) — no Slack App required\n- Vim-style modal keybindings, fuzzy channel finder, workspace picker\n- 12 themes + drop-in custom themes, live theme switcher\n- OS desktop notifications on DMs, mentions, and configurable keywords\n\nFull feature breakdown: **[[Features|https://github.com/gammons/slk/wiki/Features]]**\n\n## Quick install\n\n**Homebrew** (macOS and Linux):\n\n```bash\nbrew install gammons/tap/slk\n```\n\n**Linux/macOS tarball** (auto-resolves the latest version):\n\n```bash\nVERSION=$(curl -fsSL https://api.github.com/repos/gammons/slk/releases/latest | grep -oE '\"tag_name\": *\"v[^\"]+\"' | grep -oE 'v[0-9]+\\.[0-9]+\\.[0-9]+' | sed 's/^v//')\n# Linux x86_64\ncurl -fsSL \"https://github.com/gammons/slk/releases/latest/download/slk_${VERSION}_linux_x86_64.tar.gz\" | tar xz\n# macOS Apple Silicon\ncurl -fsSL \"https://github.com/gammons/slk/releases/latest/download/slk_${VERSION}_darwin_arm64.tar.gz\" | tar xz\nsudo mv slk /usr/local/bin/\n```\n\n**Go:**\n\n```bash\ngo install github.com/gammons/slk/cmd/slk@latest\n```\n\nFor `.deb` / `.rpm` / `.apk` packages, Windows, build-from-source, and checksums, see the [Installation wiki page](https://github.com/gammons/slk/wiki/Installation).\n\n## Setup\n\nslk uses your existing browser session. Grab your `xoxc` token and `d`\ncookie from DevTools, then:\n\n```bash\nslk --add-workspace\n```\n\nFull walkthrough: [Setup wiki page](https://github.com/gammons/slk/wiki/Setup).\n\n## Inline images in tmux\n\nIf you run `slk` inside tmux on a Kitty-capable terminal (Kitty, Ghostty,\nWezTerm), images render natively as long as tmux passthrough is enabled:\n\n```tmux\nset -g allow-passthrough on\n```\n\nReload tmux for the setting to take effect (`tmux kill-server`, then\nreattach). Verify with:\n\n```bash\ntmux show -gv allow-passthrough\n```\n\nExpected output: `on` (or `all`).\n\nIf passthrough is off, `slk` detects this at startup and falls back to\nhalf-block rendering automatically — no config change needed. To force a\nspecific renderer regardless of detection, set `image_protocol` in\n`config.toml` to `kitty`, `sixel`, `halfblock`, or `off`.\n\n## Unread indicator in tmux\n\n`slk` sets the terminal window title to reflect unread state — for\nexample `slk SW (3) +1` means three channels-with-unreads in the active\nworkspace and at least one other workspace also has unreads. The\ntwo-letter prefix is the active workspace's initials (matching the\nleft-rail label).\n\nOutside tmux this just works — modern terminals (Kitty, WezTerm,\nAlacritty, Ghostty, iTerm2, Windows Terminal, gnome-terminal) render\ntitle changes in their tab/window chrome.\n\nInside tmux there's an extra step. tmux intercepts the title escape\nfrom slk, and only re-emits it to the outer terminal when title\nforwarding is on, *and* it uses its own title template by default\n(`#W` = window name) rather than the pane's title. Add both lines to\n`~/.tmux.conf`:\n\n```tmux\nset -g set-titles on\nset -g set-titles-string '#T'\n```\n\n`#T` (active pane title) is what carries slk's string. Reload tmux for\nthe setting to take effect (`tmux kill-server`, then reattach). Verify\nwith:\n\n```bash\ntmux show -gv set-titles\ntmux show -gv set-titles-string\n```\n\nExpected output: `on` and `#T`.\n\nIf you'd prefer slk's unread indicator to work in tmux without any\nconfig change at all, that's tracked as a follow-up — it requires\npassing the title escape through tmux's DCS passthrough rather than\nrelying on `set-titles`. Not in this release.\n\n## Debugging\n\nSet `SLK_DEBUG=1` to enable a comprehensive debug log written to\n`slk-debug.log` in the current working directory. The file is\n**truncated each run**, so reproduce the issue, quit slk, then copy\nthe file before relaunching. Log lines are categorized\n(`[cache]`, `[imgfetch]`, `[imgrender]`, `[ws]`, `[general]`) so\n`grep '\\[cache\\]' slk-debug.log` slices to one focus area.\n\n## Documentation\n\nEverything lives in the [**wiki**](https://github.com/gammons/slk/wiki):\n\n- [Installation](https://github.com/gammons/slk/wiki/Installation) — prebuilt binaries, Go install, build from source\n- [Setup](https://github.com/gammons/slk/wiki/Setup) — token extraction, adding workspaces\n- [Features](https://github.com/gammons/slk/wiki/Features) — full feature breakdown\n- [Keybindings](https://github.com/gammons/slk/wiki/Keybindings) — every key, every mode\n- [Configuration](https://github.com/gammons/slk/wiki/Configuration) — `config.toml`, custom themes, XDG paths\n- [Terminal Compatibility](https://github.com/gammons/slk/wiki/Terminal-Compatibility) — what each terminal supports\n- [Clipboard and OSC 52](https://github.com/gammons/slk/wiki/Clipboard-and-OSC-52) — copy/paste setup notes\n- [Tradeoffs and Non-Goals](https://github.com/gammons/slk/wiki/Tradeoffs-and-Non-Goals) — roadmap, caveats, TOS notice\n- [Architecture](https://github.com/gammons/slk/wiki/Architecture) — service layout, data layer\n\n## Disclaimer\n\n`slk` is an independent, unofficial project. It is not affiliated with, endorsed by, or sponsored by Slack Technologies, LLC or Salesforce, Inc. \"Slack\" is a trademark of Slack Technologies, LLC; it is used here only to describe the service this client interoperates with.\n\nslk talks to Slack via the same internal browser protocol the official web client uses. This is unofficial and not sanctioned by Slack — see [Tradeoffs and Non-Goals](https://github.com/gammons/slk/wiki/Tradeoffs-and-Non-Goals#unofficial--tos-caveat) for details.\n\n## License\n\n[MIT](LICENSE) © Grant Ammons\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgammons%2Fslk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgammons%2Fslk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgammons%2Fslk/lists"}