Welcome to Spotoolfy
Version: 1.3.1 | Last Updated: December 2024
Welcome to the Spotoolfy Documentation Center! Spotoolfy is a Spotify companion client built with Flutter, bringing you lyrics display, AI translation, note-taking, music insights, and a time machine feature. All designed with Material Design 3 style.
Core Features
- Real-time Lyrics - Multi-source lyrics (NetEase, QQ Music, LRCLIB) with line-by-line scrolling and manual search
- AI Translation - Three translation styles (Faithful, Poetic, Machine) powered by Gemini
- Note System - Add notes and ratings to every song, record your music stories
- Time Machine - Rediscover songs you saved on this day in previous years
- Music Insights - AI analyzes your listening habits to generate personalized music personality
- Poster Generation - Create beautiful shareable posters for lyrics, notes, and albums
- Dynamic Theming - Automatically generate color schemes from album art
- Multi-language - English, Simplified Chinese, Traditional Chinese, Japanese
Requirements
- Spotify Premium - Required for full playback control functionality (device switching, etc.)
- Free Users - Can view lyrics, log in, and take notes, but cannot control playback
- Google AI API Key (Optional) - For lyrics translation and AI insights, free to obtain
Supported Platforms
| Platform | Availability |
|---|---|
| Android | Google Play (Closed Testing) |
| iOS/iPadOS | TestFlight |
| Web | WebApp (Beta) |
Quick Navigation
Getting Started
- Installation & Community - Download the app and join the community
- Configuration - Initial setup steps
Features & Design
- Now Playing Page - Detailed guide for lyrics, notes, and queue
- Library Page - Search, insights, and carousel features
- Explore Page - Time machine and note review features
- Settings & Devices - All settings options explained
Advanced
- FAQ & Known Issues - Common questions answered
- Build from Source - Compile the app yourself
- MD3 Components - Developer reference
Version History
v1.3 Major Updates
- New Time Machine feature (today in history memories)
- New sparse index system for optimized library scanning
- New AI conversation feature (ask questions about songs)
- New lyrics, notes, and album poster generation
- New song info analysis page
- New NetEase native translation support
- Dark mode support
- Improved copy lyrics mode
- Extended multi-language support (Traditional Chinese, Japanese)
v1.2 Major Updates
- Three translation styles (Faithful, Poetic, Machine)
- Gemini AI insight generation
- Search and library functionality
Need Help?
- Discord Community: https://discord.gg/v56yDs6vRN
- GitHub Issues: https://github.com/p2o51/spotoolfy_flutter/issues
- Email: lastnatsu51@gmail.com
Open Source
Spotoolfy is an open-source project. View the source code, submit issues, or contribute at GitHub.
Join the Community
Have questions or want to share feedback? Join our Discord community!