Repolode
Submit
dengji85

dengji85/avm

Local-first manager for an adult video collection, with metadata scraping, deduplication, web playback and viewing stats.

View on GitHub
Stars
113
Forks
11
Open issues
3
Last commit
yesterday

What is it?

AVM (Adult Video Manager) is a self-hosted web app that turns a folder of scattered adult video files into a searchable local library. It scans media directories, recognizes product codes and normalizes messy filenames, then fills in cover, performer, genre, series and rating metadata from pluggable sources such as JavBus, JavDB and AV-Wiki.

The project also handles library upkeep. It groups multiple versions of the same title, detects exact duplicates by file size and content hash, and runs a health check for media problems. A built-in web player supports streaming and resume, and external players such as VLC, PotPlayer and mpv can be monitored to record playback progress.

Viewing history feeds playlists, statistics and a yearly viewing report. The frontend uses Vue 3 and Vite, the backend uses FastAPI with SQLite, and it ships as a Windows single-file exe or a Docker image. Optional AI features call OpenAI-compatible endpoints or a local Ollama instance.

Key features

  • 01Scans media folders and normalizes product codes in filenames
  • 02Scrapes covers and metadata from multiple pluggable sources
  • 03Merges multiple versions of a title and removes exact duplicates
  • 04Built-in web player with resume, and progress tracking for external players
  • 05Playlists, viewing statistics and a yearly report
  • 06Optional AI search and summaries via OpenAI-compatible or Ollama endpoints

Use cases

  • Organizing a large, inconsistently named local video archive
  • Cleaning up duplicate files and low-quality copies in a media library
  • Running a private library on a home NAS with Docker
  • Reviewing personal viewing habits through built-in statistics

Topics

#media-manager#metadata-scraper#vue3#fastapi#sqlite#self-hosted#docker#avm#jav-scraper#javbus

FAQ

What is avm?
Local-first manager for an adult video collection, with metadata scraping, deduplication, web playback and viewing stats. AVM (Adult Video Manager) is a self-hosted web app that turns a folder of scattered adult video files into a searchable local library. It scans media directories, recognizes product codes and normalizes messy filenames, then fills in cover, performer, genre, series and rating metadata from pluggable sources such as JavBus, JavDB and AV-Wiki.
Is avm free to use? What license does it have?
avm has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.
Is avm still maintained?
Actively maintained. The last commit to avm was on Oct 17, 2026.
What can I use avm for?
Organizing a large, inconsistently named local video archive Cleaning up duplicate files and low-quality copies in a media library Running a private library on a home NAS with Docker Reviewing personal viewing habits through built-in statistics
Where can I get avm?
The source code and installation instructions are on GitHub: https://github.com/dengji85/avm

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects