Documentation

Grablytic Docs

Everything a user needs: install the right binary, learn the features, get straight answers, and fix common problems. Grablytic is free forever, works fully offline after setup, and sends zero telemetry.

Per-OS walkthrough Install Grablytic → Pick the right APK variant, .deb/.rpm/Arch package, or Windows zip. Verify SHA-256 checksums and finish first-launch setup. Capability tour Features guide → Quality ladders, playlists, batch queues, audio extraction, subtitles, SponsorBlock, profiles, and presets — what each does and where to find it. The complete manual Using Grablytic → Every screen and setting explained: Format Picker, audio, playlists, subtitles, SponsorBlock, queue, speed tuning, cookies, and automation. Long-form answers FAQ → Is it free? Which devices work? Do I need an account? JS runtimes, updates, contributing — answered in depth. Symptom → fix Troubleshooting → YouTube failures, slow fragments, stuck-at-99%, geo-blocks, resume, and log export — diagnosed step by step. Release notes Changelog → Complete history of releases, fixes, engine upgrades, and architecture changes from v0.0.1 to v0.0.6.
Getting started

Three steps to your first download

  1. 1.Install the right binary

    Android: grab the APK matching your ABI and preferred JS runtime (arm64 + Deno is the recommended default). Linux: .deb, .rpm, Arch package, or portable tarball. Windows: portable zip. Full per-OS walkthrough in the install guide.

  2. 2.Let first-launch setup finish

    On first run Grablytic verifies its engine (FFmpeg, JS runtime, yt-dlp) with SHA-256 integrity checks. On Android everything ships inside the APK; on desktop missing components are fetched automatically. Wait for the ready status before downloading.

  3. 3.Paste a link and pick a format

    Paste any supported URL on the Home tab, open the Format Picker to choose quality (up to 4K where the platform offers it), then download. For whole channels or multi-link jobs see playlists & batch in the features guide.

Inside the app

Where everything lives

The app opens on three tabs (Home, Library, Settings) — narrow phones get a bottom bar, wide screens a side rail.

Home — your queue

URL input, active downloads with live speed, engine status, and error-recovery cards when something needs you.

Format Picker

Every stream for a link with preview header (thumbnail, duration, counts) — pick exact quality, audio-only, subtitles, or a preset.

Playlist Selection & Batch

Multi-select entries from a playlist (reverse, shuffle, ranges), or paste many URLs at once with clipboard and file import.

Library & History

Finished files with search, filters, and grid/list views; a full SQLite-backed history of everything fetched.

Presets & Profiles

7 built-in download recipes plus your own customs; per-site profiles for YouTube 4K, podcasts, FLAC, and more.

Cookie WebView

In-app browser that signs you in and exports cookies for age-gated or member content — strictly opt-in.

Diagnostics & Logs

Engine health cards, a live filterable log stream, per-download logs, and one-tap log export for bug reports.

Settings

Quality ceiling, network and proxy, aria2c, concurrency, subtitles, SponsorBlock, schedule, archive, templates, watchlists, and update channels.

Privacy & security

Private by architecture, not by promise

  • Zero telemetry: no accounts, no ads, no analytics SDKs. All extraction and processing happens on your device.
  • Sandboxed secrets: session cookies are stored app-private (0600) and never leave your device; logs redact tokens automatically.
  • Verified binaries: every engine component is SHA-256 integrity-checked; dangerous yt-dlp execution flags are disabled.
  • TLS everywhere, parameterized storage queries, and hardened archive extraction (Zip-Slip / Tar-Slip guards).

Read the full policy at SECURITY.md on GitHub. Found a vulnerability? Report it privately via GitHub Security Advisories — never in a public issue.

License & DMCA

Open source, with respect for creators

Grablytic is 100% open source under the GNU General Public License v3.0 — inspect, audit, and improve every line. It hosts no media: all streams are fetched directly from public platform sources onto your own device via yt-dlp.

Rights holders: takedown inquiries and contact details live in the DMCA notice on GitHub.

Still stuck? Troubleshoot a problem or file an issue on GitHub.