Skip to content
maestebancPublic

About

Bit-perfect Hi-Res audio player for GNOME with real-time oscilloscope and synchronized lyrics

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

MyFlac

Ko-fi Built with Antigravity AI License: GPL v3

A clean, bit-perfect Hi-Res music player and library browser for the Linux desktop.

MyFlac is designed for those who want to listen to their music collection in pristine audiophile quality, with zero unnecessary bloat, a modern GNOME/Libadwaita interface, and rich contextual information about every song, album, and artist.

AI-Generated Software Disclosure: All code in MyFlac has been generated with AI using Antigravity (Google DeepMind), based on the product idea, functional design, testing, and direction of Miguel Angel Esteban.

MyFlac main window

Why MyFlac

No audio player on Linux quite matched what I was looking for: I wanted true bit-perfect hardware output without fighting system sound servers, automatic synchronized lyrics that scroll smoothly like in Roon or Apple Music, and a clean, native interface that looks at home on GNOME. Just like what drove me to conceive MyTag, I designed MyFlac to fit my exact tastes and needs as a music lover, using Antigravity to generate its codebase.

The MyFlac & MyTag Suite

MyFlac and MyTag are designed as companion applications:

  • MyTag: Edit tags, batch-organize tracks, fetch high-resolution covers, and verify file integrity.
  • MyFlac: Play your music in studio-grade fidelity, with hardware ALSA bit-perfect output, synchronized lyrics, and rich encyclopedia insights.

Key Features

  • Official Qobuz Hi-Res Streaming: Browse and stream millions of studio master FLAC albums up to 24-bit / 192 kHz directly inside MyFlac. Genre filters, editorial releases, and personal favorites with seamless one-click web login.
  • UPnP / DLNA Network Streaming: Cast your local music library and streaming playback to any UPnP / DLNA compliant network receiver, streamer, or amplifier in bit-perfect lossless quality with live transport control and real-time metadata.
  • Pure Bit-Perfect Playback: Direct hardware access to your DAC via exclusive ALSA (hw:CARD=...,DEV=...), negotiated with PipeWire/WirePlumber through the standard org.freedesktop.ReserveDevice1 D-Bus protocol. No mixer, no digital volume (fixed at 0 dB), no dithering.
    • Per-device: enable Bit-Perfect exclusive mode for each DAC from the output selector; other outputs keep using the system mixer.
    • Honest status: the output selector shows what really reaches the DAC — Bit-perfect · 192 kHz when samples arrive untouched, Resampled to 96 kHz when the track exceeds the DAC's maximum rate, or Reduced to 16 bits if the DAC cannot take the track's bit depth.
    • Hardware volume: if the DAC has its own volume control (most USB DACs do), the volume slider drives it directly — attenuation happens in the DAC and the digital stream stays bit-perfect. The previous level is restored when the DAC is handed back to the system.
    • Native DSD: DSF files are sent to DSD-capable DACs as native DSD (DSD_U32_BE), without converting to PCM or packing into DoP. DACs without native DSD get a PCM conversion, clearly flagged as DSD → PCM.
    • Plays nicely with the desktop: the DAC is only held while music plays. After 10 seconds paused or stopped it is handed back to PipeWire, so other applications can use it; resuming reserves it again without freezing the interface.
  • Roon-Style Synchronized Lyrics: Real-time line-by-line lyrics fetched via LRCLIB. Active lines are highlighted and kept centered with smooth scrolling; click any line to seek instantly to that position.
  • Ambient Backdrop & Artist Wallpapers: The library background softly blurs and tints the artist's photography, preserving crisp readability while creating a modern, warm atmosphere.
  • Wikipedia & Discogs Insights: Built-in tabs in the inspector panel displaying the story of the track, album, and artist — including release year, label, country, formats, musicians, producers, and liner notes, auto-translated to Spanish or Catalan.
  • Three Viewing Modes:
    • Main Window: Dual-column browser (Artists and Albums), fast search, and metadata inspector.
    • Mini-Player (500×500 px): Compact floating square with clean album art or real-time oscilloscope, with auto-hiding HUD controls.
    • Fullscreen Super-Player: Immersive listening experience with high-resolution artist photography, translucent lyrics card, and phosphor oscilloscope.
