インストール方法

実行ファイルで入れる

最新版は v0.1.0 です。

すべての配布物は GitHub Releases に置いてあります。Intel の Mac をお使いの場合はソースからどうぞ。

Windows

1. zip を展開します。
2. 展開したフォルダを、たとえば C:\Tools\movo に置きます。
3. そのフォルダを環境変数 Path に足すと、どこからでも movo と打てます。

# PowerShell（今のセッションだけ通す）
> $env:Path += ";C:\Tools\movo"
> movo --version

macOS / Linux

$ tar xzf movo-0.1.0-macos-arm64.tar.gz
$ sudo mv movo /usr/local/bin/movo        # PATH の通った場所へ
$ movo --version
0.1.0

sudo を使いたくない場合は ~/.local/bin などに置いて、 そのパスを PATH に足してください。

初回の起動を許可する

配布物にはコード署名を付けていません。そのため OS が初回だけ確認を出します。 次の操作で通せます。ハッシュの照合を先に済ませておくと確実です。

Windows

「WindowsによってPCが保護されました」と出たら、 「詳細情報」を押して「実行」を選びます。

macOS

「開発元を検証できません」と出たら、 システム設定 > プライバシーとセキュリティを開き、 下のほうに出る 「このまま許可」を押してから、もう一度実行します。 ターミナルからなら次の 1 行でも通ります。

$ xattr -d com.apple.quarantine /usr/local/bin/movo

ハッシュを照合する

リリースには SHA256SUMS.txt が付いています。ダウンロードしたファイルが配布物と同一かを確認できます。

macOS / Linux

$ curl -LO https://github.com/hashito/Movo-py/releases/download/v0.1.0/SHA256SUMS.txt
$ shasum -a 256 -c SHA256SUMS.txt --ignore-missing
movo-0.1.0-macos-arm64.tar.gz: OK

Linux では sha256sum -c SHA256SUMS.txt --ignore-missing でも同じです。

Windows（PowerShell）

> Get-FileHash .\movo-0.1.0-windows-x64.zip -Algorithm SHA256

# 出た Hash を SHA256SUMS.txt の該当行と見くらべます
> Select-String -Path .\SHA256SUMS.txt -Pattern "windows-x64"

値が一致すれば、そのファイルはリリースされたものと同一です。

ソースから入れる

Python 3.11 以上があれば入ります。 Intel の Mac、その他の CPU、実行ファイルを置きたくない環境ではこちらをどうぞ。 実行時の依存は NumPy と Numba の 2 つだけです。

$ git clone https://github.com/hashito/Movo-py.git
$ cd Movo-py
$ python3.11 -m venv .venv
$ source .venv/bin/activate          # Windows は .venv\Scripts\activate
$ pip install -e .
$ movo --version
0.1.0

テストや実行ファイルのビルドまでやるなら pip install -e ".[dev]" です （pytest と PyInstaller が入ります）。

ffmpeg を用意する

動画のフレームは Movo が自前で描きます。それを mp4 / webm / mov に繋ぐところで ffmpeg を使います。 GIF と連番画像（PNG）はそのまま書き出せるので、まず動かしてみるだけなら後回しでかまいません。

Movo に用意させる

$ movo setup-ffmpeg
  取得先 : https://github.com/BtbN/FFmpeg-Builds/...
  置き場 : ~/.movo/bin/ffmpeg
  取得しますか？ [y/N] y
  → 使えます: ffmpeg version n7.1

取得先とサイズを見せてから聞きます。MOVO_SETUP_YES=1 でも確認を飛ばせます。 ffmpeg は Movo 本体（MIT）とは別のプログラムとして、別ファイルで ~/.movo/bin に置かれます。

自分で入れる

# Windows
> winget install Gyan.FFmpeg

# macOS
$ brew install ffmpeg

# Ubuntu / Debian
$ sudo apt install ffmpeg

PATH にあれば Movo が見つけます。~/.movo/bin に置いたものも同じように使われます。

動くことを確かめる

movo doctor が、Python・OS・CPU・メモリ・ffmpeg・フォント・NumPy / Numba を まとめて見ます。

$ movo doctor
movo 0.1.0（Python 版）

  v Python         3.11.6
  v OS             macOS (arm64)
  v CPU / メモリ    8 コア / 16 GB
  v NumPy          2.2.6
  v Numba          0.61.2
  v ffmpeg         ffmpeg
  v ffprobe        利用可能
  v フォント        371 個 / 既定 Arial Unicode MS

OK 問題は見つかりませんでした。

そのまま 1 本作ってみます。

$ movo init my-video
$ cd my-video
$ movo validate movo.json
$ movo render movo.json -f gif -o out.gif   # ffmpeg 無しでも出ます

次はマニュアルへどうぞ。JSON の書き方、スキル、作風の測り方があります。