Documentation
Complete guide to Yaria, a desktop video downloader and personal media server.
Installation
Download the latest version for your platform from yaria.live/download.
| Platform | Architecture | Status |
|---|---|---|
| Linux | amd64 | Available |
| Windows | amd64 | Coming soon |
| macOS | Intel / Apple Silicon | Coming soon |
Run the installer or application for your platform. Required dependencies (video processing tools) are automatically installed on first launch.
Quick Start
- Open Yaria and paste any video URL into the download bar. Click Fetch to retrieve available formats, then download.
- Activate a Pro license in Settings > General > License to unlock Mantorex.
- Switch to the Mantorex tab to search, stream, and manage your personal media library.
Video Downloader
The Yaria tab provides a full-featured video and audio downloader. Paste any supported URL and click Fetch to retrieve media information.
Media preview
After fetching, Yaria displays the video thumbnail, title, uploader name, and duration so you can confirm the correct content before downloading.
Format selection
A format grid lets you choose your preferred output. Available options include:
| Type | Options |
|---|---|
| Video | 2160p, 1440p, 1080p, 720p, 480p, 360p |
| Audio | MP3, M4A, Opus, WAV, FLAC |
Download options
- Output directory. Choose where to save files using the built-in file browser.
- Progress tracking. Real-time percentage, download speed, and estimated time remaining.
- Accelerated downloads. Uses multiple connections for faster speeds.
- Batch downloads. Supports playlists and multiple URLs.
- Wide compatibility. Supports a broad range of popular platforms and formats.
Downloads Manager
The Downloads Manager shows all active and past downloads in one place.
- Active downloads display real-time progress bars, current speed, ETA, and a cancel button for each item.
- History lists completed, errored, and cancelled downloads.
- Clear completed button removes finished items from the list.
Settings
Settings are organized into six panels, accessible from a sidebar within the settings view.
General
- License management. Activate, deactivate, and view license status.
- Metadata API key. Configure an API key for enhanced metadata and artwork.
- Proxy settings. Choose between None, HTTP, or SOCKS5 proxy configurations.
Downloader
- Speed limit. Set a maximum download speed.
- Concurrent downloads. Control how many downloads run simultaneously.
Content
- Cache management. View cache size statistics and clear cached data with dedicated buttons.
Local Media
- Media folders. Add or remove folders for Movies, TV Shows, and Videos.
- Scan. Trigger a manual scan of configured folders.
- Hardware acceleration. Information about hardware-accelerated playback support.
Media Server
- LAN server. Start or stop the media server, configure the port, and set an optional PIN for access protection.
- DLNA/UPnP. Enable a DLNA server for smart TVs, consoles, and other compatible devices.
About
- Application version information.
- Links to privacy policy and terms of use.
Mantorex Overview
Yaria has two main tabs: Yaria (free video downloader) and Mantorex (Pro personal media server). Activating a Pro license unlocks the Mantorex tab.
Three modes
Mantorex operates in three modes, selectable from the interface:
| Mode | Description |
|---|---|
| Local | Browse and play media from your local library |
| Remote | Connect to remote machines via SSH/SFTP or SMB and play media directly |
| Online | Discover and stream content from online sources |
Navigation
- Search bar. Appears in the navigation bar when Mantorex is active, enabling quick searches across all modes.
- Trending content. The home screen shows trending media when a metadata API key is configured in Settings.
- Category filters. Filter by All, Movies, TV Shows, or Anime.
Content Discovery
Search across multiple online sources simultaneously to find the content you want. Results are aggregated from all available providers into a single view.
Search results
- Metadata cards. Results display poster artwork, title, year, and ratings when metadata is available.
- Source results table. For each item, a detailed table shows the source name, availability information, and action buttons to stream or download.
- Sorting. Sort results by quality, availability, or file size.
Media Details
Selecting a title opens a rich detail page with comprehensive information about the content.
Detail page contents
- Poster artwork, title, year, content type, and rating.
- Plot overview, cast, director or creator, genres, and production companies.
- Add to Library button to save content for later.
TV show browsing
For TV shows, the detail page includes a season browser with expandable episode lists. Each episode shows its air date and supports per-episode searching from online sources. Seasons are grouped with quality badges indicating available resolutions (4K, 1080p, BluRay, WEB).
Built-in Player
Yaria includes a full-featured video player for playing local and streamed media directly within the app.
Player controls
- Play/pause, seek bar, volume control, and fullscreen toggle.
- Audio track selection for multi-language content.
- Subtitle track selection.
- Buffer status indicator when streaming.
Smart codec handling
The player attempts native playback first. If the codec is not supported natively, it automatically transcodes the stream. If transcoding is not possible, it falls back to an external player (mpv or VLC).
Watch position
Your playback position is saved automatically. When you return to a video, playback resumes where you left off.
Keyboard shortcuts
| Key | Action |
|---|---|
Space | Play / Pause |
← / → | Seek backward / forward |
↑ / ↓ | Volume up / down |
F | Toggle fullscreen |
M | Toggle mute |
Library
The Library provides a unified view of all your media, combining local files and discovered content into a single browsable interface.
Sections
- Continue Watching. Items you have started but not finished, with progress indicators showing how far you got.
- TV Shows. All TV series in your library with episode tracking per season.
- Movies. All movies in your library.
- Watch History. Completed items you have already finished.
Organization
- Sorting. Sort by recently added, recently watched, title, or rating.
- Search and filter. Find specific content across your entire library.
- Episode tracking. For TV series, track which episodes you have watched and where you left off.
Content Downloads
The Mantorex downloads view manages content acquired from online sources.
Download status
Each download shows its current state (downloading, paused, complete, or error), percentage progress, speed, and estimated time remaining.
Actions
- Pause / Resume. Temporarily stop and restart downloads.
- Cancel. Stop a download in progress.
- Remove. Remove a download from the list.
- Delete with files. Remove the download and delete associated files from disk.
- Play. Completed items can be played directly from this view.
Local Media
Local Media lets you manage and play video files already on your computer. Configure media folders in Settings > Local Media.
Auto-scan and metadata
When you add folders, Yaria scans them automatically. Each recognized file is matched to its metadata, and poster artwork is downloaded for a rich browsing experience. Unrecognized files can be matched manually.
Browsing
- Recently Added. Newly scanned content appears at the top.
- Movies grid. Browse all movies with resolution tags and duration info.
- TV Shows. Series are grouped with season and episode counts.
- Search. Live filtering as you type.
Click any item to play it directly in the built-in player.
Remote Sources
Connect to remote machines and play media files without transferring them to your local device.
Connection types
| Protocol | Use Case |
|---|---|
| SSH / SFTP | Secure access to remote Linux or macOS machines |
| SMB / Samba | Access shared folders on Windows machines or NAS devices |
Features
- Saved profiles. Store connection details (host, port, username) for quick access.
- Network discovery. Automatically finds SSH and SMB devices on your local network.
- Remote file browser. Navigate the remote file system with breadcrumb navigation.
- Direct playback. Play remote media files directly in the built-in player.
Media Server & DLNA
Yaria can serve your media library to other devices on your local network.
LAN media server
Start a web-based media server accessible from any browser on your network. Configure the port and optionally protect access with a PIN code. Start and stop the server from Settings > Media Server.
DLNA / UPnP
Enable a DLNA/UPnP server to make your media available on smart TVs, game consoles, and any other DLNA-compatible device. DLNA devices on your network will automatically discover and list your media library.
License Activation
A Pro license unlocks all Mantorex features. Activation is done entirely within the app.
- Open Settings > General > License.
- Enter your license key in the format
YARIA-XXXX-XXXX-XXXXand click Activate. - The license binds to your device on first activation.
- All Mantorex features are immediately unlocked.
Key rules
- One key, one device. Each license key can only be activated on a single machine.
- 7-day revalidation. The license is verified with the server every 7 days while online.
- 14-day offline grace. If the device is offline, the cached license is trusted for up to 14 days. After that, Mantorex features are temporarily locked until the device reconnects and revalidates.
Device Binding
Each license is bound to a specific device using a hardware fingerprint. This ensures that one key cannot be shared across multiple machines.
Fingerprint components
| Component | Description |
|---|---|
| Operating System | The OS the device is running |
| Hostname | The machine's network name |
| Username | The current user account |
| Machine ID | A platform-specific hardware identifier |
These attributes are combined to produce a 16-character hex device ID, for example:
a1b2c3d4e5f6a7b8
If you reinstall your operating system or switch to a different machine, contact support for a free license reset.
Supported Platforms
| Platform | Architecture | Status |
|---|---|---|
| Linux | amd64 | Available |
| Windows | amd64 | Coming soon |
| macOS | Intel / Apple Silicon | Coming soon |
Privacy & Legal
- No telemetry or analytics. Yaria does not collect any usage data.
- All data stored locally. Your library, settings, and watch history never leave your device.
- Minimal network calls. License validation is the only communication with yaria.live servers.
- Third-party content. Content obtained from external sources is the user's responsibility. Yaria does not host, distribute, or endorse any content.