An open API service indexing awesome lists of open source software.

https://github.com/brogrammer1912/adfreetube

An alternative YouTube client without ads!
https://github.com/brogrammer1912/adfreetube

adfree ads audio audioplayer internet-video-streaming media songs streaming streaming-video trending videoplayer videos videostreaming webscraping youtube youtube-video

Last synced: 19 days ago
JSON representation

An alternative YouTube client without ads!

Awesome Lists containing this project

README

          

# Ad-Free Tube **🚀 [Download Latest Release](https://github.com/AkshathSai/addfreetube/releases/latest/download/addfreetube.jar) | 📖 [Read the Story](https://medium.com/@akshathsai.pittala/i-built-my-own-ad-free-youtube-because-i-was-tired-of-being-the-product-4fae2ac87c7b)**

A distraction-free YouTube experience that puts you in control of your viewing habits.

![Ad-Free Tube](https://github.com/user-attachments/assets/b5f3c3a9-25af-4bf4-9473-bb5086bb70ae)
Image
Image
Image
Image
Image

https://github.com/user-attachments/assets/315f427c-db18-4d77-932d-11a3a5d8cf68

## ✨ Features

- **Clean, Focused Interface** - Centered search that gets out of your way
- **Ad-Free Viewing** - Watch videos without interruptions
- **Responsive Design** - Works beautifully on all devices
- **Light & Dark Mode** - Choose your preferred viewing experience
- **Direct Video Access** - Find exactly what you want without algorithm distractions
- **Minimal UI** - No recommendation rabbit holes or endless scrolling

## 🚀 Purpose

Ad-Free Tube was created to help you reclaim your attention and time. Instead of falling into the trap of algorithmic recommendations and endless scrolling, this app:

- Puts **you in control** of what you watch
- Helps you **focus** on the content you actually care about
- Eliminates **distractions** and interruptions
- Gives you back time for **life's little things**

## 🔧 Technologies

- Java 24
- Spring Boot 3.4.5
- Thymeleaf + HTMX
- Bootstrap 5.3.5
- Maven

## 🏃‍♂️ Getting Started

### Prerequisites
- Java 24 or higher
- Maven

### Running Locally

```bash
# Clone the repository
git clone https://github.com/yourusername/addfreetube.git

# Navigate to project directory
cd addfreetube

# Build the project
mvn clean install

# Run the application
mvn spring-boot:run
```

Visit `http://localhost:8080` in your browser to start using Ad-Free Tube!

## 🧩 How It Works

1. Enter your search query in the centered search box
2. Select a video from the search results
3. Enjoy watching without ads or distractions
4. Use the theme switcher to toggle between light and dark mode

## 📱 Mobile-Friendly

Ad-Free Tube is fully responsive and works great on:
- Desktops
- Tablets
- Smartphones
- Televisions

## 📝 License

This project is open source and available under the [Apache 2](LICENSE).

## 👨‍💻 Developer

Developed by [Akshath Sai Pittala](https://github.com/AkshathSai)

---

⭐ **If you find this useful, please share it on your social networks!** ⭐

[Twitter](https://twitter.com/share?url=https://github.com/yourusername/addfreetube) | [Facebook](https://www.facebook.com/sharer/sharer.php?u=https://github.com/yourusername/addfreetube) | [LinkedIn](https://www.linkedin.com/shareArticle?mini=true&url=https://github.com/yourusername/addfreetube)