{"id":13706043,"url":"https://github.com/waaverecords/PowerToys-Run-Spotify","last_synced_at":"2025-05-05T19:34:14.392Z","repository":{"id":204194497,"uuid":"711302392","full_name":"waaverecords/PowerToys-Run-Spotify","owner":"waaverecords","description":"Search through and control Spotify from PowerToys Run.","archived":false,"fork":false,"pushed_at":"2025-04-11T00:41:46.000Z","size":3256,"stargazers_count":237,"open_issues_count":2,"forks_count":18,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-12T21:33:40.692Z","etag":null,"topics":["csharp","powertoys","powertoys-run-plugin","spotify"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/waaverecords.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"buy_me_a_coffee":"waaverecords"}},"created_at":"2023-10-28T20:25:37.000Z","updated_at":"2025-04-12T06:53:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"cdd1c0f7-32f4-4547-9791-3df397febee7","html_url":"https://github.com/waaverecords/PowerToys-Run-Spotify","commit_stats":null,"previous_names":["waaverecords/powertoys-run-spotify"],"tags_count":28,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waaverecords%2FPowerToys-Run-Spotify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waaverecords%2FPowerToys-Run-Spotify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waaverecords%2FPowerToys-Run-Spotify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waaverecords%2FPowerToys-Run-Spotify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/waaverecords","download_url":"https://codeload.github.com/waaverecords/PowerToys-Run-Spotify/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252563152,"owners_count":21768411,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["csharp","powertoys","powertoys-run-plugin","spotify"],"created_at":"2024-08-02T22:00:51.604Z","updated_at":"2025-05-05T19:34:09.366Z","avatar_url":"https://github.com/waaverecords.png","language":"C#","funding_links":["https://buymeacoffee.com/waaverecords"],"categories":["C# #"],"sub_categories":[],"readme":"# Spotify Plugin for PowerToys Run\n\nThis is a plugin for [PowerToys](https://github.com/microsoft/PowerToys) Run that allows you to search Spotify and control its player.\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./demo.gif\" width=\"760\" /\u003e\n\u003c/p\u003e\n\n## Features\n\n- Search for songs, albums, artists and playlists\n- Play songs, albums, artists and playlists\n- Add song to queue (Shift+Enter)\n- Pause and resume track\n- Go to previous or next track\n- Turn shuffle on and off\n- Set repeat to track, context or off\n\n## Installation\n\n\u003e [!IMPORTANT]\n\u003e Spotify Premium is necessary to control the player.\n\n1. Ensure you have the [latest version](https://github.com/microsoft/PowerToys/releases/latest) of PowerToys installed.\n2. Download the [newest release](https://github.com/waaverecords/PowerToys-Run-Spotify/releases/latest) zip file.\n3. Extract the content of the zip file to the `RunPlugins` folder of your PowerToys' installation. Usually `C:\\Program Files\\PowerToys\\RunPlugins`, or `%LOCALAPPDATA%\\Microsoft\\PowerToys\\PowerToys Run\\Plugins`.\n4. Restart PowerToys.\n5. Head to your Spotify [developer dashboard](https://developer.spotify.com/).\n6. Create a new app with:\n    - `Redirect URI` set to `http://localhost:5543/callback`\n    - `Web API` and `Web Playback SDK` checked\n7. Go to the settings of the newly created app and save somewhere the value of `Client ID`. It is needed later.\n8. Open PowerToys and go to the PowerToys Run section. Scroll down until you find the Spotify section. Click on it.\n9. Set the value of `Client ID` with the value saved earlier.\n10. Activate PowerToys Run and type `sp`. You should see a result asking you to login to your Spotify account. Hit `enter` and go through the login process.\n11. Activate PowerToys Run again and type `sp lofi`. If the installation was a succes, you should see results.\n\n## Update the plugin\n\n1. Ensure you have the [latest version](https://github.com/microsoft/PowerToys/releases/latest) of PowerToys installed.\n2. Close PowerToys.\n2. Download the [newest release](https://github.com/waaverecords/PowerToys-Run-Spotify/releases/latest) zip file.\n3. Extract the content of the zip file to the `RunPlugins` folder of your PowerToys' installation. Usually `C:\\Program Files\\PowerToys\\RunPlugins`, or `%LOCALAPPDATA%\\Microsoft\\PowerToys\\PowerToys Run\\Plugins`.\n4. Restart PowerToys.\n\n## Usage\n\nOpen PowerToys Run (default shortcut is ```Alt+Space```).\n\n### Play a song\n\n1. Type ```sp``` followed by your search query.\n2. Select a song, artist or playlist and press ```Enter``` to play it.\n\n### Control the playback\n\n1. Type ```sp```.\n2. Select your desired action and press ```Enter```.\n\n## Contributing\n\nContributions are welcome! If you have any ideas, improvements, or bug fixes, please open an issue or submit a pull request.\n\nTo contribute to PowerToys-Run-Spotify, follow these steps:\n\n1. Fork the repository.\n2. Create a new branch for your feature/fix.\n3. Make your changes and commit them with descriptive commit messages.\n4. Push your changes to your forked repository.\n5. Submit a pull request to the main repository.\n\nPlease ensure that your code adheres to the existing code style. Also, make sure to update the documentation as needed.\n\nTogether, we can make PowerToys-Run-Spotify better!\n\n## Development\n\nTo build and install the plugin, run `BuildAndInstallPlugin.bat`. This will build the repo then copy the files to the plugins folder for PowerToys Run.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaaverecords%2FPowerToys-Run-Spotify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwaaverecords%2FPowerToys-Run-Spotify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaaverecords%2FPowerToys-Run-Spotify/lists"}