SageTube/readme-translations/README.ja.md at 62b8ede273f33bc469aab336cfb3bfc1004998ad

Files

T

oop7 62b8ede273 Add audio normalization docs and translations

Document Audio Normalization (EBU R128) in README and translated READMEs, and add corresponding localization keys and help text in ytsage language files. Updates include README.md, readme-translations (ar,de,es,fr,hi,id,it,ja,pl,pt,ru,tr,zh) and ytsage/languages JSON files to explain the feature and note that normalization requires re-encoding and forcing a specific audio format (e.g. MP3 or M4A).

2026-03-21 15:21:40 +02:00

30 KiB

Raw Blame History

クリーンな PySide6 インターフェイスを備えた最新の YouTube ダウンローダー。
任意の品質でビデオをダウンロードしたり、音声を抽出したり、字幕を取得したりできます。

🌍 README 言語

インストール • 特徴 • 使用方法 • スクリーンショット • トラブルシューティング • スポンサー • 貢献しています

❓ なぜ YTSage なのか?

YTSage は、シンプルかつ強力な YouTube ダウンローダーを求めるユーザー向けに設計されています。他のツールとは異なり、次の機能を提供します。

クリーンでモダンな PySide6 インターフェイス
ワンクリックでビデオ、オーディオ、字幕をダウンロード
スポンサーブロック、字幕の結合、プレイリストの選択などの高度な機能
YouTube 以外の yt-dlp 対応サイト向けのオプションの汎用モード
クロスプラットフォームのサポートと簡単なインストール

✨ 特徴

コア機能	高度な機能	追加機能
🎥 テーブルのフォーマット	🚫 スポンサーブロックの統合	🎞️ FPS/HDR ディスプレイ
🎵 オーディオ抽出	📝 複数字幕の選択と結合	🔄 yt-dlp を自動更新
✨シンプルなUI	💾 説明とサムネイルを保存	🛠️ FFmpeg/yt-dlp/Deno 検出
📋 プレイリストのサポートとセレクター	🚀 スピードリミッター	⚙️ カスタムコマンド
📑 章を埋め込む	✂️ ビデオセクションをトリミング	🍪 Cookie でログイン
📜 ダウンロード履歴	🔄 チャンネル選択をリリース	🌐 プロキシサポート
🎚️ オーディオ形式変換	🎬 ビデオ形式設定	🆙 内蔵アップデータタブ
🌍 汎用モード
🌍 14 言語のローカリゼーション

🚀 インストール

⚡ クイックインストール (推奨)

PyPI から YTSage をインストールします。

pip install ytsage

🔄 既存のインストールを更新します

pip install --upgrade ytsage

次に、アプリを起動します。

ytsage

📦 ビルド済みの実行可能ファイル

👉 Download Latest Release

🪟 Windows

フォーマット	説明
	標準インストーラー
	FFmpeg がバンドルされている
	ポータブル版、インストール不要
	FFmpeg、zip 形式でポータブル

🛠️ インストール手順

EXE インストーラー (.exe): ファイルをダブルクリックし、セットアップウィザードに従います。
ポータブルバージョン (.zip): アーカイブを目的の場所に解凍し、ytsage.exe を実行します。
FFmpeg バンドル: システムに FFmpeg がインストールされていない場合は、FFmpeg バンドルバージョンを選択します。

🐧 Linux

フォーマット	説明
	Debian パッケージ
	AppImage、ポータブル
	RPM パッケージ
	フラットパックバンドル

🛠️ インストール手順

DEB (.deb):

sudo dpkg -i ytsage_*.deb
sudo apt-get install -f # Fix missing dependencies if any

RPM (.rpm):
```
sudo rpm -i ytsage-*.rpm
```

アプリ画像 (.AppImage):

chmod +x YTSage-*.AppImage
./YTSage-*.AppImage

Flatpak: Flathub の指示に従うか、次のコマンドを実行します。
```
flatpak install flathub io.github.oop7.ytsage
```

🍎 macOS

フォーマット	説明
	Apple Silicon 用の ZIP アプリケーション
	Apple Silicon 用のディスクイメージインストーラー

🛠️ インストール手順

DMG インストーラー (.dmg): ダブルクリックしてマウントし、YTSage.app をアプリケーションフォルダーにドラッグします。
アプリアーカイブ (.zip): zip を解凍し、YTSage.app をアプリケーションフォルダーに移動します。

