/ThousandPlayer

Qt6-based cross-platform music player as a tribute to TTPlayer (千千静听)

Primary LanguageC++GNU General Public License v3.0GPL-3.0

ubuntu-latest windows-2019

ThousandPlayer

A Qt6-based open-source audio player developed from scratch. It is a tribute to TTPlayer (千千静听), one of the most popular local music players for Microsoft Windows in China during 2000s.

The software is still in early development stage, but already has fundamental functions that a local audio player should have. Feel free to participate in the development! Here is the format manual of this project.

Features

  • Cross-platform.
    • Linux and Microsoft Windows (Windows 10 1809 and above) are supported at present. Need other developers' help to check the availability in macOS.
  • Most UI elements have text with proper font sizes instead of icon-only for the sake of localizability. Current supported UI languages are:
    • en (English)
    • ja (Japanese, 日本語)
    • zh_CN (Simplified Chinese, 简体中文)
    • zh_TW (Traditional Chinese, 繁體中文)
  • Currently supports following audio formats:
    • AAC (.aac, .m4a)
    • ALAC (.alac)
    • FLAC (.flac)
    • MP3 (.mp3)
    • Vorbis (.ogg) (only supported in Linux at present. see QTBUG-99278)
    • WAV (.wav)
    • For format support details about ReplayGain and cover art reading, see here.
  • .lrc lyrics file viewer.
    • In order to view lyrics, a .lrc file must be put in the same directory of the corresponding music file. Also, their filenames must be identical except for the extension part (for example, the lyrics file to be viewed while playing song.flac must be named song.lrc).
  • Integrated .lrc lyrics file editor with timestap inserting function.

  • A horizontally expandable main window. No need to worry about long music informations.
  • A cover viewer for viewing album covers.
  • Rich finding and sorting functions.
  • Standard ReplayGain support with pre-amplification and default ReplayGain.
  • Customizable fonts of various widgets.
  • Playlist persistence and multi-playlist support.
  • Multi-threaded file loading.
  • CMake-based automatic compilation.

Planned features

  • Audio format converting.
  • Music tag editor.
  • Audio description customization.
  • ReplayGain scanning.
  • .cue sheet support.
  • Streaming audio.

Serious bugs caused by other libraries

PipeWire 0.3.40, 0.3.42

  • Broken sound after moving playhead in GStreamer applications (including Qt Multimedia, Rhythmbox, etc.). (report link, largely fixed by version 0.3.43)

Qt

  • QTBUG-96248: For QListWidget, drag & drop function does not work properly when an item is dropped at an inappropriate position.

Compilation Tutorial

This page only provides complation steps with Qt Creator. Of course you can also build it with command lines, Visual Studio or anything else you like.

Before proceeding with the following OS-specific steps, you have to install

  • Latest version of Qt Creator.
  • Latest version of Qt6 along with Qt Multimedia.
  • Latest version of Conan C/C++ Package Manager.
  • CMake version 3.20 or later.
  • Other required compilation tools, such as GCC-C++ for Linux, MSVC 2019 for Microsoft Windows, and so on.
  • 【Linux】 development packages required by Qt (e.g. libOpenGL) and Qt Multimedia.

In a word, you should compile and run some example project of Qt Multimedia successfully before trying to build this project.

Steps

  1. Turn on Conan plugin in Qt Creator.

  1. In Qt Creator, Go to Edit → Preferences → Cmake → General, turn on "Package manager auto setup".

  2. Open the root CMakeLists.txt by Qt Creator, then configure the project with latest version of Qt6.

  3. After the completion of configuration, Go to "Projects" tab, remove "Conan install" build step.

  1. Built it!