Skip to content

Latest commit

 

History

History
225 lines (176 loc) · 12.1 KB

README.md

File metadata and controls

225 lines (176 loc) · 12.1 KB

Video-Compressor-Service

🌱概要

動画圧縮サービス

✨デモ

output

📝説明

このサービスは、動画圧縮サービスです。

サービスの実行には、ターミナルという黒い画面にコマンドを入力します。

このサービスは、動画からオーディオやGIFなど異なるフォーマットを作成したり解像度を変換したい!という場面に使えます。

基本的な機能として、下記のような機能を提供しています。

  • 動画ファイルを圧縮する(圧縮度をlow,medium,highの3段階から選択できます)
  • 動画の解像度を変更する
  • 動画の縦横比を変更する
  • 動画をオーディオに変換する
  • 指定した時間範囲からGIFを作成する

補足

説明で登場する用語について補足します。

用語の意味がわからない時は、下記表を確認してください。

用語 意味
ターミナル コンピュータに対してテキストベースのコマンド入力と出力を行うインターフェースのことです。
このインターフェースは、コマンドラインインターフェース(CLI)とも呼ばれます。
デモで表示されている黒い画面のことです。
コマンド コンピュータに対して特定の操作を実行するよう指示するテキストベースの命令です。
コマンドを入力することで、コンピュータは、コマンドの意味を読み取りアクションをおこします。

🧰前提条件

このサービスを実行するには、下記ソフトウェアを事前にインストールしておく必要があります。

インストールされていない場合は、インストール/使用方法/使用例で記載されているコマンドが実行できませんので

必ずインストールしてから進めてください。

Git

Gitがインストールされていない場合は、下記手順でインストールしてください。

  1. ターミナルを起動する。
    使用するOSによりターミナルの名称が異なりますので注意してください。
    (例. Windows:コマンドプロンプト,mac:ターミナル)

  2. Gitがインストールされているか確認する。
    git version 2.34.1 のように表示された場合は、Gitがインストールされています。
    以降の手順はスキップしてください。
    また、ターミナルは引き続き使用しますので開いたままにしてください!

git --version
  1. システムを更新する
sudo apt-get update
  1. Gitをインストールする
sudo apt install git
  1. Gitがインストールされたことを確認する。
    git version 2.34.1 のように表示されていれば、Gitのインストールは完了です!
git --version

Python 3.x

Pythonの公式サイトからあなたのPCのOSに合わせて、ダウンロードしてください。

ダウンロードしたファイルを使用してインストールできます。

Pythonがインストールされているかは、下記コマンドで確認することができます。

Python 3.10.12のように表示されていれば、Pythonはインストールされています。

python3 --version

FFmpeg

FFmpegは、ビデオおよびオーディオの変換、エンコード、ストリーミングなどの機能を提供しているライブラリです。

Download FFmpegからダウンロードすることもできます。

下記手順でインストールしてください。

  1. FFmpegがインストールされているか確認する。
    ffmpeg version/configurationなどが表示された場合は、FFmpegがインストールされています。
    以降の手順はスキップしてください。
ffmpeg -version
  1. システムを更新する
sudo apt-get update
  1. FFmpegをインストールする
sudo apt install ffmpeg
  1. FFmpegがインストールされたことを確認する。
    ffmpeg version/configurationなどが表示されていれば、FFmpegのインストールは完了です!
ffmpeg -version

エンコーダー

Ubuntuを利用している場合は、MP4ファイルが再生できないことがあります。

その場合は、下記記事を参考にしてエンコーダーをインストールしてください。

Ubuntu 22.04でMP4ファイルが再生できない場合の対処法

🍴インストール

クローン

このサービスをあなたのPCで実行するために、クローンします。

クローンとは、このサービスの実行に必要なファイル(リポジトリのコンテンツ)をあなたのPCのローカル環境へコピーすることです。

下記手順でクローンしてください。

  1. リポジトリをクローンする
git clone https://github.com/Aki158/Video-Compressor-Service.git
  1. クローンしたリポジトリへ移動する
cd Video-Compressor-Service

🚀使用方法

  1. inputとoutputフォルダに入っている不要なファイルを削除する
  2. インプット用の動画を用意してinputフォルダに格納する
  3. 1つ目のターミナル(サーバ用ターミナルとする)を起動する
  4. サーバ用ターミナルに下記コマンドを入力する
python3 server.py
  1. 2つ目のターミナル(クライアント用ターミナルとする)を起動する
  2. クライアント用ターミナルに下記コマンドを入力する
