构建前需安装 cmake 和 ninja-build，并准备 NDK 28.2.13676358 与 JDK 21；项目依赖打过补丁的 Media3 子模块，克隆时必须加 --recurse-submodules；无法在 Windows 上构建，自定义 Media3 构建脚本仅支持类 Unix 系统
git clone --recurse-submodules <repo>
./gradlew assembleDebug 硬件要求按 README 说明
运行 Android 7.0（API 24）及以上的手机或模拟器；README 未说明 CPU/GPU 或内存要求
Android 本地音乐播放器，界面快、功能克制，只专注把本地音乐放好
一款简洁克制的 Android 本地音乐播放器，基于 ExoPlayer 播放音频，按专辑整理媒体库，适合想要无广告、纯本地听歌体验的用户。
核心能力
- 基于 Media3 ExoPlayer 实现播放
- 支持自动无缝播放（gapless）
- 完整支持 ReplayGain（MP3/FLAC/OGG/OPUS/MP4）
- 统一艺术家与专辑艺术家系统
- 支持 Android Auto 与自适应尺寸小组件
容易踩的坑
内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README
- v4.1.5最新正式版2026-08-04 · 2026-08-04 04:07 UTC
This Patch
What's Fixed
- Fixed playlist edits not persisting between app starts.
What's New
- Design refresh to Material Design Expressive
- Added fast-forward/rewind by tapping the start/end of the playback screen's cover
- This was prioritized by a sponsor, @kalex3!
- Added swipe-to-next/previous by swiping the playback screen's cover
- Redesigned artist, genre, and playlist images with distinct looks
- This was prioritized by a sponsor, @slushspirit!
- Search now allows you to filter between any combination of Songs / Albums / Artists / Genres / Playlists
- New tablet-friendly detail UI
What's Improved
- Auxio can now load 3rd-party SAF folders (ex. RSAF)
- This was prioritized by a sponsor
- Note: Third-party folders are sponsor by Auxio to be more like "SD Cards" internally, so playlist importing may not work well
- Genre subheads are now hidden in the artist view when it is entirely unknown genre
- Auxio's playback notification now shows both shuffle/repeat
- Notification will disappear after inactivity instead of requiring a manual close
- Made taglib parsing more reliable (thanks @lepre-zhang!)
- Featured artists now show up on an album's songs
- Added option to make SAF multithreading configurable to reduce resource use & fix bugs on certain devices
What's Fixed
- Fix playback state seemingly getting stuck if you only skip next/prev without doing anything else
- Fixed taglib crash that happens on some Android 16 devices
- Slightly reduced memory use from music library
- Fixed R128 GAIN values from being incorrectly ignored
- Fixed about screen icons being colored inconsistently
- Try to fix song list loading slow/not at all in Android Auto
- This was prioritized by a sponsor @strongville!
- Readjusted widget dimens so the shortest variant isnt always shown
Dev/Meta
- Android 16 support
- Upgraded ExoPlayer, Taglib
Supporters
These users made one-time donations to support this release!
- @mactxgit - $55!
- @echelon59 - $50!
- Anonymous Sponsor - $25
- @doggodanbus - $25
- Anonymous Sponsor - $20
- Anonymous Sponsor - $20
- Anonymous Sponsor - $19.10
- @Currrupted - $20
- @ H*rnyPrivateGamer - $16
- @Currrupted - $15
- @Johnathing
- @ByteHamster - $10
- @ma4cek - $8
- @Nivisnum - $8
- @drguildo - $8
- @tomty89 - $8
- @westzipfel - $8
- Anonymous Sponsor - $6.75
- @f-russo - $6
- Anonymous Sponsor - $5.62
- Anonymous Sponsor - $5.44
- Anonymous Sponsor - $5.40
- Anonymous Sponsor - $4.24
Get these shoutouts and more by becoming a sponsor!
Checksums
APK Digest (SHA-256):
ec3ec539aaac978283d3512af01ce26276959e75e831666231070ce9eb8a7b72Certificate Hash:
DA:84:E2:53:4C:1A:CC:0B:6E:4F:57:DE:DB:64:0D:4D:C8:93:F5:BF:41:37:A2:E1:EC:BA:87:AD:F8:25:BA:44 - v4.1.42026-07-28 · 2026-07-28 05:23 UTC
查看更新说明
This Patch
What's Fixed
- Fixed notification not showing music information or failing to show correct music information on Android 17
What's New
- Design refresh to Material Design Expressive
- Added fast-forward/rewind by tapping the start/end of the playback screen's cover
- This was prioritized by a sponsor, @kalex3!
- Added swipe-to-next/previous by swiping the playback screen's cover
- Redesigned artist, genre, and playlist images with distinct looks
- This was prioritized by a sponsor, @slushspirit!
- Search now allows you to filter between any combination of Songs / Albums / Artists / Genres / Playlists
- New tablet-friendly detail UI
What's Improved
- Auxio can now load 3rd-party SAF folders (ex. RSAF)
- This was prioritized by a sponsor
- Note: Third-party folders are sponsor by Auxio to be more like "SD Cards" internally, so playlist importing may not work well
- Genre subheads are now hidden in the artist view when it is entirely unknown genre
- Auxio's playback notification now shows both shuffle/repeat
- Notification will disappear after inactivity instead of requiring a manual close
- Made taglib parsing more reliable (thanks @lepre-zhang!)
- Featured artists now show up on an album's songs
- Added option to make SAF multithreading configurable to reduce resource use & fix bugs on certain devices
What's Fixed
- Fix playback state seemingly getting stuck if you only skip next/prev without doing anything else
- Fixed taglib crash that happens on some Android 16 devices
- Slightly reduced memory use from music library
- Fixed R128 GAIN values from being incorrectly ignored
- Fixed about screen icons being colored inconsistently
- Try to fix song list loading slow/not at all in Android Auto
- This was prioritized by a sponsor @strongville!
- Readjusted widget dimens so the shortest variant isnt always shown
Dev/Meta
- Android 16 support
- Upgraded ExoPlayer, Taglib
Supporters
These users made one-time donations to support this release!
- @mactxgit - $55!
- @echelon59 - $50!
- Anonymous Sponsor - $25
- @doggodanbus - $25
- Anonymous Sponsor - $20
- Anonymous Sponsor - $20
- Anonymous Sponsor - $19.10
- @Currrupted - $20
- @ H*rnyPrivateGamer - $16
- @Currrupted - $15
- @Johnathing
- @ByteHamster - $10
- @ma4cek - $8
- @Nivisnum - $8
- @drguildo - $8
- @tomty89 - $8
- @westzipfel - $8
- Anonymous Sponsor - $6.75
- @f-russo - $6
- Anonymous Sponsor - $5.62
- Anonymous Sponsor - $5.44
- Anonymous Sponsor - $5.40
- Anonymous Sponsor - $4.24
Get these shoutouts and more by becoming a sponsor!
Checksums
APK Digest (SHA-256):
3b27f2ec9af5d9ae273ef6c8faecd4d720afbba5a79ab0d67487de6fce085eceCertificate Hash:
DA:84:E2:53:4C:1A:CC:0B:6E:4F:57:DE:DB:64:0D:4D:C8:93:F5:BF:41:37:A2:E1:EC:BA:87:AD:F8:25:BA:44 - v4.1.32026-07-09 · 2026-07-09 05:23 UTC
查看更新说明
Fixed another crash with v4.1.2 related to the improved playback skip animations.
This Patch
What's Fixed
- Stopped crashes on some SystemUIs due to placeholder covers that were too small
- Fixed buttons being much smaller than before on certain device widths
- Alleviated choppiness with the skip next/previous animation
- Not fully unfortunately due to various limitations, still working on it
What's New
- Design refresh to Material Design Expressive
- Added fast-forward/rewind by tapping the start/end of the playback screen's cover
- This was prioritized by a sponsor, @kalex3!
- Added swipe-to-next/previous by swiping the playback screen's cover
- Redesigned artist, genre, and playlist images with distinct looks
- This was prioritized by a sponsor, @slushspirit!
- Search now allows you to filter between any combination of Songs / Albums / Artists / Genres / Playlists
- New tablet-friendly detail UI
What's Improved
- Auxio can now load 3rd-party SAF folders (ex. RSAF)
- This was prioritized by a sponsor
- Note: Third-party folders are sponsor by Auxio to be more like "SD Cards" internally, so playlist importing may not work well
- Genre subheads are now hidden in the artist view when it is entirely unknown genre
- Auxio's playback notification now shows both shuffle/repeat
- Notification will disappear after inactivity instead of requiring a manual close
- Made taglib parsing more reliable (thanks @lepre-zhang!)
- Featured artists now show up on an album's songs
- Added option to make SAF multithreading configurable to reduce resource use & fix bugs on certain devices
What's Fixed
- Fix playback state seemingly getting stuck if you only skip next/prev without doing anything else
- Fixed taglib crash that happens on some Android 16 devices
- Slightly reduced memory use from music library
- Fixed R128 GAIN values from being incorrectly ignored
- Fixed about screen icons being colored inconsistently
- Try to fix song list loading slow/not at all in Android Auto
- This was prioritized by a sponsor @strongville!
- Readjusted widget dimens so the shortest variant isnt always shown
Dev/Meta
- Android 16 support
- Upgraded ExoPlayer, Taglib
Supporters
These users made one-time donations to support this release!
- @mactxgit - $55!
- @echelon59 - $50!
- Anonymous Sponsor - $25
- @doggodanbus - $25
- Anonymous Sponsor - $20
- Anonymous Sponsor - $20
- Anonymous Sponsor - $19.10
- @Currrupted - $20
- @ H*rnyPrivateGamer - $16
- @Currrupted - $15
- @Johnathing
- @ByteHamster - $10
- @ma4cek - $8
- @Nivisnum - $8
- @drguildo - $8
- @tomty89 - $8
- @westzipfel - $8
- Anonymous Sponsor - $6.75
- @f-russo - $6
- Anonymous Sponsor - $5.62
- Anonymous Sponsor - $5.44
- Anonymous Sponsor - $5.40
- Anonymous Sponsor - $4.24
Get these shoutouts and more by becoming a sponsor!
Checksums
APK Digest (SHA-256):
10e5f38085bd7eee337a83bef94b6a2f874982e2a2bb4ed1ac2546a29f870b91Certificate Hash:
DA:84:E2:53:4C:1A:CC:0B:6E:4F:57:DE:DB:64:0D:4D:C8:93:F5:BF:41:37:A2:E1:EC:BA:87:AD:F8:25:BA:44 - v4.1.22026-07-07 · 2026-07-07 05:46 UTC
查看更新说明
Fixed a major crash on v4.1.1, sorry!
This Patch
What's Fixed
- Stopped crashes on some SystemUIs due to placeholder covers that were too small
- Fixed buttons being much smaller than before on certain decide widths
- Alleviated choppiness with the skip next/previous animation
- Not fully unfortunately due to various limitations, still working on it
What's New
- Design refresh to Material Design Expressive
- Added fast-forward/rewind by tapping the start/end of the playback screen's cover
- This was prioritized by a sponsor, @kalex3!
- Added swipe-to-next/previous by swiping the playback screen's cover
- Redesigned artist, genre, and playlist images with distinct looks
- This was prioritized by a sponsor, @slushspirit!
- Search now allows you to filter between any combination of Songs / Albums / Artists / Genres / Playlists
- New tablet-friendly detail UI
What's Improved
- Auxio can now load 3rd-party SAF folders (ex. RSAF)
- This was prioritized by a sponsor
- Note: Third-party folders are sponsor by Auxio to be more like "SD Cards" internally, so playlist importing may not work well
- Genre subheads are now hidden in the artist view when it is entirely unknown genre
- Auxio's playback notification now shows both shuffle/repeat
- Notification will disappear after inactivity instead of requiring a manual close
- Made taglib parsing more reliable (thanks @lepre-zhang!)
- Featured artists now show up on an album's songs
- Added option to make SAF multithreading configurable to reduce resource use & fix bugs on certain devices
What's Fixed
- Fix playback state seemingly getting stuck if you only skip next/prev without doing anything else
- Fixed taglib crash that happens on some Android 16 devices
- Slightly reduced memory use from music library
- Fixed R128 GAIN values from being incorrectly ignored
- Fixed about screen icons being colored inconsistently
- Try to fix song list loading slow/not at all in Android Auto
- This was prioritized by a sponsor @strongville!
- Readjusted widget dimens so the shortest variant isnt always shown
Dev/Meta
- Android 16 support
- Upgraded ExoPlayer, Taglib
Supporters
These users made one-time donations to support this release!
- @mactxgit - $55!
- @echelon59 - $50!
- Anonymous Sponsor - $25
- @doggodanbus - $25
- Anonymous Sponsor - $20
- Anonymous Sponsor - $20
- Anonymous Sponsor - $19.10
- @Currrupted - $20
- @ H*rnyPrivateGamer - $16
- @Currrupted - $15
- @Johnathing
- @ByteHamster - $10
- @ma4cek - $8
- @Nivisnum - $8
- @drguildo - $8
- @tomty89 - $8
- @westzipfel - $8
- Anonymous Sponsor - $6.75
- @f-russo - $6
- Anonymous Sponsor - $5.62
- Anonymous Sponsor - $5.44
- Anonymous Sponsor - $5.40
- Anonymous Sponsor - $4.24
Get these shoutouts and more by becoming a sponsor!
Checksums
APK Digest (SHA-256):
8c455e1f89f2b93b283775a4a4bb11113b110624bc83b196cb0bf7b70a56ff19Certificate Hash:
DA:84:E2:53:4C:1A:CC:0B:6E:4F:57:DE:DB:64:0D:4D:C8:93:F5:BF:41:37:A2:E1:EC:BA:87:AD:F8:25:BA:44 - v4.1.12026-07-07 · 2026-07-07 05:18 UTC
查看更新说明
This Patch
What's Fixed
- Stopped crashes on some SystemUIs due to placeholder covers that were too small
- Fixed buttons being much smaller than before on certain decide widths
- Alleviated choppiness with the skip next/previous animation
- Not fully unfortunately due to various limitations, still working on it
What's New
- Design refresh to Material Design Expressive
- Added fast-forward/rewind by tapping the start/end of the playback screen's cover
- This was prioritized by a sponsor, @kalex3!
- Added swipe-to-next/previous by swiping the playback screen's cover
- Redesigned artist, genre, and playlist images with distinct looks
- This was prioritized by a sponsor, @slushspirit!
- Search now allows you to filter between any combination of Songs / Albums / Artists / Genres / Playlists
- New tablet-friendly detail UI
What's Improved
- Auxio can now load 3rd-party SAF folders (ex. RSAF)
- This was prioritized by a sponsor
- Note: Third-party folders are sponsor by Auxio to be more like "SD Cards" internally, so playlist importing may not work well
- Genre subheads are now hidden in the artist view when it is entirely unknown genre
- Auxio's playback notification now shows both shuffle/repeat
- Notification will disappear after inactivity instead of requiring a manual close
- Made taglib parsing more reliable (thanks @lepre-zhang!)
- Featured artists now show up on an album's songs
- Added option to make SAF multithreading configurable to reduce resource use & fix bugs on certain devices
What's Fixed
- Fix playback state seemingly getting stuck if you only skip next/prev without doing anything else
- Fixed taglib crash that happens on some Android 16 devices
- Slightly reduced memory use from music library
- Fixed R128 GAIN values from being incorrectly ignored
- Fixed about screen icons being colored inconsistently
- Try to fix song list loading slow/not at all in Android Auto
- This was prioritized by a sponsor @strongville!
- Readjusted widget dimens so the shortest variant isnt always shown
Dev/Meta
- Android 16 support
- Upgraded ExoPlayer, Taglib
Supporters
These users made one-time donations to support this release!
- @mactxgit - $55!
- @echelon59 - $50!
- Anonymous Sponsor - $25
- @doggodanbus - $25
- Anonymous Sponsor - $20
- Anonymous Sponsor - $20
- Anonymous Sponsor - $19.10
- @Currrupted - $20
- @ H*rnyPrivateGamer - $16
- @Currrupted - $15
- @Johnathing
- @ByteHamster - $10
- @ma4cek - $8
- @Nivisnum - $8
- @drguildo - $8
- @tomty89 - $8
- @westzipfel - $8
- Anonymous Sponsor - $6.75
- @f-russo - $6
- Anonymous Sponsor - $5.62
- Anonymous Sponsor - $5.44
- Anonymous Sponsor - $5.40
- Anonymous Sponsor - $4.24
Get these shoutouts and more by becoming a sponsor!
Checksums
APK Digest (SHA-256):
0a50b72e7eea952fd8c07766499981796f061a22acb3837846b16e09857a7369Certificate Hash:
DA:84:E2:53:4C:1A:CC:0B:6E:4F:57:DE:DB:64:0D:4D:C8:93:F5:BF:41:37:A2:E1:EC:BA:87:AD:F8:25:BA:44
用户点评
登录用户的真实使用记录，可按版本和硬件筛选共 0 条
还没有人点评。第一个说出真实体验的人最有价值。
About
Auxio is a local music player with a fast, reliable UI/UX without the many useless features present in other music players. Built off of modern media playback libraries, Auxio has superior library support and listening quality compared to other apps that use outdated Android functionality. In short, It plays music.
The default branch is the development version of the repository. For a stable version, see the master branch.
Screenshots
Features
- Playback based on Media3 ExoPlayer
- Snappy UI derived from the latest Material Design guidelines
- Opinionated UX that prioritizes ease of use over edge cases
- Customizable behavior
- Support for disc numbers, multiple artists, release types, precise/original dates, sort tags, and more
- Advanced artist system that unifies artists and album artists
- SD Card-aware folder management
- Reliable playlisting functionality
- Playback state persistence
- Android Auto support
- Automatic gapless playback
- Full ReplayGain support (On MP3, FLAC, OGG, OPUS, and MP4 files)
- External equalizer support (ex. Wavelet)
- Edge-to-edge
- Embedded covers support
- Search functionality
- Headset autoplay
- Stylish widgets that automatically adapt to their size
- Completely private and offline
- No rounded album covers (if you want them)
Permissions
- Storage (
READ_MEDIA_AUDIO,READ_EXTERNAL_STORAGE) to read and play your music files - Services (
FOREGROUND_SERVICE,WAKE_LOCK) to keep the music playing in the background - Notifications (
POST_NOTIFICATION) to indicate ongoing playback and music loading
Donate
You can support Auxio's development through my Github Sponsors page. Get the ability to prioritize features and have your profile added to the README, Release Changelogs, and even the app itself!
Building
Auxio relies on a patched version of Media3 that enables some extra playback features, alongside taglib for metadata parsing. This adds some caveats to the build process:
cmakeandninja-buildmust be installed before building the project.- The project uses submodules, so when cloning initially, use
git clone --recurse-submodulesto properly download the external code. - You are unable to build this project on windows, as the custom Media3 build runs shell scripts that will only work on unix-based systems.
Set up Android Studio
Install Android Studio.
pkg -S android-studio
Configuring Android Studio:
-
Be sure to have NDK tools, version 28.2.13676358. You can search it on Languages & Frameworks > Android SDK.
-
Install Java-21 with your system package manager
sudo pkg -S jdk21-openjdkAdditionally: Set java version to jdk21-openjdk
-
Run ./gradlew assembleDebug
Connecting to your Android Device
You can connect your Mobile Phone through USB to run the app.
-
Enable Developer Options on your phone
- Go to Settings > About phone
- Tap Build number 7 times until you see "You are now a developer!"
-
Enable USB debugging
- Go to Settings > Developer options
- Turn on USB debugging
-
Connect your phone to the computer
- Use a USB cable
- On your phone, accept the Allow USB debugging? prompt
-
Verify that your device is detected
cd ~/Android/Sdk/platform-tools ./adb devices
Android Studio also offers virtual devices that come with this pre-configured.
Install the app on the Android Phone
To install the app on your physical device or emulator, run this command:
./gradlew installDebug
Auxio should now appear in the list of Apps
Load music to Auxio (Optional)
You can move files from your pc to your device / emulator to test the music using this command:
cd ~/Android/Sdk/platform-tools
./adb push ~Music/ /sdcard/Music
Contributing
Auxio accepts most contributions as long as they follow the Contribution Guidelines.
However, feature additions and major UI changes are less likely to be accepted. See Why Are These Features Missing? for more information.
License
Auxio is Free Software: You can use, study share and improve it at your will. Specifically you can redistribute and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
More information can be found here.
lx-music-desktop
lyswhut·TypeScript
基于 Electron 的跨平台桌面音乐播放器，聚合多源在线音乐搜索与播放，界面清爽，适合日常听歌。
音乐播放器+4音乐播放器进阶
55238+1067.1kv2.12.62026-11-10 04:44 UTC
spotube
team-spotube·Kotlin
开源跨平台音乐播放器，桌面和手机都能用，通过 Spotify 和 YouTube 等公开来源获取歌曲，无需付费订阅即可播放。
音乐播放器+4音乐播放器硬核
50712+762.4kv6.0.02026-11-10 08:05 UTC
pear-desktop
pear-devs·TypeScript
基于 Electron 的跨平台桌面音乐播放器，为 YouTube Music 等流媒体服务提供增强扩展，支持 Windows、macOS 和 Linux。
音乐播放器+4音乐播放器进阶
34017+212.0kv3.12.02026-11-08 01:55 UTC
YesPlayMusic
qier222·Vue
基于 Electron 和 Vue 的第三方网易云音乐播放器，界面精致，支持 Windows、macOS、Linux 以及 PWA，让你在桌面端也能获得流畅的在线听歌体验。
网易云音乐+4音乐播放器进阶
33616+194.7kv0.4.112026-10-10 11:05 UTC