world.execute-me-ascii README

The project's README from github.com/yym8224961/world.execute-me-ascii. As one markdown file: README.md.

world.execute(me); —ascii

world.execute(me);

Mili《world.execute(me);》的字符动画。支持中英字幕、原曲同步播放和终端字符动画。

单文件运行(推荐)

从本仓库的 Releases 下载 world-execute-mv-macos.zip 并解压。音乐、动画、字幕、频谱数据和音频播放组件已经内嵌在 world-execute-mv.pyz 内,无需另外下载或指定 MP3。

需要 macOS 12 或更新版本、Python 3.9 或更新版本。音频组件同时包含 Apple Silicon 和 Intel 架构。终端播放器自身只使用 Python 标准库。

在 macOS「终端」中进入解压目录运行:

python3 world-execute-mv.pyz

也可双击 运行单文件.command,在系统终端中播放。按空格开始。推荐全屏,终端至少 64 列 × 24 行,128 列 × 44 行及以上效果更好。

# 从 2:38.7 开始直接播放
python3 world-execute-mv.pyz --start 158.7 --autoplay

内嵌音乐是随程序封装的资源,不是加密或 DRM。播放时会解包到当前用户的临时目录,正常退出后清理;不会读取旧电脑 Downloads 中的文件。运行过程无需联网。

操作

按键 功能
空格 开始/暂停
左/右 后退/前进 5 秒
R 从头播放
Q 退出
H 显示全部帮助
1–5 跳转章节

从源码运行

仓库不保存音频文件。从源码运行或重新打包前,请将自己的音频放到本地 media/song.mp3。使用 Release 播放包无需此步骤。

首次构建音频组件需要 Apple Command Line Tools(含 Swift 编译器):

xcode-select --install

然后执行:

./run.sh

启动脚本在缺少 audio-clock 时自动编译本机架构。双击 播放MV.command 可在 macOS 系统终端中运行源码版。

重新打包

python3 tools/build_bundle.py
python3 tests/test_bundle.py

构建输出在 dist/:

音频以 macOS 音频时钟驱动画面;暂停、跳转时字幕与动画跟随音频时间。构建会生成 universal 音频组件,并在单文件包内记录各资源 SHA-256 以检查完整性。

收录范围

本仓库为项目归档,包含当前播放器、字幕、频谱和构建工具。音乐仅内嵌于 Release 播放包。

原曲与歌词:Mili《world.execute(me);》。本项目是个人创作与备份,未对原曲、歌词或其他第三方素材授予额外使用许可。

world.execute-me-ascii (yym8224961/world.execute-me-ascii)

Searching Database…

这是什么?一个在终端里播放 ASCII 动画音乐视频的播放器,对应 Mili 的歌曲《world.execute(me);》,配有与原曲同步的中英双语字幕。
这是一个完整应用,还是我在终端里运行的脚本?它是一个打包好的单一文件(.pyz),把音乐、动画、字幕和音频播放器都打在一起,在 macOS 终端里运行。
怎么让播放器跑起来?从这个仓库的 Releases 下载 world-execute-mv-macos.zip,解压后在终端运行或双击 运行单文件.command,然后按空格键开始。
使用它需要安装什么?macOS 12 或更新版本,以及 Python 3.9 或更新版本;自带的音频组件同时覆盖 Apple Silicon 和 Intel,终端播放器本身只依赖 Python 标准库。
需要特定的终端尺寸才能显示正常吗?建议全屏,终端至少 64x24 列,想要最佳视觉效果最好 128x44 或更大。
Windows 或 Linux 上也能用吗?不能,它是专门为 macOS 12+ 构建的;没有提到 Windows 或 Linux 版本。
播放需要联网吗?不需要,一切都在本地运行,播放期间无需联网;正常退出时会清理临时文件。
播放器支持哪些键盘控制?空格键切换播放/暂停,左右方向键后退/前进 5 秒,R 从头重新开始,Q 退出,H 显示完整帮助,数字键 1-5 跳转到指定章节。
没有单独的 MP3 文件,音乐是怎么嵌入的?歌曲、动画、字幕和频谱数据全部打包在单一的 world-execute-mv.pyz 文件里。启动时解压到用户的临时目录,退出时清理——这只是普通的嵌入,不是 DRM。
这个仓库里实际有什么?和 Release 下载有什么区别?仓库是一个存档快照,包含播放器代码、字幕、频谱数据和构建工具,但真正的音乐音频只随打包好的 Release zip 提供,不在源码树里。
Creator
yym8224961
Size
6.1 MB
Stars
327
Age
21d
Commits · 90 Days