stevenfoncken / multitool-for-spotify-php
PHP command-line application that performs various tasks to enhance your Spotify experience
Installs: 11
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 1
Forks: 0
Open Issues: 0
Type:project
Requires
- php: >=8.2
- ext-curl: *
- ext-fileinfo: *
- ext-gd: *
- ext-zlib: *
- intervention/image: ^3.2
- jwilsson/spotify-web-api-php: ^6.0
- monolog/monolog: ^3.5
- parsecsv/php-parsecsv: ^1.3
- symfony/console: ^7.0
- symfony/lock: ^7.0
- symfony/mailer: ^7.0
- symfony/validator: ^7.0
- vlucas/phpdotenv: ^5.6
Requires (Dev)
- roave/security-advisories: dev-latest
This package is not auto-updated.
Last update: 2024-11-20 04:13:33 UTC
README
Report a Bug ยท Request a Feature ยท Ask a Question
A handy command-line application for archiving playlists, searching your library for tracks, or creating playlists with complete artist catalogs.
๐ค Why?
Initially, it was an automatic (CronJob) playlist archiving tool for "New Music Friday" playlists from popular EDM labels. It allowed me to compensate for FOMO when I didn't have time to discover new music right away.
Over time, I developed the desire to rewrite the otherwise lifelong beta (never touch a running system)
and sprinkle some structured overhead on top ;-)
๐ Table of Contents
Click to expand
โ Features
- Archive playlists from CSV or argument input with special naming syntax and mailing.
- Search library playlists for a given track.
- Create playlists with complete artist catalogs.
- see: โจ Future Features.
๐ Getting Started
Requirements
- php >= 8.2
- Composer
Installation
Download or Clone the Project
composer create-project stevenfoncken/multitool-for-spotify-php
or
git clone --depth 1 https://github.com/stevenfoncken/multitool-for-spotify-php.git
Now cd
into the project directory.
Install Dependencies via Composer
Skip when create-project was used.
composer install
Config
.env
cp config/.env.dist config/.env
Set your timezone in APP_TIMEZONE
- List of Supported Timezones.
Connecting to Spotify's Web API
multitool-for-spotify-php
needs to connect to Spotify's Web API in order to function.
- Log in to the Spotify Developer Dashboard.
- Click Create app.
- Choose name, description, website
- Redirect URI:
http://localhost:10276/mtfsp-auth-callback
- Check
Web API
- Click
Save
- Click
Settings
- Copy
Client ID
to .envSPOTIFY_API_CLIENT_ID
- Copy
Client Secret
to .envSPOTIFY_API_CLIENT_SECRET
It should look like this (but with your own values):
SPOTIFY_API_CLIENT_ID="2c914ba76f18385qu4b57qr82o5p1e64"
SPOTIFY_API_CLIENT_SECRET="15g2fh52qg1631j1hex4sg167164c1a6"
- Open your terminal.
- Run:
php bin/console mtfsp:auth
- Follow the displayed instructions.
Now you are ready to use multitool-for-spotify-php
๐
Usage
Playlist Archiving
php bin/console mtfsp:archive [--mail] <playlistIDsOrCSV>
Each playlist has a snapshot ID that is written to the description of the archived playlist to check whether the playlist has already been archived.
A new archive playlist is only created if the content (so the snapshot ID) has been changed.
Example of the name of an generated archive playlist: SFY-2024-06-Top 50 Global (PREFIX-YYYY-WW-SUFFIX or PLAYLIST_NAME)
You can choose between single playlist IDs or a path to a CSV file as an argument:
Argument playlist ID:
Single or comma-separated spotify playlist ID(s).
Argument CSV file path:
The CSV must be separated by semicolons. Example: playlists-to-archive.dist.csv
Option for mailing:
If you set the mail env vars in your .env file,
you can use --mail
to receive notifications when the archiving process is complete.
This is particularly useful when using a CronJob.
List Archived Playlists
php bin/console mtfsp:archive:list-playlists
Delete Archived Playlists
php bin/console mtfsp:archive:delete-playlists
Currently all archived playlists will be deleted. But multiple "are you sure" checks will protect you from hasty mistakes ;-)
Create Artist Catalog Playlist
php bin/console mtfsp:artist:catalog-to-playlist <artistId> [<playlistId>]
If you specify a playlist ID, the catalog will be added to this playlist, otherwise a new playlist will be created.
Search Library Playlists for a Given Track
php bin/console mtfsp:search:track-in-library [--withArchived] <trackIdNeedle>
Set --withArchived
if you want to include archived playlists in the search.
๐จ Development
Tech Stack
The project is built using the Symfony Console component.
โ๏ธ TODOs
- Add unit tests
โจ Future Features
- Archiving: retrieve source playlists from dedicated Spotify playlist folder.
- MyWeeklySelection: command that creates a public profile playlist with the last 30 liked songs with custom playlist image.
- Archiving: add Spotify agnostic storage, see feature/add-database.
- Everything that comes to my mind while I'm showering ;-)
Changelog
Please see CHANGELOG.md for more information on what has changed recently.
Help & Questions
Start a new discussion in the Discussions Tab.
Contributing
... is welcome.
Just fork the repository and create a pull request.
For major changes, please first start a discussion in the Discussions Tab to discuss what you would like to change.
IMPORTANT: By submitting a patch, you agree to allow the project owner(s) to license your work under the terms of the MIT License
.
Thank you!
๐ค Author
multitool-for-spotify-php
is primarily written and maintained by:
๐ฆ Steven Foncken
- Website: stevenfoncken.de
- GitHub: @stevenfoncken
- LinkedIn: Steven Foncken (@stevenfoncken)
๐ค Credits
Like most software, multitool-for-spotify-php
is build upon third-party code/libraries which was/were written by others.
I would therefore like to thank the people below for open-sourcing their work:
Project: jwilsson/spotify-web-api-php
Author: @jwilsson (Jonathan Wilsson)
Copyright (c) Jonathan Wilsson
License: MIT
Project: symfony/console
Author: @fabpot (Fabien Potencier)
Copyright (c) 2004-present Fabien Potencier
License: MIT
... and more, see composer.json.
๐ Support
If this project was helpful for you or your organization, please consider supporting my work directly:
- โญ๏ธ Star this project on GitHub
- ๐ Follow me on GitHub
Everything helps, thanks! ๐
โ๏ธ Disclaimer
"Spotify" is a registered trademark of "Spotify AB" and/or its (worldwide) subsidiaries.
This project or its author is in no way officially connected to, affiliated with, associated with, authorized by, built by, endorsed by, licensed by, maintained by, promoted by, or sponsored by "Spotify AB" or any of its affiliates, licensors, (worldwide) subsidiaries, or other entities under its control.
All trademarks are the property of their respective owners.
This is an independent project that utilizes "Spotify"s Web API to perform various tasks in the personal account.
Before taking legal action, please contact this address: dev[at]stevenfoncken[dot]de
Use at your own risk.
๐ License
multitool-for-spotify-php is licensed under the MIT License
.
See LICENSE for details.
Copyright (c) 2020-present Steven Foncken <dev[at]stevenfoncken[dot]de>
^ back to top ^