||3 months ago|
|doc||11 months ago|
|examples||5 months ago|
|include||4 months ago|
|src||4 months ago|
|test||4 months ago|
|thirdparty||4 months ago|
|.clang||3 years ago|
|.gitignore||5 months ago|
|BUILD.md||5 months ago|
|CMakeLists.txt||5 months ago|
|CODING.md||5 months ago|
|DESIGN.md||5 months ago|
|LICENSE||3 years ago|
|README.md||3 months ago|
|TODO.md||3 years ago|
|VERSIONING.md||1 year ago|
|libarcstk-config.cmake.in||2 years ago|
|libarcstk.pc.in||2 years ago|
A library to calculate and verify AccurateRip checksums and ids
What libarcstk does
Libarcstk supports the following tasks:
- Compute the AccurateRip checksums of a sequence of decoded samples
- Verify local AccurateRip checksums against their reference values provided by AccurateRip
- Calculate the AccurateRip ID of a CD image from TOC information
- Parse the response from AccurateRip database to plain text
- An API for working with AccurateRip checksums and ids
- Builds on Linux (and presumably/untested on *BSD)
- Reasonably fast
Although AccurateRip checksums are often referred to as "CRCs", they are not CRCs in a mathematical sense. Therefore, we call them just "AccurateRip Checksums" or "ARCS"s for short.
What libarcstk does not
- Libarcstk does not rip CDs
- Libarcstk does not offer to read or decode any audio data. You have to provide the samples on your own. (Note that there is libarcsdec that can possibly do that for you.)
- Libarcstk offers no network facilities and is not supposed to do so. The actual HTTP request for fetching the reference values from AccurateRip is better performed by the HTTP client of your choice.
How to Build
Build and install to just use the libarcstk API:
$ cd libarcstk # your libarcstk root directory where README.md resides $ mkdir build && cd build $ cmake .. # defaults to 'Release' build $ cmake --build . $ sudo make install # installs to /usr/local
See a detailed HowTo explaining different build scenarios and all build switches.
How to Use
- Consult the example applications in the examples folder. They illustrate the supported usecases.
- Build the API documentation and view it in a browser or read it online.
- For local ARCS calculation, also check whether libarcsdec is useful. Its target is to read virtually any lossless audio format by a uniform API that is really simple to use.
- No production release yet - will be 1.0.0
- API is not considered stable before 1.0.0 (may change any time in any way while major release number is 0)
- Supports only little endian plattforms. Release-build on big endian plattforms is therefore ruled out by cmake.
- Never built, installed or tested on Windows or Mac OS X, but it is intended to support these platforms in the future
- Checksumming CD images containing data tracks is untested and broken.