Documentation

Complete guide to Yaria, a desktop video downloader and personal media server.

Installation

Desktop App (Linux)

curl -fsSL https://yaria.live/install.sh | bash

Installs the desktop app to ~/.local/bin/ with icons and menu entry. No root required. Direct package: yaria-app-linux-amd64.tar.gz.

Desktop App (Windows)

Download the portable package, extract it, and run yaria-app.exe. No installer required.

https://yaria.live/download/yaria-app-windows-amd64.zip

Works on Windows 10/11 (amd64). WebView2 is typically already present via Microsoft Edge. First launch downloads yt-dlp and FFmpeg into %USERPROFILE%\.yaria\dependencies\.

CLI (all platforms via npm)

npm install -g @zsnero/yaria

Installs the Yaria CLI binary for your platform (Linux, macOS, Windows). Includes Mantorex (requires Pro key to unlock).

PlatformArchitectureDesktop AppCLI (npm)
Linuxamd64 / arm64AvailableAvailable
Windowsamd64AvailableAvailable
macOSIntel / Apple SiliconComing soonAvailable

The Desktop App auto-installs required dependencies (yt-dlp, FFmpeg) on first launch. The app includes a built-in self-update system for Linux and Windows.

Quick Start

  1. Open Yaria and paste any video URL into the download bar. Click Fetch to retrieve available formats, then download.
  2. Unlock Mantorex: open the Mantorex tab and click Start 30-day free trial, or activate a paid Pro key in Settings > General.
  3. Use Mantorex to search, stream, download torrents, 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:

TypeOptions
Video2160p, 1440p, 1080p, 720p, 480p, 360p
AudioMP3, 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). Unlock Mantorex with a 30-day free trial or a paid Pro license.

Three modes

Mantorex operates in three modes, selectable from the interface:

ModeDescription
LocalBrowse and play media from your local library
RemoteConnect to remote machines via SSH/SFTP or SMB and play media directly
OnlineDiscover 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.
All Movies TV Shows 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 detail page with overview, cast, seasons, and available sources.

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

KeyAction
SpacePlay / Pause
/ Seek backward / forward
/ Volume up / down
FToggle fullscreen
MToggle 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. Recognized files get metadata and posters. Anything it misses, you can match by hand.

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

ProtocolUse Case
SSH / SFTPSecure access to remote Linux or macOS machines
SMB / SambaAccess 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.

Free Trial

Yaria Pro (Mantorex) includes a 30-day free trial. No credit card or account is required.

  1. Install and open the Desktop App.
  2. Switch to the Mantorex tab.
  3. Click Start 30-day free trial on the Pro gate screen.
  4. Mantorex unlocks immediately with full Pro features.

Trial rules

  • One trial per device. Bound to your device ID on the license server. Reinstalling does not grant a new trial.
  • 30 days from start. Expiry is enforced by the server; Settings shows your trial end date.
  • After the trial. Mantorex locks again until you enter a paid Pro license key. Free Yaria downloads keep working.
  • Internet required to start. Starting a trial contacts yaria.live once to issue the trial license.

License Activation

A paid Pro license unlocks Mantorex permanently (lifetime). You can also activate a key during or after a trial.

  1. Open Settings > General > License, or use the key field on the Mantorex Pro gate.
  2. Enter your license key in the format YARIA-XXXX-XXXX-XXXX and click Activate.
  3. The license binds to your device on first activation.
  4. All Mantorex features are immediately unlocked (Settings shows PRO or TRIAL).

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.
  • Paid licenses do not expire (lifetime). Trial licenses expire after 30 days.

Device Binding

Each license is tied to one device (hardware fingerprint), so a single key cannot be used on multiple machines at once.

Fingerprint components

ComponentDescription
Operating SystemThe OS the device is running
HostnameThe machine's network name
UsernameThe current user account
Machine IDA 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

PlatformArchitectureStatus
Linuxamd64Available
Windowsamd64Available
macOSIntel / Apple SiliconComing soon
  • 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.