nas-tools  by linyuan0213

NAS media library management tool

Created 2 years ago
417 stars

Top 70.4% 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

2 weeks ago

Responsiveness

1 day

Pull Requests (30d)
1
Issues (30d)
1
Star History
29 stars in the last 30 days

Explore Similar Projects

Starred by Sourabh Bajaj Sourabh Bajaj(Cofounder of Uplimit), Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), and
3 more.

NextChat by ChatGPTNextWeb

0.1%
86k
AI assistant for web, iOS, MacOS, Android, Linux, and Windows
Created 2 years ago
Updated 3 days ago
Feedback? Help us improve.