dengji85/avm

これは何？

主な機能

• 01品番を正規化し、ファイル名から字幕、無修正、VR、4Kの表記を検出します。
• 02JavBus、JavDB、AV-Wiki、ローカルのNFOファイルなど、プラグイン式ソースからメタデータを取得します。
• 03ファイルサイズとコンテンツハッシュで重複を検出し、複数バージョンのコピーをグループ化します。
• 04ブラウザーで動画を再生でき、VLC、PotPlayer、mpvなどの外部プレーヤーでの視聴進捗も記録します。
• 05統計、スマートプレイリスト、出演者ページ、年間視聴レポートを利用できます。
• 06QRコードでログインし、スマートフォンやタブレットからLAN経由でアクセスできます。

ユースケース

• 大量の雑然としたローカルコレクションを、ひとつの閲覧可能なライブラリにまとめる。
• 重複したコピーを削除し、各タイトルの最良バージョンを残す。
• Dockerを使ってNAS上で稼働させ、ネットワーク上のほかのデバイスからライブラリにアクセスする。
• 視聴履歴を記録し、時間の経過に伴う自分の視聴傾向を振り返る。

クイックスタート

1. 1

   Pythonの依存関係をインストールする

   pip install -r requirements.txt
2. 2

   バックエンドサーバーを起動する

   python run.py serve
3. 3

   フロントエンドの開発サーバーをインストールして起動する（その後、http://localhost:5173 を開く）

   cd web_src && npm install && npm run dev

使う前に知っておきたいこと

• !READMEにはMITライセンスと記載されていますが、リポジトリのメタデータにはライセンスが記載されていないため、再利用する前に条件を確認してください。
• !ソースから実行するにはPythonとNode.jsの両方が必要です。より簡単な方法は、Windows用exeまたはDockerを使うことです。
• !スクレイピング元によっては、ローカルにインストールしたChromeで最適に動作します。Chromeがない場合、アプリは通常のリクエストにフォールバックします。

トピック

よくある質問

avm とは？

個人のAV動画コレクションを整理し、メタデータを取得して再生できるローカルファーストのメディアライブラリ管理ツール。 AVM（Adult Video Manager）は、散在するアダルト動画ファイルのフォルダを、検索可能なローカルライブラリに変えるセルフホスト型Webアプリです。品番を正規化し、サンプルや予告編を除外しながらディレクトリをスキャンします。また、JavBus、JavDB、AV-Wikiなどのプラグイン式ソースやローカルの.nfoファイルから、カバー画像、出演者、ジャンル、シリーズ、評価を取得します。

avm は無料で使えますか？ライセンスは？

avm にはライセンスが明記されていません。コードは公開されていますが、ライセンスがない場合は再利用の許諾がないため、利用前に作者に確認することをおすすめします。

avm は今もメンテナンスされていますか？

活発にメンテナンス中。avm の最終コミットは 2026年10月18日 です。

avm は何に使えますか？

大量の雑然としたローカルコレクションを、ひとつの閲覧可能なライブラリにまとめる。 重複したコピーを削除し、各タイトルの最良バージョンを残す。 Dockerを使ってNAS上で稼働させ、ネットワーク上のほかのデバイスからライブラリにアクセスする。 視聴履歴を記録し、時間の経過に伴う自分の視聴傾向を振り返る。

avm のインストール方法は？

Pythonの依存関係をインストールする: pip install -r requirements.txt バックエンドサーバーを起動する: python run.py serve フロントエンドの開発サーバーをインストールして起動する（その後、http://localhost:5173 を開く）: cd web_src && npm install && npm run dev

avm はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/dengji85/avm