如何制作属于自己的ASCII电影?ascii-movie文件格式全解析与实战教程
如何制作属于自己的ASCII电影?ascii-movie文件格式全解析与实战教程
ascii-movie 是一个用 Go 语言编写的终端 ASCII 电影播放器,能把纯文本"字符动画"流式推送到 SSH / Telnet 客户端,让你在任意终端里放映《星球大战》开场字幕这类经典 ASCII 电影。本文带你彻底搞懂它的 .txt 电影文件格式,并从零制作、播放、分享一部属于自己的 ASCII 电影——无需任何视频软件,会写文本就够了。
🎬 一、什么是 ASCII 电影?
所谓 ASCII 电影,就是用 @、#、. 等字符拼出画面,靠"一帧一帧快速切换"产生动画效果。ascii-movie 项目内置了 3 部可直接播放的电影:
| 内置电影 | 大小 | 说明 |
|---|---|---|
| movies/sw1.txt | 约 2 MB | 默认电影:Star Wars 开场动画 |
| movies/rick_roll.txt | 约 95 KB | Rick Astley 名场面 |
| movies/short_intro.txt | 约 34 KB | 短开场片段,适合学习文件格式 |
一条命令就能在本地终端放映:
docker run --rm -it ghcr.io/gabe565/ascii-movie play
💡 不想装 Docker 也可以从源码构建,仓库地址:
git clone https://gitcode.com/gh_mirrors/as/ascii-movie
📄 二、文件格式全解析:.txt 就是"帧头 + 画面"
这是全文最核心的部分。ascii-movie 的电影文件本质上就是一个纯文本文件(扩展名 .txt 或 .txt.gz),没有任何二进制头。核心规则只有一条:
一行纯数字 = 帧头,帧头之后的若干行 = 这一帧的画面,直到遇到下一个纯数字行。
拿 movies/short_intro.txt 的开头来看:
6
1
.......... @@@@@ @@@@@.......
......... @ @ @ @.......
........ @@@ @ @........
1
.......... @@@@@ @@@@@.........
......... @ @ @ @.........
解读:
- 第一行
6:第一帧停留 6 个时间单位,其后是 12 行画面; - 下一行
1:第二帧停留 1 个时间单位,画面从下一行开始; - 如此循环,直到文件结束。
⏱️ 帧时长:单位是 1/15 秒
帧头数字并不是秒,而是 1/15 秒(源自 internal/movie/file.go 中的解析逻辑):
| 帧头数字 | 实际停留时长 | 用途建议 |
|---|---|---|
1 |
1/15 秒 ≈ 0.067 秒 | 快速滚动、逐帧动画 |
6 |
0.4 秒 | 字幕定格、普通镜头 |
15 |
1 秒 | 关键画面停留 |
解析器对每一帧只做三件事(见 internal/movie/frame.go):记录时长 Duration、画面内容 Data、进度条 Progress。其中进度条是播放器自动生成的,所以你的源文件里完全不用管它。
🗜️ 压缩版:.txt.gz
同一个文件用 gzip 压缩后,改名为 xxx.txt.gz 即可被识别(判断逻辑见 internal/util/filepath.go)。加载时会自动透明解压(见 internal/movie/load.go)。Star Wars 这类大电影用 .gz 可以显著减小体积。
gzip -k sw1.txt # 生成 sw1.txt.gz,原文件保留
🎥 三、实战:制作你的第一部 ASCII 电影
第 1 步:新建一个 .txt 文件
新建 my-movie.txt,内容如下(一帧慢、一帧快,形成"闪烁"效果):
2
@@@@@@
@ @
1
@@@@@@
@ @
第 2 步:本地播放验证
ascii-movie play my-movie.txt
常用参数(详见 docs/ascii-movie_play.md):
--speed 2:2 倍速播放,数值必须大于 0;--no-controls:隐藏全部 UI 控件,还原最原汁原味的放映体验。
第 3 步:用 ls 查看影片元数据
ls 子命令(docs/ascii-movie_ls.md)会解析文件并输出时长、帧数、大小,是检查自己作品最好的"体检工具":
ascii-movie ls ./my-movie.txt
不带参数运行 ascii-movie ls 则列出所有内置电影。
🚀 四、把电影发到网上:serve 子命令
放映给自己看只是开始,ascii-movie 的灵魂是把电影通过 SSH / Telnet 服务端放映(docs/ascii-movie_serve.md):
docker run --rm -p 22:22 -p 23:23 ghcr.io/gabe565/ascii-movie serve
默认在 23 端口启动 Telnet 服务、2222 端口启动 SSH 服务。然后任何一台能连上你的机器的终端执行:
telnet 你的服务器IP
对方屏幕上就会自动开始放映——这正是当年 towel.blinkenlights.nl 的复古体验。想播放自定义电影,直接在 serve 后带上文件名即可(源码见 cmd/serve/cmd.go)。
✅ 五、快速自查清单
制作一部合格的 ASCII 电影,记住这 5 点:
- 文件扩展名必须是
.txt或.txt.gz; - 帧头行必须整行是数字(哪怕画面里出现
123,只要不是单独一行就不冲突); - 帧头单位是 1/15 秒,别误当成秒;
- 各帧尺寸不需要一致,播放器会自动按最大帧补齐并计算总画幅;
- 播放异常时先用
ascii-movie ls 文件名检查能否成功解析。
更多命令行参数请参考官方命令文档 docs/ascii-movie.md。文件格式简单到"一个记事本就能创作",现在就动手写出你的第一部 ASCII 电影吧!⌨️🍿