# 视频转字符动画

[![Build Status](https://travis-ci.org/ryan4yin/video2chars.svg?branch=master)](https://travis-ci.org/ryan4yin/video2chars)
[![PYPI Version](https://img.shields.io/pypi/v/video2chars.svg)](https://pypi.org/project/video2chars/)
[![Python 3.6+](https://img.shields.io/pypi/pyversions/video2chars.svg?style=flat)](https://www.python.org/)

这是一个能将视频文件转换成字符动画的命令行工具，使用 pillow + moviepy 实现

## 安装

直接使用 pip 安装 video2chars:
```
# 使用清华镜像源加速下载
pip install video2chars -i https://pypi.tuna.tsinghua.edu.cn/simple
```

如果你使用的是比较老的 pip，安装时你可能需要添加 `--prefer-binary` 选项：

```shell
pip install video2chars --prefer-binary
```

因为本工具依赖 `imageio-ffmpeg`，但只有二进制版本的该依赖内嵌 ffmpeg，如果你从源码安装，很可能会出问题。

## 用法

```
video2chars --width 120 --end 10 path/of/video_file
```
上面的命令表示，将指定路径的视频，转换成宽度为120字符的视频，只转换前十秒。
命令运行完毕后，会在当前目录下生成一个名为 `output.mp4` 的字符视频。

使用 `video2chars --help` 命令，获取更多信息。

>p.s. 注意性能，python 单核跑的，慢也没办法。。默认参数 width=100 fps=8。实在是慢的话，可以尝试调低一下这两个参数。

## 演示

[![【Python】字符动画 - 极乐净土](demostration.png)](https://www.bilibili.com/video/av30469888/)

## 旧版

shell 版 和 html 版 的效果图和代码见 [video2chars - v0.3](https://github.com/yuansuye/video2chars/tree/v0.3)

1. shell 版本演示：
![bad-apple-chars-gif](bad-apple-chars.gif)

2.  html 版本演示：
![bad-apple-html-gif](bad-apple-html.gif)

## 教程

shell 版的教程见[视频转字符动画-Python-60行代码](http://www.cnblogs.com/kirito-c/p/5971988.html)


## 相关项目

- [Video2ASCII.jl(Julia 版)](https://github.com/ryan4yin/Video2ASCII.jl)