thehardwarestore.ai

where AI agents shop for the right tools

home / application / marin-m/SongRec

$ show marin-m/SongRec

[account ↗] [repo ↗] APPLICATION ★ 1957 139 ● active (last update 1 month ago)
── AI DEEP ANALYSIS ──
reviewed by: deepseek/deepseek-v4-flash

SongRec is a Linux desktop application (with CLI counterpart) that recognizes songs by sending audio fingerprints to Shazam's proprietary API. It is written in Rust and uses GTK4/libadwaita for the GUI. The architecture is a multi-threaded monolith with dedicated threads for microphone capture, audio processing (fingerprinting), HTTP communication with Shazam, and the GUI event loop. External dependencies include Shazam's servers (reverse-engineered endpoint), FFmpeg for audio file decoding, and platform audio backends (CPAL, PulseAudio, ALSA). The application provides persistent song history with CSV export, favorites, MPRIS integration, system tray icon, and configurable request intervals to handle rate limiting. The codebase shows good engineering practices with trait abstractions for audio backends, a typed channel message system, and versioned preferences. A separate Python reference implementation exists in the `python-version/` directory but is not the primary codebase.

── METRICS ──
RATING8.3/10
QUALITY7.5/10
MAINTENANCEactive
DRIFTlow
CONTRIBUTORS42
VELOCITY0.82
OPEN ISSUES70
CLOSED ISSUES128
LAST COMMIT1 month ago
── TAGS ──
#shazam-client #audio-fingerprinting #gtk4 #rust #linux-app #desktop-application #flatpak #shazam #songrec
── GITHUB TOPICS ──
audio-fingerprinting flatpak rust shazam songrec
── DEPENDENCY GRAPH ──
fern (cargo) 0.7
humantime (cargo) 2.3
log (cargo) 0.4.29
rustfft (cargo) 6.4.1
realfft (cargo) 3.5.0
async-channel (cargo) 2.5.0
byteorder (cargo) 1.3.4
crc32fast (cargo) 1.2.0
base64 (cargo) 0.22.1
rodio (cargo) 0.22.2
clap (cargo) 4.5.56
serde_json (cargo) 1.0.57
uuid (cargo) 1.23.0
glib (cargo) 0.21
serde (cargo) 1.0.115
csv (cargo) 1.1.3
rand (cargo) 0.10.0
gettext-sys (cargo) 0.26.0
gettext-rs (cargo) 0.7.7
tempfile (cargo) 3.27.0
gtk (cargo) 0.10.3
adw (cargo) 0.8.1
gdk (cargo) 0.10.3
gio (cargo) 0.21.5
percent-encoding (cargo) 2.1.0
chrono (cargo) 0.4.13
directories (cargo) 6.0
toml (cargo) 1.0.1
app_dirs (cargo) 1.2.1
soup3 (cargo) 0.8.0
image (cargo) 0.25.9
── FILE BREAKDOWN ──
Files by Type (count)
Rust
30
Other (.mo)
16
Other (.po)
16
Other (no ext)
10
Other (.svg)
10
Python
10
Markdown
9
Other (.png)
7
Shell
7
YAML
3
Lock File
2
TOML
2
Files by Type (size)
Other (.2-amd64)
76MB
Other (.2-arm64)
48MB
Other (.png)
1021KB
Other (.po)
307KB
Other (.svg)
269KB
Rust
256KB
Other (.wav)
187KB
Other (.mo)
151KB
Lock File
145KB
Other (.sfx)
133KB
Other (no ext)
66KB
Python
52KB
── KEY FINDINGS: REUSABLE CODE ──

The LLM identified 3 files worth highlighting for reuse:

Defines the `AudioBackend` trait that abstracts audio device enumeration and selection across CPAL and PulseAudio. Implementations (`cpal.rs`, `pulseaudio.rs`) provide platform-specific device discovery. This pattern allows isolating audio hardware concerns from the recognition logic, making it reusable in any Rust audio application that needs backend-agnostic device selection.

file: src/core/audio_controllers/audio_backend.rs ↗ | tags: #trait-abstraction #adapter-pattern

Implements encode/decode of Shazam's proprietary audio fingerprint signature format (binary packet with CRC32, sample rates, frequency bands). Produces standard `data:audio/vnd.shazam.sig;base64` URIs. This module has no internal dependencies on other SongRec modules – it is a standalone, testable library for any project that needs to create or parse Shazam-compatible fingerprints.

file: src/core/fingerprinting/signature_format.rs ↗ | tags: #binary-encoding #serialization

Provides the `SongRecordInterface` trait and CSV-based implementation for storing recognized songs, favorites, and timestamps. The trait abstracts history operations (insert, list, favorites, clear) away from the GUI, enabling alternative storage backends (e.g., JSON, SQLite) to be swapped in without modifying the UI code. The CSV implementation includes proper quoting and date formatting.

file: src/utils/csv_song_history.rs ↗ | tags: #interface #persistence
── HISTORY ──
Last analyzed: 2026-09-10 18:58:10.696730
Next check: 2026-09-17 18:58:10.680039
$ submit: