Friends

Friends

The Friends feature shows other spotatui users you follow: who is online and what they are currently listening to. The list refreshes automatically every 30 seconds while the screen is open.

Friends is backed by the spotatui.com service and uses a separate account from your Spotify login.

Setup

1. Create an account at spotatui.com.
2. Copy your sync token from the spotatui.com dashboard.
3. Add it to spotatui, either:
   • in ~/.config/spotatui/config.yml under behavior.sync_token, or
   • in the in-app Settings → Behavior screen.

Until a sync token is set, the Friends screen shows an "Account Required" prompt instead of a friend list.

Opening the Friends screen

Open it from the Library menu → Friends. There is no dedicated global hotkey. The screen shows your own friend code at the top and your friends list below.

Using the screen

Key	Action
↑ / k, ↓ / j	Move the selection
g / H, G / L	Jump to top / bottom
c	Copy your own friend code to the clipboard
a	Open the Add Friend dialog
u	Unfollow the selected friend
Tab	Cycle the filter (All ↔ Online)
typing	Filter the list
Esc	Clear the filter, or go back

Adding a friend

Press a to open the Add Friend dialog. It has two tabs (switch with Tab):

• By Friend Code — type a friend's code and press Enter.
• Search by Name — type at least two characters to search spotatui.com users; results that you already follow are tagged. Select one and press Enter to follow.

What's shown

For each friend the list shows an online/offline indicator, their display name, and their current now-playing track and artist (or "idle" / "offline"). Now-playing data is provided by the spotatui.com server.

The Friends backend talks to https://spotatui.com/api/ (profile, friends, and user search), authenticated with your sync token.