Skip to content
Get packs

Guide · Open source

How to use AlgerMusicPlayer: install, run and key features

Updated · written with AI from the project's own documentation and checked against our catalogue data

AlgerMusicPlayer is an open-source music player built with Vue. It includes a separate desktop lyrics window, song downloads, remote playback control and playlist, MV and ranking pages. This guide explains how to install it from source with npm, what the main features do, and the limits described in the project README, so you can decide whether it fits your use.

Alger Music Playeralgerkong/AlgerMusicPlayer · ★ 17.2k · MIT

Quick start

  1. 1Install Node.js and npm. Make sure Node.js and npm are installed on your computer before you download the project.
  2. 2Get the source code. Download or clone the AlgerMusicPlayer repository from its GitHub page and open its folder in a terminal.
  3. 3Install dependencies. Run npm install in the project folder to download the required packages.
  4. 4Start development mode. Run npm run dev to launch the app in development mode.
  5. 5Set up lyrics and shortcuts. Open the cover at the bottom-left for immersive lyrics, then configure shortcuts and the desktop lyrics window in the settings.
  6. 6Read the usage terms. Review the README disclaimer and use the app only for study and exchange, not commercial purposes.

What AlgerMusicPlayer is and who it suits

The README describes AlgerMusicPlayer as a third-party player with a local service, desktop lyrics, music downloads and remote control. The README is written in Chinese, so the in-app and project documentation is mainly in that language.

It fits best for Chinese-speaking users who want a desktop player with a separate lyrics window, people who want to try an open-source player with EQ, speed control and timed playback, and developers who want to read or modify a Vue-based desktop app.

  • Good fit: Chinese-speaking desktop users, people exploring open-source players, Vue developers
  • Not a fit: users who need a licensed, official music service or a mature iOS app
  • Not allowed: commercial use, which the README explicitly prohibits

Install and run AlgerMusicPlayer from source

The README's install path uses a package manager. You need Node.js and npm installed first. Clone or download the project, open a terminal in its folder, then install dependencies and start development mode.

The README also links to a separate Chinese installation and FAQ document on Yuque for more detail. Check that page if you run into setup problems.

  • Prerequisites: Node.js and npm
  • Install dependencies from the project folder
  • Start development mode
npm install npm run dev

Use the main playback features

The player covers standard playback controls plus several extras listed in the README: EQ equalizer, playback speed control, timed playback, and remote playback control. Search covers songs, MVs, albums, playlists and bilibili content.

The README lists playlists, MVs, rankings and daily recommendations, along with play history and a favourites manager for songs.

  • EQ equalizer
  • Playback speed control (倍速播放)
  • Timed playback (定时播放)
  • Remote playback control (远程控制播放)
  • Play history and song favourites
  • Playlists, MVs, albums and rankings
  • Light and dark theme, mini mode, multi-language support

Show lyrics on screen or in a desktop window

Immersive lyrics open when you click the cover in the bottom-left corner of the player. The README also lists a separate desktop lyrics window, which runs apart from the main player window.

Screenshots in the README include a desktop lyrics view and a remote control view, so you can see both in the project repository.

  • Immersive lyrics: click the cover at the bottom-left
  • Desktop lyrics: separate window

Download music and configure shortcuts

The README lists music file download as a feature. It also says you can set custom keyboard shortcuts, either global (system-wide) or only inside the app.

Music sources are described as parsed by @unblockneteasemusic/server, and you can choose the source parser for an individual song. The README says the service is built on netease-cloud-music-api and does not require a third-party online API.

  • Download music files
  • Custom shortcuts, global or in-app
  • Per-song source parsing

Know the licence and usage limits

The project is released under the MIT licence, according to the directory data. The README, however, says the software is for study and exchange only, prohibits commercial use, and asks users to support official music services.

Read the disclaimer before using it. Its music sources depend on third-party components, so the README's terms matter more than the licence label alone.

  • Licence: MIT (per the project listing)
  • README: study and exchange only, no commercial use
  • README asks users to support official, licensed music

What people use it for

  • Listening to music on a desktop with a separate lyrics window
  • Trying EQ, playback speed and timed playback in an open-source player
  • Controlling playback remotely through the built-in remote control feature
  • Studying or modifying a Vue-based desktop music app
  • Comparing open-source music players such as Cider, YesPlayMusic or Lx Music Desktop

Frequently asked questions

Is AlgerMusicPlayer free?

The project is listed under the MIT licence. The README, however, limits use to study and exchange and prohibits commercial use, so read its disclaimer before relying on it.

What do I need to run AlgerMusicPlayer?

The README's install steps require Node.js and npm. You install dependencies with npm install, then start the app with npm run dev.

Does AlgerMusicPlayer run on iPhone?

The README lists iOS as a later goal, so it does not offer a mature iOS app. Android is marked as testing. Desktop and web are the main supported platforms.

Can AlgerMusicPlayer download songs?

Yes, the README lists music file download as a feature. Check the project's documentation for details on how it works.

What are alternatives to AlgerMusicPlayer?

Comparable open-source projects named in the directory are Cider, YesPlayMusic and Lx Music Desktop. Compare them on platform support, lyrics features and licence terms.

Why does the README mention @unblockneteasemusic/server?

The README says music resource parsing is based on @unblockneteasemusic/server, and the service is built on netease-cloud-music-api. These third-party components are what supply the music sources.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

AlgerMusicPlayer suits Chinese-speaking desktop users, people who want to test an open-source player with EQ and timed playback, and developers who want a Vue codebase to study. It is a poor choice if you need an official licensed service, a mature iOS app, or any commercial use.

Install options & downloads