Image Tplayer

Tplayer for Linux and Windows · v0.3.0

Your music library, rebuilt as a real desktop player.

Play local folders, import audio from YouTube, control the queue, scrobble to Last.fm, tune the EQ, and keep everything inside one focused warm-dark music app.

curl -fsSL https://twarga.github.io/Tplayer/install.sh | bash

Free & open source · MIT licensed · No account, no telemetry, no lock-in.

  • Local-firstyour files, your library
  • YouTube importpowered by yt-dlp
  • Last.fmnow-playing & scrobble
  • MPRISLinux media keys
Tplayer desktop app, warm dark interface with large album art and queue
Built with

A music player with a point of view

“Without music, life would be a mistake.”

Nietzsche understood music as more than decoration. Tplayer is designed around that same idea: your library should feel intentional, dramatic, and worth returning to every day.

Friedrich Nietzsche, commonly translated from Twilight of the Idols
Portrait of Friedrich Nietzsche
Friedrich Nietzsche, 1882. Public-domain portrait via Wikimedia Commons.

Features

Everything a daily player needs. Nothing it doesn’t.

Tplayer focuses on playback, library, and import. No social feed, no store, no dashboard filler.

Interface

Dark, editorial, and built around album art.

Tplayer uses a warm ink-and-gold palette, large artwork, thin dividers, and direct controls. The UI is designed to feel like a music product instead of a generic Electron panel stack.

Tplayer detailed now-playing view with album art, queue, and EQ
Playback remains visible and controllable while browsing.
Tplayer YouTube import view showing search results and download options
Search YouTube and import audio directly into your local library.

Workflow

From folder to daily player.

Add local folders, import missing tracks, build a queue, tune the EQ, and keep listening history synced through Last.fm. Linux desktop controls work through MPRIS.

  1. 01 Scan local music folders
  2. 02 Import audio from YouTube
  3. 03 Queue, seek, shuffle, and repeat
  4. 04 Scrobble and control from the desktop

Keyboard

Designed for hands-on-keyboard listening.

The most-used actions are one keystroke away. Media keys work globally on Linux via MPRIS.

Questions

Frequently asked.

Is Tplayer free?

Yes. Tplayer is free and open source under the MIT license. There are no accounts, paid tiers, or telemetry.

Does it work offline?

Yes. Local playback, library browsing, queue, and EQ all work fully offline. Only YouTube import and Last.fm scrobbling require a network connection.

What audio formats are supported?

MP3, FLAC, M4A/AAC, OGG, and WAV are supported. YouTube imports default to high-quality M4A via yt-dlp and FFmpeg.

Which operating systems are supported?

Linux is the primary target and ships as an AppImage. A Windows installer is also published. macOS packaging is planned.

Does Tplayer upload or collect my music?

No. Tplayer is fully local-first. Your files and listening history never leave your machine unless you enable Last.fm scrobbling.

Where do imported YouTube tracks go?

Into the same library you already browse, tagged source = youtube. A dedicated Home section surfaces recent imports.

Release

Installable builds live on GitHub Releases.

Install on Linux with one command, or download the Linux AppImage and Windows setup executable directly from GitHub Releases.

curl -fsSL https://twarga.github.io/Tplayer/install.sh | bash