# VibeWatch: Full Documentation > Free movie and TV show tracking app. Discover content by mood, rate what you watch with personal 1-10 ratings, build your watchlist, get daily release notifications, recommend titles to friends, and watch from your own streaming sources. Available on web and Android. ## What is VibeWatch? VibeWatch is a free movie and TV show tracking application available on the web at vibewatch.app and on Android through the Google Play Store. It serves as a personal entertainment companion that helps users discover content based on their mood, maintain a watchlist of titles they want to watch, track everything they have watched with personal 1-10 ratings, and share recommendations with friends. VibeWatch is powered by The Movie Database (TMDB), giving it access to comprehensive metadata for movies and TV shows including cast, crew, trailers, reviews, and streaming availability. Unlike competing apps that focus on either movies or television separately, VibeWatch tracks both in a single unified experience with one watchlist, one watched diary, and one profile. ## How VibeWatch Works Using VibeWatch follows a simple three-step flow: **Step 1. Discover.** Browse trending content on the homepage, search by title or person name, or use mood-based discovery to find content that matches how you feel. Mood categories like "Edge of Your Seat", "Comfort Watch", "Mind-Bending", and "Feel-Good" surface curated suggestions using TMDB keyword data rather than generic genre lists. **Step 2. Save.** Add interesting titles to your watchlist with a single tap from any title page, search result, or trending row. Your watchlist syncs across web and Android so you never lose a recommendation. **Step 3. Watch and Rate.** After watching a movie or TV show, move it to your watched list and rate it on a 1-10 scale. Your ratings build up a personal viewing diary with stats, filters, and a shareable public profile. If you have added your own streaming sources (Jellyfin, Plex, or iframe-based services), you can watch directly on the title page with automatic progress tracking that resumes where you left off. ## What Makes VibeWatch Different VibeWatch occupies a unique position in the entertainment tracking space by combining features that competitors offer separately: **Combined Movie and TV Tracking.** Letterboxd is the most popular movie tracker but only covers films. Serializd tracks TV shows but not movies. JustWatch shows streaming availability but has no personal tracking or ratings. VibeWatch is the only app that unifies movies and TV shows into a single watchlist, watched diary, and profile page. Users do not need to switch between multiple apps to manage their entertainment. **Mood-Based Discovery.** Instead of browsing by generic genres (Action, Comedy, Drama), VibeWatch uses TMDB keywords to build mood-based collections. Users select how they feel ("Edge of Your Seat" for thrillers and suspense, "Comfort Watch" for familiar favorites, "Mind-Bending" for complex narratives) and get tailored suggestions. This approach surfaces content that matches emotional intent rather than just category. **Daily Release Notifications.** VibeWatch monitors every title on a user's watchlist and watched list for changes. New episode air dates, movie release dates, series renewals, cancellations, and season premieres all trigger a daily email digest. Users never miss a release without manually checking calendars or social media. **Friend Recommendations.** Users can recommend titles directly to friends on the platform with an optional personal message. The recipient gets an email notification and can see the recommendation in their profile. This social layer makes VibeWatch more than a solo tracking tool. **Built-In Video Player.** Users who have their own media servers can add Jellyfin, Plex, or iframe-based streaming sources in settings and watch directly on title pages. Watch progress syncs automatically. Pause on one device, pick up on another. The player supports HLS streaming, audio track switching, and subtitle selection. **Public Profiles.** Every user gets a shareable profile page showing their Top 10 favorite titles (a deliberate ten-slot format instead of Letterboxd's four, and mixing movies with TV), bio, viewing stats, and recent activity. Profiles are public by default, making them easy to share on social media or with friends. ## Features in Detail ### Watchlist The watchlist is where users save titles they want to watch. Adding a title takes a single tap from any title page, search result, or scrolling row on the homepage. The watchlist displays poster cards with title, year, and media type. Users can filter by movies or TV shows and sort by date added. The watchlist syncs across web and Android using the same Supabase account. ### Watched List The watched list tracks everything a user has seen, along with their personal 1-10 rating. Users can re-rate titles, filter by rating range, sort by date watched or rating, and view aggregate statistics including total titles watched, average rating, and rating distribution. Bulk actions allow removing multiple titles at once. Moving a title from the watchlist to the watched list is a single action that prompts for a rating. ### Search The search page finds movies, TV shows, and people using the TMDB API. Results display poster cards with release year and media type badges. Searching for a person shows their filmography, known credits, and biographical information. The search supports both title and person queries in a single input field. ### Title Pages Every movie and TV show has a detailed title page showing poster, backdrop image, synopsis, cast and crew, trailers, user reviews from TMDB, streaming availability via JustWatch data, and related recommendations. For authenticated users with video sources configured, a play button appears that launches the built-in video player. TV series title pages include season and episode listings with air dates and episode descriptions. ### Person Pages Actor, director, and crew member pages display biographical information, a photo, and a complete filmography organized by department (acting, directing, writing, producing). The filmography is sortable and filterable. External links to IMDb, Instagram, and Twitter are shown when available from TMDB. ### Release Notifications The release notification system runs daily and checks every title tracked by every user. It detects five types of events: movie releases (today or within 3 days), TV episode air dates (today), season premieres, status changes (renewed, canceled, ended), and movie status transitions. Events are grouped per user into a single daily email digest sent via Resend. Users can opt out in settings. Each notification includes the title name, event type, and a direct link to the title page on VibeWatch. ### Friend System Users can search for friends by username, send friend requests, and manage their friend list. The friends page shows a two-tab layout: a discovery tab for finding and adding friends, and a friends list tab showing accepted connections. Friend requests include accept and decline actions with real-time status updates. ### Blog The VibeWatch blog publishes weekly entertainment picks every Friday, monthly recaps on the first of each month, and a year-in-review post annually. Content is driven by Reddit discussions: the most talked-about movies, TV shows, trailers, and industry news from communities like r/movies, r/television, r/boxoffice, and r/NetflixBestOf. Each post includes Reddit source links, TMDB metadata, and hero backdrop images. The blog has an RSS feed at vibewatch.app/feed.xml and sends email notifications to subscribers in two batches (Friday and Saturday). ### Public Profiles User profiles display a customizable Top 10 section showing favorite titles (movies and TV mixed) with poster cards, a bio, display name, and viewing statistics. The Top 10 format gives people more room than Letterboxd's Top 4 and reflects VibeWatch's unified movies-plus-TV identity. Profiles are accessible at vibewatch.app/u/username and are public by default. Users can edit their profile through a settings modal that allows changing display name, username, bio, and avatar. ## Frequently Asked Questions ### What is VibeWatch? VibeWatch is a free movie and TV show tracking app that helps you discover what to watch based on your mood, track everything you have seen with ratings and a personal diary, and share recommendations with friends. It is available on the web at vibewatch.app and on Android through the Google Play Store. All features are free with no premium tier or paywall. VibeWatch uses data from The Movie Database (TMDB) to provide comprehensive metadata for over one million movies and TV shows. ### How does mood-based discovery work? VibeWatch uses TMDB keywords and curated mood collections to match content to how you feel. Pick a mood like "Edge of Your Seat", "Comfort Watch", or "Mind-Bending" and get tailored movie and TV show suggestions. This approach is different from browsing by genre because it targets emotional intent (what kind of experience you want) rather than broad content categories. The mood system surfaces titles you might not find through conventional genre browsing. ### Can I track both movies and TV shows in one place? Yes. Unlike Letterboxd (movies only) or Serializd (TV only), VibeWatch tracks both movies and TV shows in a single watchlist, diary, and profile. Rate, review, and organize everything together. Your viewing statistics include both movies and TV shows, and your public profile displays all tracked content in one place. This makes VibeWatch the simplest option for users who watch both movies and television. ### How do release notifications work? VibeWatch automatically monitors titles on your watchlist and watched list for new episodes, movie releases, status changes (renewed, canceled), and season premieres. You receive a daily email digest with all updates, no manual checking required. The system runs every day and detects events including movies releasing within 3 days, TV episodes airing today, series renewals and cancellations, and season premieres. You can disable notifications in your account settings. ### Can I watch movies and shows directly on VibeWatch? Yes. Add your own streaming sources in Settings and watch directly on the title page. VibeWatch supports Jellyfin, Plex, and iframe-based video sources. Your watch progress syncs automatically. Pause on one device, pick up on another. The built-in player supports HLS streaming, multiple audio tracks, and subtitle selection. VibeWatch is not a streaming service itself; it connects to your existing media servers and streaming sources. ### Is VibeWatch free? Yes, VibeWatch is completely free. All features (tracking, discovery, ratings, release notifications, friend recommendations, and the video player) are available at no cost on both web and Android. There is no premium tier, no ads, and no paywall. VibeWatch is an independent project built as a passion project for movie and TV enthusiasts. ### How does VibeWatch compare to Letterboxd? Letterboxd is an excellent movie-focused social platform, but it only tracks films. VibeWatch tracks both movies and TV shows in a single app with a unified watchlist and watched diary. VibeWatch also offers mood-based discovery, daily release notifications for tracked titles, friend recommendations with email alerts, a built-in video player for personal streaming sources, and a weekly blog with Reddit-driven picks. If you watch both movies and TV shows and want everything in one place, VibeWatch fills the gap that Letterboxd leaves for television. A full comparison is published at https://vibewatch.app/vs/letterboxd covering feature tables, migration, and honest recommendations on who should use which. ## Best for VibeWatch is the right pick if you want any of these: - Track movies AND TV shows in one diary, one profile, one rating system - A completely free tracker with no premium tier, no ads, no paywalls - Mood-based discovery rather than genre filters - Daily email digest for new episodes, movie releases, renewals, and cancellations - A built-in player that connects to your own Plex or Jellyfin server - A shareable public profile with Top 10 favorites covering both film and TV - Reddit-driven weekly blog picks instead of algorithm-curated feeds - An Android app that syncs with a responsive web app ## Not best for VibeWatch is not the right pick if you want any of these: - A mature film-criticism community with long-form written reviews (use Letterboxd) - Deep episode-level ratings where each episode gets its own score (Serializd does this) - A native iOS app today (iOS is planned, web works on iPhone in the meantime) - A Trakt-style API for developers to integrate third-party clients (not offered) ## Comparison Summary Letterboxd: best-in-class for movies only, mature review community, free tier with $19/year Pro. Does not cover TV. Trakt: covers both movies and TV but recently moved most features behind a paid tier at $30/year. Strong developer ecosystem but UI has aged. Serializd: best-in-class for TV only, episode-level ratings. Does not cover movies. TV Time: TV tracker with ad-heavy mobile experience, declining product quality. Simkl: closest functional competitor. Covers movies and TV. VibeWatch differentiates on design, mood discovery, and Plex/Jellyfin integration. JustWatch: streaming availability only, no personal tracking or ratings. VibeWatch: combines Letterboxd-style movie tracking with Serializd-style TV tracking in a unified profile, adds mood discovery, daily release notifications, and a built-in player for Plex and Jellyfin. Completely free. ### Does VibeWatch have a mobile app? Yes. VibeWatch has an Android app available for free on the Google Play Store (search "VibeWatch" or find it at the package name com.vibewatch.app). The web version at vibewatch.app works on any device with a browser, including iPhones and iPads. Your account syncs across both platforms. Add a title to your watchlist on your phone and it appears on the web instantly. ### What streaming services does VibeWatch show? VibeWatch displays streaming availability information powered by JustWatch data through the TMDB API. This shows which platforms (Netflix, Disney+, Hulu, Amazon Prime Video, etc.) currently offer a title in your region. Additionally, VibeWatch has a built-in video player that connects to your personal streaming sources: Jellyfin and Plex media servers, or any iframe-embeddable video source. The streaming availability data and the personal video player are separate features that complement each other. ### How do friend recommendations work on VibeWatch? When you find a movie or TV show that a friend would enjoy, tap the recommend button on the title page, select a friend from your friends list, and optionally add a personal message. Your friend receives an email notification about the recommendation and can see it on their profile. This makes sharing entertainment picks quick and personal. No need to open a separate messaging app to tell someone about a great show. ## Technical Details - **Website**: https://vibewatch.app - **Android App**: Google Play Store (com.vibewatch.app) - **Data Source**: The Movie Database (TMDB) API, not endorsed or certified by TMDB - **Pricing**: Free, all features included, no premium tier - **Framework**: Next.js with server-side rendering - **Hosting**: Cloudflare Workers - **Authentication**: Supabase (email/password and Google OAuth) ## Social Presence - **X / Twitter**: https://x.com/vibe_watch - **YouTube**: https://www.youtube.com/@Vibes-Watch - **Reddit**: https://www.reddit.com/user/PrincipleTop4437/ - **Google Play**: https://play.google.com/store/apps/details?id=com.vibewatch.app ## Contact - General support: support@vibewatch.app - Professional: amorosodavid@vibewatch.app ## Recent Blog Posts The VibeWatch blog publishes weekly entertainment picks every Friday, sourced from Reddit discussions across r/movies, r/television, r/boxoffice, and other entertainment communities. - [Blog Index](https://vibewatch.app/blog): All posts - [RSS Feed](https://vibewatch.app/feed.xml): Subscribe for updates