---
name: "MusicBrainz::Client::Simple"
section: "3pm"
platform: "linux"
package: "libmusicbrainz-client-perl"
version: "0.11-2"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/MusicBrainz::Client::Simple"
---

# MusicBrainz::Client::Simple(3pm)

Perlish Interface to MusicBrainz Client API

## NAME

MusicBrainz::Client::Simple - Perlish Interface to MusicBrainz Client API

## SYNOPSIS

```
  use MusicBrainz::Client::Simple;
```

```
  my $mb = MusicBrainz::Client::Simple->new( debug => 1, utf8 => 0 );
```

```
  my @result = $mb->lookup_cd;
  die "error: " . $mb->get_error unless $mb->success;
```

```
  foreach my $album ( @result ) {
      print $album->get_name, "\n";
  }
```

## DESCRIPTION

*MusicBrainz::Client::Simple* is a class providing access to the meta data of \<http://www.musicbrainz.org\>. This class aims to be as easy to use as possible while still offering the most important functionality. If you need a more powerful interface, try *MusicBrainz::Client* instead.

## CONSTRUCTOR

- new( \[ OPTIONS \] )

  The constructor for a new MusicBrainz::Client::Simple object. To adjust the object's behaviour, you can pass options in a hash like style as illustrated in the above example. The following options are possible:

  **device** - The device name of your CD-ROM/DVD-ROM drive. (default: depends on libmusicbrainz installation)

  **debug** - Print the client's query and the server's response on standard output. (default: 0)

  **utf8** - If set, strings are in UTF-8 instead of ISO-8859-1 (latin1). (default: 0)

  **max\_items** - The maximum number of records (Artists, Albums, Tracks etc.) the server returns for one query. (default: 25)

  **proxy\_host** - The hostname of a HTTP proxy server. (default: unused)

  **proxy\_port** - The port number of a HTTP proxy server. (default: unused)

  On the Windows platform, the constructor calls *WSAInit()* and *WSAStop()* on MusicBrainz::Client.

## METHODS

- *lookup\_cd()*

  Queries the CD-ROM/DVD-ROM drive to calculate a *CDIndexID*. The ID is then sent to the musicbrainz server. `"lookup_cd"` returns a list of MusicBrainz::Client::Simple::Album objects which contain various information about album, artist and tracks of your CD.

  The reason why you might get *multiple* Album objects under some rare circumstances is the following: A *CDIndexID* is not necessarily unique, so there is a small probability that two or more albums have the same *CDIndexID*.

  After lookup\_cd, the success method should be called. In case of an error, success returns false. You can then use get\_error to get a printable error message.

- lookup\_by\_cdindex( CDINDEXID )

  This method does the same as lookup\_cd except for the difference that you have to pass a valid `"CDIndexID"` as an argument. The CD-ROM/DVD-ROM drive is not used.

- *success()*

  Returns a *true* value if the previous operation was successful and *false* otherwise.

- *get\_error()*

  Returns a printable string describing the last error that occurred. This method should only be used if the success method returned *false*.

## EXPORT

None by default.

## SEE ALSO

```
 MusicBrainz::Client::Simple::Album
 MusicBrainz::Client::Simple::Artist
 MusicBrainz::Client::Simple::Track
 MusicBrainz::Client
 http://www.musicbrainz.org
 perl(1)
```

## AUTHORS

```
 Matthias Friedrich, <matt@mafr.de>
 Sander van Zoest, <svanzoest@cpan.org>
```

## COPYRIGHT AND LICENSE

Copyright 2003 by Matthias Friedrich \<matt@mafr.de\>

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.