注意:「アプリが破損しています」エラーが発生した場合は、以下のmacOS troubleshooting sectionを参照してください。

💻 ソースからの手動インストール

1. リポジトリのクローンを作成します

git clone https://github.com/oop7/YTSage.git
cd YTSage

2. 依存関係をインストールする

⚡ UV あり

uv pip install .

📦 または標準の pip を使用

pip install .

3. アプリケーションを実行する

python -m ytsage.main

📸 スクリーンショット


ダウンロード設定	プレイリストダウンロード

オーディオフォーマット	カスタムオプション

📖 使用法

🎯 基本的な使い方

YTSage を起動
YouTube URL を貼り付け (または [URL を貼り付け] ボタンを使用)
「分析」をクリックします
形式を選択します:
- Video ビデオダウンロード用
- Audio Only 音声抽出用
オプションを選択します:
- 字幕を有効にし、言語を選択します
- 字幕のマージを有効にする
- サムネイルの保存
- スポンサーセグメントの削除
- 説明の保存
- 章を埋め込む
出力ディレクトリを選択
「ダウンロード」をクリックします

💡 デフォルトのダウンロードディレクトリは、ユーザーの「ダウンロード」フォルダーです。

📋 プレイリストのダウンロード

プレイリストの URL を貼り付け
「分析」をクリックします
プレイリストセレクターからビデオを選択します (オプション、デフォルトはすべて)
希望の形式/品質を選択します
「ダウンロード」をクリック

💡 アプリケーションはダウンロードキューを自動的に処理します

🌍 YouTube 以外のサイトの汎用モード

Dailymotion、CBC Gem、TikTok など、yt-dlp でサポートされているサイトからの URL を YTSage が受け入れるようにする場合は、ジェネリックモードを使用します。

使用方法:

Download Settings を開きます。
Generic Mode を有効にします。
サポートされている YouTube 以外のビデオまたはプレイリストの URL を貼り付けます。
「Analyze」をクリックします。
形式を選択し、通常どおりダウンロードします。

注:

汎用モードでは、YTSage 内の URL 検証のみが変更されます。ターゲットサイトは、インストールされている yt-dlp バージョンでサポートされている必要があります。
一部のサイトでは、エクストラクターに応じて、Cookie、ログインセッション、プロキシ、または追加の yt-dlp 引数が必要です。
サイトに障害が発生した場合は、問題を報告する前に、まず組み込みのアップデータータブから yt-dlp を更新してください。

🧰 メディアとダウンロードのオプション

字幕オプション: 言語をフィルターし、ビデオファイルに字幕を埋め込みます。
字幕の結合: ハードコードされた字幕のビデオファイルに字幕を結合します。
説明の保存: ビデオの説明をテキストファイルとして保存します。
サムネイルの保存: ビデオのサムネイルを画像ファイルとして保存します。
チャプターの埋め込み: 互換性のあるビデオプレーヤーのメタデータとしてチャプターマーカーを埋め込みます。
スポンサーセグメントの削除: 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 を使用して、オーディオのみのダウンロードの音量を標準化します。

🌐 アクセスとネットワーク

