---
name: "songrec"
section: "1"
platform: "linux"
package: "songrec"
version: "0.8.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/songrec"
---

# songrec(1)

An open-source Shazam client for Linux, written in Rust.

## NAME

songrec - An open-source Shazam client for Linux, written in Rust.

## SYNOPSIS

**songrec** \[**-v**\|**--verbose**\]... \[**-h**\|**--help**\] \[**-V**\|**--version**\] \[*subcommands*\]

## DESCRIPTION

An open-source Shazam client for Linux, written in Rust.

## OPTIONS

- **-v**, **--verbose**

  \-v: Set the log level to DEBUG instead of INFO for SongRec-related messages -vv: Set the log level to DEBUG for SongRec-related messages and INFO for library-related messages -vvv: Set the log level to TRACE

- **-h**, **--help**

  Print help

- **-V**, **--version**

  Print version

## SUBCOMMANDS

- [songrec-listen(1)](/songrec-listen/1.md)

  Run as a command-line program listening the microphone and printing recognized songs to stdout, exposing current song info via MPRIS

- [songrec-recognize(1)](/songrec-recognize/1.md)

  Recognize one song from a sound file or microphone and print its info.

- [songrec-audio-file-to-recognized-song(1)](/songrec-audio-file-to-recognized-song/1.md)

  Generate a Shazam fingerprint from a sound file, perform song recognition towards Shazam's servers and print obtained information to the standard output.

- [songrec-microphone-to-recognized-song(1)](/songrec-microphone-to-recognized-song/1.md)

  Recognize a currently playing song using the microphone and print obtained information to the standard output

- [songrec-audio-file-to-fingerprint(1)](/songrec-audio-file-to-fingerprint/1.md)

  Generate a Shazam fingerprint from a sound file, and print it to the standard output.

- [songrec-fingerprint-to-recognized-song(1)](/songrec-fingerprint-to-recognized-song/1.md)

  Take a data-URI Shazam fingerprint, perform song recognition towards Shazam's servers and print obtained information to the standard output.

- [songrec-gui(1)](/songrec-gui/1.md)

  The default action. Display a GUI.

- [songrec-gui-norecording(1)](/songrec-gui-norecording/1.md)

  Launch the GUI, but don't recognize audio through the microphone as soon as it is launched (rather than expecting the user to click on a button).

## VERSION

v0.8.0

## AUTHORS

Marin M. - Fossplant.re