Obsidian Movies - Product Specifications and Description
Executive Summary
Obsidian Movies is a lightweight, high-performance desktop application designed for indexing, searching, and streaming movies and television series. Utilizing a dark, distraction-free obsidian-glass design language, the software provides desktop users with an unified workspace for regional media discovery, aggregated peer-to-peer torrent streaming, and local FTP server indexing.
Architecture and Core Functionality
1. Peer-to-Peer Search Aggregator
The application incorporates a multi-source web scraping and API indexing subsystem that queries high-availability torrent sources in parallel.
- Automated extraction and scraping of mirror nodes for YTS, ThePirateBay, and TorrentGalaxy.
- Duplicate resolution matching and filtering of duplicate torrent metadata payloads based on cryptographic infohashes.
- Dynamic sorting algorithms that prioritize streamability, favoring established high-seeder 720p profiles for immediate buffering, followed by high-resolution 1080p and 2160p releases.
- Live source badge identification mapping each stream option to its respective origin index (YTS, ThePirateBay, or TorrentGalaxy).
2. FTP Direct Streaming Pipeline
Designed to operate under high-speed intranet configurations, the system integrates a direct FTP crawler.
- Automated folder matching patterns that scan remote directories for media files based on title and year parameters.
- Smart fallback search logic that automatically probes adjacent calendar years (e.g. Year - 1) if direct searches fail, ensuring compatibility with varying release database dates.
- Seamless media link resolution to stream video streams directly from low-latency FTP servers.
3. Integrated Media Player Integration
The software bridges the gap between downloaded media and native operating system playback resources.
- Automated directory scanning to identify the primary media file container (including MKV, MP4, and AVI formats) upon download completion.
- Native VLC Player orchestration that launches VLC and plays the downloaded media file immediately upon clicking the play action.
- Direct folder browsing action that opens the specific media folder in Windows Explorer for manual management.
4. Regional Media Discovery and TV Normalization
Direct integration with The Movie Database (TMDB) API allows real-time categorization and curation of foreign and regional content.
- Specialized discover tabs for Hindi Movies, Turkish TV Shows, Spanish Movies, Korean Movies, and Foreign Language Movies (indexing French, German, Italian, Japanese, and Chinese releases).
- Normalization layer that maps different schema attributes between movies (such as title and release_date) and television shows (such as name and first_air_date) into a single, uniform component structure.
- Dynamic details fetcher resolving show creators, episodes, and external ID mappings (including IMDB IDs) for all TV show records.
5. Premium Dark User Interface
A custom UI designed for dark ambient environments.
- Seamless, frameless layout with custom-implemented title bar drag and window control bindings.
- Clean visual language utilizing Inter typography, obsidian-glass backgrounds, and responsive hover transition feedback.
- Live download progress status tracking with active card queues showing real-time network speeds and completion percentages.

















