amll-dev/amll-player

Repo for standalone AMLL Player

118

stars

1,092

commits

TypeScript

primary language

Aug 5, 2026

updated

amll-dev.github.io/amll-player/

README

AMLL Player

English / 简体中文

An independent lyrics page player that obtains audio playback information through local music files/WebSocket Server.

List of functions/features:

  • Communicate with any client that implements the AMLL WS Protocol, synchronize the progress of the playback information, and get the corresponding lyrics for playback display
  • Support reading local audio files for playback, or loading local lyrics files
  • Support loading various lyric formats
  • High performance – no software issues that affect the display of lyrics
  • Expected support for playback state transfer protocols:SMTC (Windows) / MPRIS (Linux/XDG) / MPNowPlayingInfoCenter (macOS)

Install and use

Since the player is still compatible, the development build can only be downloaded through Github Action, and the official version will be released in the future.

Why is there this?

The lyrics player is equivalent to software like external subtitles, and the lyrics are played in an environment independent of the plug-in environment.

After the author's performance test, it is found that embedding it in the form of a plug-in on the playback page will cause frame drops and uncertain stuttering due to the browser framework problems of the plug-in running environment.

Therefore, the author decided to separate the playback page into a separate desktop program to improve the playback performance and effect, while the original plug-in was responsible for transmitting the playback information and status to the lyric player.

So if you also have a little stuttering, you can try using this lyric player, and the performance should be improved.

Building the AMLL Player desktop application

cd packages/player
pnpm tauri build          # Production build
pnpm tauri dev            # Development mode

Acknowledgements

Special Thanks

Thanks to JetBrains for their development tools that provide great support to the AMLL project

Contributors

Steve-xmh

716 commits

apoint123

241 commits

Eplorr

48 commits

ITManCHINA

26 commits

amll-dev/amll-player

Repo for standalone AMLL Player

118

stars

1,092

commits

TypeScript

primary language

Aug 5, 2026

updated

amll-dev.github.io/amll-player/

README

AMLL Player

English / 简体中文

An independent lyrics page player that obtains audio playback information through local music files/WebSocket Server.

List of functions/features:

  • Communicate with any client that implements the AMLL WS Protocol, synchronize the progress of the playback information, and get the corresponding lyrics for playback display
  • Support reading local audio files for playback, or loading local lyrics files
  • Support loading various lyric formats
  • High performance – no software issues that affect the display of lyrics
  • Expected support for playback state transfer protocols:SMTC (Windows) / MPRIS (Linux/XDG) / MPNowPlayingInfoCenter (macOS)

Install and use

Since the player is still compatible, the development build can only be downloaded through Github Action, and the official version will be released in the future.

Why is there this?

The lyrics player is equivalent to software like external subtitles, and the lyrics are played in an environment independent of the plug-in environment.

After the author's performance test, it is found that embedding it in the form of a plug-in on the playback page will cause frame drops and uncertain stuttering due to the browser framework problems of the plug-in running environment.

Therefore, the author decided to separate the playback page into a separate desktop program to improve the playback performance and effect, while the original plug-in was responsible for transmitting the playback information and status to the lyric player.

So if you also have a little stuttering, you can try using this lyric player, and the performance should be improved.

Building the AMLL Player desktop application

cd packages/player
pnpm tauri build          # Production build
pnpm tauri dev            # Development mode

Acknowledgements

Special Thanks

Thanks to JetBrains for their development tools that provide great support to the AMLL project

Contributors

Steve-xmh

716 commits

apoint123

241 commits

Eplorr

48 commits

ITManCHINA

26 commits

Languages

TypeScript

52.3%

Rust

39.5%

HTML

4.2%

CSS

2.6%

Kotlin

1.1%