About Elysia

关于 Elysia

A lightweight front end for Apple Music on macOS. Elysia does not play audio itself: it drives the Music app, so your library, playlists and playback state stay exactly where they are.

macOS 上 Apple Music 的轻量前端。Elysia 本身不播放音频，而是驱动「音乐」App，因此你的资料库、播放列表和播放状态都保持在原处，不会有任何改动。

Why Elysia?

为什么选择 Elysia？

• A cleaner window. Album artwork fills the left of every song row, so tracks are easier to pick out. The seldom-used sidebar sections (Radio, iTunes) and the status columns (Genre, Rating, Plays) are gone.
• A tidier layout. The artist sits under the song title, in grey and a smaller size. The playing song's artwork is outlined in red and its text turns bold red, with the progress and volume sliders in red as well, so it is obvious at a glance.
• What Apple Music does not do. Drag songs to change their order, and restore the default order in one click.

• 迎来清爽页面。用专辑封面填充歌曲卡片左侧，提高识别效率；去掉了「广播」「iTunes」等不常用的侧边栏目，以及「类型」「评分」「播放次数」等状态栏。
• 优化界面结构。将「艺人」移至歌曲下方，并改为灰色、更小的字体，兼顾阅读与美观；正在播放的歌曲封面边框变为红色、字体变为加粗红色，进度条和音量条同样为红色，一眼就能辨认。
• Apple Music 没有的功能。拖动歌曲即可调节顺序，并可以一键恢复默认排序。

Comparison

对比图片

Elysia

Elysia

Apple Music

Apple Music

Install

安装

1. Download Elysia-1.0.8.dmg from the Download Page(Click to open) or the releases page.
2. Open the DMG and drag Elysia onto the Applications shortcut.
3. Launch Elysia and allow it to control Music when macOS asks.

1. 从下载页面（点击跳转）或 Releases 页面下载 Elysia-1.0.8.dmg。
2. 打开 DMG，把 Elysia 拖到 Applications 快捷方式上。
3. 启动 Elysia，macOS 询问时允许它控制「音乐」。

The released builds are signed but not notarized, which needs a paid Apple Developer account. If macOS reports an unidentified developer, either right-click Elysia in Applications and choose Open, or clear the quarantine flag:

发布的版本已签名，但未公证（公证需要付费的 Apple 开发者账号）。如果 macOS 提示「无法验证开发者」，可在「应用程序」中右键 Elysia 选择打开，或清除下载隔离标记：

$ xattr -dr com.apple.quarantine /Applications/Elysia.app

Usage

使用方法

• Play / pause — double-click a song, press Space, or use the play/pause button.
• Reorder songs — drag a song between the two songs you want it to sit between, then let go.
• Change the repeat mode — use the playback-mode button at the top (off / repeat all / repeat one).
• Change the language or restore the default order — open Settings in the sidebar.

On first install, or after an update, the song list may not be recognized. Refresh it in Settings → Library. If that still does not work, quit Apple Music and repeat the step above.

• 播放 / 暂停 —— 双击歌曲、按空格键，或点击播放/暂停按钮。
• 调整歌单顺序 —— 拖动歌曲到你想插入的两首歌之间，然后松开。
• 切换播放模式 —— 点击顶部的播放模式按钮（无 / 列表循环 / 单曲循环）。
• 调整语言或恢复默认排序 —— 点击左侧边栏的设置。

首次安装/更新可能无法识别歌单。请在设置→曲库中刷新歌单。若仍然失败，请尝试退出 Apple Music 后重新执行上述操作。

Requirements

系统要求

macOS Ventura (13) and above

macOS Ventura (13) 或更高版本

Apple Music with a library. Elysia drives the Music app rather than playing audio itself.

已建立资料库的 Apple Music。Elysia 只是驱动「音乐」App，本身不播放音频。

Build From Source

从源码构建

The Xcode project is generated from project.yml with XcodeGen, so it is disposable:

Xcode 工程由 XcodeGen 依据 project.yml 生成，因此是可以随时丢弃的产物：

$ xcodegen generate
$ open Elysia.xcodeproj

To build a signed, universal (arm64 + x86_64) DMG into dmg/:

要在 dmg/ 下生成已签名、兼容 Intel 的通用版 DMG：

$ Scripts/package-dmg.sh

$ Scripts/elysiadmgrun              # newest image in dmg/
$ Scripts/elysiadmgrun path.dmg     # a specific image
$ Scripts/elysiadmgrun --eject      # eject it again

$ ln -s "$PWD/Scripts/elysiadmgrun" ~/.local/bin/elysiadmgrun

$ Scripts/elysiadmgrun              # dmg/ 下最新的镜像
$ Scripts/elysiadmgrun path.dmg     # 指定镜像
$ Scripts/elysiadmgrun --eject      # 卸载

$ ln -s "$PWD/Scripts/elysiadmgrun" ~/.local/bin/elysiadmgrun

License

许可

Elysia is released under the MIT License. See LICENSE for the full text.

Elysia 以 MIT 许可发布，完整条款见 LICENSE。