🎧 spc - Lightweight Multiplatform CLI for Spotify 🎶

spc is a lightweight and simple command-line interface (CLI) for Spotify, ideal for users who prefer interacting with Spotify via the terminal. 🎶✨

🚀 Installation

🍏 macOS

brew install dvdmuckle/tap/spc

🐧 Ubuntu Linux

sudo add-apt-repository ppa:dvdmuckle/spc
sudo apt-get update
sudo apt-get install spc

🦊 Fedora Linux

sudo dnf copr enable dvdmuckle/spc
sudo dnf install spc

🌍 Other Platforms

• Download the latest release and place the spc binary somewhere in your PATH.
• Alternatively, use Go:

go install github.com/dvdmuckle/spc@latest

Tip: Make sure $GOPATH/bin is in your PATH to execute it successfully. ✅

---

🔧 Setup

1. Run the following to generate a skeleton config file:

   spc config

   It will be created at ~/.config/spc/config.yaml (Linux/macOS) or .config/spc/config.yaml (Windows).

2. Go to Spotify Developer Dashboard to create a new Spotify app. Don't forget to set the callback URL to:

   http://localhost:8888/callback
   

3. Paste your ClientID and ClientSecret in the config file. Ensure the ClientSecret is base64 encoded!

4. Now, run:

   spc auth

   This starts the OAuth2 flow, granting your app the necessary permissions. 🎉

Note: A Spotify Premium account is required for playback commands. 🏆

---

▶️ Running

Use spc help or refer to the docs for command usage details.

---

🎯 Goals

The main goal is to provide a simple, lightweight CLI for Spotify with core functionalities:

• Play / Pause 🛑▶️
• Volume control 🔊
• Simple search 🔍

Saving autogenerated playlists will be the most complex feature planned at this time.

---

🤝 Contributing

Got feature ideas? 🛠️ Feel free to create an issue or submit a PR with your suggestions!
If you're tackling an open issue, submit a PR referencing the issue number, or ask for the assignment in the comments.

🚀 Happy hacking and enjoy using spc! 🎶