{"id":14985451,"url":"https://github.com/pbxg33k/php-music-info","last_synced_at":"2025-04-11T20:04:30.834Z","repository":{"id":37547330,"uuid":"59194507","full_name":"PBXg33k/php-music-info","owner":"PBXg33k","description":"A PHP Library that makes working with multiple music related API services easier","archived":false,"fork":false,"pushed_at":"2023-04-19T18:37:39.000Z","size":279,"stargazers_count":4,"open_issues_count":18,"forks_count":0,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2025-04-11T20:04:29.984Z","etag":null,"topics":["composer","music","music-api","music-info","music-information-retrieval","php","php-library","spotify","spotify-api","spotify-library","unstable","vocadb","vocaloid"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PBXg33k.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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}},"created_at":"2016-05-19T09:53:59.000Z","updated_at":"2025-01-10T04:51:50.000Z","dependencies_parsed_at":"2024-09-24T15:44:49.214Z","dependency_job_id":null,"html_url":"https://github.com/PBXg33k/php-music-info","commit_stats":{"total_commits":127,"total_committers":4,"mean_commits":31.75,"dds":0.2913385826771654,"last_synced_commit":"6641de67b66d715b218dff8491e12de321b1fb64"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PBXg33k%2Fphp-music-info","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PBXg33k%2Fphp-music-info/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PBXg33k%2Fphp-music-info/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PBXg33k%2Fphp-music-info/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PBXg33k","download_url":"https://codeload.github.com/PBXg33k/php-music-info/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248473129,"owners_count":21109628,"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":["composer","music","music-api","music-info","music-information-retrieval","php","php-library","spotify","spotify-api","spotify-library","unstable","vocadb","vocaloid"],"created_at":"2024-09-24T14:10:59.587Z","updated_at":"2025-04-11T20:04:30.812Z","avatar_url":"https://github.com/PBXg33k.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/PBXg33k/php-music-info.svg?branch=master)](https://travis-ci.org/PBXg33k/php-music-info) [![Latest Stable Version](https://poser.pugx.org/pbxg33k/music-info/v/stable)](https://packagist.org/packages/pbxg33k/music-info) [![Total Downloads](https://poser.pugx.org/pbxg33k/music-info/downloads)](https://packagist.org/packages/pbxg33k/music-info) [![Latest Unstable Version](https://poser.pugx.org/pbxg33k/music-info/v/unstable)](https://packagist.org/packages/pbxg33k/music-info) [![License](https://poser.pugx.org/pbxg33k/music-info/license)](https://packagist.org/packages/pbxg33k/music-info) [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/PBXg33k/php-music-info/badges/quality-score.png?b=develop)](https://scrutinizer-ci.com/g/PBXg33k/php-music-info/?branch=develop) [![Coverage Status](https://coveralls.io/repos/github/PBXg33k/php-music-info/badge.svg?branch=develop)](https://coveralls.io/github/PBXg33k/php-music-info?branch=develop)\n\n# MusicInfo Library #\n\nThis PHP library enables you to combine multiple music related API Services to lookup information about music. See [Supported Services](#services) to see which services are supported.\n\n## Requirements ##\nIn order to use this library your environment MUST meet the following criteria:\n* PHP 5.6 (or later)\n\t* curl extension\n\n\n## Installation ##\n\n### Using Composer (recommended) ###\nAdd the music-info package to your `composer.json` file.\n\n``` json\n{\n    \"require\": {\n        \"pbxg33k/music-info\": \"dev-master\"\n    }\n}\n```\n\nOr via the command line in the root of your project's installation.\n\n``` bash\n$ composer require \"pbxg33k/music-info\"\n```\n\nThis will install the latest stable version.\n\n~~To try the latest features, add `master-dev` as version. But be warned, this branch is unstable and not intended for production use.~~ **During this development stage master-dev will have the latest stable development version untill 1.0.0 has been released**\n\n### Without composer ###\n1. Download this repository as a zip file.\n2. Extract the content of the zip file to a directory in your application\n3. Add files to your project\n\t* Map `pbxg33k/music-info` to this directory if your autoloader is PSR-4 compatible\n\t* Include `autoloader.php` to your project bootstrap if either you don't have an autoloader or your autoloader is not PSR-4 compatible\n\n## Configuration ##\n\n```yaml\nmusic_info:\n    init_services: false ## Automatically initialize services on load\n    services:\n        - VocaDB\n        - Spotify\n        # - Discogs\n        # - MusicBrainz\n    preferred_order:\n        - Spotify\n        - VocaDB\n        # - MusicBrainz\n    # Give a weight per service\n    # This will be used to *guess* the correct\n    # value if multiple services return different values\n    service_weight:\n        - { service: VocaDB, weigth: 10 }\n        - { service: Spotify, weight: 20 }\n    guzzle:\n        proxy: null\n    # General config shared across services\n    # Mainly Guzzle\n    defaults:\n        guzzle:\n            http:\n                user_agent: 'your-app-name/0.0.1 +https://www.myawsomesite.com'\n    service_configuration:\n        # Service Specific config\n        vocadb:\n            language: Default # default, japanese, romaji, english\n            start: 0\n            max_entries: 10\n            get_total_count: false\n            name_match_mode: partials # auto, partial, exact, starts_with, words\n        spotify:\n            client_id: null # required for Spotify\n            client_secret: null # required for Spotify\n            redirect_uri: null\n            scopes:\n              - playlist-read-private\n              - user-read-private\n        discogs:\n            throttle: true\n        musicbrainz:\n            application_name: PHPMusicInfo\n            application_version: 0.0.1\n            application_url: https://www.github.com/PBXg33k/php-music-info\n```\n\n## Services ##\n\n|             | Version                  | General                  | Track                    | Artist                   | Album                    | Comments |\n|---          |:-------:                 |:-------:                 |:-----:                   |:------:                  |:-----:                   |:--------:|\n|Spotify      | 0.1                      | :white_check_mark:       | :white_check_mark:       | :white_check_mark:       | :white_check_mark:       ||\n|VocaDB       | 0.1                      | :white_check_mark:       | :heavy_multiplication_x: | :white_check_mark:       | :white_check_mark:       ||\n|MusicBrainz  | 0.1                      | :heavy_multiplication_x: | :heavy_multiplication_x: | :heavy_multiplication_x: | :heavy_multiplication_x: | _Low priority, depending on demand_ |\n|Discogs      | N/A                      | :heavy_multiplication_x: | :heavy_multiplication_x: | :heavy_multiplication_x: | :heavy_multiplication_x: | Release version not decided |\n|~~Echonest~~ | :heavy_multiplication_x: | :heavy_multiplication_x: | :heavy_multiplication_x: | :heavy_multiplication_x: | :heavy_multiplication_x: | Service cancelled in favor of Spotify [[1]](http://developer.echonest.com/docs/v4) |\n\n### Adding custom services ###\n\nWhen adding a custom service make sure the service file implements the IMusicService interface, or even better, extends the `Pbxg33k\\MusicInfo\\Service\\BaseService` abstract class.\nThe abstract class offers some basic logic and provides better compatibility with this library.\n\nWhen your service is code compliant you can register it by simply calling `MusicInfo-\u003eaddService(IMusicService $service, string $key)`.\nWhen registering make sure the key is not in use, using an already registered key will override it and replace it.\n\n\n## Changelog\n\nPlease see [CHANGELOG.md](CHANGELOG.md)\n\n## Todo\n\nPlease see [TODO.md](TODO.md)\n\n## License\n\nCopyright (c) 2016-2017 Oguzhan Uysal\nThis program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.\n\nThis program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License along with this program.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpbxg33k%2Fphp-music-info","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpbxg33k%2Fphp-music-info","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpbxg33k%2Fphp-music-info/lists"}