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.

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

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

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

• QTBUG-96248: For QListWidget, drag & drop function does not work properly when an item is dropped at an inappropriate position.
• QTBUG-100181: Seeking is buggy while playing FLAC files in Windows. This software avoids it by adding a 0.5s delay between file opening and playing. In the future, the backend will be changed to FFmpeg to make the software perfectly cross-platform.

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.
• CMake 3.20 or later.
• Other required compilation tools, such as GCC-C++ (for Linux), MSVC (for Windows), and so on.

1. Install those packages required by Qt (e.g. libOpenGL) and Qt Multimedia (e.g. libGStreamer).
2. Install the project's required development package (currently there is only one, i.e. TagLib) in your system.
   • For Red Hat distros (RHEL, CentOS, Fedora, etc.), it may be done by sudo dnf install taglib-devel.
   • For Debian distros (Debian, Ubuntu, etc.), it may be done by sudo apt install libtag1-dev.
3. Use Qt Creator to open the root CMakeLists.txt, then configure the project with latest version of Qt6.
   • If you are using Conan plugin in Qt Creator, you may turn off the plugin or remove the "Conan install" build step in "Projects" tab. Conan is not intended to be used in Linux.
4. Build.

1. Install Conan from Qt Maintenance Tool or official website.
2. Turn on Conan plugin in Qt Creator.

3. Open the root CMakeLists.txt by Qt Creator, then configure the project with latest version of Qt6. The first attempt of CMake configuration should be failed due to the lack of Conan-related scripts, but it's OK.
4. Go to "Projects" tab, raise the existing "Conan install" build step to top of the list and add additional argument --profile /replace/it/with/project/root/directory/conan_debug_windows_x64.txt to it.
   • If you are making release build, change the filename to conan_release_windows_x64.txt.

5. Open the root CMakeLists.txt in your editor, comment out the 2 Conan-related lines, and save it by CTRL+S to trigger CMake configuration again.

if(WIN32)
# In Windows, use Conan to setup 3rd party packages
    message(STATUS "[ThousandPlayer] Windows build environment detected.")
    # include(${CMAKE_BINARY_DIR}/conanbuildinfo.cmake)     # <-- COMMENT OUT!              
    # conan_basic_setup()                                   # <-- COMMENT OUT!
    message(STATUS "[ThousandPlayer] Conan packages loaded: ${CONAN_LIBS}")

6. After the end of CMake configuration, the "Build" button with a hammer icon on the bottom left becomes available. Uncomment the 2 lines mentioned above, then you should be able to build it.