Skip to content

beginner_setup.md

Latest commit

 

History

History
211 lines (127 loc) · 6.52 KB

beginner_setup.md

File metadata and controls

211 lines (127 loc) · 6.52 KB

セットアップガイド：Python のインストールから実行まで

Note: These documents are written in Japanese.

このガイドは「ターミナルをほぼ使ったことがない」方向けです。 Mac と Windows それぞれの手順を説明します。

Mac の場合

1. ターミナルを開く

Cmd + スペース で Spotlight 検索を開き、「ターミナル」と入力して Enter。

黒い（または白い）ウィンドウが開きます。これがターミナルです。

2. Homebrew をインストールする

Homebrew は Mac 用のパッケージマネージャーです。「ソフトウェアをコマンドで簡単にインストールできる仕組み」だと思ってください。

ターミナルに以下をそのまま貼り付けて Enter：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

途中でパスワードを求められます。Mac のログインパスワードを入力してください（入力中は何も表示されませんが、打てています）。

インストールが終わると「Installation successful!」のような表示が出ます。

Apple Silicon Mac（M1/M2/M3/M4）の場合： インストール後に以下のような指示が表示されることがあります：

Run these two commands in your terminal to add Homebrew to your PATH:

その下に表示されている2行のコマンドをそのまま実行してください。これをやらないと次のステップでエラーになります。

3. Python をインストールする

brew install python3

しばらく待つとインストールが完了します。

4. インストールの確認

python3 --version

Python 3.x.x のような表示が出れば成功です。

5. 仮想環境を作る

仮想環境とは「このプロジェクト専用の Python 環境」のことです。他のプロジェクトとライブラリが混ざらないようにするために作ります。

python3 -m venv ~/mp3tag-env

6. 仮想環境を有効にする

source ~/mp3tag-env/bin/activate

ターミナルの行頭に (mp3tag-env) と表示されれば有効になっています。

重要： ターミナルを閉じると仮想環境が無効になります。次回以降、スクリプトを実行する前に毎回このコマンドを実行してください。

7. mutagen をインストールする

pip install mutagen

8. インストールの確認

python3 -c "import mutagen; print('OK')"

OK と表示されれば完了です。

Windows の場合

1. PowerShell を開く

スタートメニューで「PowerShell」と検索して開きます。

または Win + R → powershell → Enter でも開けます。

2. Python をインストールする

ブラウザで以下のURLを開きます：

https://www.python.org/downloads/

「Download Python 3.x.x」という大きなボタンをクリックしてインストーラをダウンロードします。

ダウンロードしたファイルを実行します。

重要： インストーラの最初の画面で 「Add python.exe to PATH」にチェックを入れてください。デフォルトではチェックが外れています。これを忘れると後のステップでエラーになります。

チェックを入れたら「Install Now」をクリック。

3. PowerShell を再起動する

インストールが完了したら、一度 PowerShell を閉じて開き直します。

4. インストールの確認

python --version

Python 3.x.x のような表示が出れば成功です。

表示されない場合は、インストール時に「Add python.exe to PATH」のチェックを入れ忘れた可能性があります。インストーラを再実行して「Modify」→ PATH の設定を確認してください。

5. 仮想環境を作る

python -m venv $env:USERPROFILE\mp3tag-env

6. 仮想環境を有効にする

$env:USERPROFILE\mp3tag-env\Scripts\Activate.ps1

「このスクリプトの実行が無効になっています」というエラーが出た場合は、以下を実行してから再度試してください：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

仮想環境が有効になると、行頭に (mp3tag-env) と表示されます。

重要： PowerShell を閉じると仮想環境が無効になります。次回以降、スクリプトを実行する前に毎回このコマンドを実行してください。

7. mutagen をインストールする

pip install mutagen

8. インストールの確認

python -c "import mutagen; print('OK')"

OK と表示されれば完了です。

スクリプトの実行

セットアップが完了したら、スクリプトを実行できます。

Mac：

source ~/mp3tag-env/bin/activate
python3 mp3_to_csv.py
python3 csv_to_mp3.py mp3_tags.csv /path/to/your/mp3/folder

Windows：

$env:USERPROFILE\mp3tag-env\Scripts\Activate.ps1
python mp3_to_csv.py
python csv_to_mp3.py mp3_tags.csv C:\path\to\your\mp3\folder

よくあるエラー

command not found: python3（Mac）

Homebrew のインストール後に PATH の設定コマンドを実行し忘れた可能性があります。Homebrew のインストール時に表示された指示を再確認してください。

python は認識されていません（Windows）

インストール時に「Add python.exe to PATH」にチェックを入れ忘れた可能性があります。インストーラを再実行して修正してください。

ModuleNotFoundError: No module named 'mutagen'

仮想環境が有効になっていない状態で実行しています。仮想環境を有効にするコマンドを実行してから再試行してください。

このスクリプトの実行が無効になっています（Windows）

上記「6. 仮想環境を有効にする」の Set-ExecutionPolicy コマンドを実行してください。

困ったら

エラーメッセージをそのままコピーして、AI（ChatGPT、Claude 等）に貼り付けて質問するのが最も早い解決方法です。「Python のセットアップ中に出たエラーです」と一言添えると回答の精度が上がります。

[End of File]