Skip to content

Repository files navigation

🎬 SimplStream

It's not just streaming, it's SimplStream.

Donate to 💲CashApp💲


React TypeScript Tailwind CSS Vite

A beautiful, modern streaming platform with a Hulu-inspired UI

🚀 Live Demo · 📱 Download App · 🐛 Report Bug

💲CashApp


✨ Features

🎥 Content Discovery

Feature Description
🔥 Trending Content Browse what's popular right now with real-time TMDB data
🎭 Genre Browsing Explore Action, Comedy, Drama, Horror, Sci-Fi & more
🔍 Smart Search AI-powered search with filters for year, rating, and genre
🎲 Surprise Me Let SimplStream pick something perfect for your mood
📺 Live TV 40+ live channels including news, sports, movies & music

👤 User Experience

Feature Description
👨‍👩‍👧‍👦 Multiple Profiles Create up to 5 profiles per account with custom avatars
🔒 Profile Locks PIN protection for individual profiles
📋 My List Save your favorite movies and shows for later
🕐 Watch History Continue where you left off across all devices
🌙 Dark/Light Mode Beautiful themes that adapt to your preference

🎨 Modern Design

Feature Description
💎 Hulu-Inspired UI Clean, modern interface with glass morphism effects
🔵 Blue Accent Theme Elegant color scheme throughout the app
📱 Mobile Optimized PWA-ready with native-like mobile navigation
🖼️ Full-Width Hero Stunning 16:9 detail pages with backdrop imagery
Smooth Animations Polished transitions and hover effects

🛠️ Technical Features

Feature Description
Lightning Fast Built with Vite for instant hot module replacement
🎯 Type Safe Full TypeScript support for reliability
📦 Component Library Built on shadcn/ui for consistent design
💾 Local Storage Profiles and preferences persist locally
🔗 TMDB Integration Real movie & TV data from The Movie Database

📸 Screenshots

Home Detail Live TV
Modern homepage with hero banner Full-width detail pages 40+ live channels

🚀 Quick Start

Prerequisites

  • Node.js 18+
  • npm, yarn, pnpm, or bun

Installation

# Clone the repository
git clone https://github.com/SimplStudios/SimplStreamTV.git

# Navigate to project
cd SimplStreamTV

# Install dependencies
npm install

# Start development server
npm run dev

The app will be running at http://localhost:8080 🎉


📱 Mobile App

Download the Android app from our Releases Page.

Note: Enable "Install from Unknown Sources" in Android settings to install the APK.


🛠️ Tech Stack

Category Technology
⚛️ Framework React 18
📝 Language TypeScript
🎨 Styling Tailwind CSS
🧩 Components shadcn/ui + Radix UI
Build Tool Vite
🎬 Data TMDB API
🔤 Fonts Rubik

📁 Project Structure

SimplStream/
├── public/              # Static assets
├── src/
│   ├── components/      # React components
│   │   ├── ui/          # shadcn/ui components
│   │   ├── HomeView.tsx
│   │   ├── DetailView.tsx
│   │   ├── LiveTVView.tsx
│   │   ├── PlayerView.tsx
│   │   └── ...
│   ├── context/         # React context providers
│   ├── hooks/           # Custom React hooks
│   ├── lib/             # Utility functions
│   │   ├── tmdb.ts      # TMDB API integration
│   │   ├── liveChannels.ts
│   │   └── ...
│   └── pages/           # Page components
├── index.html
├── tailwind.config.ts
├── vite.config.ts
└── package.json

🤝 Contributing

Contributions are welcome! Feel free to:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

This project is for educational and personal use only. SimplStream does not host, store, or distribute any copyrighted content. All media information is provided by TMDB.


📧 Contact

SimplStudios - simplstudios@protonmail.com

Project Link: https://github.com/SimplStudios/SimplStreamTV

Donation [https://cash.app/$simplstudiosofficial]


Made with ❤️ by SimplStudios

It's not just streaming, it's SimplStream.

About

Watch unlimited movies and TV shows on Android TV. Features a clean Google-style interface with profiles and watchlists. No subscriptions. Free. Donate here: https://cash.app/$simplstudiosofficial

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages