Skip to content

TUI dashboard & settings

Playify V2 features a highly robust terminal user interface (TUI) built with Python’s Rich library. It handles much more than just logs - it’s a full control center for your bot instance.

When you run start.bat or start.sh, the dashboard automatically launches in your terminal.

The dashboard is fully interactive. Use the following keys to control the bot:

KeyActionDescription
LFull logsSwitches to full-screen log mode. You can use the Up and Down arrows to scroll through the entire session history. Press L again to exit.
CConfigurationRelaunches the initial setup wizard. This allows you to safely update your Discord token or Spotify keys without breaking your database.
SSettings menuOpens the interactive settings menu to change the bot’s Discord presence (playing/listening), default volume, and UI aesthetics on the fly.
UAuto-updaterPulls the latest .zip release directly from the GitHub main branch, extracts it, and hot-swaps the code safely.
RRestart botRestarts the background Python process without closing the terminal. Perfect if the bot crashes.
QQuit safelySafely shuts down the bot, explicitly killing any zombie FFmpeg children processes before exiting.
  • FFmpeg processes: tracks how many audio streams are currently being transcoded. If this number is suspiciously high but no music is playing, a restart might be needed.
  • Crashes: the dashboard specifically intercepts exit codes. If the bot crashes, it won’t just close your terminal; it will catch the error, show you the code, and give you the option to hit R to restart immediately.
  • Memory & uptime: real-time tracking of the exact memory footprint.