Pixootify - Spotify → Pixoo64 Display

Display your currently playing Spotify track on your Pixoo 64x64 LED display! Album art, artist name, and song title are automatically shown on screen.

✨ Features

• 🎵 Real-time Spotify integration: Displays current track, artist, and album art
• 📺 Pixoo 64x64 support: Auto-discovery or manual IP connection
• 🔐 Secure configuration: API keys stored safely in local config
• 🌗 Dark mode: Dim bright album covers for better visibility
• ☀️ Brightness control: Adjustable via slider
• 🎨 Vignette effect: Automatic vignette applied to album covers
• 📝 Dynamic text color: Black/white text based on background brightness

📦 Installation

1. Requirements

• Python 3.8+
• Pixoo 64 device (on the same network)
• Spotify account

2. Clone the repository

git clone https://github.com/Batushn/pixootify.git
cd pixootify

3. Install dependencies

pip install -r requirements.txt

4. Spotify API Setup

1. Go to Spotify Developer Dashboard
2. Click "Create App"
3. Enter app name and description
4. IMPORTANT: Add this Redirect URI:

   http://127.0.0.1:8080/callback
   

5. Copy the Client ID and Client Secret from Settings

🚀 Usage

python main.py

First Run

1. The setup screen will appear when the program starts
2. Enter your Spotify Client ID and Client Secret
3. (Optional) Enter Pixoo IP address
4. Click "Save and Start"
5. Spotify login page will open in your browser - log in
6. Done! 🎉

Display Behavior

When a track changes:

• 0-2 seconds: Artist name
• 2-6 seconds: Song title
• 6+ seconds: Current time

⚙️ Settings

Setting	Description
Brightness Slider	Adjusts display brightness (0-100%)
Dark Background	Dims bright album covers

📁 File Structure

pixootify/
├── main.py           # Main application
├── requirements.txt  # Python dependencies
├── README.md         # This file
└── LICENSE           # MIT License

Config file: ~/.pixootify_config
Token cache: ~/.pixoo_cache/.cache

🐛 Troubleshooting

"Token expired" error

Automatically refreshes - wait a few seconds.

Pixoo not connecting

• Ensure the device is on the same WiFi network
• Try entering the Pixoo IP manually
• Check the IP address in the Pixoo app

Spotify connection error

• Make sure Redirect URI is added correctly: http://127.0.0.1:8080/callback
• Delete ~/.pixoo_cache/.cache and try again
• Verify Client ID/Secret are correct

Rate limit error

The program is already optimized to make API calls every 2 seconds.

🤝 Contributing

Pull requests are welcome! For major changes, please open an issue first.

📄 License

MIT

🙏 Acknowledgments

• spotipy - Spotify API wrapper
• pixoo - Pixoo Python library
• PyQt6 - GUI framework