Skip to content

CineSync is a Python based library management tool designed to organize debrid & local libraries without the support of Sonarr & Radarr

License

Notifications You must be signed in to change notification settings

elfhosted/CineSync

Β 
Β 

Repository files navigation

Github

Discord GitHub Releases Docker Pulls

Buy Me A Coffee Patreon

CineSync - Organize Your Media Library Easily

CineSync is a comprehensive media library management system designed to efficiently organize libraries for Movies & TV shows, eliminating the need for Sonarr/Radarr. With its modern web interface, real-time monitoring, and advanced automation features, CineSync streamlines the organization of your library while providing full control over your data locally. While highly optimized for debrid platforms, CineSync is also versatile and works effectively with non-debrid platforms.

CineSync Web Interface

CineSync features a modern web interface for complete library management with professional-grade tools and real-time monitoring.

CineSync Dashboard

πŸ“Έ Interface Screenshots

File Browser Poster View
Movie Metadata Show Metadata

How CineSync Works ?

CineSync creates symbolic links from source directories to destination directories, organizing them according to your preferences and metadata from TMDb/IMDb/TVDB. This approach allows you to maintain a well-structured library without physically moving or duplicating files, preserving disk space while enabling advanced organization features.

What's New in CineSync

  • 🌐 Modern Web Interface - Complete web-based dashboard with file browser, settings management, and real-time monitoring
  • πŸ€– Auto-Processing - Intelligent automation that processes media files as they're discovered
  • πŸ“Š Advanced Analytics - Comprehensive dashboard with media statistics, recent activity, and system monitoring
  • 🎯 Smart Content Separation - Automatic categorization for Kids content, 4K media, and Anime with customizable rules
  • πŸ”„ Real-Time Updates - Live dashboard updates and instant media server integration (Plex/Jellyfin/Emby)
  • πŸ—ƒοΈ Database Management - Built-in database with export capabilities and advanced search functionality

Web Interface Features

  • πŸ“Š Interactive Dashboard: Real-time statistics, recent media tracking, and system monitoring
  • πŸ“ Advanced File Browser: Navigate, manage, and organize your media library with drag-and-drop support
  • βš™οΈ Settings Management: Configure all CineSync options through an intuitive web interface
  • πŸ” Smart Search: Advanced search and filtering capabilities with alphabet indexing
  • πŸ“ˆ Analytics & Reporting: Detailed insights into your media collection and processing activities
  • πŸ”„ Real-Time Updates: Live notifications and automatic refresh of library changes
  • 🎯 Auto-Processing Controls: Enable/disable automatic processing with toggle controls
  • πŸ—ƒοΈ Database Management: Export, search, and manage your media database
  • πŸ” Secure Authentication: JWT-based authentication with configurable access controls

With CineSync's integrated web interface, your media library is instantly manageable across multiple devices with professional-grade tools and real-time automation.

For detailed configuration and usage, visit the Web Interface Guide.

πŸš€ Installation

Ready to get started? CineSync supports multiple installation methods to fit your environment.

πŸ“– Complete Installation Guide - Docker, manual setup, system requirements, and troubleshooting

⚑️ Easy Mode (ElfHosted)

❀️ CineSync is proudly sponsored by and "elf-illiated" with ElfHosted (along with many more excellent open-source projects!)

What is ElfHosted? ElfHosted is "easy mode" for self-hosting - an open-source PaaS which runs runs over 100 popular self-hostable apps for you, reliably and securely. They take responsibility for the painful stuff (hardware, security, configuration, automation and updates), so you sit back and enjoy the fun stuff! (actually using your applications!)

Popular streaming bundles are available with Plex, Jellyfin, or Emby, integrated with cloud storage like RealDebrid, Premiumize, etc, and tooled with heavy-hitters such as Radarr/Sonarr, CineSync (hello!), Riven, Stremio Addons and more.

ElfHosted have an "excellent" ⭐️⭐️⭐️⭐️⭐️ rating on TrustPilot, a well-moderated Discord community (highly praised for support and friendliness), and comprehensive documentation and guides resource.

Grab a 7-day trial for only $1, and experience ElfHosted for yourself! πŸŽ‰

Documentation

For comprehensive guides and configuration options, visit our Wiki:

Docker Hub Repository

The CineSync Docker image is available on Docker Hub:

Supported Architectures

  • amd64 (x86_64)
  • arm64 (aarch64)

Real-Time Monitoring & Automation

CineSync features advanced real-time monitoring and automation capabilities that keep your media library perfectly organized without manual intervention. The modern web interface provides complete control over automation settings and real-time monitoring of all processing activities.

πŸ”„ Intelligent Monitoring System

  • Smart File Detection: Advanced algorithms detect new media files instantly using filesystem events
  • Auto-Processing Mode: Toggle automatic processing through the web interface for hands-free operation
  • Streaming Integration: Real-time updates to media servers (Plex/Jellyfin/Emby) ensure instant library refresh
  • Duplicate Prevention: Intelligent deduplication prevents processing the same content multiple times

πŸ€– Automated Workflows

  • Initial Smart Scan: Comprehensive library analysis and organization on startup
  • Continuous Monitoring: Real-time detection of new files with configurable monitoring intervals
  • Batch Processing: Efficient handling of multiple files with parallel processing capabilities
  • Error Recovery: Automatic retry mechanisms for failed operations with exponential backoff

πŸ“Š Real-Time Dashboard Updates

  • Live Statistics: Dashboard updates in real-time showing processing progress and library stats
  • Recent Media Tracking: Automatic tracking and display of recently added content
  • Processing Queue: Visual monitoring of current and pending file operations

CineSync’s real-time monitoring is now a core feature of the script and Docker images, allowing for seamless integration into your workflow. With this feature, users can effortlessly manage their media library and maintain a well-organized collection of files.

βš™οΈ Customizable Automation

  • Flexible Scheduling: Configurable monitoring intervals and processing schedules
  • Content-Specific Rules: Different automation rules for movies, TV shows, anime, and kids content
  • Smart Cleanup: Automatic removal of broken symlinks and orphaned database entries

πŸ”— Media Server Integration

  • Jellyfin/Emby Integration: Instant library refresh using inotify-compatible symlinks
  • Plex Integration: Automatic library scanning and updates via Plex API
  • Direct Streaming: Real-time availability of organized content through multiple access methods

CineSync's automation system transforms media management from a manual chore into a seamless, intelligent process that works continuously in the background.

🎯 Smart Content Separation

  • Kids Content Detection: Automatically separate family-friendly content based on TMDB ratings (G, PG, TV-Y, TV-G, TV-PG) and family genres
  • 4K Content Organization: Automatic detection and separation of 4K/UHD content into dedicated folders
  • Anime Classification: Specialized handling for anime content with separate organization for anime movies and TV shows
  • Resolution-Based Sorting: Intelligent sorting by video quality (720p, 1080p, 4K, etc.)

πŸ“ Flexible Organization Options

  • CineSync Layout: Simplified organization into Movies and Shows directories
  • Source Structure Preservation: Maintain original folder structures when preferred
  • Custom Folder Naming: Configurable folder names for different content types
  • Collection-Based Grouping: Organize movie franchises and collections together

Contributors

  • Suresh S ❀️
  • Special thanks to Paolo for testing the application! πŸ™

About

CineSync is a Python based library management tool designed to organize debrid & local libraries without the support of Sonarr & Radarr

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 43.9%
  • Python 33.2%
  • Go 22.4%
  • CSS 0.2%
  • Shell 0.1%
  • HTML 0.1%
  • Dockerfile 0.1%