Kinofinder is a modern movie and TV show recommendation web app built with React and the TMDb API. Users can set personalized preferences—genres, languages, favorite actors, year, and rating—to get curated recommendations for both movies and TV shows.
- Select preferred movie & TV genres
- Choose languages for recommendations
- Set a favorite actor (TMDb search automatically converts to ID)
- Filter by release year and minimum rating
- Sort results by popularity, rating, or release date
- Movies and TV shows displayed in a unified grid with type badges
- Preferences are saved locally (
localStorage) under Kinofinder_preferences
- Frontend: React, CSS
- API: TMDb (The Movie Database)
- State Management: React Hooks (
useState,useEffect) - Storage:
localStorage(namespaced to avoid conflicts)
- Clone the repository:
git clone https://github.com/yourusername/kinofinder.git
cd kinofinder- Install dependencies:
npm install-
Add your TMDb API key:
- Replace
YOUR_TMDB_API_KEYinPreferences.jsxandRecommended.jsx
- Replace
-
Start the development server:
npm run devOpen http://localhost:5173 in your browser.
- Go to the Preferences page.
- Select genres, languages, enter your favorite actor, set year, rating, and sort order.
- Click Save Preferences.
- Go to the Recommended page to see curated movies and TV shows.
Preferences Page
Recommendations Page
- Actor filtering requires TMDb person ID, automatically handled by the app.
- If no results match all preferences, the app loosens filters progressively to ensure recommendations are shown.
MIT License © 2025