{"id":13711215,"url":"https://github.com/andrewrk/libchromaprint","last_synced_at":"2025-05-06T20:32:23.378Z","repository":{"id":66013661,"uuid":"589780394","full_name":"andrewrk/libchromaprint","owner":"andrewrk","description":"chromaprint with the build system replaced by zig","archived":false,"fork":true,"pushed_at":"2024-02-25T06:51:46.000Z","size":2350,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-04-13T22:26:24.978Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"acoustid/chromaprint","license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andrewrk.png","metadata":{"files":{"readme":"README.md","changelog":null,"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}},"created_at":"2023-01-16T23:12:05.000Z","updated_at":"2023-07-01T07:50:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/andrewrk/libchromaprint","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrewrk%2Flibchromaprint","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrewrk%2Flibchromaprint/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrewrk%2Flibchromaprint/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrewrk%2Flibchromaprint/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andrewrk","download_url":"https://codeload.github.com/andrewrk/libchromaprint/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224528362,"owners_count":17326349,"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":[],"created_at":"2024-08-02T23:01:05.820Z","updated_at":"2024-11-13T21:31:38.960Z","avatar_url":"https://github.com/andrewrk.png","language":"C++","funding_links":[],"categories":["C++","Interoperability"],"sub_categories":["Build with Zig"],"readme":"This is a fork of [chromaprint](https://acoustid.org/chromaprint), packaged for\nZig. Unnecessary files have been deleted, and the build system has been\nreplaced with `build.zig`.\n\nOriginal README follows:\n\n--------------------------------------------------------------------------------\n\n# Chromaprint\n\nChromaprint is an audio fingerprint library developed for the [AcoustID][acoustid] project. It's designed to identify near-identical audio\nand the fingerprints it generates are as compact as possible to achieve that. It's not a general purpose audio fingerprinting solution.\nIt trades precision and robustness for search performance. The target use cases are full audio file identifcation,\nduplicate audio file detection and long audio stream monitoring.\n\n[acoustid]: https://acoustid.org/\n\n## Building\n\nThe most common way to build Chromaprint is like this:\n\n    $ cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_TOOLS=ON .\n    $ make\n    $ sudo make install\n\nThis will build Chromaprint as a shared library and also include the `fpcalc`\nutility (which is used by MusicBrainz Picard, for example). For this to work,\nyou will need to have the FFmpeg libraries installed.\n\nSee below for other options.\n\n### FFT Library\n\nChromaprint can use multiple FFT libraries -- [FFmpeg][ffmpeg], [FFTW3][fftw], [KissFFT][kissfft] or\n[vDSP][vdsp] (macOS).\n\nFFmpeg is preferred on all systems except for macOS, where you should use\nthe standard vDSP framework. These are the fastest options.\n\nFFTW3 can be also used, but this library is released under the GPL\nlicense, which makes also the resulting Chromaprint binary GPL licensed.\n\nKissFFT is the slowest option, but it's distributed with a permissive license\nand it's very easy to build on platforms that do not have packaged\nversions of FFmpeg or FFTW3. We ship a copy of KissFFT, so if\nthe build system is unable to find another FFT library it will use\nthat as a fallback.\n\nYou can explicitly set which library to use with the `FFT_LIB` option.\nFor example:\n\n    $ cmake -DFFT_LIB=kissfft .\n\n[ffmpeg]: https://www.ffmpeg.org/\n[fftw]: http://www.fftw.org/\n[kissfft]: https://sourceforge.net/projects/kissfft/\n[vdsp]: https://developer.apple.com/reference/accelerate/1652565-vdsp\n\n### FFmpeg\n\nFFmpeg is as a FFT library and also for audio decoding and resampling in `fpcalc`.\nIf you have FFmpeg installed in a non-standard location, you can use the `FFMPEG_ROOT` option to specify where:\n\n    $ cmake -DFFMPEG_ROOT=/path/to/local/ffmpeg/install .\n\nWhile we try to make sure things work also with libav, FFmpeg is preferred.\n\n## API Documentation\n\nYou can use Doxygen to generate a HTML version of the API documentation:\n\n    $ make docs\n    $ $BROWSER docs/html/index.html\n\n## Unit Tests\n\nThe test suite can be built and run using the following commands:\n\n    $ cmake -DBUILD_TESTS=ON .\n    $ make check\n\nIn order to build the test suite, you will need the sources of the [Google Test][gtest] library.\n\n[gtest]: https://github.com/google/googletest\n\n## Related Projects\n\nBindings, wrappers and reimplementations in other languages:\n\n * [Python](https://github.com/beetbox/pyacoustid)\n * [Rust](https://github.com/jameshurst/rust-chromaprint)\n * [Ruby](https://github.com/TMXCredit/chromaprint)\n * [Perl](https://metacpan.org/pod/Audio::Chromaprint)\n * [Raku](https://github.com/jonathanstowe/Audio-Fingerprint-Chromaprint)\n * [JavaScript](https://github.com/parshap/node-fpcalc)\n * [JavaScript](https://github.com/bjjb/chromaprint.js) (reimplementation)\n * [Go](https://github.com/go-fingerprint/gochroma)\n * [C#](https://github.com/wo80/AcoustID.NET) (reimplementation)\n * [C#](https://github.com/protyposis/Aurio/tree/master/Aurio/Aurio/Matching/Chromaprint) (reimplementation)\n * [Pascal](https://github.com/CMCHTPC/ChromaPrint) (reimplementation)\n * [Scala/JVM](https://github.com/mgdigital/Chromaprint.scala) (reimplementation)\n * [Vala](https://github.com/GNOME/vala-extra-vapis/blob/master/libchromaprint.vapi)\n * [Swift](https://github.com/wallisch/ChromaSwift)\n\nIntegrations:\n\n * [FFmpeg](https://www.ffmpeg.org/ffmpeg-formats.html#chromaprint-1)\n * [GStreamer](http://cgit.freedesktop.org/gstreamer/gst-plugins-bad/tree/ext/chromaprint)\n\nIf you know about a project that is not listed here, but should be, please let me know.\n\n## Standing on the Shoulders of Giants\n\nI've learned a lot while working on this project, which would not be possible\nwithout having information from past research. I've read many papers, but the\nconcrete ideas implemented in this library are based on the following papers:\n\n * Yan Ke, Derek Hoiem, Rahul Sukthankar. Computer Vision for Music\n   Identification, Proceedings of Computer Vision and Pattern Recognition, 2005.\n   http://www.cs.cmu.edu/~yke/musicretrieval/\n\n * Frank Kurth, Meinard Müller. Efficient Index-Based Audio Matching, 2008.\n   http://dx.doi.org/10.1109/TASL.2007.911552\n\n * Dalwon Jang, Chang D. Yoo, Sunil Lee, Sungwoong Kim, Ton Kalker.\n   Pairwise Boosted Audio Fingerprint, 2009.\n   http://dx.doi.org/10.1109/TIFS.2009.2034452\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrewrk%2Flibchromaprint","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandrewrk%2Flibchromaprint","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrewrk%2Flibchromaprint/lists"}