Download videos, audio and playlists. Keep an offline library, search subtitle moments, study with timestamped notes, and export reusable clips.
OpenYT is a local-first application built with Kotlin Multiplatform, Compose Multiplatform, yt-dlp and FFmpeg. Downloads, library records and settings stay on your device. There is no OpenYT account or remote download server.
Download · All supported sources · Usage guide · Library expansion · Brand guidelines
- Download profiles: Study offline, Audio only, Save space and Watch on TV, plus editable custom profiles. Review compatibility, destination and fallback before downloading; queued requests retain their approved settings.
- Durable offline media: local artwork/subtitle assets, explicit readiness, pinning, cache budgets and cleanup previews. Changed or missing media is shown with recovery actions rather than an incorrect offline-ready badge.
- Find and study moments: search indexed SRT/VTT subtitles and play a result at its timestamp. Add notes, bookmarks, saved ranges, A/B repetition and study progress; export Markdown notes with local-entry links. This searches available subtitles; speech transcription is not included.
- Portable backup and recovery: preview and restore selected media, companion assets, collections, tags, study records and playback positions without an account. Find moved files with content hashes and reconnect them with explicit approval. Portable backups are unencrypted and exclude credentials/local grants.
- Video, audio and playlists: inspect a link, review metadata and thumbnails, choose the available format, select playlist/channel/album entries, and choose formats per item. Files can be numbered and grouped into playlist folders.
- Download queue: priorities, 1–4 concurrent downloads, pause/resume with partial files preserved, cancellation, manual retry, automatic retry with backoff, speed limits and download time windows. Recover interrupted work after restarting the app.
- Local media library: search titles, authors, tags and sources; filter video, audio, missing files and possible duplicates; sort by title; create collections and smart collections; edit metadata and inspect technical media details.
- File organization: naming templates and organization presets, bulk rename/move with a preview, folder scanning/import, JSON library export/import, file verification, duplicate review and a storage report with import recovery. Removing a library record preserves the media file.
- Playback: a shared queue, saved playback positions, resume after restart, previous/next and ten-second seeking. Android adds background audio and system PiP; desktop adds a floating mini-player and keyboard controls.
- Audio tools: M4A, MP3, Opus, FLAC and WAV presets, optional loudness normalization and local audio conversion through FFmpeg.
- Video tools: reported manual/automatic subtitle tracks as sidecars or embedded captions, chapter preservation, optional SponsorBlock chapter marks, segment selection/preview and bounded live-stream capture.
- Batch clips: build several ranges, choose a fast keyframe cut or precise export, fit/crop portrait video, burn indexed captions and select a cover when supported by the packaged tools. Preview the recipe, retain per-clip results and retry failures without duplicating completed clips. Originals are preserved.
- Subscription rules: follow RSS/Atom or playlists with duration filters, profiles, backlog/check limits and storage reserves. Inspect decision history and approve replay explicitly. Android adds optional Wi-Fi/unmetered/charging conditions and bounded background discovery; downloads still require the app to be open. Desktop does not install an OS background scheduler.
- Link intake and sharing: paste, Android share intake, desktop dropped links,
validated
openyt://links, an optional active-tab browser extension and a desktop CLI. Share completed Android media through the OS chooser; open or reveal desktop files with the system's applications. - Language and appearance: automatically follow the OS language, with Brazilian Portuguese and English overrides; system/light/dark themes; shared OpenYT branding; source logos and accessible fallback tiles; responsive phone, tablet and desktop layouts.
- Optional conveniences: foreground-only clipboard suggestions and download notifications, both off by default; authorized local cookies encrypted at rest.
- Updates and diagnostics: a searchable installed-source catalog, explicitly requested checksum-verified yt-dlp updates, redacted diagnostics and application installer verification against a pinned signed release manifest.
Windows bundles VLC/libvlc for embedded playback, resume and the mini-player. Linux/macOS require a separately installed VLC/libvlc; otherwise files open in the OS player. Live capture defaults to 60 seconds and can be bounded from 1 second to 24 hours. Generic photo/image gallery downloading is outside this release (ADR-0023).
The installed yt-dlp engine supplies the source catalog. Examples include:
- Social video: YouTube, Instagram, TikTok, X/Twitter, Facebook, Reddit, Pinterest, Bluesky, Tumblr and VK.
- Video and live streams: Vimeo, Twitch, Dailymotion, Rumble, Bilibili, PeerTube, Kick, Niconico and Internet Archive.
- Music and audio: SoundCloud, Bandcamp, Mixcloud, Audius and supported podcast feeds.
- Learning and broadcasts: TED, Khan Academy, LinkedIn Learning, Udemy, BBC and ARTE, subject to the source's access requirements.
- Other supported media: Telegram embeds, direct media links and the additional providers and embed extractors in the complete catalog.
Browse the complete source catalog: 1,754 extractor entries →
(machine-readable JSON). This is the desktop
4.0.0 reference catalog, not a count of distinct websites or verified working URLs.
It preserves the engine's 136 CURRENTLY BROKEN warnings. Android's bundled
version and explicit engine updates can produce a different catalog.
Open Home → Sites and sources to search the engine on your device. A provider can expose separate entries for videos, playlists, channels and embedded players. Availability depends on the installed version, source changes, region and authorized access. Source logos identify providers and do not imply affiliation.
The expansion adds profile previews and explicit offline readiness:
Offline capture details and mobile variants.
These expansion captures use the real shared Compose UI with deterministic test ports. See the expansion validation ledger for native tests, emulator evidence and capability limits, and the automation and clips guide for the new workflows.
The following older captures show OpenYT 4.0.0. The desktop library uses labeled demo media; the Android PiP capture uses an emulator and a generated test clip. Capture provenance records the source of each image.
Search your files, keep a Learning collection, save a smart collection, or filter by media kind and file availability. Each available item offers playback, media processing, details and collection assignment. Select multiple records to preview a bulk rename or move before applying it.
Play an available Library item. On desktop, Space pauses/plays, ←/→ jump ten seconds, M toggles the floating window, and Escape expands it. Choose Resume playback to restore the saved session. Android uses the system PiP window for video and supports background audio.
See the installed Windows app
The Windows MSI and EXE are tested for branded shortcuts, visible playback and exact file selection in Explorer, including the first opening of a video-only folder. This capture uses generated media in a real Windows 11 session.
See the native validation record for Explorer screenshots, contract results and build fingerprints.
New installations use System language: Portuguese locales select Brazilian Portuguese; other locales currently fall back to English. In Settings, select System, Português or English explicitly, choose the appearance and concurrency, and opt into copied-link suggestions or download notifications. Existing saved language choices are preserved.
Follow a playlist or subscribe to a podcast/RSS feed
Open Settings → Local automation → Add subscription. Enter a title, URL and check interval, then select a playlist or RSS/podcast feed. Leave Also download existing items off to establish a baseline and fetch only new entries. Choose duration limits, a download profile, pending/check caps and a minimum free space reserve. Preview/history explains filtered or deferred episodes before any download. On Android, optional bounded background checks discover and queue episodes; open the app to start them. See the rules guide.
Find a source or create a local clip
Home → Sites and sources searches the installed engine rather than a fixed marketing list. In Library → Media processing, choose a clip interval or an audio preset. The output is a new file, and the original is preserved.
Get the latest stable OpenYT from Releases. The release includes Android APK, Linux DEB/RPM/AppImage/Flatpak/Arch packages, Windows MSI/EXE, macOS DMG, the browser handoff extension, per-host software inventories and signed checksums.
See the 4.0.1 Windows validation record for installed MSI/EXE contracts and real interface evidence.
- Download
androidApp-release.apkfrom the release. - Allow your browser or file manager to install the APK, then open it.
- Launch OpenYT. Requires Android 8.0+; yt-dlp and FFmpeg are bundled.
The release APK uses the project's production signing certificate. Completed media can be shared through installed Android apps, imported through the system file picker, or exported to a selected storage tree.
# Debian/Ubuntu, x86_64
wget https://github.com/AlexandreZanata/OpenYT/releases/latest/download/openyt_4.0.1_amd64.deb
sudo apt install ./openyt_4.0.1_amd64.debRPM, AppImage, Flatpak and an Arch package/recipe are also available. Desktop releases bundle yt-dlp, FFmpeg, FFprobe and Deno. Install VLC/libvlc separately for embedded playback and the mini-player. Flatpak grants access to Downloads by default; additional folders need explicit permissions.
Download and run OpenYT-4.0.1.exe or OpenYT-4.0.1.msi. The desktop tools and
VLC playback runtime are bundled. Both installers create branded desktop and
Start-menu shortcuts. Play uses the embedded player; Show in folder opens
Explorer with the file selected. Windows installers do not
currently carry Authenticode signatures, so SmartScreen can display a warning.
Use the official release and its signed checksums to verify the downloaded file.
Open OpenYT-4.0.1.dmg and drag OpenYT to Applications. Desktop tools are bundled;
VLC is separate. The app is currently unsigned and not notarized, so opening it
is subject to the Mac's Gatekeeper policy. Native CI validates the copied bundle
and launcher; see the validation ledger.
- Paste or share an authorized media URL into Home.
- Select Inspect (Analisar in Portuguese). Review the title, thumbnail, available formats, or playlist entries returned by the source.
- Choose Video or Audio, the format and the items you want. Expand Download options for subtitles, audio conversion, normalization, chapters, a segment or a bounded live capture.
- Select Download or Download selected. Follow progress in Downloads, then play and organize completed files in Library.
For a playlist, the default organization creates a named folder with entries numbered in their original order. Settings provides alternative organization presets and editable file-name templates. See the usage guide for cookies, playback, local processing, automation, data locations and recovery.
There is no OpenYT account, telemetry or remote download service. Media and thumbnail requests go to their sources. Update checks use GitHub; optional SponsorBlock marking contacts that service only when enabled. Clipboard reads are opt-in and stop when the app loses foreground focus. Imported cookies remain local and encrypted at rest.
Application updates verify the pinned signed manifest and checksums before opening an installer, which still requires OS confirmation. Settings → Update engine explicitly downloads and verifies official stable yt-dlp. Other bundled tools update with application releases. Removing a Library record never deletes the corresponding file.
Product code is Kotlin. Shared logic uses Kotlin Multiplatform, shared UI uses Compose Multiplatform, persistence uses SQLDelight, and extraction/conversion delegate to external yt-dlp and FFmpeg. There is no backend.
androidApp/ Android host and platform adapters
desktopApp/ Compose JVM host, CLI and platform adapters
core/ Pure Kotlin domain models, ports and use cases
engine-ytdlp/ Shared engine output, progress and error parsing
data/ SQLDelight persistence and repository implementations
media-ffmpeg/ Adapter invoking external FFmpeg
browserExtension/ Kotlin/JS active-tab URL handoff
ui/ Shared Compose UI and design system
docs/ Usage, architecture, ADRs, branding and validation
Read the architecture overview and relevant
ADRs before changing modules. core is independent of UI, I/O and
platform SDKs; host apps implement and inject platform ports.
Requirements: JDK 17+ (21 recommended), Android SDK platform/build-tools 36
and ANDROID_HOME or local.properties with sdk.dir. Packaging downloads the
pinned desktop tools. Running desktop directly from source requires yt-dlp,
FFmpeg and Deno on PATH.
./gradlew :androidApp:assembleDebug
./gradlew :desktopApp:run
./gradlew :desktopApp:createDistributable
./gradlew :desktopApp:packageDebThe packaged launcher also exposes headless commands. Close the GUI before
commands using the engine or stored state; an exclusive coordinator lock
protects queue and library records. version and link remain available while
the GUI is running.
OpenYT --cli inspect --url '<authorized-url>' --json
OpenYT --cli download --url '<authorized-url>' --kind video --dir '<folder>' --json
OpenYT --cli playlist --url '<authorized-playlist-url>' --kind audio --limit 5 --json
OpenYT --cli library --list --json
OpenYT --cli sources --json
OpenYT --cli versionThe optional browser ZIP contains an unpacked active-tab handoff extension. Load
it through the browser's extension developer screen. It forwards a validated
openyt:// link for review in the app; browser-store publication is separate.
Run deterministic unit and UI suites:
./gradlew :core:desktopTest :engine-ytdlp:desktopTest :data:desktopTest \
:media-ffmpeg:desktopTest :desktopApp:testValidate the real Linux package with isolated data directories:
./scripts/validate-linux.sh --scenario all --no-build --offline
# External-network scenarios are opt-in and run separately:
./scripts/validate-linux.sh --scenario all --no-buildThe 4.0 validation ledger records executed checks and limitations: local engine/FFmpeg/VLC contracts, packaged Linux upgrade and handoff, Android emulator instrumentation, and native Windows/macOS installer and media contracts. It does not claim manual GUI or physical-device coverage on every platform. The published release notes contain final workflow evidence.
- User-reported video regression contracts
- Windows playback, shell and shortcut contracts
- Expansion regression contracts
- Release pipeline and signing
- Current status and limitations
- Brand assets and usage rules
- Source icon licenses and rules
OpenYT is distributed under GPL-3.0, including the requirements of the Android yt-dlp wrapper. yt-dlp itself is Unlicense; FFmpeg licensing depends on the packaged build. See LICENSE and THIRD_PARTY_NOTICES.md.
Download only content you are authorized to obtain, in accordance with the source's terms. OpenYT does not bypass DRM or access restrictions.









