LocalTube

LocalTube is a modern, high-performance desktop application for browsing YouTube playlists, channels, and videos with a focus on a clean, premium user experience. Built with Electron and React, it provides a distraction-free way to consume content from your favorite creators.

✨ Features

• 🚀 Desktop-First Experience: A native-feeling application with smooth interactions and a polished UI.
• 📺 Distraction-Free Browsing: Browse YouTube channels and playlists without the clutter and algorithm-driven noise of the web interface.
• 📑 Channel & Playlist Management: Easily navigate through curated content and deep-dive into specific channels.
• 🔖 Bookmarking: Save your favorite videos or playlists for quick access later.
• 🎨 Premium UI/UX: Built with a modern design system, featuring glassmorphism, smooth animations, and a responsive layout.

🖥️ System Requirements

• OS: macOS 13.0 or later
• Architecture: Apple Silicon (M1/M2/M3/M4)

⬇️ Download

You can download the latest version of LocalTube for macOS from the Releases page.

1. Go to Releases.
2. Download the latest .dmg or .zip file.
3. Install by dragging LocalTube to your Applications folder.

🛠 Tech Stack

Core

• Framework: React 18
• Desktop Shell: Electron
• Build Tool: Vite
• Language: TypeScript

State & Routing

• Routing: TanStack Router
• Data Fetching: TanStack Query
• State Management: Immer

Styling & UI

• CSS: Tailwind CSS v4
• Components: Radix UI primitives
• Icons: Lucide React
• Animations: tailwindcss-animate

Desktop Utilities

• Storage: electron-store
• Window Management: electron-window-state
• Updater: electron-updater
• Packaging: electron-builder

🚀 Getting Started

Prerequisites

• Node.js (v20 or later recommended)

Installation

1. Clone the repository:

   git clone https://github.com/limboy/localtube.git
   cd localtube

2. Install dependencies:

   npm install

3. (Optional) Set up environment variables: Copy .env.example to .env and fill in any required keys.

Development

Run the development environment:

npm run dev

This command will concurrently start:

• The Vite dev server for the frontend (src-web).
• The Electron main process with TypeScript compilation and hot-reloading.

Building for Production

To package the application for production:

npm run build

The build artifacts will be available in the dist/ and electron/dist/ directories (specific output location depends on electron-builder.yml configuration). By default, it targets macOS (arm64).

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.