MyFlac Fullscreen Super-Player
  • System Tray Integration: Standard StatusNotifierItem / AppIndicator. Left-click opens a sleek popup with cover art and progress bar; right-click opens a full D-Bus menu, and scrolling the mouse wheel adjusts the volume.
  • Ultra HD Cover Art: If an embedded cover is low resolution (e.g. 500 px), MyFlac searches iTunes/Deezer for a matching high-resolution version (up to 2000 px) using strict pixel-correlation checks to ensure exact image identity. Press Ctrl+P to zoom into full-screen album art.
  • Multi-Format Audio Engine: Seamless gapless playback for FLAC, MP3, WAV, AIFF, M4A/AAC, OGG Vorbis, OPUS, and DSD (DSF/DFF).
  • Trilingual Interface: Full native support for Spanish, Catalan, and English, matching your desktop locale.

MyFlac Mini-Player


Installation

Grab the pre-built packages from the GitHub Releases page.

Flatpak (any Linux distribution) — recommended

Install from the official MyFlac repository and get automatic updates through GNOME Software or Discover:

flatpak install --from https://maestebanc.github.io/MyFlac/myflac.flatpakref

Or click Install MyFlac on the official website. The standalone myflac-0.2.7.flatpak bundle from the releases page also receives updates from the repository.

Fedora / RHEL (RPM)

sudo dnf install ./myflac-0.2.7-1.noarch.rpm

Debian / Ubuntu (24.04 LTS+, Debian 13+)

sudo apt install ./myflac_0.2.7-1_all.deb

Arch Linux

Install the pre-built package with pacman:

sudo pacman -U myflac-0.2.7-1-any.pkg.tar.zst

Or build from source using the included PKGBUILD:

cd packaging/arch
makepkg -si

Running from Source

MyFlac requires Python 3.11+, GTK4, Libadwaita, GStreamer, and PyGObject:

System Dependencies

Fedora:

sudo dnf install python3 python3-gobject gtk4 libadwaita gstreamer1 gstreamer1-plugins-base gstreamer1-plugins-good

Debian / Ubuntu:

sudo apt install python3 python3-gi gir1.2-gtk-4.0 gir1.2-adw-1 gstreamer1.0-plugins-base gstreamer1.0-plugins-good

Arch Linux:

sudo pacman -S python python-gobject gtk4 libadwaita gst-plugins-base gst-plugins-good

Clone and Run

git clone https://github.com/maestebanc/MyFlac.git
cd MyFlac
./run.sh

Keyboard Shortcuts

Shortcut Action
Space Play / Pause
Ctrl + → / ← Next / Previous track
Shift + → / ← Seek ±10 seconds
Ctrl + ↑ / ↓ Volume up / down
Ctrl + 1 Main Window view
Ctrl + 2 Mini-Player view (500×500)
Ctrl + 3 / F11 Fullscreen Super-Player
Ctrl + P Full-size Cover Popup
Ctrl + I Toggle Cover / Artist Photo mode
Ctrl + E Toggle Bit-Perfect Exclusive mode
Ctrl + , Open Preferences
Ctrl + ? / F1 Keyboard Shortcuts cheat-sheet
Ctrl + Q Quit MyFlac

Support / Donaciones

Si te gusta MyFlac y quieres apoyar su desarrollo o invitar a un café:

Ko-fi


License

MyFlac is open-source software released under the GNU General Public License v3.0 or later (GPL-3.0-or-later).

About

Bit-perfect Hi-Res audio player for GNOME with real-time oscilloscope and synchronized lyrics

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages