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);» с двуязычными китайско-английскими субтитрами, синхронизированными с оригинальной дорожкой.
Это полноценное приложение или просто скрипт, который я запускаю в Terminal?Это один упакованный файл (.pyz), который объединяет музыку, анимацию, субтитры и аудиопроигрыватель; запускается он в macOS Terminal.
Как запустить проигрыватель?Скачайте world-execute-mv-macos.zip из Releases этого репозитория, распакуйте, затем запустите из Terminal или двойным щелчком по 运行单文件.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?Репозиторий — это архивный снимок с кодом проигрывателя, субтитрами, данными спектра и инструментами сборки, но сама аудиодорожка песни поставляется только внутри zip из Releases, а не в исходном дереве.
Creator
yym8224961
Size
6.1 MB
Stars
332
Age
22d
Commits · 90 Days