SUPYSONIC-CLI-USER(1)

💖 SUPYSONIC-CLI-USER 💖

okay bestie, so this is a page from the Supysonic manual — it's manual section 1, and it's all about supysonic-cli-user, the little command that handles user management for you. if you've ever been like "who even has an account on my server" — this is the page. let's go ✨

---

✨ NAME ✨

supysonic-cli-user — Supysonic user management commands 🫶

---

🌸 SYNOPSIS 🌸

supysonic-cli user --help

supysonic-cli user list

supysonic-cli user add <user> [--password <password>] [--email <email>]

supysonic-cli user delete <user>

supysonic-cli user changepass <user> [--password <password>]

supysonic-cli user setroles [--admin | --noadmin] [--jukebox |
--nojukebox] <user>

supysonic-cli user rename <user> <newname>

---

💅 DESCRIPTION 💅

the supysonic-cli user subcommand is literally the user manager of the whole thing. it lets you:

• list everyone 👀
• add a new user ➕
• delete an existing user 🗑️
• change their password 🔑
• change their roles 👑

that's the whole vibe. no cap.

---

🎀 ARGUMENTS 🎀

• list — show me every single user, all of them, the whole roster 💖
• add <user> [--password <password>] [--email <email>] — makes a brand new user called <user>. if you don't hand over a password with the --password option, it'll prompt you for one instead. bestie it will literally just ask.
• delete <user> — bye bye, deletes the user <user> 👋
• changepass <user> [--password <password>] — swaps out the password for user <user>. no password given? it prompts you for the new one. easy.
• setroles [--admin | --noadmin] [--jukebox | --nojukebox] <user> — gives rights to user <user>, or takes them away. choose your fighter 😤
• rename <user> <newname> — glow-up time, renames user <user> to <newname> ✨

---

⭐ OPTIONS ⭐

• -h, --help — shows help and dips out. where this option shows up changes what you get: either the list of available commands, or the help for one specific command. it's giving context-aware 💅
• -p <password>, --password <password> — sets the user's password when you're creating them.
• -e <email>, --email <email> — sets the user's email.

the next options are all about user roles. they come in pairs — one option in the pair grants the right, the other revokes it. and obviously, the two options in the same pair are mutually exclusive, you can't pick both, that's the whole point bestie.

the long options are named after the right they control, and you slap a no in front to revoke it. for the short options it's the other way: the UPPER CASE letter grants the right, and the lower case letter revokes it. and here's the cute part — short options can be combined into one, like -aJ, which both revokes the admin right and grants the jukebox one. one little cluster, two whole decisions. iconic.

• -A, --admin — grants admin rights 👑
• -a, --noadmin — revokes admin rights 🚫
• -J, --jukebox — grants jukebox rights 🎵
• -j, --nojukebox — revokes jukebox rights 🔇

---

🌈 EXAMPLES 🌈

say you wanna add a new admin user named MyUserName with the password MyAwesomePassword. here's the move:

$ supysonic-cli user add MyUserName -p MyAwesomePassword
$ supysonic-cli user setroles -A MyUserName

first you create them, then you hand them the crown. two commands, done. slay 🫶

---

🦋 SEE ALSO 🦋

supysonic-cli (1), supysonic-cli-folder (1), supysonic-server (1), supysonic-daemon (1)

---

💜 AUTHOR 💜

Louis-Philippe Véronneau, Alban Féron

---

🌸 COPYRIGHT 🌸

2013-2023, Alban Féron

---

k that's the whole page bestie. go forth and manage your users, you've got this 💖

and for the lil sign-off: this was Supysonic version 0.7.9, dated Apr 15, 2025 — no cap, that's the actual footer. love that for us ✨🎀🦋