如何制作属于自己的ASCII电影?ascii-movie文件格式全解析与实战教程

原创2026-11-13 14:43:561,394 阅读

如何制作属于自己的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
     ..........          @@@@@    @@@@@.........
      .........         @     @  @     @.........

解读:

  1. 第一行 6:第一帧停留 6 个时间单位,其后是 12 行画面;
  2. 下一行 1:第二帧停留 1 个时间单位,画面从下一行开始;
  3. 如此循环,直到文件结束。

⏱️ 帧时长:单位是 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 点:

  1. 文件扩展名必须是 .txt 或 .txt.gz;
  2. 帧头行必须整行是数字(哪怕画面里出现 123,只要不是单独一行就不冲突);
  3. 帧头单位是 1/15 秒,别误当成秒;
  4. 各帧尺寸不需要一致,播放器会自动按最大帧补齐并计算总画幅;
  5. 播放异常时先用 ascii-movie ls 文件名 检查能否成功解析。

更多命令行参数请参考官方命令文档 docs/ascii-movie.md。文件格式简单到"一个记事本就能创作",现在就动手写出你的第一部 ASCII 电影吧!⌨️🍿

登录后查看全文
ascii-movie