zhiyiYo/Groove

A cross-platform music player based on PyQt5, supports Win32, Linux and macOS.

Python

652

476 commits

updated May 5, 2026

See the code

README

logo

Groove Music

A cross-platform music player based on PyQt5

Python 3.8.6 PyQt 5.15.2 Platform Win32 | Linux | macOS

English | 简体中文

界面

Features

  • Play local music

    local music

  • Create and manage custom playlist

    custom playlist

  • View and edit song meta data

    song meta data

  • Watch and download MV

    MV

Quick start

  1. Create virtual environment:

    conda create -n Groove python=3.8
    conda activate Groove
    pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
    
  2. Download decoder:

    • For the Win32, you should install LAV Filters.
    • For the Linux, you should install GStreamer.
  3. Open Groove music:

    cd app
    conda activate Groove
    python Groove.py
    

Document

Want to know more about Groove Music? Please read the help document 👈

See also

License

Groove is licensed under GPLv3 for non-commercial usage.

Copyright © 2020 by zhiyiYo.

Attention

This software is only for learning and communication, the songs' and playlists' copyright belongs to each music platform.

desktop-lyric
local-music
lyrics
music-player
online-music
online-mv
pyqt
python
qt
song-metadata

Significant stargazers

Ahnaf Mahmud

117 followers · starred Aug 2023

Vlad

93 followers · starred Jul 2022

JasonMo

12 followers · starred Nov 2023

zhiyiYo/Groove

A cross-platform music player based on PyQt5, supports Win32, Linux and macOS.

Python

652

476 commits

updated May 5, 2026

See the code

README

logo

Groove Music

A cross-platform music player based on PyQt5

Python 3.8.6 PyQt 5.15.2 Platform Win32 | Linux | macOS

English | 简体中文

界面

Features

  • Play local music

    local music

  • Create and manage custom playlist

    custom playlist

  • View and edit song meta data

    song meta data

  • Watch and download MV

    MV

Quick start

  1. Create virtual environment:

    conda create -n Groove python=3.8
    conda activate Groove
    pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
    
  2. Download decoder:

    • For the Win32, you should install LAV Filters.
    • For the Linux, you should install GStreamer.
  3. Open Groove music:

    cd app
    conda activate Groove
    python Groove.py
    

Document

Want to know more about Groove Music? Please read the help document 👈

See also

License

Groove is licensed under GPLv3 for non-commercial usage.

Copyright © 2020 by zhiyiYo.

Attention

This software is only for learning and communication, the songs' and playlists' copyright belongs to each music platform.

desktop-lyric
local-music
lyrics
music-player
online-music
online-mv
pyqt
python
qt
song-metadata

Significant stargazers

Ahnaf Mahmud

117 followers · starred Aug 2023

Vlad

93 followers · starred Jul 2022

JasonMo

12 followers · starred Nov 2023

Languages

Python

99.9%