🛠️ インストール手順
@@ -136,18 +137,18 @@ ytsage - **DEB (`.deb`)**: ```bash sudo dpkg -i ytsage_*.deb - sudo apt-get install -f # Fix missing dependencies if any + sudo apt-get install -f # 必要に応じて不足している依存関係を修正 ``` - **RPM (`.rpm`)**: ```bash sudo rpm -i ytsage-*.rpm ``` -- **アプリ画像 (`.AppImage`)**: +- **AppImage (`.AppImage`)**: ```bash chmod +x YTSage-*.AppImage ./YTSage-*.AppImage ``` -- **Flatpak**: Flathub の指示に従うか、次のコマンドを実行します。 +- **Flatpak**: Flathub の指示に従うか、以下を実行します： ```bash flatpak install flathub io.github.oop7.ytsage ``` @@ -155,18 +156,18 @@ ytsage #### 🍎 macOS -|フォーマット |説明 | -|----------|---------------| -|  | Apple Silicon 用の ZIP アプリケーション | -|  | Apple Silicon 用のディスク イメージ インストーラー | +| フォーマット | 説明 | +|--------|-------------| +|  | Apple Silicon 用 ZIP アプリ | +|  | Apple Silicon 用ディスクイメージインストーラー |🛠️ インストール手順
-- **DMG インストーラー (`.dmg`)**: ダブルクリックしてマウントし、`YTSage.app` をアプリケーション フォルダーにドラッグします。 -- **アプリ アーカイブ (`.zip`)**: zip を解凍し、`YTSage.app` をアプリケーション フォルダーに移動します。 +- **DMG インストーラー (`.dmg`)**: ダブルクリックしてマウントし、`YTSage.app` をアプリケーションフォルダにドラッグします。 +- **App アーカイブ (`.zip`)**: ZIP を展開し、`YTSage.app` をアプリケーションフォルダに移動します。 -*注意:「アプリが破損しています」エラーが発生した場合は、以下の[macOS troubleshooting section](#troubleshooting)を参照してください。* +*注意: 「アプリが破損しています」というエラーが表示される場合は、以下の macOS トラブルシューティング セクションを参照してください。*💻 ソースからの手動インストール
-### 1. リポジトリのクローンを作成します +### 1. リポジトリをクローンする ```bash git clone https://github.com/oop7/YTSage.git @@ -183,13 +184,13 @@ cd YTSage ### 2. 依存関係をインストールする -#### ⚡ UV あり +#### ⚡ uv を使用する場合 ```bash uv pip install . ``` -#### 📦 または標準の pip を使用 +#### 📦 または標準の pip を使用する場合 ```bash pip install . @@ -203,330 +204,335 @@ python -m ytsage.main |
-  |
+ |
+ |
| ダウンロード設定 | プレイリストダウンロード | ||
 |
-  |
+ |
+ |
| オーディオフォーマット | -カスタム オプション | +カスタムオプション |
🎯 基本的な使い方
-1. **YTSage を起動** -2. **YouTube URL を貼り付け** (または [URL を貼り付け] ボタンを使用) -3. **「分析」をクリックします** -4. **形式を選択します:** - - `Video` ビデオダウンロード用 - - `Audio Only` 音声抽出用 -5. **オプションを選択します:** - - 字幕を有効にし、言語を選択します - - 字幕のマージを有効にする - - サムネイルの保存 - - スポンサーセグメントの削除 - - 説明の保存 - - 章を埋め込む -6. **出力ディレクトリを選択** -7. **「ダウンロード」をクリックします** +1. **YTSage を起動する** +2. **YouTube の URL を貼り付ける** (または「URL を貼り付け」ボタンを使用) +3. **「分析」をクリックする** +4. **フォーマットを選択する：** + - ビデオダウンロードの場合は `Video` + - オーディオ抽出の場合は `Audio Only` +5. **オプションを選択する：** + - 字幕を有効にして言語を選択 + - 字幕結合を有効化 + - サムネイルを保存 + - スポンサーセクションを削除 + - 説明を保存 + - チャプターを埋め込む +6. **出力ディレクトリを選択する** +7. **「ダウンロード」をクリックする** -> 💡 デフォルトのダウンロード ディレクトリは、ユーザーの「ダウンロード」フォルダーです。 +> 💡 デフォルトのダウンロードディレクトリは、ユーザーの「ダウンロード」フォルダです。📋 プレイリストのダウンロード
-1. **プレイリストの URL を貼り付け** -2. **「分析」をクリックします** -3. **プレイリスト セレクターからビデオを選択します (オプション、デフォルトはすべて)** -4. **希望の形式/品質を選択します** -5. **「ダウンロード」をクリック** +1. **プレイリストの URL を貼り付ける** +2. **「分析」をクリックする** +3. **プレイリストセレクターからビデオを選択する (任意、デフォルトはすべて)** +4. **希望のフォーマット/品質を選択する** +5. **「ダウンロード」をクリックする** -> 💡 アプリケーションはダウンロードキューを自動的に処理します +> 💡 アプリケーションはダウンロードキューを自動的に管理し、プレイリストのエントリを `.txt`, `.csv`, `.m3u`, または `.json` ファイルとしてエクスポートできます。
-
🌍 YouTube 以外のサイトの汎用モード
+🌍 YouTube 以外のサイト向けのジェネリックモード
-Dailymotion、CBC Gem、TikTok など、yt-dlp でサポートされているサイトからの URL を YTSage が受け入れるようにする場合は、ジェネリック モードを使用します。 +Dailymotion、CBC Gem、TikTok など、yt-dlp がサポートするサイトからの URL を YTSage に受け入れさせたい場合は、ジェネリックモードを使用します。 -使用方法: +使用方法： 1. `Download Settings` を開きます。 2. `Generic Mode` を有効にします。 -3. サポートされている YouTube 以外のビデオまたはプレイリストの URL を貼り付けます。 -4. 「`Analyze`」をクリックします。 -5. 形式を選択し、通常どおりダウンロードします。 +3. YouTube 以外のサポートされているビデオまたはプレイリストの URL を貼り付けます。 +4. `Analyze` をクリックします。 +5. フォーマットを選択し、通常通りダウンロードします。 -注: +注意： -- 汎用モードでは、YTSage 内の URL 検証のみが変更されます。ターゲット サイトは、インストールされている yt-dlp バージョンでサポートされている必要があります。 -- 一部のサイトでは、エクストラクターに応じて、Cookie、ログイン セッション、プロキシ、または追加の yt-dlp 引数が必要です。 -- サイトに障害が発生した場合は、問題を報告する前に、まず組み込みのアップデーター タブから yt-dlp を更新してください。 +- ジェネリックモードは、YTSage 内部の URL バリデーションのみを変更します。対象サイトは、インストールされている yt-dlp バージョンでサポートされている必要があります。 +- サイトによっては、エクストラクターに応じてクッキー、ログイン、プロキシ、または追加の yt-dlp 引数が必要になる場合があります。 +- サイトが失敗する場合は、問題を報告する前に統合アップデートタブから yt-dlp を更新してください。🧰 メディアとダウンロードのオプション
-- **字幕オプション:** 言語をフィルターし、ビデオ ファイルに字幕を埋め込みます。 -- **字幕の結合:** ハードコードされた字幕のビデオ ファイルに字幕を結合します。 -- **説明の保存:** ビデオの説明をテキスト ファイルとして保存します。 +- **字幕オプション:** 言語をフィルタリングし、字幕をビデオファイルに埋め込みます。 +- **字幕結合:** 字幕をビデオファイルにマージして、焼き付け字幕（ハードコード）にします。 +- **説明の保存:** ビデオの説明をテキストファイルとして保存します。 - **サムネイルの保存:** ビデオのサムネイルを画像ファイルとして保存します。 -- **チャプターの埋め込み:** 互換性のあるビデオ プレーヤーのメタデータとしてチャプター マーカーを埋め込みます。 -- **スポンサー セグメントの削除:** SponsorBlock を使用してビデオからスポンサー セグメントを削除します。 -- **ビデオのトリミング:** `HH:MM:SS` 形式で時間範囲を指定して、ビデオの特定の部分のみをダウンロードします +- **チャプターの埋め込み:** 対応しているビデオプレーヤー用に、チャプターマーカーをメタデータとして含めます。 +- **スポンサーセクションを削除:** SponsorBlock を使用して、ビデオからスポンサーセグメントを削除します。 +- **ビデオのトリミング:** `HH:MM:SS` 形式で時間範囲を指定して、ビデオの特定のセクションのみをダウンロードします。⚙️ 出力とファイルの設定
-- **速度リミッター:** ダウンロード速度を制限します (例: `500K` 500 KB/秒) -- **ダウンロード パスの保存:** 今後のダウンロードのためにデフォルトのダウンロード パスを保存します。 **[ダウンロード設定] → [ダウンロード パス]** で利用できます。 -- **出力ファイル名の形式:** `%(title)s`、`%(uploader)s`、`%(resolution)s` などの変数を使用して、出力ファイル名の形式をカスタマイズします。 **ダウンロード設定 → ファイル名形式**で利用できます。- **出力形式を強制:** ビデオを`mp4`、`webm`、`mkv`などの特定のコンテナ形式に強制的にダウンロードします。 **ダウンロード設定 → 出力形式設定**で利用できます。 -- **オーディオ形式変換:** オーディオのみのダウンロードを、`AAC`、`MP3`、`FLAC`、`WAV`、`Opus`、`M4A`、などの優先形式に変換します。 `Vorbis`、または `Best`。 **ダウンロード設定 → オーディオ形式設定**で利用できます。 -- **オーディオの正規化:** EBU R128 を使用して、オーディオのみのダウンロードの音量を標準化します。 -- **同時接続数:** ファイルを複数のフラグメントで同時にダウンロードすることにより、ダウンロード速度を劇的に向上させます。**ダウンロード設定 → 一般 → 同時接続数** から利用可能（デフォルトは1、IP制限を防ぐための推奨最大値は8～10）。\n +- **速度制限:** ダウンロード速度を制限します（例：500 KB/s の場合は `500K`）。 +- **ダウンロードパスの保存:** 将来のダウンロードのためにデフォルトのダウンロードパスを保存します。**Download Settings → Download Path** で設定可能です。 +- **デフォルトのビデオ解像度:** 自動選択のために好みのビデオ解像度を設定します（例：1080p, 720p）。**Download Settings → Default Video Resolution** で設定可能です。 +- **デフォルトの字幕言語:** 自動選択のためにデフォルトの字幕言語を設定します（カンマ区切り、例：`ja,en`）。**Download Settings → Default Subtitle Languages** で設定可能です。 +- **ファイル名形式:** `%(title)s`, `%(uploader)s`, `%(playlist_index)s`, `%(resolution)s` などの変数を使用して出力ファイル名の形式をカスタマイズします。**Download Settings → Filename Format** で設定可能です。 +- **出力形式の強制:** ビデオダウンロードを `mp4`, `webm`, `mkv` などの特定のコンテナ形式に強制します。**Download Settings → Output Format Settings** で設定可能です。 +- **オーディオ形式の変換:** オーディオのみのダウンロードを `AAC`, `MP3`, `FLAC`, `WAV`, `Opus`, `M4A`, `Vorbis`, または `Best` などの好みの形式に変換します。**Download Settings → Audio Format Settings** で設定可能です。 +- **オーディオノーマライズ:** EBU R128 を使用して、オーディオのみのダウンロードの音量を標準化します。 +- **同時接続数:** ファイルを複数のパーツで同時にダウンロードすることで、ダウンロード速度を大幅に向上させます。**Download Settings → General → Concurrent Connections** で設定可能です（デフォルトは 1。IP ブロックを避けるため最大 8-10 を推奨）。 +🌐 アクセスとネットワーク
-- **Cookie を使用してログイン:** Cookie を使用して YouTube にログインし、プライベート コンテンツにアクセスします。 - 使用方法: - 1. **推奨:** アプリに組み込まれている `Extract cookies from browser` オプションを使用し、ブラウザーとオプションでプロファイルを選択します。 - 2. または、Cookie を手動で抽出します。 - ａ． [cookie-editor](https://github.com/moustachauve/cookie-editor?tab=readme-ov-file) のような拡張子を使用してブラウザから Cookie をエクスポートします。 - b. Netscape 形式で Cookie をコピーします。 - c. `cookies.txt` という名前のファイルを作成し、そこに Cookie を貼り付けます。 - d.アプリで `cookies.txt` ファイルを選択します -- **プロキシ サポート:** ダウンロードにはプロキシ サーバーを使用します (例: `http://🛠️ ツールとメンテナンス
-- **カスタム コマンド:** コマンドライン引数を介して高度な yt-dlp 機能にアクセスします -- **「アップデータ」タブ:** カスタム オプションの 1 か所から組み込みの更新ツールを管理します。 - - **yt-dlp アップデート:** アップデートを確認し、安定リリース チャネルと夜間リリース チャネルを切り替えます。 - - **FFmpeg バージョン チェッカー:** FFmpeg バージョンを確認し、インストール ガイドを開きます - - **Deno の更新:** Deno ランタイムを確認して更新します -- **FFmpeg/yt-dlp/Deno 検出:** [バージョン情報] ダイアログから FFmpeg、yt-dlp、および Deno のパスとバージョンを自動的に検出します。 -- **ダウンロード履歴:** **履歴** ボタンから過去のダウンロードをサムネイルとステータスとともに表示します。 +- **カスタムコマンド:** コマンドライン引数を介して高度な yt-dlp 機能にアクセスします。 +- **アップデートタブ:** カスタムオプション内の一箇所で内蔵のアップデートツールを管理します： + - **yt-dlp アップデート:** アップデートを確認し、Stable と Nightly リリースチャネルを切り替えます。 + - **FFmpeg バージョンチェッカー:** FFmpeg のバージョンを確認し、インストールガイドを開きます。 + - **Deno アップデート:** Deno ランタイムを確認し、アップデートします。 +- **FFmpeg/yt-dlp/Deno 検出:** About ダイアログから FFmpeg、yt-dlp、Deno のパスとバージョンを自動的に検出します。 +- **ダウンロード履歴:** **History** ボタンから、サムネイルとステータス付きで過去のダウンロードを表示します。
-
-
+
## 🛠️ トラブルシューティング
🌍 ローカリゼーション
+🌍 ローカライズ
-YTSage は **14 の言語**をサポートしており、世界中からアクセスできます。 **カスタム オプション → 言語** から希望の言語を選択します。 +YTSage はグローバルに対応するため、**14 言語**をサポートしています。**Custom Options → Language** で好みの言語を選択してください。 ### サポートされている言語 -|言語 |コード |言語 |コード | +| 言語 | コード | 言語 | コード | |----------|------|----------|------| | 🇺🇸 英語 | `en` | 🇪🇸 スペイン語 | `es` | -| 🇸🇦アラビア語 | `ar` | 🇫🇷 フランス語 | `fr` | -| 🇩🇪 ドイツ語 | `de` | 🇮🇳ヒンディー語 | `hi` | -| 🇮🇩インドネシア語 | `id` | 🇮🇹イタリア語 | `it` | -| 🇯🇵 日本語 | `ja` | 🇵🇱ポーランド語 | `pl` | -| 🇧🇷 ポルトガル語 | `pt` | 🇷🇺ロシア語 | `ru` | -| 🇹🇷 トルコ語 | `tr` | 🇨🇳中国語 | `zh` | +| 🇸🇦 アラビア語 | `ar` | 🇫🇷 フランス語 | `fr` | +| 🇩🇪 ドイツ語 | `de` | 🇮🇳 ヒンディー語 | `hi` | +| 🇮🇩 インドネシア語 | `id` | 🇮🇹 イタリア語 | `it` | +| 🇯🇵 日本語 | `ja` | 🇵🇱 ポーランド語 | `pl` | +| 🇧🇷 ポルトガル語 | `pt` | 🇷🇺 ロシア語 | `ru` | +| 🇹🇷 トルコ語 | `tr` | 🇨🇳 中国語 | `zh` | -### README の翻訳 +### README 翻訳 -|言語 |ファイル |言語 |ファイル | +| 言語 | ファイル | 言語 | ファイル | |----------|------|----------|------| -| 🇺🇸 英語 | [README.md](../README.md) | 🇪🇸 スペイン語 | [README.es.md](README.es.md) -| 🇸🇦アラビア語 | [README.ar.md](README.ar.md) | 🇫🇷 フランス語 | [README.fr.md](README.fr.md) | -| 🇩🇪 ドイツ語 | [README.de.md](README.de.md) | 🇮🇳ヒンディー語 | [README.hi.md](README.hi.md) | -| 🇮🇩インドネシア語 | [README.id.md](README.id.md) | 🇮🇹イタリア語 | [README.it.md](README.it.md) | -| 🇯🇵 日本語 | [README.ja.md](README.ja.md) | 🇵🇱ポーランド語 | [README.pl.md](README.pl.md) | -| 🇧🇷 ポルトガル語 | [README.pt.md](README.pt.md) | 🇷🇺ロシア語 | [README.ru.md](README.ru.md) | -| 🇹🇷 トルコ語 | [README.tr.md](README.tr.md) | 🇨🇳中国語 | [README.zh.md](README.zh.md) | +| 🇺🇸 英語 | [README.md](README.md) | 🇪🇸 スペイン語 | [README.es.md](README.es.md) | +| 🇸🇦 アラビア語 | [README.ar.md](README.ar.md) | 🇫🇷 フランス語 | [README.fr.md](README.fr.md) | +| 🇩🇪 ドイツ語 | [README.de.md](README.de.md) | 🇮🇳 ヒンディー語 | [README.hi.md](README.hi.md) | +| 🇮🇩 インドネシア語 | [README.id.md](README.id.md) | 🇮🇹 イタリア語 | [README.it.md](README.it.md) | +| 🇯🇵 日本語 | [README.ja.md](README.ja.md) | 🇵🇱 ポーランド語 | [README.pl.md](README.pl.md) | +| 🇧🇷 ポルトガル語 | [README.pt.md](README.pt.md) | 🇷🇺 ロシア語 | [README.ru.md](README.ru.md) | +| 🇹🇷 トルコ語 | [README.tr.md](README.tr.md) | 🇨🇳 中国語 | [README.zh.md](README.zh.md) | -> 💡 **翻訳に貢献しませんか?** 言語を追加するには、[Contributing](#contributing) セクションをご覧ください。 +> 💡 **翻訳を手伝いたいですか？** [貢献](#貢献) セクションを参照して、さらに多くの言語を追加するのを手伝ってください！
--ffmpeg.exe` ファイルをダウンロードすることです。
+- **フォーマットテーブルが表示されない:** yt-dlp を最新バージョンに更新し、yt-dlp Nightly への切り替えを試してください。
+- **ダウンロードが失敗する:** インターネット接続を確認し、ビデオが利用可能であることを確認してください。
+- **特定のダウンロードエラー：**
+ - **非公開ビデオ:** 非公開コンテンツにアクセスするには、クッキー認証を使用してください。
+ - **年齢制限のあるコンテンツ:** YouTube アカウントにログインして、年齢制限のあるビデオを表示してください。
+ - **ジオブロックされたビデオ:** 地域制限を回避するために VPN の使用を検討してください。
+ - **削除されたビデオ:** ビデオは YouTube で利用できなくなっています。
+ - **ライブストリーム:** ライブストリームは放送中にダウンロードできません。ストリームが終了するまで待ってください。
+ - **ネットワークエラー:** インターネット接続を確認して再試行してください。
+ - **無効な URL:** URL が正しく、サポートされているプラットフォームのものであることを確認してください。
+ - **プレミアムコンテンツ:** YouTube Premium のサブスクリプションが必要です。
+ - **著作権ブロック:** 著作権制限のため、コンテンツがブロックされています。
+- **ダウンロード後にビデオとオーディオファイルが分かれている:** これは FFmpeg が不足しているか、検出されない場合に発生します。YTSage は、高品質のビデオとオーディオストリームを結合するために FFmpeg を必要とします。
+ - **解決策:** FFmpeg がインストールされており、システムの PATH でアクセス可能であることを確認してください。Windows ユーザーにとって最も簡単なオプションは、FFmpeg が同梱されている `YTSage-v-ffmpeg.exe` ファイルをダウンロードすることです。
---
-#### 🛡️ Windows Defender / ウイルス対策の警告
+#### 🛡️ Windows Defender / アンチウイルス警告
-一部のウイルス対策ソフトウェアでは、`.exe` ファイルに誤検知のフラグが立てられる場合があります。これは、パッケージ化されたアプリケーションの**既知の制限**です。
+一部のアンチウイルスソフトウェアは、`.exe` ファイルを誤検知（False Positive）としてフラグを立てる場合があります。これは、パッケージ化されたアプリケーションの**既知の制限**です。
-**これが起こる理由:**
-- ウイルス対策ヒューリスティックにより、パックされた実行可能ファイルが疑わしいものとして誤認識される可能性がある
+**なぜ発生するのか：**
+- アンチウイルスのヒューリスティック機能が、パッケージ化された実行ファイルを疑わしいものとして誤認することがあります。
-**安全な代替品:**
-- ✅ **pip インストールを使用します:** `pip install ytsage` (推奨)
-- ✅ **ソースからビルド**: これに従ってください [guide](../.github/CI_CD_README.md)
-- ✅ **ウイルス対策ソフトウェアでアプリケーションをホワイトリストに登録**
+**安全な選択肢：**
+- ✅ **pip インストールを使用する:** `pip install ytsage` (推奨)
+- ✅ **ソースからビルドする**: この[ガイド](.github/CI_CD_README.md)に従ってください。
+- ✅ **アプリケーションをホワイトリストに追加する** (アンチウイルスソフトウェアの設定)。
#### 🍎 macOS: 「アプリが破損しているため開けません」
-macOS Sonoma 以降でこのエラーが発生した場合は、隔離属性を削除する必要があります。
+macOS Sonoma 以降でこのエラーが表示される場合は、 quarantine（隔離）属性を削除する必要があります。
-1. **ターミナルを開きます** (Spotlight を使用して見つけることができます)。
-2. **次のコマンドを入力します**。**まだ Enter キーは押さないでください**。必ず末尾にスペースを含めてください。
+1. **ターミナルを開きます** (Spotlight で検索できます)。
+2. **次のコマンドを入力します** が、まだ Enter は押さないでください。最後にスペースを含めるようにしてください：
```bash
xattr -d com.apple.quarantine
```
-3. **`YTSage.app` ファイル**を Finder ウィンドウからドラッグし、ターミナル ウィンドウに直接ドロップします。これにより、正しいファイル パスが自動的に貼り付けられます。
-4. **Enter キーを押して**、コマンドを実行します。
-5. **YTSage.app をもう一度開いてみてください。** これで正しく起動するはずです。
+3. **Finder ウィンドウから `YTSage.app` ファイルをドラッグし**、ターミナルウィンドウに直接ドロップします。これにより、正しいファイルパスが自動的に貼り付けられます。
+4. **Enter を押して** コマンドを実行します。
+5. **YTSage.app を再度開いてみてください。** 正しく起動するはずです。
---
-#### **構成の場所 (詳細)**
+#### **設定ファイルの場所 (上級者向け)**
- **Windows:** `%LOCALAPPDATA%\YTSage`
- **macOS:** `~/Library/Application Support/YTSage`
- **Linux:** `~/.local/share/YTSage`
-
+
## 💖 スポンサー
-YTSage によって時間を節約できる場合は、プロジェクトのスポンサーになることを検討してください。スポンサーシップは、開発時間、プラットフォーム全体のテスト、将来の改善をカバーするのに役立ちます。
+YTSage があなたの時間を節約できたなら、プロジェクトのスポンサーになることを検討してください。スポンサーシップは、開発時間、全プラットフォームでのテスト、および将来の改善に役立てられます。
-- GitHub スポンサー: https://github.com/sponsors/oop7
-- スポンサー リンクは、アプリ内の [バージョン情報] ダイアログから直接利用することもできます。
+- GitHub Sponsors: https://github.com/sponsors/oop7
+- スポンサーリンクは、アプリ内の About ダイアログから直接利用可能です。
[](https://github.com/sponsors/oop7)
-
-## 👥 貢献しています
+
+## 👥 貢献
-寄付を歓迎します!お手伝いできる方法は次のとおりです。
+貢献を歓迎します！以下のように手助けができます：
1. 🍴 リポジトリをフォークする
-2. 🌿 機能ブランチを作成します。
+2. 🌿 フィーチャーブランチを作成する：
```bash
git checkout -b feature/AmazingFeature
```
-3. 💾 変更をコミットします。
+3. 💾 変更をコミットする：
```bash
git commit -m 'Add some AmazingFeature'
```
-4. 📤 ブランチにプッシュします。
+4. 📤 ブランチにプッシュする：
```bash
git push origin feature/AmazingFeature
```
-5. 🔄 プルリクエストを開く
+5. 🔄 プルリクエストを作成する
-### 🌍 翻訳に貢献
+### 🌍 翻訳に貢献する
-- 一致するローカライズされた README ファイルを更新します (例: `README.es.md`)
-- `ytsage/languages/クリックすると一般的な問題と解決策が表示されます
+クリックして一般的な問題と解決策を表示
-- **フォーマット テーブルが表示されない:** yt-dlp を最新バージョンに更新し、毎晩 yt-dlp に切り替えます。 -- **ダウンロードが失敗する:** インターネット接続をチェックし、ビデオが利用可能であることを確認してください。 -- **特定のダウンロード エラー:** - - **プライベート ビデオ:** Cookie 認証を使用してプライベート コンテンツにアクセスします。 - - **年齢制限のあるコンテンツ:** 年齢制限のある動画を閲覧するには、YouTube アカウントにログインしてください。 - - **地理的にブロックされたビデオ:** 地域制限を回避するには、VPN の使用を検討してください。 - - **削除/削除されたビデオ:** このビデオは YouTube で利用できなくなりました。 - - **ライブ ストリーム:** ライブ ストリームはダウンロードできません。ストリームが終了するまで待ちます。 - - **ネットワーク エラー:** インターネット接続を確認して、もう一度試してください。 - - **無効な URL:** URL が正しく、サポートされているプラットフォームからのものであることを確認してください。 - - **プレミアム コンテンツ:** YouTube プレミアム メンバーシップが必要です。 - - **著作権ブロック:** コンテンツは著作権制限によりブロックされています。 -- **ダウンロード後にビデオ ファイルとオーディオ ファイルを分離します:** これは、FFmpeg が見つからない、または検出されない場合に発生します。 YTSage では、高品質のビデオ ストリームとオーディオ ストリームをマージするために FFmpeg が必要です。 - - **解決策:** FFmpeg がシステムの PATH にインストールされ、アクセスできることを確認してください。 Windows ユーザーの場合、最も簡単なオプションは、FFmpeg にバンドルされている `YTSage-v.json` を編集してアプリ文字列を同期させます
-- 言語が見つからない場合は、`README.md` から開始して `README..md` を作成します
+- 関連するローカライズ版 README ファイルを更新する (例: `readme-translations/README.ja.md`)
+- `ytsage/languages/.json` を編集して、アプリの文字列を同期させる
+- お使いの言語がない場合は、 `README.md` をベースに `README..md` を作成してください。
📂 プロジェクト構造
## YTSage - プロジェクト構造
-このドキュメントでは、YTSage の整理されたフォルダー構造について説明します。
+このドキュメントでは、YTSage の整理されたフォルダ構造について説明します。
-### 📁 プロジェクトの構造
+### 📁 プロジェクト構造
```
YTSage/
-├── 📁 .github/ # GitHub configuration
-│ ├── 📁 ISSUE_TEMPLATE/ # Issue templates
-│ │ └── 🐛-bug-report.md # Bug report template
-│ ├─── 📁 workflows/ # GitHub Actions workflows
-│ │ ├── build-linux.yml # Linux build workflow
-│ │ ├── build-macos.yml # macOS build workflow
-│ │ │── build-windows.yml # Windows build workflow
-| | └── release-all.yml # Master release workflow
-│ └── 📄 CI_CD_README.md # CI/CD documentation
-├── 📁 branding/ # Branding assets (Screenshots, SVGs)
-│ ├── 📁 icons/ # Application icons
-│ ├── 📁 screenshots/ # Screenshots for documentation
-│ └── 📁 svg/ # SVG assets
-├── 📄 LICENSE # License file
-├── 📄 pyproject.toml # Project metadata and dependencies
-├── 📄 README.md # Project documentation
-├── 📄 requirements.txt # Python dependencies (dev)
-└── 📁 ytsage/ # Source package
- ├── 📁 assets/ # Runtime assets
- │ ├── 📁 Icon/ # Application icons
- │ └── 📁 sound/ # Audio files
- ├── 📁 languages/ # Localization files
- │ ├── 📄 ar.json # Arabic translation
- │ ├── 📄 de.json # German translation
- │ ├── 📄 en.json # English translation
- │ └── ... # Other languages
- ├── 📁 core/ # Core business logic
- │ ├── 📄 __init__.py # Core package init
- │ ├── 📄 ytsage_deno.py # Deno integration
- │ ├── 📄 ytsage_downloader.py # Download functionality
- │ ├── 📄 ytsage_ffmpeg.py # FFmpeg integration
- │ ├── 📄 ytsage_utils.py # Utility functions
- │ └── 📄 ytsage_yt_dlp.py # yt-dlp integration
- ├── 📁 gui/ # User interface components
- │ ├── 📄 __init__.py # GUI package init
- │ ├── 📄 ytsage_gui_main.py # Main application window
- │ └── 📁 ytsage_gui_dialogs/ # Dialog classes
- ├── 📁 utils/ # Utility modules
- │ ├── 📄 __init__.py # Utils package init
- │ ├── 📄 ytsage_config_manager.py # Configuration management
- │ └── 📄 ytsage_logger.py # Logging utilities
- ├── 📄 __init__.py # Package entry point
- └── 📄 main.py # Main execution script
+├── 📁 .github/ # GitHub 設定
+│ ├── 📁 ISSUE_TEMPLATE/ # イシューテンプレート
+│ │ └── 🐛-bug-report.md # バグレポートテンプレート
+│ ├─── 📁 workflows/ # GitHub Actions ワークフロー
+│ │ ├── build-linux.yml # Linux ビルドワークフロー
+│ │ ├── build-macos.yml # macOS ビルドワークフロー
+│ │ │── build-windows.yml # Windows ビルドワークフロー
+| | └── release-all.yml # マスターリリースワークフロー
+│ └── 📄 CI_CD_README.md # CI/CD ドキュメント
+├── 📁 branding/ # ブランディングアセット (スクリーンショット, SVG)
+│ ├── 📁 icons/ # アプリアイコン
+│ ├── 📁 screenshots/ # ドキュメント用スクリーンショット
+│ └── 📁 svg/ # SVG アセット
+├── 📄 LICENSE # ライセンスファイル
+├── 📄 pyproject.toml # プロジェクトメタデータと依存関係
+├── 📄 README.md # プロジェクトドキュメント
+├── 📄 requirements.txt # Python 依存関係 (dev)
+└── 📁 ytsage/ # ソースコードパッケージ
+ ├── 📁 assets/ # ランタイムアセット
+ │ ├── 📁 Icon/ # アプリアイコン
+ │ └── 📁 sound/ # オーディオファイル
+ ├── 📁 languages/ # ローカライズファイル
+ │ ├── 📄 ar.json # アラビア語翻訳
+ │ ├── 📄 de.json # ドイツ語翻訳
+ │ ├── 📄 en.json # 英語翻訳
+ │ └── ... # その他の言語
+ ├── 📁 core/ # コアビジネスロジック
+ │ ├── 📄 __init__.py
+ │ ├── 📄 ytsage_deno.py # Deno 統合
+ │ ├── 📄 ytsage_downloader.py # ダウンロード機能
+ │ ├── 📄 ytsage_ffmpeg.py # FFmpeg 統合
+ │ ├── 📄 ytsage_utils.py # ユーティリティ関数
+ │ └── 📄 ytsage_yt_dlp.py # yt-dlp 統合
+ ├── 📁 gui/ # ユーザーインターフェースコンポーネント
+ │ ├── 📄 __init__.py
+ │ ├── 📄 ytsage_gui_main.py # アプリメインウィンドウ
+ │ └── 📁 ytsage_gui_dialogs/ # ダイアログクラス
+ ├── 📁 utils/ # ユーティリティモジュール
+ │ ├── 📄 __init__.py
+ │ ├── 📄 ytsage_config_manager.py # 設定管理
+ │ └── 📄 ytsage_logger.py # ロギングツール
+ ├── 📄 __init__.py # パッケージエントリポイント
+ └── 📄 main.py # メイン実行スクリプト
```
-## ⭐️スターの歴史
+## ⭐️ スター履歴
-## スターの歴史
+## Star History
@@ -538,9 +544,9 @@ YTSage/
-## 📜ライセンス
+## 📜 ライセンス
-このプロジェクトは MIT ライセンスに基づいてライセンスされています。詳細については、[LICENSE](../LICENSE) ファイルを参照してください。
+このプロジェクトは MIT ライセンスの下でライセンスされています。詳細は [LICENSE](LICENSE) ファイルを参照してください。
## 🙏 謝辞
@@ -549,21 +555,21 @@ YTSage/
-改善の提案やバグの報告のために問題を開いてこのプロジェクトに貢献してくださった皆様に心から感謝します。
+改善の提案やバグの報告のためにイシューを開いてこのプロジェクトに貢献してくださったすべての方々に感謝いたします。
- コアコンポーネント 主要コンポーネント
yt-dlp
- ダウンロード エンジン
+ ダウンロードエンジン
FFmpeg
メディア処理
- デノ
- yt-dlp との統合用ランタイム
+ Deno
+ yt-dlp 統合用ランタイム
ライブラリとフレームワーク
@@ -571,32 +577,33 @@ YTSage/
GUI フレームワーク
- 枕
+ Pillow
画像処理
- リクエスト
+
+ requests
HTTP リクエスト
- 梱包
- バージョンとパッケージの取り扱い
+ packaging
+ バージョン管理とパッケージ化
- 値下げ
- マークダウン レンダリング
+ markdown
+ Markdown レンダリング
- ろぐる
+ loguru
ロギング
- アセットと寄稿者 アセットと貢献者
- ユニバーズフィールドによる新しい通知 09
+ New Notification 09 by Universfield
通知音
- ウイルス185
- コード寄稿者
+ viru185
+ コード貢献者
@@ -604,14 +611,14 @@ YTSage/
-## ⚠️免責事項
+## ⚠️ 免責事項
-このツールは個人使用のみを目的としています。 YouTube の利用規約とコンテンツ作成者の権利を尊重してください。
+このツールは個人利用のみを目的としています。YouTube の利用規約およびコンテンツ制作者の権利を尊重してください。
---
-[oop7](https://github.com/oop7) によって ❤️ で作られました
+Created with ❤️ by [oop7](https://github.com/oop7)