Home

ttyak is a Slack client for the terminal, written in Rust: messages and threads, pictures and video, desktop notifications and huddles. It is not an official Slack app. This wiki is its manual; the site is ttyak.sh, the code github.com/dmytrobsp/ttyak.

Getting started

• Install — the install script, package managers, the zips by hand; updating and uninstalling
• Requirements — what your terminal, fonts and system need, and what makes ttyak better
• Verifying downloads — checksums and attestations of a release's files
• Signing in — why it is not as smooth as in Slack's own app, and the three ways: an email code, your browser, a pasted cookie
• Profiles and sessions — where sign-ins are kept, signing out, several workspaces and profiles, deleting everything

Using ttyak

• The screen — the sidebar, the messages, the status line, the rail, statuses, the Threads, Activity and Huddles views
• Keys — modes and the leader, the default keys, commands
• Links into your Slack — links to channels, messages and people that open in ttyak
• Images and video — pictures in the terminal, the viewer, video playback
• Notifications and attention — the tab title, desktop notifications, the bell, sound, do-not-disturb, bringing the window forward
• Huddles — calls: joining, the call bar, invitations, audio, cameras and screen sharing

Configuring

• Settings — F6, settings.toml and the environment variables
• Themes — the built-in colour themes and your own
• Translations — translating the interface with a locale file
• Updates — the update check, F6 → Updates, the update screen
• Rebinding keys — F6 → Keys and keys.toml

Scripting

• Scripting — ttyak ctl commands, and the status for bars and scripts

Developing

• Building from source — the toolchain and packages, building for Windows from Linux
• Project layout — a map of the repository
• Contributing — how to work on ttyak, and how this wiki is made

Troubleshooting

• Troubleshooting — one entry per symptom: what you see, why, what to do; and how to report a bug