A modern, feature-rich web client for Jellyfin media servers, Finetic enhances user experience with AI-powered navigation and an advanced media player. It targets Jellyfin users seeking a more interactive and intelligent interface, as well as developers interested in Next.js, React, and AI integrations. Finetic offers streamlined media discovery, playback control, and library management through AI assistance and a polished UI.

How It Works

Built with Next.js 15 and React 19, Finetic leverages TypeScript for type safety and integrates Google Gemini 2.0 Flash for AI features. This enables natural language interaction for search, playback control, and subtitle analysis. The AI assistant's ability to understand vague descriptions and perform semantic subtitle analysis for scene navigation and explanation is a key differentiator, moving beyond simple keyword matching.

Quick Start & Requirements

• Primary install: Clone the repository (git clone https://github.com/AyaanZaveri/finetic), then run npm install (or yarn install, bun install).
• Prerequisites: Node.js 18+, a running Jellyfin server, and an optional Google AI API key for AI features.
• Setup: Configure environment variables by creating a .env.local file with your Jellyfin server URL and Google AI API key.
• Development: Run npm run dev.
• Docker: Recommended deployment via docker-compose up -d.

Highlighted Details

• AI-powered navigation and search using Google Gemini 2.0 Flash, capable of understanding natural language queries and vague descriptions (e.g., "the show about meth" → "Breaking Bad").
• Advanced media player featuring direct/transcoded playback, automatic subtitle analysis for scene skipping and context explanation, and an integrated "Skip Intro" button.
• Modern frontend stack including Next.js 15, React 19, TypeScript, Tailwind CSS v4, shadcn/ui, and Framer Motion.

Maintenance & Community

The provided README does not detail specific contributors, sponsorships, or community channels like Discord or Slack. It appears to be a personal or small-team project.

Licensing & Compatibility

• License: GNU General Public License v3.0 (GPL-3.0).
• Compatibility: GPL-3.0 is a strong copyleft license. Derivative works must also be licensed under GPL-3.0, which may impose restrictions on integration into closed-source commercial applications.

Limitations & Caveats

AI features are optional and require a Google AI API key, which may incur costs. The project's functionality is dependent on a running Jellyfin server. The use of bleeding-edge framework versions (Next.js 15, React 19) might indicate potential instability or rapid changes.