PHPackages                             yeboahnanaosei/acoust - 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. yeboahnanaosei/acoust

ActiveLibrary[API Development](/categories/api)

yeboahnanaosei/acoust
=====================

A simple one-class wrapper for acoustid.org API

v1.0.1(7y ago)116[1 issues](https://github.com/yeboahnanaosei/acoust/issues)MITPHPPHP >=7.1

Since Jun 26Pushed 7y agoCompare

[ Source](https://github.com/yeboahnanaosei/acoust)[ Packagist](https://packagist.org/packages/yeboahnanaosei/acoust)[ Docs](https://github.com/yeboahnanaosei/acoust)[ RSS](/packages/yeboahnanaosei-acoust/feed)WikiDiscussions master Synced 2w ago

READMEChangelogDependenciesVersions (4)Used By (0)

API wrapper for Acoustid.org
============================

[](#api-wrapper-for-acoustidorg)

What this package can do 🔨
--------------------------

[](#what-this-package-can-do--hammer)

- Uses chromaprint to generate or retrieve fingerprint and duration of songs
- Perform a lookup using the fingerprint of the song against [acoustid.org](https://acoustid.org) database

---

### Installation

[](#installation)

Just run

```
composer require yeboahnanaosei/acoust
```

---

### How to use the package

[](#how-to-use-the-package)

You can use this package in two ways

- To perform a lookup. *(You will need an application API key from acoustid.org for this)*
- To generate the fingerprint and duration of the song for any other purpose you might have.

**1. Perform a lookup**

Performing a lookup is as simple as calling just one method.

> **IMPORTANT: To perform a lookup of a song on acoustid.org database, you should have already obtained an `application API key` from [acoustid.org](https://acoustid.org)**

```
try {
    // Set the needed parameters
    $song   = 'Path to song';      # Always required
    $apiKey = 'API key'; 	       # Required when performing a lookup
    $format = 'json or xml'        # Optional. Defaults to 'json' if not supplied

    // Create instance of acoust
    // $format is optional and can be omitted
    // In that case $format will default to 'json'
    $acoust = new Acoust($apiKey, $song, $format);

    // All you need to do is to just call query() method
    // This method will return data from acoustid.org in
    // json format by default or in xml if you set your
    // format to xml
    $response = $acoust->query();
} catch (Throwable $e) {
    echo $e->getMessage();
}
```

**2. Generate fingerprint or duration of song**

To only generate fingerprints of songs or durations of songs you only need the song. No need of an API key or a response format

```
try {
    // Set needed parameters
    $song = 'Path to song';

    // Create an instance of acoust
    $acoust = new Acoust($song)

    // Generate fingerprint or duration of the song as you wish
    $fingerprint = $acoust->getFingerprint();
    $duration = $acoust->getDuration();

} catch (Throwable $e) {
    echo $e->getMessage();
}
```

Contributing ❤️
---------------

[](#contributing--heart)

- As always pull requests are graciously welcomed
- Feel free to report bugs and also suggest improvements

###  Health Score

21

—

LowBetter than 18% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~54 days

Total

2

Last Release

2872d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a22899df5ec2cd39a579d0c8c56daa66def5e590fd4b93f4b89bec5e34db9b2e?d=identicon)[yeboahnanaosei](/maintainers/yeboahnanaosei)

---

Top Contributors

[![yeboahnanaosei](https://avatars.githubusercontent.com/u/22800157?v=4)](https://github.com/yeboahnanaosei "yeboahnanaosei (7 commits)")

---

Tags

acoustic-fingerprintsfingerprintingmusicmusicFingerprintaudio-fingerprintingacoustid.orgacoustic fingerprint

### Embed Badge

![Health badge](/badges/yeboahnanaosei-acoust/health.svg)

```
[![Health](https://phpackages.com/badges/yeboahnanaosei-acoust/health.svg)](https://phpackages.com/packages/yeboahnanaosei-acoust)
```

###  Alternatives

[fingerprint/fingerprint-pro-server-api-sdk

Fingerprint Server API allows you to get, search, and update Events in a server environment. It can be used for data exports, decision-making, and data analysis scenarios. Server API is intended for server-side usage, it's not intended to be used from the client side, whether it's a browser or a mobile device.

32250.3k1](/packages/fingerprint-fingerprint-pro-server-api-sdk)[aerni/laravel-spotify

A Laravel wrapper for the Spotify Web API

208157.8k](/packages/aerni-laravel-spotify)[dariusiii/php-itunes-api

Query iTunes API System

1117.0k](/packages/dariusiii-php-itunes-api)

PHPackages © 2026

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