- Installation
- How does it work?
- Keybinds
- Versions, Change Logs, Future Implementations
- Contributing
- License
Currently in early stage development, if and when an alpha version is realeased an installer and website will be created. For the time being, you must install Flutter and run
flutter build macos
After this you will be able to find Lightify through Spotlight or inside the releases folder for MacOS in the project directory.
Additionally you will need to create a Spoty client and input the client ID when you run the application.
Once you have installed it, it's a simple matter of logging in. This is NOT a remote, you do not need to have an instance of Spotify running to make this work. You will be able to easily search for, queue, and play music. Please note the Keybinds below for usage, particularly because none of the buttons work right now.
| KeyBind | Action |
|---|---|
| Meta + Shift + S | Open/Close lightify (works anywhere on your Mac) |
| Esc | Close Lightify |
| Space | Play/Pause |
| H | Previous Song |
| L | Next Song |
| S | Change shuffle mode |
| R | Change repeat mode |
| TAB | Navigate to search bar (when already not open) |
| T | Switch to track search mode |
| A | Switch to album search mode |
| P | Switch to playlist search mode |
| M | Switch to "my catalog" |
| Enter | Run search or play selected song |
| Q | Queue selected song |
| J/Down Arrow | Navigate down list item |
| K/Up Arrow | Navigate up list item |
| Ctrl + R | Restart |
| Ctrl + D | Restart and delete cached data |
✅ = this version is published
❌ = this version is not published
- Settings page
- Auto load next options when bottom of list is reached
- Auto size window when searching similar to spotlight
- Theme loader
- Consistency on tab click
-
Add a section to input client secrets and ids easily -
Add "my catalog" for tracks and albums -
Enable search in "my catalog" - Make the GUI buttons work (currently only keybinds work)
- Add a like button for songs
-
Make sure repeat mode works properly -
Add transfer playback shortcut - Create an installer
Contributions are welcome and encouraged.
Please visit the issues tab to see what needs to be done. Check to see if anyone has been working on it so you don't do redundant work.
Send in a PR when you've fixed an issue and I might or might not merge it.
This is a small project so if anyone sends in a review I will probably code review everything.
This software is distributed under the Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0). You are granted permission to copy, modify, and personalize this code for your own non-commercial projects and experiments. However, any use of this work for commercial purposes—including selling, licensing, or incorporating it into products or services offered for profit—is expressly prohibited without obtaining a separate license.
© 2025 Cedric Claessens