Skip to content

Getting Started

Jump to bottom
OnlyXianzo edited this page Jun 10, 2026 · 1 revision

Getting Started

TrueStream bundles the Python download engine and all media processing tools. On first launch, the app automatically downloads the required external binaries — FFmpeg for media processing and aria2c for download acceleration — so you don't need to install anything manually.

System requirements

Android

  • Android 7.0+ (API 24)
  • 64-bit ARM (arm64-v8a) or x86_64 processor
  • 200 MB free storage

Windows

  • Windows 10 or 11, 64-bit
  • 300 MB free storage

Linux

  • GTK3 desktop environment
  • 64-bit processor
  • 300 MB free storage

Installation

Android

  1. Download the latest APK from the releases page.
  2. Open the APK file on your device.
  3. If prompted, enable Install from unknown sources in your device settings.
  4. Follow the on-screen prompts to complete installation.

Windows

  1. Download the latest release bundle (.zip) from the releases page.
  2. Extract the archive to a folder of your choice.
  3. Run TrueStream.exe from the extracted folder.

Linux

  1. Download the latest release bundle (.tar.gz) from the releases page.
  2. Extract the archive to a folder of your choice.
  3. Open a terminal in the extracted directory and run:
./truestream

First run

On first launch, TrueStream walks you through a set of onboarding screens that explain the app's features and layout. After you complete the onboarding, the engine bootstrap process begins:

  • FFmpeg and aria2c are downloaded from the CDN and verified with SHA-256 checksums.
  • yt-dlp is initialized and updated to the latest version.
  • The app creates default file structures for downloads, presets, and caching.

Once the bootstrap finishes, you're ready to go. Paste a supported URL into the Home screen input field to start your first download.

Quick start

Step 1: Open TrueStream. You'll land on the Home screen with a text input at the top.

Step 2: Paste a supported URL (YouTube, Vimeo, Twitter/X, and thousands more) into the input field.

Step 3: Tap the format picker to browse available streams. Choose your preferred quality and container format. You can also apply a saved preset to skip this step in the future.

Step 4: The download begins immediately. A live progress card shows the download speed, ETA, and current stage (downloading, merging, or post-processing).

Step 5: Switch to the Library tab to access your completed downloads. From there you can play, share, or delete your media.

Clone this wiki locally