Virelo

Product Introduction

1. Definition: Virelo is a free, open-source, local-first private video library and web-based media player categorized under open-source self-hosted applications and browser-based video streaming tools. Available as both a zero-install browser app and a self-hosted Node.js/npm package (npx virelo), it runs locally on user devices without requiring cloud uploads or external account registrations.
2. Core Value Proposition: Virelo exists to provide users with a private, Netflix-style streaming experience for their local media collections. By bridging the gap between raw file folders and polished media interfaces, it delivers advanced video library management—including custom playlists, watch progress tracking, volume leveling, and a dedicated vertical Shorts feed—entirely within the user's local computing environment.

Main Features

1. Local-First Web Player & Folder Access: Operating via modern browser File System Access APIs, the Virelo web player reads video directories directly from the host device. It requires no server upload, processing files on-the-fly and supporting local audio conversion, embedded text subtitles, playback speed controls, and multiple player interface styles.
2. Shorts Vertical Video Feed: Virelo automatically indexes portrait-oriented clips into a dedicated "Shorts" interface. Users can swipe through a dynamically generated vertical video feed, tap to pause, flag favorites, and review local vertical content mimicking mainstream social media layouts without privacy compromises.
3. Advanced Playlist Management & Queues: The platform allows users to build, save, and reorder named playlists via drag-and-drop functionality. It features persistent vertical playback queues, shuffle controls, and folder tree exploration via an address bar with path completion.
4. Volume Leveling & Watch Progress Tracking: To counter inconsistent audio mastering across disparate media files, Virelo includes optional volume normalization. Additionally, watch history, playback timestamps, and library favorites persist locally within the browser or self-hosted server environment, allowing seamless viewing resumption.

Problems Solved

1. Pain Point: Users managing large local libraries of movies, home videos, or short clips often rely on rudimentary media players lacking metadata tracking, unified playlists, or modern mobile-style viewing experiences (such as vertical feeds). Furthermore, standard cloud-based streaming platforms compromise data privacy by forcing file uploads to third-party servers.
2. Target Audience: Privacy-conscious media enthusiasts, self-hosters, local-first software advocates, digital archivists, and content creators looking to organize and stream personal video collections across local networks.
3. Use Cases: Organizing sprawling personal movie archives into searchable libraries, streaming local video files to secondary devices over a local network using CLI hosting (npx virelo --host 0.0.0.0), browsing unstructured folders of vertical smartphone clips via a dedicated Shorts feed, and resuming multi-episode series without manually tracking watch timestamps.

Unique Advantages

1. Strengths & Limitations (Pros & Cons):
   • Strengths: Zero data exposure with 100% local-first file processing; requires no account creation or cloud infrastructure; lightweight deployment via npx virelo; includes modern UI features like Shorts feeds, volume leveling, and PWA (Progressive Web App) home screen installation support; licensed freely under AGPL-3.0-only.
   • Limitations: Browser codec support dictates direct playback compatibility for certain file formats (though resolvable via FFmpeg and the CLI tool); browser-based storage limits persistence scope to individual browsers unless running the self-hosted npm server variant; lacks native automatic metadata scraping in the zero-install web-only mode.
2. Key Alternatives & Differentiation:
   • Plex / Jellyfin: While Plex and Jellyfin are robust self-hosted media server alternatives, they require dedicated server installation, client apps, and extensive library configuration. Virelo differentiates itself by offering an instant, zero-install web player mode via browser file access, alongside a lightweight CLI option (npx virelo) and a dedicated vertical Shorts feed tailored for mixed-format personal libraries.
   • VLC Media Player: VLC is a traditional desktop application optimized for individual file playback rather than library aggregation, watch history persistence, custom playlists, and modern streaming UI experiences. Virelo transforms raw directories into an interactive, Netflix-style web library.

Frequently Asked Questions (FAQ)

1. Is Virelo free and open source? Yes, Virelo is free and open source, distributed under the AGPL-3.0-only license. The source code for both the web interface and the command-line interface (CLI) is publicly available on GitHub.
2. Does Virelo upload my video files to the cloud? No. Virelo operates entirely locally. The web player reads user-selected directories directly on the host device, meaning video files are never uploaded to external servers, and favorites, watch progress, and thumbnails are stored locally within the browser.
3. What is the difference between the web player and the self-hosted server? The zero-install web player reads files directly on the local device using browser permissions without requiring an account. The self-hosted npm version (npx virelo) runs locally on a computer, adding multi-user accounts, library permissions, automatic movie/series metadata scraping, and network streaming capabilities.
4. Can I stream videos from my computer to other devices on my network? Yes. By running npx virelo --host 0.0.0.0 inside a terminal on a trusted local network, users can access their Virelo library from other devices by navigating to the host computer's local IP address.
5. Will all video formats play in the browser? Playback compatibility depends primarily on the native video and audio codecs supported by the user's web browser. While Virelo supports embedded text subtitles and local audio conversion for standard formats, users requiring broader format support can utilize the CLI version integrated with FFmpeg.