python3 client.py
  1. Type in a file to upload: と表示されたら、Inputのパスを入力する
    推奨 : inputフォルダのファイルパス
  2. 下記指示が表示されたら、利用したい機能を0から4の中から選択して入力する
    Please enter a number from 0 to 4
    0 : 動画ファイルを圧縮する
    1 : 動画の解像度を変更する
    2 : 動画の縦横比を変更する
    3 : 動画をオーディオに変換する
    4 : 時間範囲からGIFを作成する
  3. その後、追加で指示が表示されたら、指示に従い入力する
  4. サーバ用ターミナルが動き出したら、クライアント用ターミナルにFile generated.と表示されるまで待つ
  5. Do you want to continue ?と表示されたら、サービスを続けるか選択する(0 : 終了する/1 : 続ける)
  6. outputフォルダにダウンロードされた動画を確認する

🙋使用例

一通りの手順のイメージはデモを参考にしてください。

  1. inputとoutputフォルダに入っている不要なファイルを削除する。
    クローンしてきた状態だと、サンプルファイルが残っています。
    今回は、inputフォルダ内のファイルは、以降の手順で使用するのでそのままにして、outputフォルダのファイルをすべて削除しました。
  2. インプット用の動画を用意してinputフォルダに格納する。
    今回は、既にinputフォルダに入っているサンプルファイルを使用するので格納はしません。
  3. 1つ目のターミナル(サーバ用ターミナルとする)を起動する
  4. サーバ用ターミナルに下記コマンドを入力する
python3 server.py
  1. 2つ目のターミナル(クライアント用ターミナルとする)を起動する
  2. クライアント用ターミナルに下記コマンドを入力する
python3 client.py
  1. Type in a file to upload: と表示されたら、Inputのパスを入力する
    推奨 : inputフォルダのファイルパス
    inputフォルダに入っているinput.mp4を使用したいので、input/input.mp4と入力します。
  2. 下記指示が表示されたら、利用したい機能を0から4の中から選択して入力する
    Please enter a number from 0 to 4
    0 : 動画ファイルを圧縮する
    1 : 動画の解像度を変更する
    2 : 動画の縦横比を変更する
    3 : 動画をオーディオに変換する
    4 : 時間範囲からGIFを作成する
    動画をオーディオに変換したいので3を入力します。
  3. その後、追加で指示が表示されたら、指示に従い入力する。
    手順8.で3を入力した場合、追加の指示がなかったので、スキップします。
  4. サーバ用ターミナルが動き出したら、クライアント用ターミナルにFile generated.と表示されるまで待つ。
  5. Do you want to continue ?と表示されたら、サービスを続けるか選択する(0 : 終了する/1 : 続ける)。
    終了したいので、0を入力します。
  6. outputフォルダにダウンロードされた動画を確認する。
    outputフォルダにoutput_audio.mp3というファイルが入っていることを確認できました。

💾使用技術

カテゴリ 技術スタック
開発言語 Python
インフラ Ubuntu
VirtualBox
その他 Git
Github
FFmpeg

👀機能一覧

image

機能 内容
メッセージの表示 サービスの進行に必要なメッセージを表示します。
サーバへのファイルアップロード ユーザーが入力したパスを読み取ります。
ファイルが問題なければ、サーバへファイルをアップロードします。
下記のような場合には、ファイルのアップロードが出来ずメッセージを表示します。
・ファイルサイズが4GBを超える場合:File must be below 4GB.
・ファイルの拡張子がmp4でない場合:File extension must be mp4.
サービスに必要な入力の要求 サービスを利用する際は、いくつかの指示が表示されます。
利用するサービスによって指示は異なります。
サービスに必要な入力が完了すると、そのデータをサーバへ送信します。
サービスの実行 サーバは、クライアントからサービスに必要なデータを受信すると、サービスを実行します。
サービスは、FFmpegライブラリと実行に必要なデータを利用して実現させています。
サービスの実行が完了するとoutputフォルダに動画がダウンロードされます。
その後、サーバは、サービスの完了メッセージをクライアントへ送信します。
サービスを続けるかの確認 サービスを続けるか確認します。
続ける場合は、アップロードされたファイルをそのまま使用し、サービスに必要な入力の要求を行います。
サーバへアップロードしたファイルの削除 サービスを続けるかの確認で終了するを選択した場合、クライアントは、終了通知をサーバへ送信します。
サーバは、終了通知を受け取るとアップロードファイルされていたファイルを削除します。

📮今後の実装したいもの

  • デスクトップアプリケーションとして利用できるようにする

📑参考文献

公式ドキュメント

参考にしたサイト