✨ KawaiiCut

English | Русский

KawaiiCut is a modern video editing application similar to Clipchamp, built with web technologies. It combines a sleek, dark-themed aesthetic with powerful editing capabilities, featuring a timeline, media management, text overlays, and visual effects.

Important

Project Origin: This project was originally created for my personal needs and preferences. The source code is shared here just in case someone wants to modify or improve it for themselves. It was not intended for a mass audience, so feel free to do whatever you want with it.

🌟 Features

• Multi-Track Timeline: Drag-and-drop support for video, audio, and overlay tracks.
• Media Library: Import and manage your videos, images, and audio files.
• Rich Text Editor: Add stylish text with preset animations (Cyber, Retro, Neon, etc.) and custom fonts.
• Visual Effects: Apply effects like VHS Glitch, Snow, Rain, Blur, and more via drag-and-drop.
• Keyframe-like Control: Adjust scale, position, rotation, and opacity for every clip.
• Export: Render your projects to MP4 with customizable resolution (up to 4K) and FPS.

Caution

CRITICAL EXPORT WARNING: When exporting your video, DO NOT CLOSE OR MINIMIZE THE APPLICATION. It is highly recommended to close all other background applications. The export process is resource-intensive; if the PC is overloaded, the audio in the final video will glitch and stutter significantly.

• Auto-Save: Projects are automatically saved to the local database.

🛠 Tech Stack

• Core: Electron
• UI Framework: React
• Build Tool: Vite
• Language: TypeScript
• Styling: Tailwind CSS
• Database: IndexedDB (via idb)

🚀 Getting Started

Prerequisites

• Node.js (v16 or higher)
• npm

Installation

1. Clone the repository:

   git clone https://github.com/dvytvs/KawaiiCut.git
   cd KawaiiCut

2. Install dependencies:

   npm install

Running in Development

To start the app in development mode with hot-reloading:

npm start

📦 Building for Production

To build the application for Linux:

npm run build

The output files (AppImage, deb, snap, etc.) will be located in the release/ directory.

⌨️ Controls

• Space: Play / Pause
• Delete / Backspace: Delete selected clip
• Drag & Drop: Move clips, import media, apply effects
• Mouse Wheel: Scroll timeline

---

🇷🇺 KawaiiCut (Описание на русском)

KawaiiCut — это современное приложение для видеомонтажа, схожее с Clipchamp, созданное с использованием веб-технологий. Оно сочетает в себе эстетичный темный интерфейс с мощными возможностями редактирования, включая мультитрековый таймлайн, управление медиафайлами, стильные титры и визуальные эффекты.

Important

О проекте: Этот проект изначально создавался исключительно под мои личные хотелки и нужды. Исходный код выложен просто на случай, если кому-то захочется что-то поменять или доработать под себя. Программа не создавалась для широких масс, так что делайте с ней что хотите.

🌟 Возможности

• Мультитрековый таймлайн: Поддержка перетаскивания (drag-and-drop) для видео, аудио и оверлеев.
• Медиатека: Импорт и управление вашими видео, изображениями и аудиофайлами.
• Редактор текста: Добавление стильного текста с пресетами (Кибер, Ретро, Неон и др.) и кастомными шрифтами.
• Визуальные эффекты: Применение эффектов, таких как VHS-глитч, Снег, Дождь, Размытие и других, простым перетаскиванием.
• Настройка клипов: Регулировка масштаба, позиции, поворота, прозрачности и скорости воспроизведения.
• Экспорт: Рендеринг проектов в MP4 с настраиваемым разрешением (до 4K) и FPS (30/60).

Caution

ВАЖНОЕ ПРЕДУПРЕЖДЕНИЕ ПРИ ЭКСПОРТЕ: Когда вы экспортируете проект, НЕ ВЫХОДИТЕ ИЗ ПРИЛОЖЕНИЯ И НЕ СВОРАЧИВАЙТЕ ЕГО. Крайне желательно отключить все другие приложения в фоне. Процесс рендеринга сильно нагружает ПК; если система будет перегружена, аудио в готовом видео будет ужасно глючить и заикаться.

• Автосохранение: Проекты автоматически сохраняются в локальную базу данных браузера (IndexedDB).

🛠 Стек технологий

• Ядро: Electron
• Интерфейс: React
• Сборщик: Vite
• Язык: TypeScript
• Стили: Tailwind CSS
• База данных: IndexedDB (через idb)

🚀 Начало работы

Требования

• Node.js (версия 16 или выше)
• npm

Установка

1. Клонируйте репозиторий:

   git clone https://github.com/dvytvs/KawaiiCut.git
   cd KawaiiCut

2. Установите зависимости:

   npm install

Запуск (Режим разработки)

Чтобы запустить приложение в режиме разработки с hot-reloading:

npm start

📦 Сборка (Build)

Чтобы собрать приложение в установочный файл для Linux:

npm run build

Готовые файлы (AppImage, deb, snap и т.д.) появятся в папке release/.

Примечание для Linux: Для сборки .deb пакетов в package.json обязательно должно быть указано поле homepage.

⌨️ Управление

• Пробел: Воспроизведение / Пауза
• Delete / Backspace: Удалить выбранный клип
• Drag & Drop: Перемещение клипов, импорт медиа, применение эффектов
• Колесо мыши: Прокрутка таймлайна

---

👤 Author / Автор

dvytvs

• Email: zapretsystem445@proton.me

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.