PHPackages                             pbxg33k/music-info - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. pbxg33k/music-info

ActiveLibrary[API Development](/categories/api)

pbxg33k/music-info
==================

Combine the power of multiple music related API Services and get the complete information for your music

v0.0.4(9y ago)424[15 PRs](https://github.com/PBXg33k/php-music-info/pulls)LGPL-3.0PHP ^5.6|^7.0

Since May 31Compare

[ Source](https://github.com/PBXg33k/php-music-info)[ Packagist](https://packagist.org/packages/pbxg33k/music-info)[ RSS](/packages/pbxg33k-music-info/feed)WikiDiscussions Synced today

READMEChangelog (4)Dependencies (16)Versions (22)Used By (0)

[![Build Status](https://camo.githubusercontent.com/39636f95cda9acdb7b574d7a1c877075b2d48141e319df2d4a903b56943d9e01/68747470733a2f2f7472617669732d63692e6f72672f5042586733336b2f7068702d6d757369632d696e666f2e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/PBXg33k/php-music-info) [![Latest Stable Version](https://camo.githubusercontent.com/63e0f5184d733d2fbfb7215a40980f7c146ff0eed373e90eb81557e25eb56edb/68747470733a2f2f706f7365722e707567782e6f72672f7062786733336b2f6d757369632d696e666f2f762f737461626c65)](https://packagist.org/packages/pbxg33k/music-info) [![Total Downloads](https://camo.githubusercontent.com/813832110e96ad342f80322011beeaeaf53df98a7a10e851b3792429186834bb/68747470733a2f2f706f7365722e707567782e6f72672f7062786733336b2f6d757369632d696e666f2f646f776e6c6f616473)](https://packagist.org/packages/pbxg33k/music-info) [![Latest Unstable Version](https://camo.githubusercontent.com/4cc62c0cd2d25d146130168cfd238c9c33a02f25b85e53d4a60cdd7d8d0d15c9/68747470733a2f2f706f7365722e707567782e6f72672f7062786733336b2f6d757369632d696e666f2f762f756e737461626c65)](https://packagist.org/packages/pbxg33k/music-info) [![License](https://camo.githubusercontent.com/2b1a99a7c3123bb1bdc126333a8bb0bafeb7eabae70144ddfa5f94ddd8938af6/68747470733a2f2f706f7365722e707567782e6f72672f7062786733336b2f6d757369632d696e666f2f6c6963656e7365)](https://packagist.org/packages/pbxg33k/music-info) [![Scrutinizer Code Quality](https://camo.githubusercontent.com/d0ea19837ad40686ea6e6dd83b683e893e73af965e9b81760bf16356c71a38ea/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f5042586733336b2f7068702d6d757369632d696e666f2f6261646765732f7175616c6974792d73636f72652e706e673f623d646576656c6f70)](https://scrutinizer-ci.com/g/PBXg33k/php-music-info/?branch=develop) [![Coverage Status](https://camo.githubusercontent.com/2258db4d8523789933f80d748c01bf0ce011e6dfad85efabb78bf4d38f436f1e/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f5042586733336b2f7068702d6d757369632d696e666f2f62616467652e7376673f6272616e63683d646576656c6f70)](https://coveralls.io/github/PBXg33k/php-music-info?branch=develop)

MusicInfo Library
=================

[](#musicinfo-library)

This 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.

Requirements
------------

[](#requirements)

In order to use this library your environment MUST meet the following criteria:

- PHP 5.6 (or later)
    - curl extension

Installation
------------

[](#installation)

### Using Composer (recommended)

[](#using-composer-recommended)

Add the music-info package to your `composer.json` file.

```
{
    "require": {
        "pbxg33k/music-info": "dev-master"
    }
}
```

Or via the command line in the root of your project's installation.

```
$ composer require "pbxg33k/music-info"
```

This will install the latest stable version.

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**

### Without composer

[](#without-composer)

1. Download this repository as a zip file.
2. Extract the content of the zip file to a directory in your application
3. Add files to your project
    - Map `pbxg33k/music-info` to this directory if your autoloader is PSR-4 compatible
    - Include `autoloader.php` to your project bootstrap if either you don't have an autoloader or your autoloader is not PSR-4 compatible

Configuration
-------------

[](#configuration)

```
music_info:
    init_services: false ## Automatically initialize services on load
    services:
        - VocaDB
        - Spotify
        # - Discogs
        # - MusicBrainz
    preferred_order:
        - Spotify
        - VocaDB
        # - MusicBrainz
    # Give a weight per service
    # This will be used to *guess* the correct
    # value if multiple services return different values
    service_weight:
        - { service: VocaDB, weigth: 10 }
        - { service: Spotify, weight: 20 }
    guzzle:
        proxy: null
    # General config shared across services
    # Mainly Guzzle
    defaults:
        guzzle:
            http:
                user_agent: 'your-app-name/0.0.1 +https://www.myawsomesite.com'
    service_configuration:
        # Service Specific config
        vocadb:
            language: Default # default, japanese, romaji, english
            start: 0
            max_entries: 10
            get_total_count: false
            name_match_mode: partials # auto, partial, exact, starts_with, words
        spotify:
            client_id: null # required for Spotify
            client_secret: null # required for Spotify
            redirect_uri: null
            scopes:
              - playlist-read-private
              - user-read-private
        discogs:
            throttle: true
        musicbrainz:
            application_name: PHPMusicInfo
            application_version: 0.0.1
            application_url: https://www.github.com/PBXg33k/php-music-info
```

Services
--------

[](#services)

VersionGeneralTrackArtistAlbumCommentsSpotify0.1✅✅✅✅VocaDB0.1✅✖️✅✅MusicBrainz0.1✖️✖️✖️✖️*Low priority, depending on demand*DiscogsN/A✖️✖️✖️✖️Release version not decidedEchonest✖️✖️✖️✖️✖️Service cancelled in favor of Spotify [\[1\]](http://developer.echonest.com/docs/v4)### Adding custom services

[](#adding-custom-services)

When adding a custom service make sure the service file implements the IMusicService interface, or even better, extends the `Pbxg33k\MusicInfo\Service\BaseService` abstract class. The abstract class offers some basic logic and provides better compatibility with this library.

When your service is code compliant you can register it by simply calling `MusicInfo->addService(IMusicService $service, string $key)`. When registering make sure the key is not in use, using an already registered key will override it and replace it.

Changelog
---------

[](#changelog)

Please see [CHANGELOG.md](CHANGELOG.md)

Todo
----

[](#todo)

Please see [TODO.md](TODO.md)

License
-------

[](#license)

Copyright (c) 2016-2017 Oguzhan Uysal This 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.

This 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.

You should have received a copy of the GNU General Public License along with this program. If not, see .

THE 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.

###  Health Score

27

—

LowBetter than 47% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 96.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~102 days

Total

4

Last Release

3376d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/056e16095aa1c6f1b8c0f914ca98d0d00fa7289d5c5c78d95face22210102ad5?d=identicon)[PBX\_g33k](/maintainers/PBX_g33k)

---

Top Contributors

[![PBXg33k](https://avatars.githubusercontent.com/u/1777196?v=4)](https://github.com/PBXg33k "PBXg33k (114 commits)")[![dependabot-preview[bot]](https://avatars.githubusercontent.com/in/2141?v=4)](https://github.com/dependabot-preview[bot] "dependabot-preview[bot] (2 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (2 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/pbxg33k-music-info/health.svg)

```
[![Health](https://phpackages.com/badges/pbxg33k-music-info/health.svg)](https://phpackages.com/packages/pbxg33k-music-info)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.8M717](/packages/sylius-sylius)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.4M528](/packages/shopware-core)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19664.8M1.6k](/packages/drupal-core)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M196](/packages/sulu-sulu)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6941.5M398](/packages/drupal-core-recommended)[open-dxp/opendxp

Content &amp; Product Management Framework (CMS/PIM)

9417.2k58](/packages/open-dxp-opendxp)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
