Introduction

Welcome to the ClipCookBook documentation!

What is ClipCookBook?

ClipCookBook is a self-hosted web application specifically designed to make saving, extracting, and organizing recipes you find on social media (such as Instagram, TikTok, or YouTube) as easy as possible.

Instead of endlessly scrolling through your saved posts across different apps to find that one recipe, you can simply paste the link here and the application does the rest.

Why this application?

Creators often share recipes in a video description or quick fragments within the video itself. This makes it difficult to easily cook the recipe later.

ClipCookBook solves this by:
1. Downloading and processing the video (with cookies where platforms require login).
2. Using AI to analyze the video and/or description to distill the ingredients and preparation method into a clean, easy-to-read format.
3. Safely storing this recipe in your own local database.

Key Features

• Video Download: Uses yt-dlp to download media from most major platforms, with optional auto-updates.
• Smart Extraction: Google Gemini analyzes videos and text to find the core of the recipe (default model: gemini-3.5-flash).
• Instagram Support: Cookie upload and helpers so private/login-walled downloads keep working; public caption fallback when video auth fails.
• Beautiful UI: A modern, responsive user interface built with Next.js and Tailwind CSS.
• Local Storage: All your data stays yours, safely stored in a SQLite database via Prisma ORM.
• Ops Alerts: Optional SMTP alerts for backup failures, missing media, and expired cookies.

Now that you know what the project is about, you can continue with the Installation!