https://github.com/zhiyiyo/groove

A cross-platform music player based on PyQt5, supports Win32, Linux and macOS.
https://github.com/zhiyiyo/groove

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

Last synced: about 1 month ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/zhiyiyo/groove
• Owner: zhiyiYo
• License: gpl-3.0
• Created: 2020-05-10T00:02:32.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2025-02-23T04:03:56.000Z (4 months ago)
• Last Synced: 2025-04-07T22:04:35.588Z (2 months ago)
• Topics: desktop-lyric, local-music, lyrics, music-player, online-music, online-mv, pyqt, python, qt, song-metadata
• Language: Python
• Homepage: https://groove-music.readthedocs.io
• Size: 334 MB
• Stars: 570
• Watchers: 9
• Forks: 92
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


  



  


  Groove Music





  A cross-platform music player based on PyQt5





  

    

  

  

    

  

  

    

  





English | 简体中文



![界面](docs/source/_static/images/Groove音乐.jpg)

## Features

* Play local music

  ![local music](docs/source/_static/images/本地音乐.gif)

* Create and manage custom playlist

  ![custom playlist](docs/source/_static/images/播放列表.gif)

* View and edit song meta data

  ![song meta data](docs/source/_static/images/歌曲信息.gif)

* Watch and download MV

  ![MV](docs/source/_static/images/播放和下载MV.jpg)

## Quick start

1. Create virtual environment:

    ```shell

    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](https://github.com/Nevcairiel/LAVFilters/releases/download/0.74/LAVFilters-0.74-Installer.exe).

   * For the Linux, you should install GStreamer.

3. Open Groove music:

    ```shell

    cd app

    conda activate Groove

    python Groove.py

    ```

## Document

Want to know more about Groove Music? Please read the [help document](https://groove-music.readthedocs.io) 👈

## See also

- [zhiyiYo/PyQt-Frameless-Window](https://github.com/zhiyiYo/PyQt-Frameless-Window)：A cross-platform frameless window based on pyqt5, support Win32, Linux and macOS.

- [zhiyiYo/PyQt-Fluent-Widgets](https://github.com/zhiyiYo/PyQt-Fluent-Widgets)：A fluent design widgets library based on PyQt5

- [jsmolka/egg-player](https://github.com/jsmolka/egg-player)：A Groove Music like music player. The code of this repo is very elegant.

## 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.