Welcome to the SWAYA documentation! SWAYA is a modern, privacy-first desktop media workstation designed to organize, enrich, browse, and watch personal media collections.
Quick Overview
SWAYA transforms disorganized video files into a structured, visually engaging media library. Whether you are sorting raw video dumps, organizing multi-season TV shows, or curating custom performer lists, SWAYA provides automated metadata matching, customizable renaming pipelines, and integrated playback with real-time progress tracking.
Core Pillars
- Intelligent File Organizer: Automated matching against online databases (TMDb, OMDb, StashDB, ThePornDB, FansDB) with custom renaming syntax and conflict resolution.
- Dual-Mode Privacy (SFW/NSFW): Instant session toggling with server-side image proxying, discrete mode switches, and vault isolation.
- High-Performance Playback: GPU-accelerated embedded MPV player with multi-audio, subtitle rendering, and external player support (VLC, MPC-HC).
- Rich Metadata & Artwork: Automatic high-res poster and backdrop fetching, transparent logos, actor filmographies, studio portfolios, and custom visual art pickers.
- Personalized Curation: Custom lists with collage artwork, granular 10-star rating system with half-star steps, tag focus modes, and in-depth watch logs.
Feature Guides Index
Explore each core module in detail:
- Dashboard & Discovery: Personalized home screen, continue watching queue, spotlight banner, and discovery feeds.
- Smart File Organizer: Batch matching, regex renaming templates, collision resolution, and metadata overrides.
- Playback Engine: GPU accelerated MPV engine, subtitle sync, video zooming, and external players.
- Universal Search: Multi-source global searching, instant filters, and deep entity exploration.
- Settings & Configuration: Library root directories, template presets, API keys, and theme customizations.
- Library Analytics & Statistics: Storage visualization, Library DNA genre breakdown, and viewing timelines.
- Ratings & Reviews: 10-star rating metrics, private markdown notes, and favorite collections.
- Custom Lists & Curated Collections: Dynamic multi-item lists, collage covers, and JSON import/export.
- Watch History & Playback Logs: Resumption tracking, watch logs, and peaks analytics.
- Torrent Integration: Automated download monitoring, matching, and queue imports.