nas-tools  by linyuan0213

NAS media library management tool

created 2 years ago
385 stars

Top 75.5% on sourcepulse

GitHubView on GitHub
Project Summary

This project provides a comprehensive suite of tools for managing media libraries on Network Attached Storage (NAS) devices, primarily targeting users of private torrent trackers (PT sites). It automates tasks like site maintenance, checking, downloading, and media synchronization, significantly simplifying the process of curating a large media collection.

How It Works

The tool operates by interacting with various PT sites through their APIs or web interfaces. It supports direct integration with download clients like Aria2 and download indexers like Jackett and Prowlarr. For site interactions requiring advanced capabilities like CAPTCHA solving or simulating user logins, it leverages separate Docker containers for OCR and web automation (Chrome). This modular approach allows for flexibility and scalability in handling diverse site requirements.

Quick Start & Requirements

  • Installation: Docker is the recommended installation method. Refer to docker/compose.yml for setup.
  • Prerequisites: Docker, Docker Compose. For OCR and web automation, separate Docker images (linyuan0213/nas-tools-ocr, linyuan0213/nas-tools-chrome) are required and need to be configured within the main tool's settings. Redis is required for versions 3.3.0+.
  • Setup: Configuration involves adding site tokens and API keys in config.yaml and potentially setting up OCR/Chrome containers.
  • Documentation: https://github.com/linyuan0213/nas-tools

Highlighted Details

  • Supports over 100 PT sites for browsing, downloading, and checking in.
  • Includes plugins for automated backups (WebDAV, Samba), Emby media sync, and enterprise WeChat IP updates.
  • Features RSS feed generation, automatic torrent deletion (free leech expiry, disk space), and flexible scheduling for torrent seeding.
  • Offers web automation capabilities for sites that don't expose APIs or require complex interactions.

Maintenance & Community

  • Actively maintained with frequent updates addressing site compatibility and feature additions.
  • Community support is available via a Telegram group: https://t.me/+UxUIoJMmH2YwYWE1.

Licensing & Compatibility

  • The specific license is not explicitly stated in the README. Compatibility for commercial use or closed-source linking is not detailed.

Limitations & Caveats

The project relies heavily on the continued availability and structure of numerous third-party PT sites, making it susceptible to breakage if these sites change their interfaces or access methods. Some site-specific features, like "search subscription" for FSM, are marked as not supported.

Health Check
Last commit

3 days ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
1
Star History
50 stars in the last 90 days

Explore Similar Projects

Starred by Andrej Karpathy Andrej Karpathy(Founder of Eureka Labs; Formerly at Tesla, OpenAI; Author of CS 231n), Alex Cheema Alex Cheema(Cofounder of EXO Labs), and
3 more.

Perplexica by ItzCrazyKns

0.3%
23k
AI-powered search engine alternative
created 1 year ago
updated 1 day ago
Feedback? Help us improve.