# FreeTube — Privacy-Focused YouTube Desktop Client

> A cross-platform desktop app for watching YouTube without ads or tracking. Built with Electron, it supports local subscriptions, video downloads, and works with Invidious or the built-in extractor.

## Install

Save in your project root:

# FreeTube — Privacy-Focused YouTube Desktop Client

## Quick Use
```bash
# Install on Linux via Flatpak
flatpak install flathub io.freetubeapp.FreeTube

# Or download from GitHub releases for Windows/macOS/Linux
# https://github.com/FreeTubeApp/FreeTube/releases
```

## Introduction
FreeTube is a free, open-source desktop YouTube client designed to keep your viewing habits private. It runs on Windows, macOS, and Linux, letting you browse, search, and watch YouTube content without Google tracking your activity or showing ads.

## What FreeTube Does
- Streams YouTube videos without ads or Google telemetry
- Manages subscriptions and watch history entirely on your local machine
- Downloads videos in multiple resolutions and formats
- Offers two extraction backends: a local scraper and the Invidious API
- Supports importing subscriptions from YouTube, NewPipe, and OPML

## Architecture Overview
FreeTube is an Electron-based application that uses either a local extraction module (similar to NewPipe Extractor) or proxies requests through Invidious instances to retrieve video data. All user data including subscriptions, playlists, and history is stored in a local NeDB database, so nothing is sent to external servers by default.

## Self-Hosting & Configuration
- Download pre-built binaries from GitHub Releases or install via Flatpak
- Switch between Local API and Invidious API modes in Settings
- Configure a preferred Invidious instance for API-mode requests
- Set default video quality, playback speed, and subtitle preferences
- Back up your profile data by exporting the local database file

## Key Features
- Dual extraction backend for flexibility and resilience
- Fully local subscription and history management
- Sponsor segment skipping via SponsorBlock integration
- Distraction-free interface without recommendations or comment noise
- Cross-platform support for all major desktop operating systems

## Comparison with Similar Tools
- **NewPipe** — Android-only native app; FreeTube covers desktop platforms
- **Invidious** — web-based frontend requiring a hosted instance; FreeTube is a standalone app
- **Piped** — server-side proxy approach; FreeTube can run fully offline with local API
- **youtube-dl / yt-dlp** — CLI download tools; FreeTube adds a full GUI player experience

## FAQ
**Q: Does FreeTube require a Google account?**
A: No. All subscriptions and history are stored locally.

**Q: What is the difference between Local API and Invidious API?**
A: Local API scrapes YouTube directly from your machine. Invidious API routes requests through a third-party server, adding a layer of IP privacy.

**Q: Can I use SponsorBlock with FreeTube?**
A: Yes. Enable it in Settings to automatically skip sponsored segments in videos.

**Q: Is FreeTube available on mobile?**
A: No. For mobile, consider NewPipe (Android) or similar alternatives.

## Sources
- https://github.com/FreeTubeApp/FreeTube
- https://freetubeapp.io

---
Source: https://tokrepo.com/en/workflows/asset-0e49f2c9
Author: AI Open Source