# marin-m/SongRec

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

Repository: https://github.com/marin-m/SongRec
Canonical: https://ross.abutalabs.com/products/songrec
Homepage: https://songrec.fossplant.re/
Language: Rust
License: GPL-3.0
License Family: copyleft
Topics: audio-fingerprinting, flatpak, rust, shazam, songrec
Last push: 2026-08-20T18:10:50+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 98, longevity 100
- inputs: {"age_days": 2211, "days_push": 13, "days_rel": 15, "gap_med": 4, "n_releases_24m": 18}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1941, forks 139 (observed 2026-08-28T04:05:57.404157+00:00)

## What it is
SongRec is an open-source Shazam client written in Rust that recognizes songs from audio files or the microphone. It offers both a GTK GUI with recognition history and a command-line interface, and is available via Flatpak, Snap, and native packages.

## Use cases
- identify a song playing from my speakers on linux
- recognize music from an audio file
- continuously detect songs from the microphone
- export my recognized song history to csv
- shazam alternative for linux desktop
- find what song is playing using command line

## When to choose
- you need song recognition on Linux with a GUI or CLI
- you want to identify music from files or microphone input
- you want an open-source Shazam client with history export

## When to avoid
- you need fully offline recognition (it relies on Shazam servers)
- you need a mobile song-recognition app
- you are on a platform without builds and cannot compile Rust

## Facets
- artifact type: application
- maturity: active
- function: audio-processing, gui, cli
- domain: media, desktop-applications
- platform: windows, cross-platform
- tags: shazam-client, audio-fingerprinting, song-recognition, flatpak, gtk, audio, linux

## Member repositories
- marin-m/SongRec (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:57.404157+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:08:06.922353+00:00, confidence not recorded.
  - readme: https://github.com/marin-m/SongRec (fetched 2026-08-28T04:05:57.404157+00:00, sha 8603418f551f)
  - homepage: https://songrec.fossplant.re/ (fetched 2026-08-29T10:47:17.867799+00:00, sha e3da9e726a0a)
  - registry_crates: https://crates.io/api/v1/crates/songrec (fetched 2026-08-29T10:47:17.876885+00:00, sha e82741173af1)
- Data as of 2026-08-30T08:39:29.467469+00:00.