Skip to main content

SRG Player

A terminal-based music player that streams music directly from YouTube.

Features

  • 🎵 Search YouTube songs
  • 📃 Search and import YouTube playlists
  • ⏯ Pause, resume, next, previous
  • ⏩ Forward / backward seeking
  • 🎚 Playback speed control
  • 📝 Lyrics lookup (synced follow mode)
  • 🔤 Romanized lyrics toggle (press t in lyrics view)
  • 🔁 Reuse previous search results
  • ➕ Add songs while music is playing
  • 🔊 Volume controls
  • ⌨ Keyboard shortcuts

Installation

Install the application:

pipx install srgplayer

Requirements

SRG Player requires the mpv media player.

Ubuntu/Debian:

sudo apt install mpv

macOS:

brew install mpv

Usage

srgplayer

Controls:

  • Space — Pause/Resume
  • n — Next song
  • p — Previous song
  • a — Search song/playlist
  • l — List queue
  • r — Show previous search results
  • y — Show lyrics (synced follow, q to exit, t for romanized)
  • j / k — Nudge lyric timing ∓0.5s (in lyrics view)
    • / - — Volume up/down
  • ← / → — Seek backward/forward 5 seconds
  • , / . — Seek backward/forward 10 seconds
  • [ / ] — Decrease/increase playback speed
  • \ — Reset speed to 1.0x
  • 0-9 — Play a previous search result
  • c — Clear queue
  • q — Quit

License

MIT License

Metadata

Release files for srgplayer 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for srgplayer 0.3.0
File Size Uploaded
srgplayer-0.3.0.tar.gz 56.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for srgplayer 0.3.0
File Interpreter ABI Platform
srgplayer-0.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 77.4 kB

Release files / srgplayer-0.3.0.tar.gz

Download URL srgplayer-0.3.0.tar.gz
Size 56.1 kB
Tags Source
SHA-256 checksum
How to use checksums
43f95204668d9829333321992e58671ace775e766601da0102a9547d8947cebc
BLAKE2b-256 checksum
How to use checksums
6f3392016bddadfe1a69a6cae49a9218c0801f7959e5bc698705e6bea07cdecf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.0 {"installer":{"name":"uv","version":"0.12.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / srgplayer-0.3.0-py3-none-any.whl

Download URL srgplayer-0.3.0-py3-none-any.whl
Size 21.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8eb6ab06f8a524bcdfaf788a015e1d5edb240d99f356a4d25b6d613d33ee1557
BLAKE2b-256 checksum
How to use checksums
236ea858f7541278e6377b11cb77ad9945c828e80734d603f8e2005aa4544b48
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.0 {"installer":{"name":"uv","version":"0.12.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.3.0 This release

2 release files

0.2.0

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page