このプロジェクトについて
open-Xdownloadは、組み込みWeb UIとバックグラウンドタスクキューを備えたローカルファーストのX/Twitterメディアダウンローダーです。4つのタスクタイプ(単一投稿、ユーザー、リスト、フォローアカウント)に対応し、バッチタスク、スケジュールプラン、増分アーカイブ、失敗時のリトライ、APIレート制限 ротация用Cookieプールを提供します。
主な機能:
- 単一投稿の解析・ダウンロード:x.comまたはtwitter.comのリンクを貼り付けるだけで、テキスト、作者、メディア一覧を解析し、各画像・動画・GIFの最高品質版をダウンロード。
- ユーザーメディアのアーカイブ:ユーザー名、@ハンドル、ユーザーIDでタイムラインのメディアをアーカイブ。
- リストアーカイブ:XリストIDを入力してメンバーを取得し、メディアをアーカイブ。
- フォローアカウントアーカイブ:ターゲットがフォローしているアカウントをフェッチし、それらのアカウントからメディアをアーカイブ。
- バッチタスク:ユーザー、リスト、フォローアカウントを最大200件まで一度に入力可能。自動重複除外対応。
- スケジュールプラン:再訪アーカイブプランとしてターゲットを保存。間隔は5〜43200分で設定可能。
- 増分アーカイブ:繰り返し実行時に前回の成功位置から再開。既にダウンロード済みのメディアをスキップ。
- 失敗ハンドリング:部分的な失敗は明確に表示。失敗した投稿はリトライキューに入り、手動またはタスク完了時に自動リトライ可能。
- Cookieプール:プライマリCookieに加え、複数バックアップグループでレート制限回転を実現。
- メディアリブラリ:画像、動画、GIFカテゴリでダウンロード済みメディアを閲覧。ファイル名、メディアURL、投稿IDで検索。キーボードナビゲーション対応の遅延読み込みプレビュー。
- 軽量プレビュー:画像は遅延読み込み。動画はデフォルトでポスターサムネイルのみ読み込み、拡大プレビュー時のみプレイヤーをマウント。
- ローカルディレクトリ保存:UIまたはCLIでダウンロードディレクトリを設定可能。閲覧・作成可能なパス。
デプロイメントオプション:
- Docker Compose(推奨):ポート127.0.0.1:8787、データおよびダウンロード用ボリューム、設定可能なPUID/PGID。
- Docker run:同じ環境変数、手動実行。
- バイナリ:Releasesからダウンロード。デフォルトで127.0.0.1:8787でリッスン。addr、data-dir、web-dir、download-dirフラグで設定可能。
本サービスには認証機能がなく、デフォルトでlocalhostにバインドされます。LANアクセスにはアドレスを0.0.0.0:8787に明示的に設定し、認証付きリバースプロキシの背後に配置する必要があります。
データはSQLiteデータベース(open-xdownload.db)とローカルダウンロードディレクトリに保存されます。機密フィールド(Cookie)はUIでマスク表示されます。バックアップにはデータベースとダウンロードディレクトリの両方を含めてください。
ライセンス:MIT。
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.