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).
| Platform | Architecture | Desktop App | CLI (npm) |
|---|---|---|---|
| Linux | amd64 / arm64 | Available | Available |
| Windows | amd64 | Available | Available |
| macOS | Intel / Apple Silicon | Coming soon | Available |
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
- Open Yaria and paste any video URL into the download bar. Click Fetch to retrieve available formats, then download.
- Unlock Mantorex: open the Mantorex tab and click Start 30-day free trial, or activate a paid Pro key in Settings > General.
- 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:
| 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). Unlock Mantorex with a 30-day free trial or a paid Pro license.
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 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
| 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. 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
| 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.
Free Trial
Yaria Pro (Mantorex) includes a 30-day free trial. No credit card or account is required.
- Install and open the Desktop App.
- Switch to the Mantorex tab.
- Click Start 30-day free trial on the Pro gate screen.
- 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.liveonce 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.
- Open Settings > General > License, or use the key field on the Mantorex Pro gate.
- 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 (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
| 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 | Available |
| 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.