Installation

Desktop App (Linux)

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

Installs to ~/.local/bin/ (launcher + binary), desktop menu entry, and icons. Direct package: yaria-app-linux-amd64.tar.gz.

If yaria-app is not found, open Yaria from the app menu, run ~/.local/bin/yaria-app, or add ~/.local/bin to your PATH (the installer prints the exact lines when needed).

• The app installs in your home folder (not a system-wide root install).
• WebKitGTK 4.1 is required for the windowed UI. The installer and launcher try to install it automatically on common distros; you may be asked for your password once for that system package only.
• If that fails, install manually, e.g. sudo pacman -S webkit2gtk-4.1 gtk3 or sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0 or sudo dnf install webkit2gtk4.1 gtk3.
• First launch may download tools (yt-dlp, aria2, ffmpeg, …) in the background. That can take a minute on a slow connection. The free downloader works without signing up; Mantorex is optional Pro (trial available in the app).

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 usually already installed with Edge. Windows may show SmartScreen once: choose More info → Run anyway.

First launch auto-downloads tools (yt-dlp, aria2, FFmpeg, deno, and optional portable mpv) into %USERPROFILE%\.yaria\dependencies\. That can take a minute.

CLI (all platforms via npm)

npm install -g @zsnero/yaria

Terminal only, not the windowed desktop app. Use the Linux installer or Windows zip above if you want the GUI. Mantorex features in the CLI/desktop require a Pro key (or trial) to unlock.

Auto-installed tools (first launch)

The desktop app fetches missing tools into ~/.yaria/dependencies/ (or %USERPROFILE%\.yaria\dependencies\ on Windows) when needed:

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. Optional — Yaria Bridge: install the Firefox add-on, enable Settings → Bridge in the app, paste the pairing token, then send pages to Downloads from the browser.
3. Unlock Mantorex: open the Mantorex tab and click Start 30-day free trial, or activate a paid Pro key in Settings > General.
4. 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:

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 (including jobs sent from Yaria Bridge).

• Active downloads display real-time progress bars, current speed, ETA, plus Pause, Resume, and Cancel.
• History lists completed, errored, and cancelled downloads.
• Retry restarts failed or cancelled jobs; Copy copies the source URL.
• Clear completed removes finished items from the list (files stay on disk unless you Delete).

Yaria Bridge

Yaria Bridge is a free browser add-on that detects media on web pages and sends download jobs to the Yaria desktop app over a local bridge (default 127.0.0.1:19547). Nothing is uploaded to yaria.live.

Install

• Firefox (recommended): install from addons.mozilla.org — Yaria Bridge.
• Chrome / Edge / Chromium: load the unpacked extension from the project source (Chrome Web Store listing may follow). See the extension README for developer load steps.
• Desktop app download: yaria.live/download.

Pair with the desktop app

1. Start Yaria and open Settings → Bridge.
2. Ensure bridge integration is Enabled (status should show running).
3. Show or Copy the pairing token.
4. In the browser add-on settings, paste host 127.0.0.1, port 19547 (unless you changed it), and the token. Use Test connection.
5. Optional: set the Default download folder in Bridge settings (uses Yaria’s built-in folder picker).

Using the add-on

• Open a page with video/audio, click the toolbar icon, pick a quality (or Best), then Download.
• Or right-click → Download page / link with Yaria.
• If Yaria is already open, the job is queued in that instance and the app tries to focus the Downloads page. If Yaria is closed, start the app first (the extension does not auto-launch it).

Privacy

The add-on only talks to your local bridge. Full policy: https://yaria.live/privacy-bridge.

Settings

Settings are organized into six panels, accessible from a sidebar within the settings view.

General

• License management. Activate, deactivate, and view license status (Pro / Trial).
• Metadata API key. Optional TMDB key for richer posters and metadata.
• Proxy settings. None, HTTP, or SOCKS5.
• Appearance. Font (default Roboto), size, UI scale, animations (default off), blur/glass effects.
• Open on startup. Choose whether the app opens on the Yaria tab or Mantorex (Local).
• Video player backend. WebView (built-in, default) or Native (libmpv/mpv) for wider codec support. Native tools are auto-downloaded when possible.

Downloader

• Speed limit. Cap download throughput.
• Concurrent downloads. How many Yaria downloads run at once.

Bridge

• Enable / disable the localhost bridge used by the Yaria Bridge browser add-on.
• Port and pairing token (copy into the add-on settings).
• Default download folder for jobs sent from the extension (Linux and Windows).

See Yaria Bridge for full setup. Privacy: /privacy-bridge.

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 opens on Local by default when you switch to the Mantorex tab (configurable under Settings > Open on startup). Three modes are available:

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 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

• WebView player (default). Plays streams the browser engine supports. Containers like MKV are remuxed on the fly with FFmpeg into a browser-friendly format when needed (especially on Linux WebKit).
• Native player (optional). Uses libmpv (Linux) or portable mpv (Windows) for broader codec support. Enable under Settings > Video Player; the app tries to install mpv automatically if missing.
• Low disk space. Prefer enough free space for downloads. Fully downloaded files use progressive remux when possible to avoid large temporary segment caches (helpful on live USBs).

Watch position

Your playback position is saved automatically. When you return to a video, playback resumes where you left off.

Keyboard shortcuts

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

• Start from torrents. Choosing a folder starts the download and shows a notification (e.g. Download started: Title…) without leaving the torrents page.
• 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

• Continue Watching. In-progress titles with resume position.
• Movies grid. Browse movies with resolution tags and duration.
• TV Shows. Series grouped with season and episode counts.
• Search. Filters movies, TV shows, episodes, and continue-watching items as you type.

Click any item to play it in the built-in player.

Remote Sources

Connect to remote machines and play media files without transferring them to your local device.

Connection types

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

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

Settings are stored in ~/.config/yaria/app.toml (Windows: under your user config directory). App data and auto-downloaded tools live under ~/.yaria/.

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.
• Yaria Bridge add-on. Talks only to your local desktop bridge. See Bridge Privacy Policy.
• Third-party content. Content obtained from external sources is the user's responsibility. Yaria does not host, distribute, or endorse any content.

Privacy Policy · Bridge Privacy · Terms