Cookie を使用してログイン: Cookie を使用して YouTube にログインし、プライベートコンテンツにアクセスします。使用方法:
1. 推奨: アプリに組み込まれている Extract cookies from browser オプションを使用し、ブラウザーとオプションでプロファイルを選択します。
2. または、Cookie を手動で抽出します。ａ． cookie-editor のような拡張子を使用してブラウザから Cookie をエクスポートします。 b. Netscape 形式で Cookie をコピーします。 c. cookies.txt という名前のファイルを作成し、そこに Cookie を貼り付けます。 d.アプリで cookies.txt ファイルを選択します
プロキシサポート: ダウンロードにはプロキシサーバーを使用します (例: http://<proxy-server>:<port>)
汎用モード: YTSage が yt-dlp でサポートされている YouTube 以外のサイトから分析してダウンロードできるようにします。 [ダウンロード設定] → [汎用モード] から有効にします。

🛠️ ツールとメンテナンス

カスタムコマンド: コマンドライン引数を介して高度な yt-dlp 機能にアクセスします
「アップデータ」タブ: カスタムオプションの 1 か所から組み込みの更新ツールを管理します。
- yt-dlp アップデート: アップデートを確認し、安定リリースチャネルと夜間リリースチャネルを切り替えます。
- FFmpeg バージョンチェッカー: FFmpeg バージョンを確認し、インストールガイドを開きます
- Deno の更新: Deno ランタイムを確認して更新します
FFmpeg/yt-dlp/Deno 検出: [バージョン情報] ダイアログから FFmpeg、yt-dlp、および Deno のパスとバージョンを自動的に検出します。
ダウンロード履歴: 履歴ボタンから過去のダウンロードをサムネイルとステータスとともに表示します。

🌍 ローカリゼーション

YTSage は 14 の言語をサポートしており、世界中からアクセスできます。 カスタムオプション → 言語 から希望の言語を選択します。

サポートされている言語

言語	コード	言語	コード
🇺🇸 英語	`en`	🇪🇸 スペイン語	`es`
🇸🇦アラビア語	`ar`	🇫🇷 フランス語	`fr`
🇩🇪 ドイツ語	`de`	🇮🇳ヒンディー語	`hi`
🇮🇩インドネシア語	`id`	🇮🇹イタリア語	`it`
🇯🇵 日本語	`ja`	🇵🇱ポーランド語	`pl`
🇧🇷 ポルトガル語	`pt`	🇷🇺ロシア語	`ru`
🇹🇷 トルコ語	`tr`	🇨🇳中国語	`zh`

README の翻訳

言語	ファイル	言語	ファイル
🇺🇸 英語	README.md	🇪🇸 スペイン語	README.es.md
🇸🇦アラビア語	README.ar.md	🇫🇷 フランス語	README.fr.md
🇩🇪 ドイツ語	README.de.md	🇮🇳ヒンディー語	README.hi.md
🇮🇩インドネシア語	README.id.md	🇮🇹イタリア語	README.it.md
🇯🇵 日本語	README.ja.md	🇵🇱ポーランド語	README.pl.md
🇧🇷 ポルトガル語	README.pt.md	🇷🇺ロシア語	README.ru.md
🇹🇷 トルコ語	README.tr.md	🇨🇳中国語	README.zh.md

💡 翻訳に貢献しませんか? 言語を追加するには、Contributing セクションをご覧ください。

🛠️ トラブルシューティング

クリックすると一般的な問題と解決策が表示されます

フォーマットテーブルが表示されない: yt-dlp を最新バージョンに更新し、毎晩 yt-dlp に切り替えます。
ダウンロードが失敗する: インターネット接続をチェックし、ビデオが利用可能であることを確認してください。
特定のダウンロードエラー:
- プライベートビデオ: Cookie 認証を使用してプライベートコンテンツにアクセスします。
- 年齢制限のあるコンテンツ: 年齢制限のある動画を閲覧するには、YouTube アカウントにログインしてください。
- 地理的にブロックされたビデオ: 地域制限を回避するには、VPN の使用を検討してください。
- 削除/削除されたビデオ: このビデオは YouTube で利用できなくなりました。
- ライブストリーム: ライブストリームはダウンロードできません。ストリームが終了するまで待ちます。
- ネットワークエラー: インターネット接続を確認して、もう一度試してください。
- 無効な URL: URL が正しく、サポートされているプラットフォームからのものであることを確認してください。
- プレミアムコンテンツ: YouTube プレミアムメンバーシップが必要です。
- 著作権ブロック: コンテンツは著作権制限によりブロックされています。
ダウンロード後にビデオファイルとオーディオファイルを分離します: これは、FFmpeg が見つからない、または検出されない場合に発生します。 YTSage では、高品質のビデオストリームとオーディオストリームをマージするために FFmpeg が必要です。
- 解決策: FFmpeg がシステムの PATH にインストールされ、アクセスできることを確認してください。 Windows ユーザーの場合、最も簡単なオプションは、FFmpeg にバンドルされている YTSage-v<version>-ffmpeg.exe ファイルをダウンロードすることです。

🛡️ Windows Defender / ウイルス対策の警告

一部のウイルス対策ソフトウェアでは、.exe ファイルに誤検知のフラグが立てられる場合があります。これは、パッケージ化されたアプリケーションの既知の制限です。

これが起こる理由:

ウイルス対策ヒューリスティックにより、パックされた実行可能ファイルが疑わしいものとして誤認識される可能性がある

安全な代替品:

✅ pip インストールを使用します: pip install ytsage (推奨)
✅ ソースからビルド: これに従ってください guide
✅ ウイルス対策ソフトウェアでアプリケーションをホワイトリストに登録

🍎 macOS: 「アプリが破損しているため開けません」

macOS Sonoma 以降でこのエラーが発生した場合は、隔離属性を削除する必要があります。

ターミナルを開きます (Spotlight を使用して見つけることができます)。
次のコマンドを入力します。まだ Enter キーは押さないでください。必ず末尾にスペースを含めてください。
```
xattr -d com.apple.quarantine 
```
YTSage.app ファイルを Finder ウィンドウからドラッグし、ターミナルウィンドウに直接ドロップします。これにより、正しいファイルパスが自動的に貼り付けられます。
Enter キーを押して、コマンドを実行します。
YTSage.app をもう一度開いてみてください。 これで正しく起動するはずです。

構成の場所 (詳細)

Windows: %LOCALAPPDATA%\YTSage
macOS: ~/Library/Application Support/YTSage
Linux: ~/.local/share/YTSage

💖 スポンサー

YTSage によって時間を節約できる場合は、プロジェクトのスポンサーになることを検討してください。スポンサーシップは、開発時間、プラットフォーム全体のテスト、将来の改善をカバーするのに役立ちます。

GitHub スポンサー: https://github.com/sponsors/oop7
スポンサーリンクは、アプリ内の [バージョン情報] ダイアログから直接利用することもできます。

👥 貢献しています

寄付を歓迎します!お手伝いできる方法は次のとおりです。

🍴 リポジトリをフォークする
🌿 機能ブランチを作成します。

git checkout -b feature/AmazingFeature

💾 変更をコミットします。

git commit -m 'Add some AmazingFeature'

📤 ブランチにプッシュします。

git push origin feature/AmazingFeature

🔄 プルリクエストを開く

🌍 翻訳に貢献

一致するローカライズされた README ファイルを更新します (例: README.es.md)
ytsage/languages/<code>.json を編集してアプリ文字列を同期させます
言語が見つからない場合は、README.md から開始して README.<code>.md を作成します

📂 プロジェクト構造

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

⭐️スターの歴史

スターの歴史

📜ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。詳細については、LICENSE ファイルを参照してください。

🙏 謝辞

謝辞を表示

改善の提案やバグの報告のために問題を開いてこのプロジェクトに貢献してくださった皆様に心から感謝します。

コアコンポーネント
yt-dlp	ダウンロードエンジン
FFmpeg	メディア処理
デノ	yt-dlp との統合用ランタイム
ライブラリとフレームワーク
PySide6	GUI フレームワーク
枕	画像処理
リクエスト	HTTP リクエスト
梱包	バージョンとパッケージの取り扱い
値下げ	マークダウンレンダリング
ろぐる	ロギング
アセットと寄稿者
ユニバーズフィールドによる新しい通知 09	通知音
ウイルス185	コード寄稿者

⚠️免責事項

このツールは個人使用のみを目的としています。 YouTube の利用規約とコンテンツ作成者の権利を尊重してください。

oop7 によって ❤️ で作られました

30 KiB Raw Blame History

🌍 README 言語

❓ なぜ YTSage なのか?

✨ 特徴

🚀 インストール

⚡ クイックインストール (推奨)

📦 ビルド済みの実行可能ファイル

🪟 Windows

🐧 Linux

🍎 macOS

1. リポジトリのクローンを作成します

2. 依存関係をインストールする

⚡ UV あり

📦 または標準の pip を使用

3. アプリケーションを実行する

📸 スクリーンショット

📖 使用法

サポートされている言語

README の翻訳

🛠️ トラブルシューティング

🛡️ Windows Defender / ウイルス対策の警告

🍎 macOS: 「アプリが破損しているため開けません」

構成の場所 (詳細)

💖 スポンサー

👥 貢献しています

🌍 翻訳に貢献

YTSage - プロジェクト構造

📁 プロジェクトの構造

⭐️スターの歴史

スターの歴史

📜ライセンス

🙏 謝辞

⚠️免責事項

30 KiB

Raw Blame History