Skip to content

levywang/avhub

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FTP Web Client Logo

AvHub - R18 Resource Search & Management Tool

AvHub is a web platform dedicated to the retrieval and management of adult video resources.

Cloudflare Page: https://avhub.pages.dev/

Vercel Page: https://avhub.vercel.app/


GitHub license Release Version GitHub Star GitHub Fork Repo Size GitHub Issue

Docker Stars Docker Pulls

Star History

Star History Chart

English | 简体中文


Core Features

● 🔗 Magnet Link Search by Video Code
 Accurately find magnet links and cover images corresponding to video codes.
● 📅 Timely Hacg Resource Updates
 Automatically update and archive monthly hacg resources.
● 📊 Random Video Recommendation
 Random playback functionality based on crawled data.
● 🌐 Multi-language Support
 Supports multiple language interfaces to meet global user needs.
● 🎨 Multiple Theme Options
 Offers various theme color schemes to enhance user experience.


Getting Started

Run Locally

git clone https://github.com/levywang/avhub.git  
cd avhub  
pip install -r requirements.txt  
python main.py  

The default API address: http://127.0.0.1:8000/

You can configure a reverse proxy and domain, replacing BASE_URL in line 52 of web/script.js.

The backend configuration file is located in data/config.yaml. Modify it according to your actual needs.

Docker Deployment

Note: Python Version >= 3.7

git clone https://github.com/levywang/avhub.git  
cd avhub  
docker run -d -p <your_server_port>:80 -v $PWD:/app --name avhub levywang/avhub:latest  

Configuration Instructions

If you deploy the project on a server within China, the source site missav is blocked, so you need to configure a proxy server in config.yaml. Edit the /data/config.yaml file and modify it as follows:

av_spider:
  source_url: "https://missav.ai/cn/search/"
  proxy_url: "http://192.168.50.3:7890" # HTTP or SOCKS5 proxy
  use_proxy: true

Technology Stack

  • Frontend:
    • Built with Tailwind CSS for a modern, responsive interface.
    • Integrated with hls.js for smooth video playback.
  • Backend:
    • Developed using FastAPI, a Python framework, to provide efficient and stable API services.
  • Privacy Protection:
    • Strictly adheres to privacy principles and does not directly host any resource files. All data is retrieved through third-party links.

Data Sources

  • Magnet Links and Cover Images: Sourced from missav.
  • Hacg Resources: Sourced from hacg liuli.
  • Random Video Recommendations: Sourced from crawled data stored in the local file /data/video_urls.txt.

The above data sources are configured in /data/config.yaml. If the data sources change or become inaccessible, modifications and maintenance are required.


Legal Disclaimer

Users must comply with the laws and regulations of their respective regions. AvHub is solely a resource retrieval tool and does not involve the distribution or storage of any resources.


License

This project is provided under an Apache License 2.0 license that can be found in the LICENSE file. By using, distributing, or contributing to this project, you agree to the terms and conditions of this license.