A minimal, ad-free YouTube client built with Next.js and FastAPI. This project provides a clean and distraction-free YouTube viewing experience.
- 🚫 Ad-free YouTube experience
- 🎯 Minimal and clean interface
- 🔄 Video recommendations
- 🎨 Modern, responsive design
- 💨 Fast and efficient playback
- 🔒 Secure cookie-based authentication
- Bun for frontend package management and development
- uv for Python package management
- Cookie Editor browser extension
- Python 3.8 or higher
# Install Bun (macOS & Linux)
curl -fsSL https://bun.sh/install | bash
# Install dependencies
bun i
# Start development server
bun run dev# Navigate to backend directory
cd backend
# Install uv package manager
curl -LsSf https://astral.sh/uv/install.sh | sh
# Create and activate virtual environment
uv venv
source .venv/bin/activate
# Install Python dependencies
uv pip install -r requirements.txt
# Start backend server
uvicorn main:app- Install the Cookie Editor extension in your browser
- Visit YouTube
- Open Cookie Editor and export cookies in Netscape format
- Navigate to
localhost:3000in your browser - When prompted, select "cookies" option and paste your YouTube cookies
- Next.js
- TypeScript
- Tailwind CSS
- Bun package manager
- FastAPI (Python)
- Redis for caching
- MongoDB for data storage
- yt-dlp for YouTube integration
Contributions are welcome! Feel free to submit issues and enhancement requests.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is for educational purposes only. Please ensure you comply with YouTube's terms of service when using this application.
Made with ❤️ by S4tyendra